Skip to content

Saml with Google Workspace (formerly G Suite)

This guide walks you through configuring your Google Workspace (formerly known as G Suite) service as a SAML SSO identity provider (IDP) for Ostorlab.

Prerequisites

Creating the SAML Application

  1. In the administrator console for your Google Workspace domain, open the flyout menu in the upper-left corner and choose Apps > Web and mobile apps. Google Workspace Admin Console

  2. Select Add app > Add custom SAML app to create a new SAML application. Google Workspace Admin Console

  3. In the first step, give the SAML app a name (e.g., Ostorlab-SSO), and optionally add an App Icon, and select Continue. Google Workspace Admin Console

  4. Next, under Option 2: Copy the SSO URL, entity ID, and certificate, copy the SSO URL, the Entity ID and the Certificate. You will paste them in Ostorlab to complete the configuration. Then select Continue. Google Workspace Admin Console

  5. In step 3, for the required ACS URL and Entity ID and Start URL fields, enter the fully-qualified URLs of the acs and metadata and sso endpoints of the Ostorlab API, adjusted for your Ostorlab organisation name.

Warning: The values you need to use are dependent upon your Ostorlab organisation prefix. Be sure to replace <organisation_prefix> with your actual organisation prefix. You can find your org’s prefix in your organisation's settings page.

SAML Setting Value
ACS URL https://api.ostorlab.co/saml/acs/?org=<organisation_prefix>
Entity ID https://api.ostorlab.co/saml/metadata/
Start URL Empty
Name ID Format urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified
Assertion Consumer Service Binding urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST

Google Workspace Admin Console

Leave the other fields as their default values, then select Continue.

Important: Do not change the value of Name ID Format value once your users have started using Ostorlab—not even switching its value between EMAIL or PERSISTENT

  1. The final step—attribute mapping—is optional, but you may wish to specify proper first and last names for your Ostorlab users, based on their Google account profiles. Ostorlab expects to receive these fields as firstName and lastName, respectively.

Once you add them, select Finish. Google Workspace Admin Console

  1. On the next screen, enable your newly created SAML application for your Google domain users by selecting the down arrow in the User access panel: Google Workspace Admin Console

Select ON for everyone and Save. Google Workspace Admin Console

At this point, you’re done configuring Google Workspace, and can move on to completing SAML SSO setup in Ostorlab.

Configuring Your Ostorlab Organisation

The final step in the process consists of associating your Ostorlab organisation with your SSO identity provider.

  1. Sign into Ostorlab, navigate to the SAML integration section and open the Configuration tab.
  2. Turn on Enable Integration and paste the values you copied from Google:
    • Identity Provider Entity ID: the Google Entity ID
    • Sign-On Service URL: the Google SSO URL
    • Sign-On Service Binding: urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST
    • X.509 Certificate: the Google Certificate
  3. Click Save (Update when the integration was already configured).

Your Ostorlab organisation is now configured to use Google as a SAML SSO identity provider.

Signing into Ostorlab with Google

Members of your Google Workspace can now sign into Ostorlab. Navigate to https://report.ostorlab.co/account/login, click LOGIN VIA SSO and enter the prefix of your Ostorlab organisation.

Troubleshooting

Google Workspace SAML troubleshooting page: SAML app error messages