Single Sign-On - Overview

Swagger Studio uses email addresses to identify users internally. Make sure the addresses of SSO users do not change. If a user’s email address changes, Swagger Studio will not be able to find an existing user in the database and will create a new user instead.

If you need to update the email addresses of SSO users, please contact Support.

Swagger Studio usernames for Okta users are derived from the username part of the email address (before @). For example, a new user with the email address j.smith@example.com will have Swagger Studio username j.smith.

Note that Swagger Studio allows only the following characters in usernames:

A..Z a..z 0..9 - . _ 

Please make sure the SSO email addresses of your users contain valid usernames. Users with unsupported email addresses will not be able to log in via SSO.

Starting from v. 1.18.2, if another user with the same username already exists in Swagger Studio, a number is appended at the end of the new username to make it unique. For example, j.smith@example.com will become j.smith, and j.smith@acme.com will become j.smith2.

When users log in for the first time, their usernames and email addresses are populated based on the values of the sAMAccountName and userPrincipalName fields, or, as of v. 1.18.2, based on the values of the fields specified by the Profile name and Email options.

Starting from v. 1.18.2, the usernames are normalized so that they contain only the characters A..Z a..z 0..9 - . _ and start and end with a letter or number. Duplicate usernames get a number at the end, for example, j.smith, j.smith2, j.smith3 and so on.