Informationen zu Benutzernamen mit externer Authentifizierung
Du kannst die externe Authentifizierung für GitHub Enterprise Server mit CAS, LDAP oder SAML konfigurieren. Weitere Informationen finden Sie 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 deine GitHub Enterprise Server-Instanz zu bestimmen. Wenn der Bezeichner nicht unterstützte Zeichen enthält, normalisiert GitHub den Benutzernamen gemäß den folgenden Regeln.
-
GitHub normalisiert 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 im selben 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 auf GitHub.com | 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 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
GitHub bestimmt den Benutzernamen jeder Person durch eine der folgenden Assertionen in der SAML-Antwort, sortiert durch absteigende Priorität, wenn du die SAML-Authentifizierung für Ihre GitHub Enterprise Server-Instance konfigurierst.
- 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 erfordert das NameID
-Element auch dann, wenn andere Attribute vorhanden sind. Weitere Informationen finden Sie unter Referenz zur SAML-Konfiguration.
GitHub erstellt eine Zuordnung zwischen NameID
aus dem Identitätsanbieter und dem Benutzernamen auf Ihre GitHub Enterprise Server-Instance. NameID
muss daher beständig und eindeutig sein und darf während des Lebenszyklus der benutzenden Person nicht geändert werden.
Note
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 finden Sie unter Aktualisieren der SAML-NameID von Benutzer*innen.