When AD FS rolls over the token-signing certificate, the new certificate must also be trusted by each federation partner. If the partner or SaaS app still has the old certificate, sign-ins fail because the token signed by AD FS is no longer trusted.
Use this approach:
- Verify whether partners can consume federation metadata.
- If they can consume federation metadata, ensure they refresh and pick up the new token-signing certificate.
- If they cannot consume federation metadata, send them the public key of the new certificate as a
.cerfile, or.p7bif the full chain is needed. They must update trust on their side.
- Check whether AD FS is using automatic rollover.
- Run:
Get-ADFSProperties | FL AutoCertificateRollover - If
AutoCertificateRollover = TRUE, AD FS automatically generates new certificates before expiration and later promotes them to primary. - If
AutoCertificateRollover = FALSE, certificate replacement and promotion must be done manually.
- Run:
- If rollover is manual, promote the new secondary certificate only after partners have had time to consume it.
- In the AD FS Management MMC, select the secondary token-signing certificate and choose Set As Primary.
- This reduces disruption because federation metadata can publish the secondary certificate before it becomes active.
- For Microsoft Entra ID or Office 365 federated domains, confirm the cloud-side signing certificate matches AD FS.
- Compare the token-signing certificate thumbprint between AD FS and the federated domain configuration.
- Use:
Get-MgDomainFederationConfiguration -DomainId <domain_id> - If the thumbprints do not match, update the federated domain configuration:
Connect-MgGraph -scopes Domain.ReadWrite.All, Directory.ReadWrite.All $tdo= Get-MgDomainFederationConfiguration -DomainID <domain_id> Update-MgDomainFederationConfiguration -DomainId <domain_id> -InternalDomainFederationId $tdo.Id -SigningCertificate <certificate_token> Disconnect-MgGraph
- If sign-in failures continue after rollover, also check these common causes:
- Stale or cached credentials in Windows Credential Manager.
- The Secure Hash Algorithm on the Office 365 relying party trust is set to
SHA1.
- If the certificate is already expired and an immediate rotation is required, use emergency rotation carefully.
- This revokes the old certificate immediately.
- It can cause a service outage until all federation partners update to the new certificate.
Operationally, the safest rollover pattern is:
- Let AD FS publish the new secondary certificate.
- Allow metadata-consuming partners time to refresh.
- Manually notify non-metadata-consuming partners and provide the new public certificate.
- Promote the new certificate to primary only after partners are ready.
- For Microsoft Entra ID, verify and update the federated domain signing certificate if needed.
References: