Skip to main content

What is JWKS?

JSON Web Key Set (JWKS) is a standard that allows Chipi Pay to verify your users’ JWT tokens without ever seeing their credentials. Your auth provider exposes a public endpoint with its signing keys, and Chipi uses those keys to verify that tokens are authentic. Any OIDC-compliant provider (Auth0, Cognito, Okta, Keycloak, etc.) exposes a JWKS endpoint.
1

Install the Chipi SDK

2

Add Environment Variables

Add your Chipi API key to your .env file:
You can get your API keys from the Chipi Dashboard.
3

Setup the Chipi SDK Provider

Wrap your app with ChipiProvider alongside your auth provider:
4

Get the Bearer Token

Use your auth provider’s SDK to get a JWT token, then pass it to Chipi hooks:
5

Register JWKS in Chipi Dashboard

Register your auth provider’s JWKS endpoint in the Chipi Dashboard:
  1. Go to Configure > Auth Provider
  2. Select Other as your provider
  3. Paste your provider’s URL or JWKS endpoint
  4. The dashboard will try OIDC discovery automatically
  5. Click Verify & Save

Compatible providers

Need help? Check out our Telegram Community for support and to connect with other developers.