Skip to main content

Problembehandlung bei der Lizenznutzung für GitHub Enterprise

Du kannst die Problembehandlung bei der Lizenznutzung für dein Unternehmen durchführen, indem du Lizenzberichte überwachst.

Wer kann dieses Feature verwenden?

Enterprise owners can review license usage for GitHub Enterprise.

Informationen zur unerwarteter Lizenznutzung

Bei einer unerwarteten Anzahl für dein Unternehmen genutzter Lizenzen kannst du deine Lizenznutzung anhand des Berichts über genutzte Lizenzen in allen deinen Unternehmensbereitstellungen und Abonnements überwachen. Weitere Informationen findest du unter Anzeigen der Lizenznutzung für GitHub Enterprise und unter Abonnement und Nutzung für dein Enterprise-Konto anzeigen.

Wenn du Fehler findest, kannst du die Schritte zur Problembehandlung ausprobieren.

Aus Datenschutzgründen können Unternehmensbesitzer*innen nicht direkt auf die Details von Benutzerkonten zugreifen, es sei denn, du verwendest Enterprise Managed Users.

Informationen zur Berechnung der verbrauchten Lizenzen

Hinweis: Informationen zu Visual Studio-Abonnenten finden Sie unter „Informationen zu Visual Studio-Abonnements mit GitHub Enterprise“.

Eine Person beansprucht eine Lizenz für GitHub Enterprise in Abhängigkeit von bestimmten Kriterien. Wenn ein Benutzer eine Einladung zum Beitritt zu Ihrem Unternehmen noch nicht angenommen hat, verbraucht er trotzdem eine Lizenz. Weitere Informationen zu den Personen in deinem Unternehmen, die eine Lizenz nutzen, findest du unter Informationen zur benutzerabhängigen Preisgestaltung.

Für jeden Benutzerin, der bzw. die einen einzelnen Arbeitsplatz verwendet, musst du unabhängig von der jeweils genutzten Anzahl von Bereitstellungen die Lizenznutzung zwischen GitHub Enterprise Server und GitHub Enterprise Cloud synchronisieren. Weitere Informationen findest du unter Synchronisieren der Lizenzverwendung zwischen GitHub Enterprise Server und GitHub Enterprise Cloud.

Nachdem du die Lizenznutzung synchronisiert hast, ordnet GitHub Benutzerkonten auf GitHub Enterprise Server Benutzerkonten auf GitHub Enterprise Cloud nach E-Mail-Adresse zu.

Zunächst überprüfen wir die primäre E-Mail-Adresse der einzelnen Benutzer*innen auf GitHub Enterprise Server. Anschließend versuchen wir, diese Adresse der E-Mail-Adresse für ein Benutzerkonto auf GitHub Enterprise Cloud zuzuordnen. Wenn Ihr Unternehmen bei GitHub.com oder einer der Organisationen des Unternehmens die SAML-Authentifizierung oder SCIM-Bereitstellung verwendet, überprüfen wir zuerst die verknüpften SAML- oder SCIM-Identitäten, um festzustellen, ob die Identität eines der folgenden Attribute enthält. Wir versuchen, die Werte dieser Attribute mit der primäre E-Mail-Adresse jedes GitHub Enterprise Server-Benutzers abzugleichen.

  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • username
  • NameID
  • emails

Wenn es keine Übereinstimmung gibt oder die SAML-Authentifizierung oder SCIM-Bereitstellung nicht verwendet wird, versuchen wir, die primäre E-Mail-Adresse auf GitHub Enterprise Server mit einer überprüften E-Mail-Adresse für ein Benutzerkonto auf GitHub.com abzugleichen. Weitere Informationen zur Überprüfung von E-Mail-Adressen auf GitHub.com findest du unter Deine E-Mail-Adresse verifizieren.

Felder in den Dateien mit genutzten Lizenzen

Der GitHub.com-Lizenznutzungsbericht und die exportierte GitHub Enterprise Server-Lizenznutzungsdatei umfassen eine Vielzahl von Feldern zur Problembehandlung bei der Lizenznutzung für dein Unternehmen.

GitHub.com-Lizenznutzungsbericht (CSV-Datei)

Der Lizenznutzungsbericht für dein Unternehmen ist eine CSV-Datei, die die folgenden Informationen zu Mitgliedern deines Unternehmens enthält. Einige Felder sind spezifisch für deine GitHub Enterprise Cloud-Bereitstellung (GHEC), verbundenen GitHub Enterprise Server-Umgebungen (GHES) oder deine Visual Studio-Abonnements (VSS) mit GitHub Enterprise.

FeldBeschreibung
github_com_loginDer Benutzername für das GHEC-Konto des Benutzers bzw. der Benutzerin
github_com_nameDer Anzeigename für das GHEC-Konto des Benutzers bzw. der Benutzerin
github_com_profileDie URL für die Profilseite des Benutzers bzw. der Benutzerin auf GHEC
github_com_userOb der Benutzer bzw. die Benutzerin über ein Konto auf GHEC verfügt
github_com_member_rolesDer Name der Organisation und die Rolle des Benutzers bzw. der Benutzerin in dieser Organisation (Owner oder Member), getrennt durch einen Doppelpunkt (für jede der Organisationen, denen der Benutzer bzw. die Benutzerin auf GHEC angehört)

Durch Kommas getrennte Organisationen
github_com_enterprise_roleMögliche Werte: Owner, Member, Outside collaborator (für ein Unternehmen mit persönlichen Konten auf GitHub.com) oder Repository collaborator (für ein Unternehmen, das verwaltete Benutzerkonten auf GitHub.com nutzt)
github_com_verified_domain_emailsAlle dem GHEC-Konto des Benutzers bzw. der Benutzerin zugeordneten E-Mail-Adressen, die den verifizierten Domänen deines Unternehmens entsprechen
github_com_saml_name_idDer SAML-Benutzername
github_com_orgs_with_pending_invitesAlle ausstehenden Einladungen für das GHEC-Konto des Benutzers bzw. der Benutzerin zur Teilnahme an Organisationen innerhalb deines Unternehmens
github_com_advanced_security_license_userOb der Benutzer eine GitHub Advanced Security Lizenz für GHEC nutzt oder nicht
license_typeMögliche Werte: Visual Studio subscription oder Enterprise
enterprise_server_userOb der Benutzer mindestens ein Konto auf GHES hat oder nicht
enterprise_server_primary_emailsDie primären E-Mail-Adressen, die jedem der GHES-Konten des Benutzers bzw. der Benutzerin zugeordnet sind
enterprise_server_user_idsDie Benutzer-ID des Kontos (für jedes der GHES-Konten des Benutzers bzw. der Benutzerin)
enterprise_server_advanced_security_user_idsDie GHES-Instanzen, auf denen der Benutzer GitHub Advanced Security verwendet (nur vorhanden, wenn Sie GHES Version 3.12 oder höher verwenden und Lizenzsynchronisierung aktiviert haben)
total_user_accountsDie Gesamtzahl der Konten, über die die Person sowohl auf GHEC als auch auf GHES verfügt
visual_studio_subscription_userOb der Benutzer ein Visual Studio-Abonnent ist oder nicht
visual_studio_subscription_emailDie E-Mail-Adresse, die dem VSS des Benutzers bzw. der Benutzerin zugeordnet ist
visual_studio_license_statusOb die Visual Studio-Lizenz einem bzw. einer GitHub-Benutzer*in entspricht.

Exportierte GitHub Enterprise Server-Lizenznutzung (JSON-Datei)

Deine GitHub Enterprise Server-Lizenznutzung ist eine JSON-Datei, die in der Regel beim Ausführen einer manuellen Synchronisierung von Benutzerlizenzen zwischen GitHub Enterprise Server und GitHub Enterprise Cloud-Bereitstellungen verwendet wird. Die Datei enthält die folgenden Informationen, die für deine GitHub Enterprise Server-Umgebung spezifisch sind.

FeldBESCHREIBUNG
FeaturesDas Datum und die Uhrzeit der Aktivierung sind die auf deiner GitHub Enterprise Server-Instanz aktivierten GitHub Connect-Features.
HostnameDer Hostname deiner GitHub Enterprise Server-Instanz.
Nur HTTPOb Transport Layer Security (TLS) aktiviert und für deine GitHub Enterprise Server-Instanz konfiguriert ist. Kann True oder False sein.
LizenzEin Hash deiner GitHub Enterprise Server-Lizenz.
Öffentlicher SchlüsselDer Teil deiner GitHub Enterprise Server-Lizenz, der ein öffentlicher Schlüssel ist.
Server-IDUUID, die für deine GitHub Enterprise Server-Instanz generiert wurde.
VersionDie Version deiner GitHub Enterprise Server-Instanz.

Problembehandlung bei genutzten Lizenzen

Um sicherzustellen, dass jeder Benutzer bzw. jede Benutzerin nur einen Arbeitsplatz für verschiedene Bereitstellungen und Abonnements verwendet, probiere die folgenden Schritte zur Problembehandlung aus.

  1. Wenn dein Unternehmen verifizierte Domänen für GitHub Enterprise Cloud verwendet, überprüfe die Liste der Unternehmensmitglieder, die keine E-Mail-Adresse aus einer verifizierten Domäne haben, welche mit ihrem Konto auf GitHub.com verknüpft ist, um Benutzer*innen zu ermitteln, die mehrere Arbeitsplätze verbrauchen. Häufig sind dies die Benutzer, die versehentlich mehr als eine Arbeitsplatzlizenz nutzen. Weitere Informationen findest du unter Anzeigen von Personen in deinem Unternehmen.

    Hinweis: Zur Erleichterung der Problembehandlung empfehlen wir die Verwendung verifizierter Domänen mit deinem Unternehmenskonto auf GitHub.com. Weitere Informationen findest du unter Überprüfen oder Genehmigen einer Domäne für dein Unternehmen.

  2. Nachdem du Benutzer*innen identifiziert hast, die mehrere Arbeitsplätze verwenden, stelle sicher, dass die gleiche E-Mail-Adresse allen Konten des Benutzers bzw. der Benutzerin zugeordnet ist. Weitere Informationen dazu, welche E-Mail-Adressen übereinstimmen müssen, findest du unter Informationen zur Berechnung der verbrauchten Lizenzen.

  3. Wenn eine E-Mail-Adresse kürzlich aktualisiert oder überprüft wurde, um eine Übereinstimmung zu korrigieren, zeige den Zeitstempel des letzten Lizenzsynchronisierungsauftrags an. Wenn ein Auftrag seit der Korrektur nicht ausgeführt wurde, löse manuell einen neuen Auftrag aus. Weitere Informationen findest du unter Synchronisieren der Lizenzverwendung zwischen GitHub Enterprise Server und GitHub Enterprise Cloud.

Wenn du nach der Einsicht der oben genannten Problembehandlungsinformationen noch Fragen zu deinen genutzten Lizenzen hast, kannst du dich über das GitHub-Supportportal an den GitHub-Support wenden.