The certificates used for SAML-based Single Sign On (SSO) in OpenAir Production and Sandbox will expire in the upcoming weeks. New certificates will be made available on August 14, 2024 for Sandbox and Production in advance of the expiration. The expiring certificates will be replaced on August 20, 2024 at 5 AM ET for Sandbox, and August 27, 2024 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, and click on the currently active SAML identity provider record for which you are replacing the certificate. In the Service Provider section, click the link for “Entity ID”, which will bring you to the page containing our SAML certificate.
- Two certificates will be visible on August 14, 2024. The new certificate is the SECOND certificate visible on the page (i.e. at the bottom of 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 the 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 should require 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.