Skip to main content
Single-Sign-On (SSO)

How to set up SSO with HiPeople

Updated over 2 weeks ago

HiPeople supports Single Sign-On (SSO) to provide a seamless and secure login experience. This guide will walk you through the process of accessing HiPeople using SSO with systems like Okta/Google/Microsoft 365.

SSO is only available for customers on Enterprise plans - so reach out to your CSM if you're on a lower plan and would like to upgrade.


Single-Sign-On (SSO) with Okta


HiPeople allows users to authenticate using Single Sign-On (SSO) to streamline the login process and enhance security. This guide covers the steps to configure and use SSO with Okta, a popular identity and access management provider.
Prerequisites
Before you begin, ensure you have the following:

  • An active HiPeople account.

  • Administrative access to your organization’s Okta account.


Initial steps in Okta:

  • Log in to Okta Admin Console:

    1. Go to your Okta dashboard and log in with your administrator credentials.

  • Add a New Application:

    1. Navigate to the Applications section.

    2. Click on Create App Integration.

    3. Choose SAML 2.0 as the sign-on method.

    4. Enter the name "HiPeople" as the application and add an optional logo

    5. Enter the SAML details as shown:

    6. Click Next

    7. Click Finish

    8. Copy the Metadata URL and give it to your HiPeople CSM

  • Update application details

    1. After the Metadata URL has been given to your HiPeople CSM, they will have a new Single sign-on URL for you

    2. Back at the admin interface, edit the application settings again

    3. Visit the General tab, scroll to SAML Settings and click Edit

    4. Change the Single sign-on URL to the new URL

    5. Click Next

    6. Click Finish

Assigning Users in Okta to HiPeople:

  1. Assign Users:

  • In the Okta Admin Console, go to the HiPeople application you just created.

  • Click on Assignments.

  • Select Assign and choose the users or groups who need access to HiPeople.

Logging into HiPeople using SSO


Once SSO is configured in Okta, users can log into HiPeople using their Okta credentials.

  1. Navigate to HiPeople Login:

    1. Go to the HiPeople login page: app.hipeople.io

  2. Enter your work email:

    1. Make sure to enter your email address that is associated with your Okta account and click "Continue"

  3. Authenticate via Okta:

    1. You will be redirected to the Okta login page.

    2. Enter your Okta credentials and complete any additional authentication steps (such as MFA).

  4. Access HiPeople:

    1. Upon successful authentication, you will be redirected back to HiPeople and logged in.

Troubleshooting


If you encounter issues with SSO, consider the following steps:

  • Verify SAML Configuration:

    • Ensure the SAML settings in Okta match the required HiPeople configuration.

  • Check User Assignments:

    • Confirm that users are correctly assigned to the HiPeople application in Okta.

  • Review Okta Logs:

    • Check the Okta system logs for any error messages related to SSO.

  • Clear Browser Cache:

    • Sometimes, clearing the browser cache can resolve unexpected login issues.

Support
If you need further assistance, please contact your HiPeople CSM or use the in-app chat to get in touch.


Single-Sign-On (SSO) with Microsoft Entra ID

HiPeople supports Single Sign-On (SSO) to provide a seamless and secure login experience using Microsoft Entra ID (formerly Azure AD).

Availability

SSO is exclusively available for customers on Enterprise plans. Please contact your Customer Success Manager (CSM) if you need to upgrade your plan to enable this feature.

Prerequisites

Before configuring SSO with Microsoft Entra ID, ensure:

  • You have admin access to your Microsoft Entra ID tenant

  • Your organization has an Enterprise subscription with HiPeople

  • You are an admin of your HiPeople organization

Initial Steps in Microsoft Entra ID

  1. Sign in to the Microsoft Entra admin center

  2. Navigate to “Manage” -> “Enterprise Applications”

  3. Click "New Application"

  4. Then “Create your own application”

  5. Name it “HiPeople” and select the Non-gallery radio button

  6. Create the application

Configuring the application

After the application has been created, it needs to be setup for SSO

  1. Click “Set up single sign on”

  2. Choose SAML as the method

  3. Copy the “Medadata URL” and give this to your HiPeople CSM

  4. Your HiPeople CSM will give you back and new URL to be used as shown:

Assigning Users in Microsoft Entra ID:

  1. Navigate to the HiPeople application in Enterprise Applications

  2. Select "Users and groups"

  3. Click "Add user/group"

  4. Assign the appropriate users or groups who need access to HiPeople

Logging into HiPeople using SSO

Once SSO is configured, users can log into HiPeople using their Microsoft credentials.

Troubleshooting

If you experience SSO-related issues:

  • Verify user assignments in Microsoft Entra ID

  • Check if the user has the correct licenses

  • Ensure the SSO configuration is correct

  • Clear browser cache and cookies

Support

For additional assistance, please contact your HiPeople CSM or reach out through the in-app support chat.

Did this answer your question?