Greenhouse cloud application

Using Security Assertion Markup Language (SAML), your users can use their Google Cloud credentials to sign in to enterprise-cloud applications.

Set up SSO via SAML for Greenhouse

Here's how to set up single sign-on (SSO) via SAML for the Greenhouse application.

Step 1: Set up Greenhouse as a SAML 2.0 service provider (SP)
  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Securityand thenSet up single sign-on (SSO) for SAML applications.

    You must be signed in as a super administrator for this task.

  3. Click the Download button to download the Google IdP metadata and the X.509 Certificate.
  4. Greenhouse support will complete the service provider set-up. Send them the Google IdP metadata and the X.509 Certificate required for SSO setup you downloaded in Step 3.
  5. Proceed to the next section to set up Google as a SAML identity provider (IdP).
Step 2: Set up Google as a SAML identity provider (IdP)
  1. In a new browser tab, sign in to your Admin console as a super administrator.
  2. Click Apps SAML apps.
  3. Click the plus (+) icon in the bottom corner.
  4. Select the Greenhouse item from the list. The values on the Google IDP Information page automatically populate.
  5. Contact Greenhouse support to setup Google as a SAML IdP. Once the certificates have been sent by Greenhouse support upload them into the appropriate service provider Setup fields, and then come back to the admin console and click Next.
  6. In the Basic application information window, the Application name and Description values automatically populate.
  7. Click Next.
Step 3: Enter service provider details in Google Admin console
  1. In the Service Provider Details section, if you have a custom subdomain, enter the following URLs into the Entity ID, ACS URL, and Start URL fields:

    • ACS URL: https://your-domain-name.greenhouse.io/users/saml/consume
    • Entity ID: your-domain-name.greenhouse.io
    • Start URL:<empty>

    If you do not have a custom subdomain, enter the following URLs into the Entity ID, ACS URL, and Start URL fields:

    • ACS URL: https://app.greenhouse.io/your-access-token/users/saml/consume
    • Entity ID: greenhouse.io
    • Start URL:<empty>
  2. Leave Signed Response unchecked.
    When the Signed Response checkbox is unchecked, only the assertion is signed. When the Signed Response checkbox is checked, the entire response is signed.
  3. The default Name ID is the primary email. Multi-value input is not supported.
  4. Click Next.
  5. Click Add new mapping and map the attribute value "User.FirstName" to Basic Information > First Name. Map the attribute value "User.LastName" to Basic Information > Last Name.
  6. In the drop-down list, select the Category and User attribute to map the attribute from the Google profile.
  7. Click Finish.
Step 4: Enable the Greenhouse app
  1. Sign in to your Admin console.
  2. Go to Apps SAML apps.
  3. Select Greenhouse.
  4. Click User access.
  5. To turn on or off a service for everyone in your organization, click On for everyone or Off for everyone, and then click Save.

  6. To turn on or off a service only for users in an organizational unit:

    1. At the left, select the organizational unit.
    2. Select On or Off.
    3. To keep the service turned on or off even when the service is turned on or off for the parent organizational unit, click Override.
    4. If the organization's status is already Overridden, choose an option:
      • Inherit—Reverts to the same setting as its parent.
      • Save—Saves your new setting (even if the parent setting changes).

    Learn more about organizational structure.

  7. (Optional) Turn on the service for a group of users.
    Use access groups to turn on a service for specific users within or across your organizational units. Learn more

  8. Ensure that your Greenhouse user account email IDs match those in your Google domain.
Step 5: Verify that the SSO is working

Greenhouse supports both Identity Provider (IdP) initiated and Service Provider (SP) initiated SSO. Follow these steps to verify SSO in either mode:

IdP-initiated

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Appsand thenSAML apps.
  3. Select Greenhouse.
  4. At the top left, click Test SAML login

    Greenhouse should open in a separate tab. If it doesn’t, use the information in the resulting SAML error messages to update your IdP and SP settings as needed, then retest SAML login.

SP-initiated

  1. Open https://your-domain-name.greenhouse.io. You should be automatically redirected to the Google sign in page.
  2. Enter your sign in credentials.
  3. After your sign in credentials are authenticated you will be automatically redirected back to Greenhouse.

Google, G Suite, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.
Was this helpful?
How can we improve it?