Changing signing key for ID token


This article explains an example on changing a signing key for ID token. In order to have Authlete to sign an ID token with the new key, you may have to configure both a service of Authlete and a client registered to the service.

Service settings

Register a JWK set document to "JWK Set Content" section in Service Settings.

The following example illustrates usage of service to generate an ES256 keypair, and parameters specified for it. 

  • Key Type: Elliptic Curve
  • Curve: P-256
  • Key Use: Signing
  • Algorithm: ES256
  • Key ID: 1

mkjwk.png 242.71 KB

Copy the generated document in the "Keypair set" section and paste it to the service's "JWK Set Content" section in "JWK Set" tab.  Also add the value of "kid" of this keypair set ("1" in this example) to "ID Token Signature Key ID" section in the same settings page.

so-jwkset.png 134.45 KB

Client settings

In order for the Authlete service to issue an ID token signed with the new key (signature algorithm: ES256), choose "ES256" on "ID Token Signature Algorithm" section in Client Settings.

cd-idTokenSigAlg.png 88.29 KB

With the settings above, Authlete will be using the ES256 key (identified by "kid=1") to sign ID tokens for the client.
How did we do with this article?