Informationen zu Benutzernamen mit externer Authentifizierung
Du kannst die externe Authentifizierung für GitHub Enterprise Server mit CAS, LDAP oder SAML konfigurieren. Weitere Informationen findest du unter Informationen zur Identitäts- und Zugriffsverwaltung.
Wenn du die externe Authentifizierung verwendest, erstellt Ihre GitHub Enterprise Server-Instance automatisch einen Benutzernamen für jede Person, wenn sich diese Person über dein externes Authentifizierungssystem zum ersten Mal bei Ihre GitHub Enterprise Server-Instance anmeldet.
Benutzernamen dürfen 39 Zeichen nicht überschreiten.
Informationen zur Normalisierung von Benutzernamen
Benutzernamen für Benutzerkonten auf GitHub dürfen nur alphanumerische Zeichen und Bindestriche (-
) enthalten.
Wenn du CAS, LDAP oder die SAML-Authentifizierung konfigurierst, verwendet GitHub Enterprise Server einen Bezeichner aus dem Benutzerkonto auf deinem externen Authentifizierungsanbieter, um den Benutzernamen für das entsprechende Benutzerkonto für GitHub Enterprise Server zu bestimmen. Wenn der Bezeichner nicht unterstützte Zeichen enthält, normalisiert GitHub Enterprise Server den Benutzernamen gemäß der folgenden Regeln.
-
GitHub Enterprise Server normalisieren alle nicht-alphanumerischen Zeichen im Benutzernamen deines Kontos in einen Bindestrich. So wird der Benutzername
mona.the.octocat
beispielsweise aufmona-the-octocat
normalisiert. Beachte, dass die normalisierten Benutzernamen weder mit einem Bindestrich beginnen noch darauf enden können. Darüber hinaus können sie nicht zwei aufeinanderfolgende Bindestriche enthalten. -
Aus E-Mail-Adressen erstellte Benutzernamen werden anhand der normalisierten Zeichen erstellt, die dem Zeichen
@
vorangestellt sind. -
Benutzernamen, die anhand von Domänenkonten erstellt wurden, werden aus den normalisierten Zeichen nach dem Trennzeichen
\\
erstellt. -
Wenn mehrere Konten zum selben GitHub Enterprise Server-Benutzernamen normalisiert werden, wird nur das erste Benutzerkonto erstellt. Nachfolgende Benutzer mit demselben Benutzernamen können sich nicht anmelden.
Beispiele für die Normalisierung von Benutzernamen
Bezeichner des Anbieters | Normalisierter Benutzername für GitHub | Ergebnis |
---|---|---|
The.Octocat | the-octocat | Dieser Benutzername wird erfolgreich erstellt. |
!The.Octocat | -the-octocat | Dieser Benutzername wird nicht erstellt, da er mit einem Bindestrich beginnt. |
The.Octocat! | the-octocat- | Dieser Benutzername wird nicht erstellt, da er mit einem Bindestrich endet. |
The!!Octocat | the--octocat | Dieser Benutzername wird nicht erstellt, da er zwei aufeinanderfolgende Bindestriche enthält. |
The!Octocat | the-octocat | Dieser Benutzername wird nicht erstellt. Obwohl der normalisierte Benutzername gültig ist, ist er bereits vorhanden. |
The.Octocat@example.com | the-octocat | Dieser Benutzername wird nicht erstellt. Obwohl der normalisierte Benutzername gültig ist, ist er bereits vorhanden. |
internal\\The.Octocat | the-octocat | Dieser Benutzername wird nicht erstellt. Obwohl der normalisierte Benutzername gültig ist, ist er bereits vorhanden. |
mona.lisa.the.octocat.from.github.united.states@example.com | mona-lisa-the-octocat-from-github-united-states | Dieser Benutzername wird nicht erstellt, da er den Grenzwert von 39 Zeichen überschreitet. |
Informationen zur Normalisierung des Benutzernamens mit SAML
Wenn du die SAML-Authentifizierung für Ihre GitHub Enterprise Server-Instance, konfigurierst, bestimmt GitHub Enterprise Server den Benutzernamen jeder Person durch eine der folgenden Behauptungen in der SAML-Antwort, sortiert durch absteigende Priorität.
- das benutzerdefinierte
username
-Attribut, sofern definiert und vorhanden - Eine
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
-Assertion, wenn vorhanden - Eine
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
-Assertion, wenn vorhanden - Das
NameID
-Element
GitHub Enterprise Server erfordert das NameID
-Element auch dann, wenn andere Attribute vorhanden sind. Weitere Informationen findest du unter Referenz zur SAML-Konfiguration.
GitHub Enterprise Server erstellt eine Zuordnung zwischen NameID
aus dem IdP und dem Benutzernamen auf Ihre GitHub Enterprise Server-Instance, sodass NameID
beständig, eindeutig und nicht dem Lebenszyklus des Benutzers unterliegen soll.
Hinweis: Wenn sich die NameID
für eine Person für den IdP ändert, wird dem Benutzer bzw. der Benutzerin beim Versuch, sich bei Ihre GitHub Enterprise Server-Instance anzumelden, eine Fehlermeldung angezeigt. Damit der Zugriff der Person wiederhergestellt werden kann, musst du die NameID
-Zuordnung des Benutzerkontos entsprechend aktualisieren. Weitere Informationen findest du unter Aktualisieren der SAML-NameID von Benutzer*innen.