GitHub AE uses SAML SSO for authentication, and automatically creates a username for each person when the person signs in through your identity provider (IdP) for the first time.
Usernames must not exceed 39 characters.
Usernames for user accounts on GitHub AE can only contain alphanumeric characters and dashes (
When you configure SAML authentication, GitHub AE uses an identifier from the user account on your IdP to determine the username for the corresponding user account on GitHub AE. If the identifier includes unsupported characters, GitHub AE will normalize the username per the following rules.
GitHub AE will normalize any non-alphanumeric character in your account's username into a dash. For example, a username of
mona.the.octocatwill be normalized to
mona-the-octocat. Note that normalized usernames also can't start or end with a dash. They also can't contain two consecutive dashes.
Usernames created from email addresses are created from the normalized characters that precede the
If multiple accounts are normalized into the same GitHub AE username, only the first user account is created. Subsequent users with the same username won't be able to sign in.
|Identifier on provider||Normalized username on GitHub||Result|
|The.Octocat||This username is created successfully.|
|!The.Octocat||This username is not created, because it starts with a dash.|
|The.Octocat!||This username is not created, because it ends with a dash.|
|The!!Octocat||This username is not created, because it contains two consecutive dashes.|
|The!Octocat||This username is not created. Although the normalized username is valid, it already exists.|
|This username is not created. Although the normalized username is valid, it already exists.|
|This username is not created, because it exceeds the 39-character limit.|
GitHub AE determines each person's username by one of the following assertions in the SAML response, ordered by descending priority.
- The custom
usernameattribute, if defined and present
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameassertion, if present
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddressassertion, if present
GitHub AE requires the
NameID element even if other attributes are present. For more information, see "SAML configuration reference."
GitHub AE creates a mapping between the
NameID from the IdP and the username in 您的企业, so the
NameID should be persistent, unique, and not subject to change for the lifecycle of the user.