Intercom-integration-configuration-sso-agent-saml
2 years ago
Originally Published: 2021-11-30

 

Intercom - SAML SSO Agent Configuration - SecurID Access Implementation Guide

This section describes how to integrate SecurID Access with Intercom using a SAML SSO Agent.

Architecture Diagram

gmoison_8-1638309519338.png

 

Configure SecurID Access Cloud Authentication Service

Perform these steps to configure SecurID Access Cloud Authentication Service(CAS) as an SSO Agent SAML IdP to Intercom.

Procedure

  1. Sign into the SecurID Access Cloud Administration Console and browse to Applications > Application Catalog.

  2. Click on Create From Template then click Select for SAML Direct.

  3. On Basic Information page enter a Name for the application, ie. Intercom Then click on Next Step.

  4. On Connection Profile page.

      1. Choose IDP-Initiated or SP-Initiated. Note: The following IDP-initiated configuration works for SP-initiated as well.

        gmoison_7-1638309506446.png

         


    1. In Connection URL field leave the defaults.

    2. Note the Identity Provider URL and Issuer Entity ID. These values are automatically generated. They may be needed later for the configuration of Intercom.

      gmoison_6-1638309496237.png

       

    3. Click on Generate Cert Bundle, set a a common name for your company certificate. Then click Generate and Download .

    4. Select Choose File and upload the private key from the generated certificate bundle.

    5. Select Choose File and upload the public cert from the generated certificate bundle. This is the cert.perm file.

    6. Unselect Include Certificate on Outgoing Assertion.

    7. Scroll down to Service Provider section.

    8. For the Assertion Consumer Service (ACS) enter the documented value for SAML name for this workspace from Intercom. This URL is based on the SAML name, https://app.intercom.com/saml/<SAML_NAME>/consume. For example, https://app.intercom.com/saml/z6d2test/consume.

    9. For the Audience (Service Provider Issuer ID) enter the documented value for SAML name for this workspace from Intercom. This URL is based on the SAML name, https://app.intercom.com/saml/<SAML_NAME>. For example, https://app.intercom.com/saml/z6d2test.

      gmoison_5-1638309466084.png

       

    10. Scroll down to User Identity section.

    11. Ensure Identifier Type = Email Address, set your Identity Source and Property = mail.

      gmoison_4-1638309442601.png

       

    12. Expand Advanced Configuration

    13. For Attribute Extension click +Add.

    14. For Attribute Name enter lastName and select corresponding Property , i.e. sn.

    15. Click +Add.

    16. For Attribute Name enter firsttName and select corresponding Property , i.e. givenName.

    17. For Sign Outgoing Assertion select Assertion within response.

    18. For Relay State URL Encoding uncheck Send encoded URL in outgoing assertion.

    19. Click Next Step.

  5. On User Access page select the Access Policy you require. Allow All Authenticated Users is the least restrictive. Click Next Step.

    gmoison_3-1638309404452.png

     

  6. On Portal Display Page.

    1. Select Display in Portal.

    2. Upload an Application Icon if you wish.

    3. Set an Application Tooltip if you wish.

    4. Click on Save and Finish.

  7. For this new Connector, click on the down arrow next to the Edit button and Export Metadata to save off the IDP metadata information for configuration of .

  8. Click on Publish Changes. Your application is now enabled for SSO. If you make any additional changes to the application configuration you will need to republish.

    gmoison_2-1638308867026.png

     

 

Configure Intercom

Perform these steps to integrate Intercom as an SSO Agent SAML SP to SecurID Access Cloud Authentication Service.

Procedure

  1. Login into Intercom as an administrator with email in the same domain that SSO is being configured with.

  2. Click on User account icon and choose Settings.

  3. From Security choose Security Settings.

  4. Scroll down to the Authentication methods section and select Require SAML SSO.

  5. First configure allowed domains if not done so.

    1. Type in your domain and click on Add domain.

    2. If first time, verify the domain, a pop up will give the required information to validate the domain. It may take some time for the domain to be validated.

    3. Once a domain has been invalided it will appear in the list off allowed domains above the text field.

  6. Note the SAML name for this workspace. This string represents the instance name needed to configure the Service Provider information in the SecurID CAS configuration.

  7. For Identity provider Single Sign-On URL  provide the Identity Provider Entity ID from the above in the SecurID CAS configuration. For example, https://testportal.pe.rsatest.net/IdPServlet?idp_id=1v9d1q5testme. Note the https:// part of the string is not needed

  8. For Single Sign On x509 Certificate copy and paste the certificate downloaded above in the SecurID CAS configuration.

    gmoison_1-1638308842107.png

     

  9. Click on Save .

  10. A pop up will appear test the configuration. Click on the Authenticate with identity Provider and authenticate the user same logged into Intercom via SecurID Cloud Authentication service.

    gmoison_0-1638308801495.png

     

Configuration is complete.

Next Step: Head back to the main page.

 

 

Don't see what you're looking for?