This guide explains how to integrate Assertiv with Humanity using SAML. When this setup is complete, users will be able to log into Humanity 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 Humanity application and select the Humanity 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 Humanity 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 --".
Humanity 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 "Humanity Admin".
After saving there will be space for some more information.
Subdomain Value: When you create a humanity account, you are given a specialized URL for your organization (e.g. https://acme.humanity.com). Enter the first section of the URL hostname. E.g. for https://acme.humanity.com, enter acme.
Then save. Keep this tab open we will use this information in the following configuration
Humanity Setup
Login to you software as a service account https://acme.humanity.com
Navigate to Settings then to Single Sign-on.
Humanity Configuration
SAML Configuration
SAML Enabled: Enables SAML on Humanity.
Allow Password Login: If selected allows user to login with a password as well as using SAML. Note: This may cause confusion for your users if you want to manage all your user accounts access through the Assertiv Platform
SAML Issuer URL: This is available from the Assertiv app configuration
X.509 Certificate: This is available from the Assertiv app configuration
Remote Logout URL: This could be configured in numerous ways. Here are some of the examples were <tenantName> replaces your organisation name:
https://<tenantName>.assertiv.com/sign-out
If you want users to be redirected to the Application launch page in Assertiv on logout from Humanity, use the following URL.
https://<tenantName>.assertiv.com/sso
SAML Login URL: Use the subdomain value in the Assertiv config for subdomain. https://acme.humanity.com/includes/saml/
Access Consumer Service (ACS) URL: Use the subdomain value in the Assertiv config for subdomain.
https://acme.humanity.com/includes/saml/consume.php
SAML Metadata URL: Use the subdomain value in the Assertiv config for subdomain. https://acme.humanity.com/includes/saml/metadata.php
Click Save Settings.
Configure Roles
For your users to access Humanity from their Assertiv apps page, you must set up a role, assign users to the role, and give that role permission to access the Humanity application.
More details on roles can be found in the following articles: