dotCMS - SAML SSO Agent Configuration - RSA Ready SecurID Access Implementation Guide

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

Architecture Diagram

Configure RSA Cloud Authentication Service

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

Procedure

1. Sign into the RSA 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. dotCMS Then click on Next Step.

4. On Connection Profile page.

   1. Click on Import Metadata and load the SP Metadata exported in the dotCMS configuration below.

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

   3. Choose IDP-Initiated or SP-Initiated.

      

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

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

   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 .

      

   1. Scroll down to Service Provider section.

   2. Enter the Assertion Consumer Service (ACS) This should be pre-populated from the SP Metatdata Import from the dotCMS configuration below for For example: https://rsa.dotcms.io/dotsaml/login/48190c8c-42c4-46af-8d1a-0cd5db894797l.

   3. Enter the Audience (Service Provider Issuer ID) This should be pre-populated from the SP Metatdata Import from From the . dotCMS. This corresponds to the Service Provider Issuer IDL use the domain name. For example: https://rsa.dotcms.io/dotAdmin.

      

   1. Scroll down to User Identity section .

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

   1. Expand Show Advanced Configuration .

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

   3. Add Attribute Name = mail and Property = mail

   4. In Attribute Extension section click +ADD

   5. Add Attribute Name = givenName and Property = givenName

   6. In Attribute Extension section click +ADD

   7. Add Attribute Name = sn and Property = sn

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

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

2. Browse to Application > My Applications .

3. Locate newly create application for dotCMS

4. Click on Down Arrow next to Edit button

5. Select Export Metadata data. This will be used below for dotCMS configuration.

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

Configure dotCMS

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

Procedure

1. Sign into dotCMS and browse to Settings > Apps > SAML Configuration.

2. Add a new configuration.

3. Select Enable? to enable SAML.

4. For IDP Name enter a name. For Example, RSA CAS.

5. Note the Service Provider Issuer ID this is used above in the RSA Cloud Authenitcation Service (CAS) configuration.

6. Generate a private key using dotCMS documentation found on their website. And add the key in private key field.

7. Click on Generate Metadata and download the Service Provider Metadata to import into RSA Cloud Authenitcation Service (CAS) configuration.

8. For the Validation Type set it to None.

9. In the IDP Metadata File field, use the contents of the metadata XML file downloaded above and copy and paste.

10. In the Public Certificate field, copy and paste the of the public certificate created in the generated certificate bundle in the RSA Cloud Authenitcation Service (CAS) configuration above.

11.  

12. In the Custom property section, be sure the following exist, if not create them.

1. Key = authn.protocol.binding Value = Http-POST-Raw

2. Key = bindingtype Value = urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST

3. Key = role.extra Value = DOTCMS_BACK_END,CMS Administrator

13. Save Changes.

Configuration is complete.

See main page for more certification information.