DeskPro-integration-configuration-sso-agent-saml
2 years ago
Originally Published: 2021-11-04

 

DeskPro - SAML SSO Agent Configuration - SecurID Access Implementation Guide

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

Architecture Diagram

gmoison_1-1636029928119.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 DeskPro.

Procedure

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

  2. Search for DeskPro and click Add.

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

  4. On Connection Profile page.

      1. Choose IDP-Initiated or SP-Initiated .

        gmoison_2-1636029945537.png

         


    1. In Connection URL field enter the Single Sign-on URL from the DeskPro configuration below.

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

      gmoison_3-1636029981444.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 cert from the generated certificate bundle.

    6. Select Include Certificate on Outgoing Assertion.

    7. Scroll down to Service Provider section.

    8. Enter the Assertion Consumer Service (ACS) Enter the value for the Consumer Service URL (ACS) from the DeskPro configuration. For example, https://demos-2021.deskpro.com/login/authenticate-callback/3.

    9. Enter the Audience (Service Provider Issuer ID) Enter the value for the Metadata URL (Entity ID) from the DeskPro configuration. For example, https://demos-2021.deskpro.com/saml/metadata/3.xml.

      gmoison_4-1636030000076.png

       

    10. Scroll down to User Identity section.

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

      gmoison_5-1636030012867.png

       

    12. Expand Advanced Configuration

    13. Under Attribute Extension click on +Add.

    14. For Attribute Name enter email for Property choose mail.

    15. Under Attribute Extension click on +Add.

    16. For Attribute Name enter first_name for Property choose givenName.

    17. Under Attribute Extension click on +Add.

    18. For Attribute Name enter last_name for Property choose sn.

    19. Under Attribute Extension click on +Add.

    20. For Attribute Name enter NameID for Property choose mail.

    21. Note Property values may vary based on your specific configuration.

    22. 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_6-1636030034321.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 DeskPro.

  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_0-1636029781725.png

     

 

Configure DeskPro

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

Procedure

  1. Sign into DeskPro and select  Settings.

  2. Under the CRM tab click on Auth and SSO.

  3. Click the Add and select SAML Authentication.

  4. In the SAML Details section note the following.

    1. Consumer Service URL (ACS). For example, https://demos-2021.deskpro.com/login/authenticate-callback/3.

    2. Metadata URL (Entity ID. For example, https://demos-2021.deskpro.com/saml/metadata/3.xml.

  5. Click Yes for the enabled checkbox.

  6. For SSO: Single Sign on URL copy the Identity Provider URL from the above in the SecurID CAS configuration. For example, https://portal.sso.pe.rsa.net/IdPServlet?idp_id=9nfo7bii265b.

  7. For MetadataL: Issuer XML metadata URL copy the Identity Provider URL from the above in the SecurID CAS configuration. For example, https://portal.sso.pe.rsa.net/IdPServlet?idp_id=9nfo7bii265b.

  8. For X509 Certificate Copy and paste the contents of the certificate saved above in the SecurID CAS configuration. This is the cert.pem from the downloaded certificate bundle from the SecurID Access CAS configuration above.

  9. Select emailAddress from the dropdown list for Name ID format.

  10. Set the Name of the Login Button Text to be displayed.

  11. Select disabled for SSO Method.

  12. Click on Install App.

Configuration is complete.

Next Step: Head back to the main page.

 

Don't see what you're looking for?