Set up single sign-on (SSO) for Amplitude using G Suite

  • Updated

Amplitude provides a single sign-on integration with G Suite for customers on Scholarship, Growth, or Enterprise plans.

Before you begin

For some general information about SSO, see our Help Center article on SSO in Amplitude.

In order to set up SSO, you must be an org admin for your Amplitude organization. You must also be an administrator for your G Suite organization, and you must configure your own SSO settings, a requirement that is enforced when logging into your org.

Set up SSO for Amplitude using G Suite

To configure SSO for Amplitude using G Suite, follow these steps:

  1. In the G Suite admin console, navigate to Apps and click the SAML apps card.

    an_gsuite_1_apps.png

  2. Click the + button (in the bottom left corner) to add a SAML app.

    an_gsuite_2_add_app.png

  3. In the modal, click Setup my own custom app.

    an_gsuite_3_custom_app.png

  4. Under Option 2, click Download to download the IDP metadata.

    an_gsuite_4_download_metadata.png

  5. Upload the metadata file in Amplitude, under gear_icon_for_settings.png > Organizational settings > Access & SSO Settings, then save the changes.

    SSO

  6. Go back to G Suite and continue with the app creation process. Enter a name and description and optionally upload the logo for easy recognition.

    an_gsuite_6_name.png

  7. Next, you will be prompted for the "ACS URL" and "Entity ID".

    an_gsuite_7_sp_details.png


    You can find the Entity ID and Assertion Consumer Service URL in the Amplitude SSO settings; just navigate to gear_icon_for_settings.png > Organizational settings > Access & SSO Settings:

    SSO

     

  8. Finally, in Google Admin, click Finish to save the app and enable SSO.

    an_gsuite_8_attributes.png

 

NOTE: You can review information regarding just-in-time (JIT) provisioning settings for G Suite administration here. There may be a short "settling period" when setting up and validating the configuration. If users are getting 403 errors, please wait a day and try JIT again.