If Auto-certificate roll-over is enabled, AD FS manages the Token Decrypting Certificate. If you manage your certificate ...

If Auto-certificate roll-over is enabled, AD FS manages the Token Decrypting Certificate.

If you manage your certificate manually, please follow the below instructions.

  1. Obtain a new Token Decrypting Certificate.
    • Ensure that the Enhanced Key Usage (EKU) includes "Key Encipherment".
    • Subject or Subject Alternative Name (SAN) do not have any restrictions.
    • Please remember that your Federation Servers and Claims Provider partners need to be able to chain to a trusted root certification authority when validating your Token-Decrypting certificate.
  2. Decide how your Claims Provider partners will trust the new Token-Decrypting certificate
    1. Ask partners to pull the Federation Metadata after updating the certificate.
    2. Share the public key of the new certificate. (.cer file) with the partners. On the Claims Provider partner's AD FS server, launch AD FS Management from the Administrative Tools menu. Under Trust Relationships/Relying Party Trusts, select the trust that was created for you. Under Properties/Encryption click "Browse" to select the new Token-Decrypting certificate and click OK.
  3. Install the certificate in the local certificate store on each of your Federation Server.
    • Ensure that the certificate installation file has the Private Key of the certificate on each server.
  4. Ensure that the federation service account has access to the new certificate's private key.
  5. Add the new certificate to AD FS.
    1. Launch AD FS Management from the Administrative Tools menu
    2. Expand Service and select Certificates
    3. In the Actions pane, click Add Token-Decrypting Certificate
    4. You will be presented with a list of certificates that are valid for Token-Decrypting. If you find that your new certificate is not being presented in the list, you need to go back and make sure that the certificate is in the local computer personal store with a private key associated and the certificate has the Key Encipherment as Extended Key Usage.
    5. Select your new Token-Decrypting certificate and click OK.
  6. Set the new Token-Decrypting Certificate as Primary.
    • With the Certificates node in AD FS Management selected, you should now see two certificates listed under Token-Decrypting: existing and the new certificate.
    • Select your new Token-Decrypting certificate, right-click, and select Set as primary.
    • Leave the old certificate as secondary for roll-over purposes. You should plan to remove the old certificate once you are confident it is no longer needed for roll-over, or when the certificate has expired.