Single Sign-on enables you to manage users and testers outside of TestFairy. A list of permitted users and testers, as well as their passwords, is stored in OKTA. Therefore onboarding a new developer into the team is an easy task.

Talk to us! Visit here to Request a Demo.

Setting up OKTA in your account

  • Login to OKTA, click on 'Admin' and pick 'Add Applications' from the right sidebar:

  • Type "TestFairy" into the search form:

  • And click "Add" on the TestFairy app:

  • Now type in the name of the team in TestFairy (it is also the name of the subdomain):

  • Next, select authorized users. When done, click "Next":

  • OKTA-side configuration is done. Now click "Next":

  • In the "Sign On" menu, click on "View Setup Instructions":

  • Copy "ID Provided Metadata" from section 4 into your clipboard:

  • Now login to, and open the "Preferences" page:

  • In the 'Security' manu item "SAML/Single Sign-on" section, paste the copied 'ID Provided Metadata' into the text area:

  • TestFairy-side configuration is also done:

Now, please logout and if SSO is configured into your account, the login page is replaced with a simple login with sso button.

login screenshot

[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, she will be automatically be associated with the following groups in TestFairy next time she signs in: "okta", "okta-qa", and "okta-qa-san-francisco". If she was removed from group "QA", she will be automatically be removed from "okta-qa" group in TestFairy, the next time she signs in.

To import groups each time a user signs into TestFairy, please follow these instructions.

  • Open the TestFairy app in your OKTA account, select General tab, and click Edit. In SAML Settings section, under Group Attribute Statements, add a rule with name: "groups", (LOWERCASE!!!) and filter "Matches regex" with value .*. (dot asterisk) See screenshot:

  • When done, please click on Update Now so OKTA updates caches. See screenshot:

That's it!
Need our assistance? Don't hesitate to contact support.

Last updated on 2021-10-18