Skip to main content

Single Sign On (SSO) Integration Overview

Steven Colón
  • Updated

Hi Marley offers a Single Sign On integration through our Okta instance. If your organization manages permissions and access through SSO, your organization could enable users to sign into Hi Marley using the same log-in process.

Setting up a Single Sign On integration is a collaborative process between the Hi Marley I&E team and your IT team that manages user access. We will guide you on setting up SSO on our UAT (non-prod) environment for testing and rolling out to Production.

 

If your organization would like to get started with setting up SSO, please reach out to your CSM. Your CSM will route with the Hi Marley integrations team to review and initiate this integration project.

This article will cover more details regarding the SSO Integration with Hi Marley

 

Table of Contents

 

Okta SAML 2.0 Integration

We mainly support an integration with SAML 2.0 since it is a common protocol. Please let us know if you require a different protocol for integration.

 

Carrier Configuration Details

When an SSO integration is initiated, Hi Marley will share metadata XML details on the identity provider that we are setting up for your organization. 

Below is a list of fields that need to be configured in your system to ensure Hi Marley recieves the required information

requiredFields

  • "firstName"
  • "lastName"
  • "email"
  • "subjectNameId" set as a email.

 optionalFields

  • "phoneNumber"

relayState

 

Required Browser Settings

To successfully use the Hi Marley SSO integration, we recommend using Google Chrome and enabling third-party cookies for Hi Marley. We require these cookies as we redirect to your sign-on system and back to Hi Marley to allow access. 

 

Enabling Third-Party Cookies in Chrome

  1. Hit the three vertical dots in the upper right of the Chrome browser
  2. Select Settings -> Privacy and Security -> Cookies and other site data
  3. Scroll down to "Sites that can always use cookies" and select "Add"
     
  4. Type in the URL '[*.]marley.ai', ensure that "including third party cookies" is selected.
    • Note: If you are testing/accessing UAT, the URL is '[*.]uat.marley.ai'.

image (19).png

 

Enabling Third-Party Cookies in Edge

  1. Hit the three vertical dots in the upper right of the Edge browser
  2. Settings > Cookies and site permissions > Manage and delete cookies and site data
  3. Turn off Block third-party cookies


     

Additional recommended steps are adding the following URL to the allowed cookies list on the same settings page under the "Allow" list: 

  1. [*.]marley.ai

     


     

 

Related articles