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

Ekarda - SAML SSO Agent Configuration - SecurID Access Implementation Guide

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

Architecture Diagram

gmoison_6-1636030689921.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 Ekarda.

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. Ekarda Then click on Next Step.

  4. On Connection Profile page.

      1. Choose IDP-Initiated.

        gmoison_5-1636030679379.png

         


    1. In Connection URL field enter the Single Sign-on URL from the Ekarda 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 Ekarda.

      gmoison_4-1636030665021.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. For the Assertion Consumer Service (ACS) Enter the value for the ACS found in the Ekarda configuration. This is based on the Company ID for your Ekarda instance. The URL is in the form of https://my.ekarda.com/users/saml_acs/<CompanyID>. For example, https://my.ekarda.com/users/saml_acs/101538389182ef3cc430fa62687d2a47.

    9. For the Audience (Service Provider Issuer ID) Enter the value for the EntityID found in the Ekarda configuration. This is based on the Company ID for your Ekarda instance. The URL is in the form of https://my.ekarda.com/users/saml_metadata/<CompanyID>. For example, https://my.ekarda.com/users/saml_metadata/101538389182ef3cc430fa62687d2a47.

      gmoison_3-1636030653529.png

       

    10. Scroll down to User Identity section.

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

      gmoison_2-1636030636997.png

       

    12. Expand Advanced Configuration

    13. Under Attribute Extension click on +Add.

    14. For Attribute Name enter username for Property choose sAMAcountName.

    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. Select Constant for Attribute Source for Attribute Name enter companyID for Property enter the company ID for the your Ekarda instance.

    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_1-1636030624296.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 Ekarda.

  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-1636030567033.png

     

 

Configure Ekarda

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

Procedure

  1. Sign into Ekarda and select  Admin tab and click on My Account .

  2. Scroll down to SAML Settings.

  3. Check the Enable SAML checkbox.

  4. Note the Company ID or click on the Service Provider metadata for configuration details needed for SecurID configuration.

  5. For IDP Entity ID copy the Issuer Entity ID from the above in the SecurID CAS configuration. For example, 9nfo7bii265b.

  6. For IDP Login 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 IDP 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.

  8. For Attribute Mapping provide the required attributes that map to the configuration with SecurID Access CAS configuration above. For example:

    1. Email: mail.

    2. UserName: sAMAccountName.

    3. First Name: givenName.

    4. Last Name: sn.

  9. In Advanced section, check the SignAuthnRequest checkbox.

  10. Click on Update.

Configuration is complete.

Next Step: Head back to the main page.