Matomo - SAML SSO Agent Configuration - SecurID Access Implementation Guide
2 years ago
Originally Published: 2021-08-24

Matomo - SAML SSO Agent Configuration - SecurID Access Implementation Guide

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

Architecture Diagram

Admin_Dharani_0-1629834095881.png

 

Configure SecurID Access Cloud Authentication Service

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

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. matomo 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-1629834122863.png

       

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

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

    5. For Issuer Entity ID click on override and set the value to the same as the Identity Provider URL above. For example, https://portal.sso.per.rsa.net/IdPServlet?idp_id=1cnfrt3e9zckw.

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

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

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

    9. Select Include Certificate on Outgoing Assertion .

      Admin_Dharani_2-1629834773898.png

       

    10. Scroll down to Service Provider section.

    11. Enter the Assertion Consumer Service (ACS) From the matomo configuration below for ACS URL For example: https://rsatest.matomo.cloud/index.php?module=LoginSaml&action=assertionConsumerService.

    12. Enter the Audience (Service Provider Issuer ID) From the matomo configuration below for Entity Id. For example: https://rsatest.matomo.cloud/index.php?module=LoginSaml&action=metadata.

      Admin_Dharani_3-1629834811812.png

       

    13. Scroll down to User Identity section .

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

      Admin_Dharani_4-1629834828376.png

       

    15. Expand Show Advanced Configuration .

    16. In Attribute Extension section click +ADD . Note Property values may vary configurations.

    17. Add Attribute Name = email and Property = mail

    18. In Attribute Extension section click +ADD

    19. Add Attribute Name = firstName and Property = givenName . Note this is used to identify the username in matomo.

    20. 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-1629834847680.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 matomo

  9. Click on Down Arrow next to Edit button

  10. Select Export Metadata data. This will be used below for matomo 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-1629834871122.png

     

Configure matomo

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

Procedure

  1. Sign into matomo and browse to Settings > System > SAML.

  2. Select Access to SP metadata.

  3. Note the Entity Id and ACS URL these are used above in the Cloud Authenitcation Service (CAS) configuration above.

  4. Go to the Identity Provider Settings Section

    1. For the Single Sign on URL enter the Identity Provider URL from the SecurID Access configuration above. For example, https://portal.sso.per.rsa.net/IdPServlet?idp_id=1cnfrt3e9zckw.

  5. For the Entity ID enter the Identity Provider URL from the SecurID Access configuration above. For example, https://portal.sso.per.rsa.net/IdPServlet?idp_id=1cnfrt3e9zckw.
  6. For the X.509 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.
  7. In the Options Settings, in the field to identify the user, choose email and click on Save.
  8. In the Attribute Mapping Settings, enter the login(user name) and Email you created in the Attribute Extensions for the Cloud Authenitcation Service (CAS) configuration above. For example, firstName and email.

  1. Save changes.

Configuration is complete.

Next Step: See main page for more certification information.

Related Articles

Trending Articles

Don't see what you're looking for?