Can I authenticate to Cognocient with JWTs from my identity provider?
Accept short-lived JWTs from Okta, Entra, Auth0, Keycloak or any OIDC provider as proxy credentials, with claims mapped to attribution automatically. Business plan.
Register your identity provider
Open Settings → Security & SSO → JWT authentication and add an issuer:
| Field | Example |
|---|---|
Issuer (iss) | https://acme.okta.com/oauth2/default |
Audience (aud) | cognocient (anything your IdP puts in the token's audience) |
| JWKS URL | https://acme.okta.com/oauth2/default/v1/keys |
| User claim | sub (or email) |
| Department / project / feature claims | Optional: the claim names that carry them |
Cognocient reads the JWKS to confirm it holds signing keys before saving. An issuer and audience pair can belong to only one account.
Call with a token
The token goes wherever an API key would: Authorization: Bearer <jwt>. It works on every proxy endpoint, including /v1/responses, audio, rerank and the MCP gateway.
Use Verify token on the same page to paste a token and see whether it would be accepted and exactly how it would be attributed, without making a call.
Security model
- Algorithms: RS256/384/512, PS256/384/512, ES256/384/512 only.
alg: noneand every HMAC algorithm are refused, which closes the classic algorithm-confusion attack. - Claims:
issmust equal the registered issuer,audthe registered audience, andexpmust be present. 60 seconds of clock skew is tolerated. - Keys: fetched from the JWKS URL you registered, which must be public HTTPS (private and internal addresses are refused). An unknown
kidtriggers one refetch per minute, so key rotation works without letting bad tokens hammer your IdP. - Fail closed: if the registry cannot be read, nobody is authenticated.
- Plan: if your plan drops below Business, tokens stop being accepted.
Notes
- All callers from one issuer share the issuer's rate-limit key. Per-user limits belong in your IdP or gateway.
- The verified token itself is never logged or stored.
- Deleting an issuer revokes its key immediately.
Related articles
Supported Providers
OpenAI, Anthropic, Gemini, Mistral, Groq, Together, Azure, AWS Bedrock, Vertex AI, and custom OpenAI-compatible endpoints.
OpenAI Responses API
POST /v1/responses on every provider, with streaming and function tools. Budgets, guardrails and routing apply unchanged.
Audio & Rerank Endpoints
Transcription, translation, speech and rerank through Cognocient, with the same budgets, guardrails and cost tracking as chat.