Identity and people

Google Workspace

Create a custom SAML application for your Workspace users.

Deployment
BYOC

Use a custom SAML app for managed company sign-in. This is separate from a consumer Sign in with Google button. You need permission to manage SAML applications in Google Admin Console.

Create the application

  1. Open Apps → Web and mobile apps → Add app → Add custom SAML app.
  2. Name the app Diakrin. Download the Google identity-provider metadata XML and retain it for the activation handoff.
  3. In Service provider details, enter the ACS URL and Entity ID from your setup packet.
  4. Set Name ID to the user’s primary work email with EMAIL format, and add an email attribute mapping from Basic Information → Primary email.
  5. Enable the app for your pilot organizational unit or access group. Keep the broader organization disabled until the pilot succeeds.

Map the fields

Google Workspace fieldValue
ACS URLDiakrin ACS URL
Entity IDDiakrin SP Entity ID
Name IDPrimary work email
Name ID formatEMAIL
Attribute mapping emailPrimary email

Activate and test

Return the metadata XML, approved domains and certificate expiry to your Diakrin onboarding contact. After activation, start from Diakrin’s company SSO form and follow Test and roll out SSO. Allow for Google’s application-access changes to propagate before retesting.

When sign-in succeeds but the organization is missing, check the Diakrin invitation and project assignment; Google application access does not create those grants.

Official reference: Set up your own custom SAML app ↗.

Next stepTest and roll out SSO →