Before You Start
You need admin access to Google Workspace Admin Console and to Whistleblower Software Settings.
Users must already exist in Whistleblower Software before they can sign in via SAML.
If you only need simple Google login without centralized SAML control, use the Login with Google (OAuth) guide instead.
SAML 2.0 is available only on the Advanced plan.
Step 1: Open Google Workspace Admin
Navigate to https://admin.google.com/ac/apps/unified.
Step 2: Create a New SAML App
Click Add app, then select Add custom SAML app.
Step 3: Name the Application
Give the application a name, for example "Whistleblower Software". You can also add a logo at this stage if needed.
Step 4: Download the Google Metadata File
Select option 1 and download the metadata file from Google. You will upload this into Whistleblower Software in the next step.
Step 5: Upload the Google Metadata File into Whistleblower Software
Go to Settings > Security in Whistleblower Software. Enable Login with SAML. Under Identity provider metadata file, upload the metadata file you downloaded from Google.
Step 6: Continue in Google Admin
Press Continue in the Google Admin interface to move to the service provider details screen.
Step 7: Enter the ACS URL and Entity ID
In Whistleblower Software under Settings > Security, with SAML enabled, copy the Application ACS URL and the Application entity ID. Enter these into the corresponding fields in Google Admin under Service provider details.
On the same screen:
Enable Signed responses.
Set Name ID format to Email.
Set Name ID to Primary Email.
Step 8: Configure Attribute Mapping
Under Attribute mapping, add the following:
First name mapped to first_name
Last name mapped to last_name
Primary email mapped to email
Step 9: Finish and Enable Access
Click Finish. Then go to the app's access settings in Google Admin and enable access for the users or groups who need to sign in to Whistleblower Software.
It may take a short time for Google to fully activate the app. If users see an error immediately after setup, wait a few minutes and try again.
Only administrators, system technician and user-defined users with access to security settings can make these changes in Whistleblower Software.
We’re here to support you. If you have questions reach out to us directly via the Messenger icon in the bottom right corner of your screen, or send us an email at support@whistleblowersoftware.com