Google - SAML

Google SAML authentication allows you to authenticate using a Google SAML application. To configure Google SAML in IguanaX, please follow the steps below.

Note: To configure SAML settings in Google , you must have appropriate user-level permissions, typically a super administrator role.

STEP 1. Configure an app name and description

Under Apps → Web and mobile apps, add a custom SAML app. Configure the app name and description:

STEP 2. Download IdP metadata file

Download the IdP metadata file. This file will be used later during the IguanaX configuration:

STEP 3. Configure service provider details

Chose a unique name for the Entity ID. For the ACS URL, use the DNS name of the IguanaX server, and add /saml/verify to the endpoint.

In the Name ID format select “EMAIL” and set Name ID to “Basic Information > Primary email”.

STEP 4. Attribute mapping

Configure the group membership attributes section to apply a role to users in IguanaX. The name of the Google group should match the name of the roll created in IguanaX. Users who belong to the Google group will have the associated role applied inside IguanaX.

STEP 5. IguanaX configuration

In IguanaX under Settings → Authentication configure the authentication details for the Google SAML application. In the ACS URL section, simply include the DNS of the IguanaX instance (do not include /saml/verify). The Metadata path should point to the metadata file downloaded in step 2.

STEP 6. Test the integration

Now we can verify our SAML functionality!

Log out of IguanaX. On the login page, you should now see “ Sign in with Google” as an authentication option.

Click it and confirm that you can successfully sign in using your credentials.

Setup is complete! IguanaX is now integrated with Google SAML.