Google SAML Setup#

This page provides instructions on how to integrate Squirro with Google’s Single Sign-on offering.

Configure Google Apps#

  1. Open the Google Admin console.

  2. Click Apps.

  3. Click SAML apps.

  4. Create a new SAML app using the plus button at the bottom right.

  5. Select Setup my own custom app image1

  6. Download the IDP metadata file - this is required for Squirro later

  7. Fill out the basic information:

    • Application Name: Squirro

    • Upload logo. image2

  8. Fill in the service provider details:

    1. ACS URL: https://SQUIRRO/sso/callback (URL of your Squirro installation plus the path /sso/callback)

    2. Entity ID:

    3. Keep other settings as is image3

  9. No mapping need to be defined.

  10. Finish the process and close the resulting dialog.

  11. Now enable the Squirro app for everybody, by clicking on the hamburger menu and clicking ON for everyone image4

Configure SAML Metadata#

To configure SAML Single Sign-On with the federation metadata file, go to the Server space in Squirro and in the navigation on the left select Single Sign-On (SAML).

Press the orange plus icon on the top right. Fill out the form:

  • Domain: *

  • Enabled: Check

  • Metadata file: upload the file that was downloaded from Google earlier

  • User group: Select a user group which should be assigned to all SSO users


Enable SSO#

For security reasons, the final configuration needs to be done directly on the server. Log into the server using SSH or similar means and edit the file /etc/squirro/frontend.ini. Then append the following lines at the end:

sso_enabled = true
sso_endpoint = http://localhost:81/studio/extauth_saml/extauth

Reduce HTTP Session#

With Single Sign-On enabled, Squirro recommends reviewing the session expiration parameters. See Reducing Session Lifetime for information.