Hi5 integration with Okta - OpenID Connect

Contents
Supported Features
Requirements
Configuration Steps
Notes

Supported Features
This article shows a fairly simple example setup demonstrating how to use OKTA as a Service Provider (SP)-Initiated Authentication for Single Sign-On (SSO) using OIDC.

Requirements
You need to have an active Hi5 company account to use this integration.
All users need to be a part of the same Hi5 company account and be active.
Be the Administrator of your Okta account.

Configuration Steps

How to enable OIDC in Hi5
OIDC is automatically activated and by leveraging Okta’s widget experience we create a secure SSO flow.

How to add the Hi5 OIDC application in Okta

Step 1

Open Okta and make sure you are in the “Classic UI’ view (in the top left corner). This opens the Admin Console.



For more information, see Administrator Console on the Okta Organizations page of the Okta Developer website.

Step 2

Under Shortcuts, choose Add Applications. Or, choose Applications, and then choose Add Application.



On the Add Application page, search for Hi5. Select the Hi5 card and click “Add”.



Next define the Application label (or leave it as standard) and click “Done”.



Once the integration has been added, you will be able to assign users to the Hi5 app under the Assignments tab. This will enable users to login to Hi5 using Okta as the SSO.

Assign users

Under the Assignments tab, click on the “Assign” dropdown and select Assign to People or Assign to Group.



Select the People/Group that you want to add and click Save. When you’re finished, click Done.



Link Okta OpenID Connect to Hi5

In a new browser tab, login to your Hi5 account and navigate to My Company > Settings > Profile.



Scroll down to the Okta integration section and click the Link Now button. A new modal will open.



Now, go back to Okta and navigate to the General tab for the Hi5 Okta app and copy your Client ID.



Paste the Client ID from Okta into the Hi5 modal.



Next, go to the Sign On tab in Okta and copy-paste the Issuer url into the Hi5 modal.



Click Save and you’re done!

Important: Before your employees can log in using Okta, you need to invite them to Hi5 by following these steps: Add Co-workers. Once they've activated their accounts, your employees can log in using Okta 👇

Notes

Now that you have configured the Hi5 app on your Okta account, your team can head over to app.get5.io and select to login with Okta.



The secure Okta SSO widget will open, where your Okta credentials can be entered to sign in!



Once authenticated, you will automatically be logged into Hi5 with your current session token.
Was this article helpful?
Cancel
Thank you!