Skip to main content

priompt-auth reference

priompt-auth init [-key-file auth.key] [-force] generate the Ed25519 signing key
priompt-auth gen-secret <client_id> [org] [rw] mint a service-account secret + clients.txt line
priompt-auth serve [flags] run the token issuer

serve flags

FlagDefault
-addr:8444listen address
-key-fileauth.keysigning key from init
-clients-fileservice accounts: client_id sha256:<hex> [org] [rw]
-groups-fileIdP group → [org] [rw] mapping (first match wins)
-oidc-issuerIdP issuer URL. Turns on grant_type=oidc.
-oidc-audiencethe ID token's required aud
-ttl15missued token lifetime

Endpoints

Endpoint
POST /tokengrant_type=client_credentials with client_id and client_secret, or grant_type=oidc with id_token. Returns {"access_token","token_type":"Bearer","expires_in"}.
GET /jwkspublic keys. Point the server's -auth-jwks-url here.
GET /healthzliveness

Errors: 401 {"error":"invalid_client"} for bad client credentials, and 403 {"error":"access_denied"} when an SSO user matches no group.

Audit

The service writes one JSON line per issuance and per denial to stderr, with the subject, org, grant type, and reason.