Rotate SAML certificates before they expire to avoid interrupting single sign-on. The process depends on whether the certificate belongs to Populi as an Identity Provider (IdP), Populi as a Service Provider (SP), or an external service provider registered in Populi.
Rotate Populi IdP certificates
Populi uses its default IdP certificate to sign SAML responses sent to your external service providers.
- Go to Account > Integrations and open your SSO (Identity Provider) integration.
- Under Identity Provider Certificates, click Generate Certificate. Generating a certificate does not change the current default.
- Download the new public certificate.
- Update every external service provider to trust the new certificate. If a service provider allows multiple IdP certificates, configure it to accept both the new certificate and the old certificate during the transition.
- When the service providers are ready, make the new certificate the default in Populi. Populi will immediately begin using it to sign SAML responses. If possible, do this after hours to reduce disruption.
If a service provider accepts only one IdP certificate, coordinate the change carefully: make the new certificate the default in Populi and then immediately replace the old certificate on that service provider. Its SSO integration will be interrupted between those changes.
If you do not rotate the certificate manually, the old certificate will be used until it expires. A new certificate may then be generated and used automatically, but service providers that still trust only the expired certificate can stop working.
Rotate Populi SP certificates
When Populi is the Service Provider, its default SP certificate is used to sign outgoing SAML requests when request signing is enabled. Your Identity Provider can also use the public certificate to encrypt assertions that Populi decrypts with the corresponding private key.
- Go to Account > Integrations and open your SSO (Service Provider) integration.
- Under Service Provider Certificates, click Generate Certificate. This does not change the current default.
- Download the new public certificate and add it to your Identity Provider's configuration for verifying Populi's signed requests, encrypting assertions, or both, according to your setup.
- If your Identity Provider supports certificate rollover, configure it to accept both certificates during the transition.
- When the Identity Provider is ready, make the new certificate the default in Populi. Perform this change after hours when possible; request signing or encrypted assertions can fail until both sides are using compatible certificates.
If your Identity Provider accepts only one Populi SP certificate, make the new certificate the default in Populi and immediately update the Identity Provider. Coordinate the change carefully to minimize the login interruption.
Update certificates for an external service provider
These certificates belong to an external application registered under Populi as IdP. They are separate from Populi's own IdP certificates.
- Go to Account > Integrations, open your SSO (Identity Provider) integration, and edit the service provider.
- If its Metadata URL is saved, click Import to retrieve its current Entity ID, certificates, and other published settings. Review the changes and click Save Service Provider. Importing is an on-demand refresh, not continuous synchronization.
- To rotate signing certificates manually, add the new X509 Signing Certificate without immediately removing the old one. Populi can verify requests with any of the saved signing certificates. Remove the old certificate after the service provider has stopped using it.
- If you use encrypted assertions, update the X509 Encryption Certificate when the service provider rotates the corresponding private key. Coordinate this change with the service provider to avoid decryption failures.
Need help?
As always, if you have any questions or would like help with generating or rotating certificates, please contact Populi Support.
0 Comments