This guide explains how to integrate Assertiv with 4me using SAML. When this setup is complete, users will be able to log into 4me using their Assertiv account.
Note: The screenshots used are for demonstrative purposes only and are accurate at time of writing. These screens can change over time. Please let us know if this document no longer reflects the application.
Setup Assertiv
Log into your Assertiv Organization (https://<your-org>.assertiv.com) as an Admin user and select the Manage Apps dashboard tile.
Creating the App
Select the plus ( ) or the create app (
) button to create a new App config.
Search for the 4me application and select the 4me icon.
Configuring the App
You will be prompted for some basic information on the following page.
Signing Certificate: The certificate is used to create a trust between Assertiv and your 4me account. For advanced users, if you have created a certificate you wish to use, select it here. Otherwise (or if you are unsure) you can select "-- Generate New Signing Certificate --".
4me Service Name: This is the name of the application as you would like it to appear in Assertiv. Make this a descriptive name that your users will understand. E.g "4me Admin".
After saving there will be space for some more information.
Domain Name: This is part of the URL for your 4me application. If your URL was https://stargate.stars.com/** then your domain name would be stargate.stars.com
Enable Just In Time provisioning: If the user doesn't yet exist in 4me, enabling setting will create the user automatically when they attempt to single sign-on.
Then save. Keep this tab open we will use this information in the following configuration
4me Setup and configuration
Login to your software as a service account https://wdc.4me-demo.com/
Click on the settings icon then Single Sign-On then the Plus Icon to add a new Single Single-On Configuration.
Fill in the following information
Name: Is the name that 4me will use to display this Single Sign method
Enable Single Sign on.
Logout URL: Could be configured with the following were <tenantName> replaces your organisation name:
https://<tenantName>.assertiv.com/sign-out (to log out of Assertiv)
https://<tenantName>.assertiv.com/sso (to redirect back to the Assertiv application launch page)
IP ranges: See 4me configuration documentation
Protocol: should be set to SAML for Single Sign on configuration
SAML Configuration
Identifier: Authentication ID
SAML SSO URL: From the Assertiv app configuration
Certificate fingerprint: From the Assertiv app configuration
Click Save.
Configure Roles
For your users to access 4me from their Assertiv apps page, you must set up a role, assign users to the role, and give that role permission to access the 4me application.
More details on roles can be found in the following articles: