Skip to main content
All CollectionsRecruiters/ HiPeople UsersIntegrations & Developer Resources
Single-Sign-On (SSO)
Single-Sign-On (SSO)

How to set up SSO with HiPeople

Ricky avatar
Written by Ricky
Updated over 6 months 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.

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.

Did this answer your question?