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.
-
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.
-
General settings
Name the app Flipbird and select Next.
-
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/acsAudience URI (SP Entity ID)
https://your-workspace.flipbird.io/api/sso/metadata -
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.
-
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.
-
Assign people
Where: Assignments › Assign
Assign the people or groups who should use Flipbird.
-
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.
| Attribute | From | Used for |
|---|---|---|
email | user.email | Email address (required) |
firstName | user.firstName | First name |
lastName | user.lastName | Last name |
groups | Group Attribute Statement (Sign On tab, Show legacy configuration) | Groups, for role mapping |