Gurock TestRail - SAML SSO Agent Configuration - SecurID Access Implementation Guide
2 years ago
Originally Published: 2021-08-31

Gurock TestRail - SAML SSO Agent Configuration - SecurID Access Implementation Guide

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

Architecture Diagram

Admin_Dharani_0-1630438443761.png

 

Configure SecurID Access Cloud Authentication Service

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

Procedure

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

  2. Click on Create From Template found in he upper right of the page then select SAML Direct.

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

  4. On Connection Profile page.

    1. In Connection URL field, verify the default setting.

    2. Choose IDP-Initiated or SP-Initiated.

      Admin_Dharani_1-1630438469048.png

       

    3. Scroll down to SAML Identity Provider (Issuer) section.

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

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

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

    7. Select Choose File and upload the cert from the generated certificate bundle.

    8. Select Include Certificate on Outgoing Assertion .

      Admin_Dharani_2-1630438500063.png

       

    9. Scroll down to Service Provider section.

    10. Enter the Assertion Consumer Service (ACS) From the TestRail configuration below for Single Sign On URL For example: https://rsaready.testrail.io/index.php?/auth/redirect_acs.

    11. Enter the Audience (Service Provider Issuer ID) From the TestRail configuration below for Entity ID. For example: https://rsaready.testrail.io/index.php?/auth/metadata.

      Admin_Dharani_3-1630438529852.png

       

    12. Scroll down to User Identity section .

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

      Admin_Dharani_4-1630438552277.png

       

    14. Expand Show Advanced Configuration .

    15. In Attribute Extension section click +ADD

    16. Add Attribute Name = Email and Property = mail

    17. click +ADD again

    18. Add Attribute Name = FirstName and Property = givenName

    19. click +ADD again

    20. Add Attribute Name = LastName and Property = distinguisedName

    21. 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.

    Admin_Dharani_5-1630438579744.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. Browse to Application > My Applications .

  8. Locate newly create application for TestRail

  9. Click on Down Arrow next to Edit button

  10. Select Export Metadata data. This will be used below for TestRail configuration.

  11. 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.

    Admin_Dharani_6-1630438603908.png

     

Configure Gurock TestRail

Perform these steps to integrate Gurock TestRail with SecurID Access as a SAML SSO Agent.

Procedure

  1. Sign into TestRail and browse to Administration > Site Settings.

  2. For IDP SSO URL enter the Identity Provider URL from CAS noted above.

  3. For IDP Issuer URL enter the Identity Provider URL from CAS noted above.

  4. For IDP Certificate use the contents of the metadata XML file downloaded above and copy the X.509 certification information between the tags <ds:X509Certificate></ds:X509Certificate> and paste it in the IDP Certificate field.

  5. Note the Entity ID value it will be used in the CAS configuration above.

  6. Note the Single Sign On URL value it will be used in the CAS configuration above.

  7. Save changes.

Configuration is complete.

Next Step: See main page for more certification information.