Überlegungen zum Benutzernamen für die externe Authentifizierung

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.

1. GitHub normalisiert alle nicht-alphanumerischen Zeichen im Benutzernamen deines Kontos in einen Bindestrich. So wird der Benutzername mona.the.octocat beispielsweise auf mona-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.

2. Aus E-Mail-Adressen erstellte Benutzernamen werden anhand der normalisierten Zeichen erstellt, die dem Zeichen @ vorangestellt sind.

3. Benutzernamen, die anhand von Domänenkonten erstellt wurden, werden aus den normalisierten Zeichen nach dem Trennzeichen \\ erstellt.

4. 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.

1. das benutzerdefinierte username-Attribut, sofern definiert und vorhanden
2. Eine http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name-Assertion, wenn vorhanden
3. Eine http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress-Assertion, wenn vorhanden
4. 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.