Okta

1. Login to OKTA, click on Admin and pick Add Applications from the right sidebar.
2. Type "TestFairy" into the search form
3. Click Add on the TestFairy app.
4. Next, type in the team's name in TestFairy (it is also the subdomain's name).
5. Next, select authorized users. When done, click Next.
6. OKTA-side configuration is done. Now click Done.
7. In the Sign On menu, click on View Setup Instructions.
8. Copy ID Provided Metadata from section 4 into your clipboard.
9. Now login to https://app.testfairy.com, and open the Preferences.
10. In the Security menu item SAML/Single Sign-on section, paste the copied ID Provided Metadata into the text area.
11. TestFairy-side configuration is done. Now, log out, and if SSO is configured into your account, the login page is replaced with Login with OKTA.

(Optional) Automatically Importing Groups From OKTA

When managing large teams with OKTA, it is most likely that people are already associated with groups.

For example, say Alice is associated with the following groups in OKTA: ["QA", "QA San Francisco"]. With auto-import of groups, Alice is automatically associated with the following groups in TestFairy the next time she signs in: "okta", "okta-qa", and "okta-qa-san-francisco". Once removed from the group "QA", Alice is automatically removed from the "okta-qa" group in TestFairy, the next time she signs in.

To import groups each time a user signs into TestFairy:

1. Open the TestFairy app in your OKTA account, select Sign On, and click Edit.
2. Click on Attributes.
3. Under Group Attribute Statements, add a rule with the name: "groups" (in lowercase) and filter "Matches regex" with value .*. (dot asterisk).