SAML single sign-on (SSO) lets your team log in to HiHello with the same company account they already use for their other work apps. You connect HiHello to your identity provider, such as Okta, Microsoft Entra ID, Google Workspace, OneLogin, JumpCloud, or another SAML 2.0 provider, and then choose which groups can use it.
To enable this, you'll need administrator access to both your HiHello account and your identity provider. You'll work in two browser tabs: the WorkOS setup page that HiHello opens for you, which shows the exact values to copy for your provider, and your provider's admin console.
The screenshots below use Okta as an example. Button and field names may be a little different in other providers.
Looking for HiHello's standard Microsoft sign-in instead? See How to Enable Microsoft Single Sign-On (SSO) for Your Organization.
You can jump to any section below to find out more:
- Start the Connection in HiHello
- Create a SAML App in Your Identity Provider
- Connect Your Provider's Metadata
- Map User Attributes
- Assign Groups to the HiHello App
- Test Single Sign-On
Start the Connection in HiHello
To start connecting your identity provider:
- Log in on Your Computer
- Go to the Company page
- Under User Management, click Connect
- Select your identity provider from the list
The WorkOS setup page opens. Keep it open in its own tab, because you'll copy values from it in the next sections.
Create a SAML App in Your Identity Provider
To create a SAML app for HiHello:
- Sign in to your identity provider's admin console
- Go to the applications area and create a new app integration. In Okta, for example, expand Applications in the left menu, select Applications, and click Create App Integration:
- Select SAML 2.0 as the sign-in method and continue:
- Enter an app name, such as "HiHello, Inc." You can also add the HiHello logo, which you can download from the WorkOS setup page:
Please note: Adding the logo helps your team find HiHello on their identity provider's dashboard.
- Copy the Single Sign-On URL and the Audience URI (SP Entity ID) from the WorkOS setup page and paste them into the matching fields in your provider. Some providers call these fields ACS URL and Entity ID:
- Set the application username as shown on the WorkOS setup page. In Okta, open the Application username dropdown, select Custom, and paste the expression from the WorkOS setup page
- Save the app. In Okta, scroll down and click Next, check This is an internal app that we have created, and click Finish:
Connect Your Provider's Metadata
Your identity provider can share its details with HiHello in two ways: with a metadata URL (dynamic configuration) or by entering them by hand (manual configuration). We strongly recommend the metadata URL.
To connect:
- In your provider, open the HiHello app's sign-on settings and find the Metadata URL then copy it:
- On the WorkOS setup page, paste it into the Identity provider metadata URL field
This connects your identity provider to your HiHello account.
Map User Attributes
To send your users' email addresses and names to HiHello:
- In the HiHello app's settings in your provider, open the attribute mapping section.
Please note: Depending on which features are turned on, the attribute settings may be in a different place in the admin console.
- Add the attribute statements shown on the WorkOS setup page. For an example, in Okta, the finished mapping looks like this:
- Click Save
Assign Groups to the HiHello App
To choose who can sign in to HiHello with SSO:
- Open the HiHello app's assignments and assign the groups that should use HiHello:
- Click Done or Save when you are finished
Only people you assign to the app can sign in to HiHello through your identity provider. You can add more groups at any time.
Test Single Sign-On
To make sure everything is set up correctly:
- Sign in to HiHello through your identity provider to check that the single sign-on connection works