Configuring your authentication provider

To integrate your authentication provider with Privy:

Go to the Privy Dashboard
Select your app from the App Dropdown in the left sidebar
Request access to Custom Auth Support in the Integrations > Plugins tab of the Privy dashboard
Navigate to the JWT Dashboard via User management > Authentication > JWT-based auth

You’ll need to provide the following information:

JWT Verification Details

required

Privy requires a verification key to ensure the JWTs received are valid. Both the token’s signature and its expiration time (claim) are verified to ensure secure access. This verification process helps protect user data and prevents unauthorized access to Privy services.You can provide the verification key in one of two ways:

JWKS Endpoint

If your provider uses JWKS to sign JWTs, provide a JWKS endpoint URL where Privy can retrieve your auth provider’s JWT public key.

{
    "keys": [
        {
          "kty": "XXX",
          "n": "XXX",
          "e": "XXX",
          "alg": "XXX", // "RS256" or "ES256"
          "kid": "XXX"
          // ...
        }
    ]
}

Public Verification Key

JWT ID Claim

default:"sub"

Enter the claim from your user’s JWT that contains the user’s unique ID. In most access tokens and identity tokens, this is the claim.

Using Privy authentication

Using your own authentication

Configuring your authentication provider