Envoy - SAML Relying Party Configuration - RSA Ready Implementation Guide
Last Modified: 2024-05-31
This article describes how to integrate RSA with Envoy using SAML Relying Party.

Configure RSA Cloud Authentication Service

Perform these steps to configure RSA Cloud Authentication Service as Relying Party to Envoy.
Procedure
  1. Sign in to RSA Cloud Administration Console. 
  2. Click Authentication Clients > Relying Parties.                                                                                                                                         image.png
  3. On the Relying Party Catalog page, click Add a Relying Party and click Add for Service Provider SAML.                                         image.png
  4. On the Basic Information page, enter the name for the application in the Name field and click Next Step.                                            image.png
  5. On the Authentication page, choose SecurID manages all authentication.
  6. Select a Primary Authentication Method and Access Policy as required and click Next Step.                                                               image.png
  7. Provide the Service Provider details in the following format: 
    1. ACS URL: <Envoy ACS URL> 
    2. Service Provider Entity ID: <Envoy Entity ID>
      Refer to the Configure Envoy section to obtain the ACS URL and Entity ID.                                                                             image.png
  8. In the SAML Response Protection section, choose IdP signs assertion within response.
  9. Download the certificate by clicking Download Certificate.                                                                                                                          image.png
  10. Click Show Advanced Configuration.
  11. Under the User Identity section, configure Identifier Type and Property. For example, Identifier Type: Auto Detect and Property: Auto Detect.                                                                                                                                                                 image.png
  12. Click Save and Finish.
  13. On the My Relying Parties page, click the Edit drop-down icon and select the Metadata option to download the metadata.              image.png
  14. Click Publish Changes. Your application is now enabled for SSO.                                                                                                          image.png  image.png

Configure Envoy

Perform these steps to configure Envoy.
Procedure
  1. Log on to Envoy with administrator credentials - https://dashboard.envoy.com/
  2. Navigate to Apps > Directory and SSO and click Directory settings.                                                                                                          image.png
  3. Click Configure.                                                                                                                                                                                         image.png
  4. Provide the following Identity Provider details:
    1. Fingerprint – Refer to the Notes section for instructions on how to obtain Fingerprint.
    2. Identity Provider HTTP SAML URL – The SingleSignOnService value that can be obtained from the metadata file downloaded from RSA.
    3. Enable the Required option.
    4. Copy the ACS URL and SAML Identifier and click Save.                                                                                                            image.png

Notes

To obtain the certificate fingerprint, perform the following steps:
  1. Install the latest version of OpenSSL for Windows.
  2. Open the Windows Command Line.
  3. Navigate to the OpenSSL installation directory (the default directory is C:\OpenSSL-Win32\bin).
  4. Run the following commands to view the certificate fingerprint/thumbprint. openssl x509 -noout -fingerprint -sha1 -inform pem -in <Certificate.pem  >                                                                                                                                                                                     Certificate.pem file is the certificate that was downloaded from RSA (previous section).                                                                               image.png
The configuration is complete.
Return to Envoy - RSA Ready Implementation Guide.