154 views

Description


Typically, an administrator will be informed on the Identity Provider certificate expiring 2 - 4 weeks before the actual expiration date. At this time, the new certificate on the Identity Provider system is created and can be imported into the ServiceNow system.

General Procedure


The following procedure is used for Multi-Provider SSO, if you are still using SAML 2.0 Update 1, please upgrade to Multi-Provider SSO as soon as possible.

Replacing the certificate is done in three general steps:

  1. Create the new certificate.

  2. Add the certificate to the Identity Provider record.

  3. Remove the old certificate after it has expired

Repeat these steps every time a certificate is about four weeks from its expiration date.

Detailed Procedure


  1. Create the new certificate.

    1. Contact your IdP (Identity Provider) administrator to provide you the new certificate in .pem format.

      If any other format is provided, convert the file to .pem format. Third-party sites are available online to accomplish this type of conversion.

      You can recognize a pem-formatted certificate by opening it in a text editor. It should be encapsulated as follows:

      -----BEGIN CERTIFICATE-----

      ...

      -----END CERTIFICATE-----

    2. Copy the content of the text file, including the start and finish headings but without any leading or trailing line feeds.

      -----BEGIN CERTIFICATE-----

      ...

      -----END CERTIFICATE-----

    3. In the browser window for your ServiceNow instance, go to Multi-Provider SSO and go to the X.509 certificate module.

    4. Click New to create a new certificate

    5. Give the certificate a name.

      Consider including the expiration year in the name for easier searchability.

    6. Paste the information including the BEGIN CERTIFICATE and END CERTIFICATE start and finish headings into the PEM certificate field and save the record.

      You should see the expiration information as well as general information on the certificate displayed at this time. This will indicate that the certificate is valid.

  2. Add the certificate to the Identity Provider record

    1. Navigate to Multi-Provider SSO > Identity Providers.

    2. Select the active default identity provider for which you created the new certificate.

    3. Scroll until you see the X.509 certificates related list and click the Edit button.

    4. Move the newly created certificate from the left to the right, leaving the current certificate on the right (selected) side.

    5. Click Save

      You will now have both the old and the new certificate associated to your IdP record.

  3. Remove the old certificate after it has expired.

    A few weeks after these steps have been completed, the old certificate will have passed its expiration date. There was no outage or procedure required on the date of the actual expiration because the system automatically checks all certificates related to the IdP record against the signature in the SAML response.

    1. Once the expiration date for the old certificate has passed, go to Multi-Provider SSO and go to the X.509 certificate module.

    2. Search for the certificate(s) that have an expiration date in the past, and change the active flag to false.

    3. Navigate to Multi-Provider SSO > Identity Providers.

    4. Select the active default identity provider that used the expired certificate.

    5. Scroll until you see the X.509 certificates related list and click the Edit button.

    6. Move the expired certificate from the right to the left, leaving the current (new) certificate on the right (selected) side.

Applicable Versions


All versions starting with Helsinki

Additional Information


Starting in the Jakarta version, the ServiceNow instance can be configured to automatically query the IdP for SAML certificates. As noted in the product documentation topic Create a SAML 2.0 configuration using Multi-Provider SSO, the IdP properties import from the URL set in the configuration Advanced tab in the field Metadata URL from which IDP properties are imported. If set, it enables the automatic import of SAML certificate from the IdP if the previous certificate has expired.

Note: If you upgrade from SAML2 Update 1 to Multi-Provider SSO or if you manually set up your SSO connection, the IdP Metadata URL does not automatically populate.

 

Article Information

Last Updated:2018-08-03 02:08:46
Published:2018-07-09