SECSIPIDX(1)

<h1># secsipidx ✨</h1>

okay so bestie, welcome to section 1 of the General Commands Manual, and it's literally all about secsipidx — the CLI tool and HTTP API server that checks or builds your SIP identity headers. It's giving "small tool, big STIR/SHAKEN energy" and honestly? obsessed. 💅

🌸 NAME 🌸

secsipidx — a CLI tool and HTTP API server to check or build SIP identity headers. that's it, that's the whole vibe, no cap 🎀

🦋 SYNOPSIS 🦋

secsipidx [options]

✨ DESCRIPTION ✨

okay so picture this: it's a command line application whose whole main character job is to check or build SIP identity headers as per IETF RFC8224 and RFC8588 — yes bestie, that's STIR and SHAKEN. 🔥

and it can also be run in daemon mode, serving up an HTTP REST API so that external applications can adopt STIR and SHAKEN without breaking a sweat. fr fr, it's out here making everyone's life easier. 🫶

💅 OPTIONS 💅

okay bestie, here comes the whole list. every single one. hydrate first. 💖

• -H, -http-srv — http server bind address
• -https-srv — https server bind address
• -https-pubkey — https server public key
• -https-prvkey — https server private key
• -http-dir — directory to serve over http
• -k, -fprvkey — path to private key
• -p, -fpubkey — path to public key
• -fheader — path to file with header value in JSON format
• -header — header value in JSON format
• -fpayload — path to file with payload value in JSON format
• -payload — payload value in JSON format
• -fidentity — path to file with identity value
• -identity — identity value
• -alg — encryption algorithm (default: ES256)
• -ppt — used extension (default: shaken)
• -typ — token type (default: passport)
• -x5u — value of the field with the location of the certificate used to sign the token (default: '')
• -a, -attest — attestation level (default: 'C')
• -d, -dest-tn — destination (called) number (default: '')
• -o, -orig-th — origination (calling) number (default: '')
• -iat — timestamp when the token was created
• -orig-id — origination identifier (default: '')
• -c, -check — check validity of the signature
• -s, -sign — sign the header and payload
• -S, -sign-full — sign the header and payload, with parameters
• -json-parse — parse and re-serialize JSON header and payaload values
• -expire — duration of token validity (in seconds)
• -timeout — http get timeout (in seconds, default: 3)
• -l, -ltest — run local basic test
• -version — print version
• -cache-dir — path to the directory with cached certificates (default: '')
• -cache-expire — duration of cached certificates (in seconds, default 3600)
• -ca-file — file with root CA certificates in pem format
• -ca-inter — file with intermediate CA certificates in pem format
• -cert-verify — certificate verification mode (default: 0)
• -crl-file — file with CRL

🎀 EXAMPLES 🎀

TODO

bestie I'm not gonna lie, that's literally what it says. the examples section is a TODO. we wait. 💀

👑 AUTHOR 👑

This manual page was written by Victor Seva <vseva@debian.org>, for the Debian project (and may be used by others). 💜 iconic behavior honestly.

and that's the whole page bestie!! this one's dated 2021-01-07, it's the SECSIPIDX(1) page, straight out of the General Commands Manual — so go forth and check/build those SIP identity headers. slay. 🦋✨🎀