Tutorial: Authenticate Using SAML with Keycloak⁠

Steps: Retrieve certificate value and IdP endpoint from Keycloak⁠

1. Navigate to Keycloak and sign in with your Administrator account.

   

2. Access Realm Settings > Endpoints and click SAML 2.0 Identity Provider Metadatal.

   

3. Copy the IdP X.509 Public Certificate and the IdP Authentication Endpoint URL, which are used later in the CloudConnexa set up process.

Steps: Configure and enable SAML in CloudConnexa⁠

1. Sign in to the CloudConnexahttps://cloud.openvpn.com/

2. Access Settings > User Authentication and click Edit.

   

3. Click on Configure in the Authenticate Users Using > SAML section.

   • The SAML Configuration window opens. Click Next.

     

4. Add your IdP Name (optional), and then select Manual Configuration.

   

5. Paste the previously copied IdP Authentication Endpoint URL and the IdP X.509 Public Certificate.

   

6. Click Next, review the displayed information, then click Finish.

   • You now have the option to use SAML to authenticate Users.

     

Steps: Create a new Keycloak client⁠

1. Navigate to Keycloak and sign in as an Administrator.

   

2. Access Clients and click Create.

3. Set the Client ID to be the same as the Issuer Name that was displayed in the SAML configuration on the CloudConnexa portal:

   

4. Select SAML as the Client Protocol.

5. Enter the SSO URL for the Client SAML Endpoint:

   

6. Click Save.

   • The settings tab displays the default values.

7. Enable Sign Assertions.

8. Disable Client Signature Required and Force POST Binding.

9. Set the Name ID format to email.

10. Enter this value in Valid Redirect URIs, which allows redirects to the ACS URL:

    

    • All other values are left as default.

      

Steps: Create a Keycloak User account⁠

1. Navigate to Keycloak, access Users, and click Add User.

2. Fill out the form with your data.

   

3. Open the Credentials tab and assign a password for the User account, and click Set Password.

   

Steps: Configure attributes and group mapping in Keycloak⁠

1. Navigate to Keycloak, access Clients, and click on your Client ID.

2. Click on the Mappers tab, which allows you to create SAML attributes.

3. Click Create, and in Mapper Type select User Property.

4. Add a separate attribute entry for each of First Name, Last Name, and Email.

5. Set the SAML Attribute Name value to be the same as each corresponding Property name value.

6. Click Create, and in Mapper Type select Group List to create a Group Mapper.

Steps: Configure attribute mapping in CloudConnexa⁠

To finalize your attribute mapping set up, you must ensure that the Property values and SAML Attribute values match the Attribute Mapping values in your SAML Configuration on CloudConnexa.

1. Access CloudConnexa > Settings > User Authentication > SAML > View Attirbute Mapping to check that those values match :

Steps: Set up group mapping in CloudConnexa⁠

1. Access CloudConnexa Settings > User Authentication > SAML > View Group Mapping and click Add Rule.

2. Enter the name of the group(s) from your identity provider under SAML IdP User Group(s) and then select a group from the CloudConnexa User Groups that you want to map to your IdP group(s).

Steps: Sign in to User Portal with Keycloak⁠

1. Navigate to the CloudConnexa account page at: https://myaccount.openvpn.com/product-select

2. Click Not an Owner? Sign In Here.

   • CloudConnexa recognizes that your domain uses SAML and displays the Single Sign On prompt.

     

1. Click Sign In.

   • The Keycloak Log In page opens.

2. Enter the Keycloak test account email and password and click Log In.

   • The CloudConnexa Get Connected page opens with app download and installation instructions.