Überlegungen zum Benutzernamen für die externe Authentifizierung

Informationen zu Benutzernamen mit externer Authentifizierung

Wenn du ein Unternehmen mit Enterprise Managed Users verwendest, müssen sich Mitglieder deines Unternehmens authentifizieren, um auf GitHub über deinen SAML-Identitätsanbieter (IdP) zuzugreifen. Weitere Informationen findest du unter Informationen zu Enterprise Managed Users und Informationen zur Identitäts- und Zugriffsverwaltung.

GitHub erstellt automatisch einen Benutzernamen für jede Person, wenn ihr Benutzerkonto über SCIM bereitgestellt wird.

• Zum Erstellen des Benutzernamens normalisiert GitHub einen Bezeichner, der von deinem Identitätsanbieter bereitgestellt wird.
• Auf GitHub.com fügt GitHub am Ende jedes Benutzernamens auch einen Unterstrich und den Kurzcode deines Unternehmens hinzu.

Wenn mehrere Bezeichner im selben Benutzernamen normalisiert werden, tritt ein Benutzernamenskonflikt auf, und nur das erste Benutzerkonto wird erstellt. Du können Benutzernamenskonflikte lösen, indem du eine Änderung in deinem Identitätsanbieter vornimmst, sodass die normalisierten Benutzernamen eindeutig sind und den Grenzwert von 39 Zeichen einhalten.

Informationen zu Kurzcodes für verwaltete Benutzerkonten

Jedem Unternehmen, das verwaltete Benutzerkonten verwendet, wird ein Kurzcode zugeordnet. Dabei handelt es sich um eine alphanumerische Zeichenfolge bestehend aus drei bis acht Zeichen.

Kurzcodes auf GitHub.com

Wenn du auf GitHub.com ein Unternehmen mit verwalteten Benutzer*innen erstellst, wählst du einen Kurzcode aus, der für alle Benutzernamen der Mitglieder deines Unternehmens als Suffix verwendet wird.

• Der Kurzcode muss für dein Unternehmen eindeutig sein und darf keine Sonderzeichen enthalten.
• Wähle den Kurzcode sorgfältig aus, da eine Änderung nicht möglich ist, nachdem du dein Unternehmen mit verwalteten Benutzer*innen erstellt hast.

Der Setupbenutzer, der SAML-SSO konfiguriert, hat einen Benutzernamen im Format von SHORT-CODE_admin. Wenn der Shortcode Ihres Unternehmens beispielsweise „octo“ lautet, lautet der Setupbenutzer „octo_admin“.

Wenn du neue Benutzer aus deinem Identitätsanbieter bereitstellst, verfügen diese neuen verwaltetes Benutzerkonto über einen GitHub-Benutzernamen im Format @IDP-USERNAME_SHORT-CODE (z. B. „mona-cat_octo“).

Kurzcodes auf GHE.com

Wenn du dein Unternehmen mit verwalteten Benutzer*innen auf GHE.com mit GitHub Enterprise-Cloud mit Datenresidenz erstellst, wird der Kurzcode für dein Unternehmen zufällig generiert.

• Der Kurzcode wird nicht als Suffix in den Benutzernamen der bereitgestellten Benutzer verwendet.
• Du findest den Kurzcode nur im Benutzernamen des Setupadministrators, wie z. B. in 2abvd19d_admin.

Informationen zu normalisierten Benutzernamen

Benutzernamen werden durch Normalisieren des SCIM-Attributwerts userName gebildet, der vom Identitätsanbieter gesendet wird.

Identitätsanbieter	GitHub-Benutzername
Microsoft Entra ID (früher Azure AD)	Der IDP-USERNAME wird durch Normalisieren der Zeichen erzeugt, die dem Zeichen @ im UPN (Benutzerprinzipalname) vorausgehen, das nicht die #EXT# für Gastkonten enthält.
Okta	IDP-USERNAME ist das normalisierte Benutzernamensattribut, das vom IdP bereitgestellt wird.

Diese Regeln können dazu führen, dass dein IdP denselben IDP-USERNAME für mehrere Benutzer bereitstellt. Für Entra ID führen beispielsweise die folgenden UPNs zu demselben Benutzernamen:

• bob@contoso.com
• bob@fabrikam.com
• bob#EXT#fabrikamcom@contoso.com
• bob_example#EXT#fabrikamcom@contoso.com
• bob_example.com#EXT#fabrikamcom@contoso.com

Dies führt zu einem Benutzernamenskonflikt, und nur der erste Benutzer wird bereitgestellt. Weitere Informationen findest du unter Beheben von Problemen mit Benutzernamen.

Benutzernamen, einschließlich Unterstrich und Kurzcode, 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 die SAML-Authentifizierung konfigurierst, verwendet GitHub Enterprise Cloud den Attributwert userName von SCIM, der vom Identitätsanbieter gesendet wurde, um den Benutzernamen für das entsprechende Benutzerkonto auf GitHub zu bestimmen. Wenn dieser Wert nicht unterstützte Zeichen enthält, normalisiert GitHub Enterprise Cloud den Benutzernamen gemäß der folgenden Regeln.

1. GitHub Enterprise Cloud normalisieren 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 zum selben GitHub Enterprise Cloud-Benutzernamen normalisiert werden, wird nur das erste Benutzerkonto erstellt. Nachfolgende Benutzer mit demselben Benutzernamen können sich nicht anmelden. Weitere Informationen findest du unter Beheben von Problemen mit Benutzernamen.

Beispiele für die Normalisierung von Benutzernamen

Bezeichner des Anbieters	Normalisierter Benutzername auf GitHub.com	Ergebnis
The.Octocat	the-octocat_SHORT-CODE	Dieser Benutzername wird erfolgreich erstellt.
!The.Octocat	-the-octocat_SHORT-CODE	Dieser Benutzername wird nicht erstellt, da er mit einem Bindestrich beginnt.
The.Octocat!	the-octocat-_SHORT-CODE	Dieser Benutzername wird nicht erstellt, da er mit einem Bindestrich endet.
The!!Octocat	the--octocat_SHORT-CODE	Dieser Benutzername wird nicht erstellt, da er zwei aufeinanderfolgende Bindestriche enthält.
The!Octocat	the-octocat_SHORT-CODE	Dieser Benutzername wird nicht erstellt. Obwohl der normalisierte Benutzername gültig ist, ist er bereits vorhanden.
The.Octocat@example.com	the-octocat_SHORT-CODE	Dieser Benutzername wird nicht erstellt. Obwohl der normalisierte Benutzername gültig ist, ist er bereits vorhanden.
internal\\The.Octocat	the-octocat_SHORT-CODE	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_SHORT-CODE	Dieser Benutzername wird nicht erstellt, da er den Grenzwert von 39 Zeichen überschreitet.

Beheben von Problemen mit Benutzernamen

Wenn bei der Bereitstellung eines neuen Benutzers der Benutzername länger als 39 Zeichen ist (einschließlich Unterstrich und Kurzcode) oder mit einem bereits vorhandenen Benutzer im Unternehmen in Konflikt steht, schlägt der Bereitstellungsversuch mit dem Fehler 409 fehl.

Um dieses Problem zu lösen, musst du eine der folgenden Änderungen in deinem Identitätsanbieter vornehmen, damit alle normalisierten Benutzernamen innerhalb der Zeichenobergrenze liegen und eindeutig sind.

• Ändere den Wert des Attributs userName für einzelne Benutzer, die Probleme verursachen.
• Ändere die Zuordnung des Attributs userName für alle Benutzer.
• Konfiguriere für alle Benutzer ein benutzerdefiniertes Attribut userName.

Wenn du die Attributzuordnung änderst, werden Benutzernamen vorhandener verwaltete Benutzerkonten aktualisiert, jedoch ändert sich nichts weiter an den Konten, auch nicht am Aktivitätsverlauf.

Beheben von Problemen mit Benutzernamen mit Entra ID

Um Probleme mit Benutzernamen in Entra ID zu beheben, ändere entweder den Wert des Benutzerprinzipalnamens für den in Konflikt stehenden Benutzer oder die Attributzuordnung für das Attribut userName. Wenn du die Attributzuordnung ändert, kannst du ein vorhandenes Attribut auswählen oder einen Ausdruck verwenden, um sicherzustellen, dass alle bereitgestellten Benutzer einen eindeutigen normalisierten Alias haben.

1. Öffnen Sie in Entra ID die GitHub Enterprise Managed User-Anwendung.
2. Klicke auf der linken Randleiste auf Bereitstellung.
3. Klicke auf Bereitstellung bearbeiten.
4. Erweitern Sie Zuordnungen und klicken Sie dann auf Benutzer der Entra-ID bereitstellen.
5. Klicke auf die userName-Attributzuordnung von GitHub.
6. Ändere die Attributzuordnung.
   • Wenn Sie ein vorhandenes Attribut in Entra ID dem userName-Attribut in GitHub zuordnen möchten, klicken Sie auf das gewünschte Attributfeld. Speichere und warte dann, bis der Bereitstellungszyklus beginnt. Dies sollte innerhalb von ca. 40 Minuten passieren.
   • Um einen Ausdruck anstelle eines vorhandenen Attributs zu verwenden, ändere den Zuordnungstyp in „Ausdruck“, und füge dann einen benutzerdefinierten Ausdruck hinzu, der diesen Wert für alle Benutzer eindeutig macht. Du kannst beispielsweise [FIRST NAME]-[LAST NAME]-[EMPLOYEE ID] verwenden. Weitere Informationen finden Sie unter Referenz zum Schreiben von Ausdrücken für Attributzuordnungen in Microsoft Entra ID auf Microsoft Learn.

Beheben von Problemen mit Benutzernamen mit Okta

Um Probleme mit Benutzernamen in Okta zu beheben, aktualisiere die Attributzuordnungseinstellungen für die GitHub Enterprise Managed User-Anwendung.

1. Öffne in Okta die GitHub Enterprise Managed User-Anwendung.
2. Klicke auf Anmelden.
3. Klicke im Abschnitt „Einstellungen“ auf Bearbeiten.
4. Aktualisiere das „Format für den Anwendungsbenutzernamen“.