Docs

Okta

Create a SAML 2.0 app integration in the Okta Admin Console, point it at this workspace, then add the email and name attribute statements on its Sign On tab, assign it, and give Flipbird its metadata URL.

Version 2 · checked on

  1. Create the app integration

    Where: Applications › Applications › Create App Integration

    In the Okta Admin Console, select Create App Integration. If Okta asks, choose Classic experience.

    Choose SAML 2.0 as the sign-in method and select Next.

  2. General settings

    Name the app Flipbird and select Next.

  3. Configure SAML

    Where: Configure SAML › General

    Keep Use this for Recipient URL and Destination URL checked. Leave Default RelayState empty.

    Set Name ID format to EmailAddress and Application username to Email.

    Select Next, say it is an internal app, and select Finish.

    Single sign-on URL

    https://your-workspace.flipbird.io/api/sso/acs

    Audience URI (SP Entity ID)

    https://your-workspace.flipbird.io/api/sso/metadata
  4. Attribute statements

    Where: Sign On › Attribute Statements

    Okta adds attribute statements after the app is created, not in the wizard. Open the app's Sign On tab and find the Attribute Statements section.

    Select Add expression and add email with the expression user.email, then firstName with user.firstName and lastName with user.lastName. Or expand Show legacy configuration, select Edit, and add the same three with Name format Unspecified.

    Optional, to map groups to Flipbird roles: expand Show legacy configuration, select Edit, and under Group Attribute Statements add groups with Name format Unspecified and a filter that matches the groups you want to send, such as Starts with flipbird-.

    Select Save.

  5. Copy the metadata URL

    Where: Sign On › SAML Signing Certificates

    On the Sign On tab, copy the Metadata URL of the active certificate and paste it into Flipbird.

  6. Assign people

    Where: Assignments › Assign

    Assign the people or groups who should use Flipbird.

  7. Test in Flipbird

    Back in Flipbird, import the metadata URL 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 Email.

AttributeFromUsed for
emailuser.emailEmail address (required)
firstNameuser.firstNameFirst name
lastNameuser.lastNameLast name
groupsGroup Attribute Statement (Sign On tab, Show legacy configuration)Groups, for role mapping

The provider's own documentation