Skip to main content

Security & SSO

CLI equivalent of Admin Tasks → Security & SSO. Admin-only, and Enterprise-only - the same plan restriction the SSO tab enforces.

Show Current Configuration

sudodocs admin sso get

Prints domain, client_id, and issuer_url - never the client secret, even though the web dashboard's own form does pre-fill it into a password field.

Configure SSO

sudodocs admin sso set \
--domain "company.com" \
--client-id "your-client-id" \
--client-secret "your-client-secret" \
--issuer-url "https://company.okta.com/.well-known/openid-configuration"

Set your IdP's Sign-in Redirect URI to https://app.sudodocs.com/login/sso/callback before saving - see Configure your Identity Provider.

Headless API

EndpointMethodPurpose
/admin/ssoGET{"domain", "client_id", "issuer_url"} (no secret). Wrapped by sudodocs admin sso get.
/admin/ssoPOST{"domain", "client_id", "client_secret", "issuer_url"}. Wrapped by sudodocs admin sso set.