Docs
Google Workspace
Add a custom SAML app in the Google Admin console, point it at this workspace, map the email and name attributes, turn it on for your users, and upload Google's IdP metadata file to Flipbird.
-
Add a custom SAML app
Where: Menu › Apps › Web and mobile apps › Add app › Add custom SAML app
Sign in to the Google Admin console (admin.google.com) with a super administrator account.
Name the app Flipbird and select Continue.
-
Download Google's IdP metadata
Where: Google Identity Provider details › Download metadata
Select Download metadata and keep the file: you upload it to Flipbird later. Then select Continue.
-
Service provider details
Where: Service provider details
Leave Start URL empty. Signed response can stay unchecked: Google always signs the assertion, which is what Flipbird checks.
Set Name ID format to EMAIL and Name ID to Basic Information, Primary email, then select Continue.
ACS URL
https://your-workspace.flipbird.io/api/sso/acsEntity ID
https://your-workspace.flipbird.io/api/sso/metadata -
Attribute mapping
Where: Attribute mapping › Add mapping
Map Primary email to the app attribute email, First name to firstName, and Last name to lastName.
Optional, to map groups to Flipbird roles: under Group membership, pick the groups and set the app attribute to groups. Google sends each group's name.
Select Finish.
-
Turn the app on
Where: Apps › Web and mobile apps › Flipbird › User access
Select On for everyone, or turn it on for an organizational unit or access group, then Save.
-
Test in Flipbird
Back in Flipbird, upload the metadata file and run Test sign-in. Require SAML only after the test succeeds.
What Flipbird reads
Name ID: urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress, from Basic Information, Primary email.
| Attribute | From | Used for |
|---|---|---|
email | Primary email | Email address (required) |
firstName | First name | First name |
lastName | Last name | Last name |
groups | Group membership | Groups, for role mapping |