The certificates used for SAML-based Single Sign On (SSO) in OpenAir Production and Sandbox will expire in the upcoming weeks. New certificates have been made available for Sandbox and Production in advance of the expiration. The expiring certificates will be replaced on September 26, 2023 at 5 AM ET for Sandbox, and October 4, 2023 at 5 AM ET for Production.
Customers are strongly advised to consult with their internal technical team as to potential impacts.
IMPORTANT: Please note that the newly updated certificate for OpenAir SAML-based Single Sign on (SSO) is different from the SSL certificate. In order to retrieve the SAML certificate correctly, do NOT download the SSL certificate from the browser header, but instead please follow these instructions:
- In your OpenAir account, navigate to Administration > Account > Integration: SAML Single Sign-On, click on the currently active SAML identity provider record for which you are replacing the certificate, and in the Service Provider section click the link for "Entity ID", which will bring you to the page containing our SAML certificate. For customers still using the "Legacy profile", please be reminded that this will stop working in production with the October major release. You must switch to a self-service identity provider record endpoint before October 7, 2023.
- Two certificates will be visible. The new certificate is the SECOND certificate visible on the page. (Prior to promotion of the new certificate, and after removal of the expiring certificate, only one certificate will be visible)
- View the Page Source in your browser, select and copy the text of the certificate to a text editor. The certificate is the content on the page between these tags: <ds:X509Certificate>...</ds:X509Certificate>
- When viewing page source, the beginning of the certificate may start on the top line of the page at the end of the line in certain browsers. Be cautious to identify the tags and copy the entirety of the certificate.
- In your text editor, add certificate header and footer (the lines for ‘begin certificate’ and ‘end certificate’) and save it with .pem or .crt file extension depending on which is needed by your SAML service provider:
-----BEGIN CERTIFICATE-----
[...CERTIFICATE CONTENT...]
-----END CERTIFICATE-----
- Confirm that this is correct certificate by opening it as a certificate (rather than text) and checking that the expiration date is at least next year, rather than the near future. Follow the steps again to pull the correct certificate if necessary.
Will this certificate upgrade require any downtime?
This upgrade requires no downtime for either the sandbox or production environments.
Will this certificate upgrade impact my users?
Depending on your Identity Provider, your users may not be able to log in until you have provided your Identity Provider with the new certificate as detailed above.
If you have additional questions, please reach out to OpenAir Support.