Permissions: Basic users and above who can manage and configure SSO

Product tier: Available for Advanced and Expert subscription tiers

If your organization manages user access through Google Apps, you can easily set up Single Sign-On (SSO) to allow your users to log into Greenhouse Recruiting or Greenhouse Onboarding using their employee Google account.

Note: Click here for more information on Single Sign-On.

Once SSO is enabled, all users must log in through Google Apps and won't be able to use their previous username and password.

Logging in through Google Apps only changes the way a user logs in to Greenhouse Recruiting or Greenhouse Onboarding and doesn't change anything else associated with their account. In other words, if a user has an existing Greenhouse Recruiting or Greenhouse Onboarding account, they'll still be able to access their jobs, candidates, interviews, onboarding tasks, and other data as normal.

Note: If a new user has a Google Apps account, but not a Greenhouse Recruiting account, Greenhouse Recruiting will automatically create a Greenhouse user account the first time they sign in using Google Apps. By default, this account will be assigned Basic permissions. Site Admins can update these permissions on the Configure page.

Set up SSO for Greenhouse Recruiting

Note: This process is based on Google's standard SSO setup steps, outlined here.

Log into Greenhouse Recruiting and copy your SSO Assertion Consumer URL in the Dev Center. (Configure > Dev Center > Single Sign-On > SSO Assertion Consumer URL)

Screenshot of copy Assertation URL

In another tab, sign in to your Google Admin console and navigate to the Web and mobile apps page. (Home > Apps > Web and mobile apps)

Screenshot of web and mobile app menu

Click Add app at the top of the page and select Add custom SAML app.

Screenshot of custom SAML app menu item

Enter the App name and click Continue. If needed, you can enter an optional description and app icon on this page.

Screenshot of Greenhouse Recruiting app name

Enter the following information on the Service Provider Details page:

  • Entity ID: greenhouse.io
  • Assertion Consumer Service (ACS) URL: The ACS URL previously copied from Greenhouse Recruiting
  • Name ID format: EMAIL
  • Name ID: Basic Information > Primary email

Screenshot of GHR privder details

Map the following information on the Attributes page and click Finish. The text must exactly match the text below (including capitalization) in order for the integration to work correctly

Basic information App attributes
First name User.FirstName
Last name User.LastName
Primary email NameID

Select Download Metadata on the saved tile. 

Screenshot of download metadata

Navigate back to the Dev Center in Greenhouse Recruiting and finish the Single Sign-On setup outlined in this article.

Once you're finished, take the following steps:

  • Grant users access to Greenhouse Recruiting in your Google Admin Console under User Access
    Screenshot of user access button
  • Finish setup in Greenhouse Recruiting by completing the remaining fields in the Dev Center (Configure > Dev Center > Single Sign-On)
  • Finish overall SSO setup and move your integration to a hard-enabled state by following the steps in this document

Note: For troubleshooting guidance for common SAML errors, click here.

Set up SSO for Greenhouse Onboarding

Add Greenhouse Onboarding to Google Apps

Sign in to your Google Admin console and navigate to the Web and mobile apps page. (Home > Apps > Web and mobile apps)

Screenshot of web and mobile app menu

Click Add app at the top of the page and select Add custom SAML app.

Screenshot of custom SAML app menu item

Enter the App name and click Continue. If needed, you can enter an optional description and app icon on this page.

Note: We recommend using "Greenhouse Onboarding" for your app name.

Screenshot of Greenhouse Onboarding app name

Enter the following information on the Service Provider Details page:

  • Entity ID: app.parklet.co
  • Assertion Consumer Service (ACS) URL: https://onboarding.greenhouse.io/saml/{Greenhouse Onboarding UID}/consume
  • Name ID format: EMAIL
  • Name ID: Basic Information > Primary email

Note: Owners can retrieve your organization's Entity ID and ACS URL directly in Greenhouse Onboarding. 

Navigate to Settings Data Flow Single Sign-On, then copy the values from the SSO Assertion Consumer Service (ACS) URL and Entity ID/Issuer fields.

Single Sign On page in Greenhouse Onboarding Settings with Step One credentials highlighted

Screesnhot of GHO provider details

Map the following information on the Attributes page and click Finish. The text must exactly match the text below (including capitalization) in order for the integration to work correctly

Basic information App attributes
First name User.FirstName
Last name User.LastName
Primary email NameID

Screenshot of attributes field

Select Download Metadata on the saved tile. You'll use this metadata to complete setup in the next step.

Screenshot of download metadata

Finish SAML configuration in Greenhouse Onboarding

Next, you'll finish SAML configuration directly in Greenhouse Onboarding.

Open Greenhouse Onboarding, then navigate to Settings > Data Flow > Single Sign-On.

Single Sign On page in Greenhouse Onboarding Settings

On the Single Sign-On page, fill out the following fields with credentials from your Google metadata file:

  • Single Sign-On URL
  • Single Logout URL (optional)
  • IdP Certificate Fingerprint (SHA1 format)

Step Two of Single Sign On setup in Greenhouse Onboarding settings with fields highlighted

Click Save.

Once you've saved your SSO information, reach out to Greenhouse Technical Support to finish setup and turn on your SAML configuration.

After you've finished setup in Greenhouse Onboarding, you'll need to grant users access to Greenhouse Onboarding in your Google Admin Console under User Access.

Screenshot of user access button

Note: For troubleshooting guidance for common SAML errors, click here.