Guide Purpose:

• This guide IS designed to:
  • Show how to setup SAML SSO for Tenant
  • Show how to obtain required information for the JSON Configuration from Note++
• This guide IS NOT designed to:
  • Show how to understand or write an xml File

Terminologies

• SSO – Single Sign-On
• SAML – Security Assertion Markup Language
• Manifest – Xml File
• Note++ - Xml File Editor

How to Get to Tenant JSON Configuration Page

Please note that for SSO to be configured for a customer, we must receive an email from the customer with a manifest that contains the information needed for the SSO configuration.

1. Click on the Administration Tab
2. Select the Configuration button
3. Select Companies button
4. Search or scroll for the Tenant
5. Select the Tenant
6. Section Highlighted in BLUE is the JSON Configuration where SSO will be configured.
   

How to Configure SSO JSON

1. Insert the SSO JSON in Configuration. Please note that there are 3 major information needed for this JSON to work accurately as highlighted in the BLUE box
   1. Issuer: This is the URL to our portal
   2. SamlUrl: This information will be obtained from the manifest
   3. X509Cert: this information will be obtained from the manifest
      

Issuer Information

The information provided here is for the portal where the SSO will be used. In the section highlighted in GREEN, we will see the URL link to our 3^rd Eye portal as the issuer.

1. Insert Issuer URL
   

SamlUrl Information

This information is obtained from the manifest. There are 2 types of SamlUrl, a redirect and a post SSO URL link. Please make sure if this is not stated in the request, we reach out to the customer to obtain the type of SamlUrl needed.

1. Open the manifest using Notepad++
   1. If you don’t have Notepad ++, Please download it as it is free to download.
2. Open the Find page by clicking Ctrl F
3. Type in “Signlesignon” in the Find what field
4. Click the Find next to search
   
5. Copy the URL link for the specified type needed as highlighted in GREEN
   
6. Insert the URL in the JSON configuration section as highlighted in GREEN 
   

X509Cert Information

This information is obtained from the Manifest.

1. Open the manifest using Notepad++
   1. If you don’t have Notepad ++, Please download it as it is free to download.
2. Open the Find page by clicking Ctrl F
3. Type in “x509cert” in the Find what field
4. Click the Find next to search
   
5. Copy the x509cert text starting after the opening-end bracket to the end of the text before the opening-close bracket as highlighted in the BLUE box
   
6. Insert the x509cert text in the JSON configuration section as highlighted in BLUE
   

How to Complete Saml SSO Configuration

1. Verify the SSO Configuration was inputted in the right JSON format as highlighted in the ORANGE box
2. Click update
   
3. Select close from the Success Pop up notification
4. Click Save