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.

Version 1 · checked on

  1. 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.

  2. 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.

  3. 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/acs

    Entity ID

    https://your-workspace.flipbird.io/api/sso/metadata
  4. 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.

  5. 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.

  6. 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.

AttributeFromUsed for
emailPrimary emailEmail address (required)
firstNameFirst nameFirst name
lastNameLast nameLast name
groupsGroup membershipGroups, for role mapping

The provider's own documentation