Integrieren Sie mit GitHub Unternehmensserver

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 7 Minuten Lesedauer

    • Integration von Software Asset Management Anwendung mit GitHub Mit der Enterprise Server-Anwendung können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

    Wichtig:
    Minimieren Sie Sicherheitsrisiken, und schützen Sie Informationen, indem Sie nur den erforderlichen Anwender- oder API-Berechtigungen Zugriff gewähren.
    Tabelle : 1. Minimale Anwenderberechtigungen
    Prozess Erforderliche Anwenderrolle in GitHub Enterprise Server-Anwendung Authentifizierungsbereiche
    Abonnements herunterladen Site-Administrator Site_admin
    Abonnement zurückfordern Site-Administrator Site_admin

    Generieren Sie ein API-Zugriffstoken für GitHub Unternehmensserver

    Generieren Sie ein Token, mit dem Sie auf zugreifen können GitHub Unternehmensserver-API.

    Vorbereitungen

    GitHub Erforderliche Rolle: Site-Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Die GitHub Der Repository-Hosting-Service verwendet persönliche Zugriffstoken, um Anwendern Zugriff auf zu gewähren GitHub API. Persönliche Zugriffstoken funktionieren ähnlich wie OAuth-Zugriffstoken, indem API-Anforderungen autorisiert werden. Indem Sie ein persönliches Zugriffstoken generieren, um Ihre zu autorisieren GitHub Enterprise Server-API-Anforderungen, können Sie Zugriff auf erhalten GitHub Unternehmensserver-API.

    Prozedur

    1. Öffnen Sie in einem Webbrowser Ihren GitHub Enterprise-Serverinstanz.
    2. Melden Sie sich bei an GitHub Account.
    3. Auf GitHub Seitenheader, wählen Sie Ihr Profilfoto aus, und wählen Sie dann aus Einstellungen .
      Ihre Profileinstellungen sind geöffnet.
    4. Wählen Sie im linken Navigationsbereich aus Entwicklereinstellungen .
      Ihre Entwicklereinstellungen werden geöffnet.
    5. Wählen Sie im linken Navigationsbereich aus Persönliche Zugriffstoken .
    6. Wählen Sie auf der Seite „persönliche Zugriffstoken“ die Option aus Neues Token generieren .
    7. Wenn Sie aufgefordert werden, Ihr Passwort zu bestätigen, bevor Sie fortfahren, geben Sie ein GitHub Passwort, und wählen Sie dann aus Passwort bestätigen .
    8. Beschreiben Sie im Formular „Neues persönliches Zugriffstoken“ den Zweck des Tokens in Hinweis Feld.
    9. Aktivieren Sie im Formularabschnitt „Bereiche auswählen“ den OAuth-Bereich „Site_admin“, indem Sie auswählen Site_admin Kontrollkästchen.
      OAuth-Umfänge beschränken die Zugriffsebene, die die Anwendung auf Ihre geschützten Ressourcen hat. Mit dem OAuth-Bereich „Site_admin“ können Sie Ihre Enterprise-Anwender, Organisationen und Repositorys verwalten.
    10. Wählen Sie Aus Token generieren .
      Ihr persönliches Zugriffstoken wird generiert.
    11. Kopieren Sie das Zugriffstoken, und speichern Sie es zur späteren Verwendung an einem sicheren Ort.

    Erstellen Sie ein GitHub Integrationsprofil für Enterprise Server

    Erstellen Sie ein GitHub Enterprise Server-Integrationsprofil, um Softwareabonnements nachzuverfolgen und die Lizenzierung für zu optimieren GitHub Enterprise Server-Anwendungen.

    Vorbereitungen

    Zum Erstellen von GitHub Enterprise Server-Integrationsprofil, fordern Sie an Software Asset Management– SaaS-Lizenzmanagement Plugin (sn_sam_saas_int) von ServiceNow-Speicher .

    ServiceNow Erforderliche Rolle: sam_Integrator

    Wichtig:
    Sie müssen auswählen GitHub-Spoke Kontrollkästchen für diese Integration beim Installieren optionaler Funktionen auf Application Manager Seite. Weitere Informationen zur Auswahl der erforderlichen SaaS-Anwendungen finden Sie unter SaaS-Lizenzmanagement anfordern.

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie verwenden Software-Asset-Arbeitsbereich, Die Option zum Erstellen von GitHub Serverintegrationsprofil in Core-UI Ist inaktiv.

    Prozedur

    1. Navigieren Sie zum Integrationsprofil.
      SchnittstelleAktion
      Core-UI
      1. Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integrationan.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus GitHub-Server-Abonnementprofil .
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofilean.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus GitHub-Server Aus der Dropdown-Liste.
      4. Wählen Sie Fortsetzen.
    2. Füllen Sie im Formular die Felder aus.
      Tabelle : 2. Integrationsprofilformular
      Feld Beschreibung
      Anzeigename Name des Integrationsprofils. Beispiel: GitHub-Serverintegration .
      Status Status des Integrationsprofils.
      • Wenn Sie das Integrationsprofil nicht veröffentlicht haben, wird dieses Feld automatisch auf festgelegt Entwurf .
      • Wenn Sie das Integrationsprofil bereits veröffentlicht haben, wird dieses Feld automatisch auf festgelegt Veröffentlicht .
      Profiltyp Integrationsprofiltyp. Dieses Feld wird automatisch auf festgelegt github_Server_Subscription .
    3. Überprüfen Sie im Abschnitt „Prozesskonfiguration“ die erforderlichen Anwenderrollen oder API-Berechtigungen, die in angegeben sind Lieferantenkonfiguration Feld für jeden Prozess, um Sicherheitsrisiken zu minimieren und zu optimieren SaaS Lizenzen.
      Hinweis:
      Weitere Informationen zu den erforderlichen Rollen und Umfängen finden Sie unter Minimale Anwenderberechtigungen Tabelle.

      • Die Abonnements herunterladen Das Kontrollkästchen ist standardmäßig aktiviert, und Sie können es nicht deaktivieren.

      • Hinweis:
        Die Aktivität Herunterladen Das Kontrollkästchen ist standardmäßig aktiviert. Wenn Sie sie löschen, die geplante Aufgabe der Aktivität SAM - Refresh <displayname> ActivityIst nicht erstellt.
        In Analysieren Sie die Anwenderaktivität Können Sie auch das Datum und die Uhrzeit auswählen, ab dem Sie die Anwenderaktivität analysieren möchten. Standardmäßig können Sie Anwenderaktivitäten bis zu 60 Tage vor dem aktuellen Datum analysieren und Ereignisse anzeigen, die von einzelnen Anwendern ab dem Zeitpunkt der Erstellung dieses Profils ausgeführt wurden.
        Hinweis:
        Software Asset Management Ruft die Ereignisse ab dem Zeitpunkt ab, zu dem Sie mit der Analyse der Anwenderaktivität beginnen, unabhängig vom Erstellungsdatum des Profils.
        Sie können diesen Wert im Feld „Schwellenwert für letzte Aktivität“ Ihrer Software-Reklamationsregeln ändern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Reklamationsregel.

      • Die Abonnements zurückfordern Das Kontrollkästchen ist standardmäßig aktiviert. Wenn Sie keine Abonnements zurückfordern möchten, können Sie dieses Kontrollkästchen deaktivieren. Wenn Sie dies löschen, werden die Entfernungskandidaten erstellt, der Subflow „Abonnement zurückfordern“ wird jedoch nicht ausgelöst, oder der Reklamationsprozess wird nicht initiiert.

    4. Wählen Sie Speichern.
      Ihr ServiceNow Instanz erstellt einen Entwurf für ein Integrationsprofil.

      Die Verbindung Und Anmeldeinformationen Feld wird angezeigt und wird automatisch auf festgelegt sn_github_spoke.GitHub_Server .

    5. Öffnen Sie den Datensatz für Aliasse für Verbindungen und Anmeldeinformationen, indem Sie das Vorschausymbol auswählen Neben Verbindung Und Anmeldeinformationen Feld und dann auswählen Datensatz Öffnen In der Datensatzvorschau.
    6. Wählen Sie im Formular Aliasse für Verbindungen und Anmeldeinformationen die aus Erstellen Sie Eine Neue Verbindung Und Anmeldeinformationen Zugehöriger Link.
    7. Füllen Sie im Dialogfeld Verbindung und Anmeldeinformationen erstellen die Felder aus.
      Tabelle : 3. Dialogfeld „Verbindung und Anmeldeinformationen erstellen“
      Feld Beschreibung
      Verbindungsname Name von GitHub Verbindung.
      Verbindungs-URL URL von GitHub API-Endpunkt.

      Eingabetaste https://api.github.com .
      MID-Server verwenden Option, die aktiviert ServiceNow Instanz, die verwendet werden soll MID-Server Für die Kommunikation mit Ihrem GitHub Cloud-Anwendungen für Unternehmen.
      • Wenn Ihre Instanz einen erfordert MID-Server, Legen Sie dieses Feld auf fest Wahr .
      • Wenn Ihre Instanz keine erfordert MID-Server, Lassen Sie dieses Feld leer.
      Wichtig:
      Um diese Option zu aktivieren, müssen Sie bereits über verfügen MID-Server Richten Sie auf Ihrer Instanz ein. Siehe MID-Server Für detaillierte Anweisungen.
      API-Schlüssel Persönliches Zugriffstoken, mit dem Sie auf zugreifen können GitHub Enterprise-Cloud-API.
      • Wenn GitHub Die installierte Spoke-Version ist 2.2.5 oder höher, geben Sie ein <api-key> .
      • Wenn GitHub Die installierte Spoke-Version ist niedriger als 2,2.5. Geben Sie die Eingabetaste ein Bearer-<api-key> .
      Die < api-Schlüssel > ist das persönliche Zugriffstoken, das Sie in generiert haben Generieren Sie ein API-Zugriffstoken für GitHub Unternehmensserver.
    8. Wählen Sie Erstellen aus.
    9. Wählen Sie im Formular „Integrationsprofil“ die Option aus Validieren Sie Die Verbindung Dient zum Überprüfen der Verbindungs- und Anmeldeinformationsdetails dieser Integration.

      Durch die Validierung der Verbindung werden die APIs „Abonnements herunterladen“ und „Aktivität berechnen“ überprüft, aber nicht die APIs „Abonnements zurückfordern“.

    10. Nachdem die Verbindung validiert wurde, wählen Sie aus Veröffentlichen .
    11. Wählen Sie im Dialogfeld „Bestätigung veröffentlichen“ die Option aus OK .
      Hinweis:
      Wenn Sie löschen Aktivität Herunterladen Kontrollkästchen nach der Veröffentlichung des Integrationsprofils müssen Sie die Verbindungen erneut validieren und dann das Integrationsprofil erneut veröffentlichen, da die folgenden Ereignisse auftreten:
      • Die Status Das Feld im Integrationsprofilformular ändert sich in Entwurf .
      • Die Validieren Sie die Verbindung Schaltfläche wird im Formular angezeigt.
      • Die aktuelle SAM - Refresh <displayname> ActivityAuftrag wird gelöscht.

    Nächste Maßnahme

    Nachdem die Integration eine Verbindung hergestellt hat, ist Ihr ServiceNow Die Instanz erstellt automatisch Softwaremodelle, Reklamationsregeln und Softwareabonnements, die täglich aktualisiert werden.

    Zeigen Sie nach dem Erstellen eines Integrationsprofils Informationen zum Profil in an Software-Asset-Arbeitsbereich Indem Sie zu navigieren Lizenzvorgänge > Anwenderabonnement > Direkte Integrationsprofilean. Sie können ein Integrationsprofil auswählen, um die folgenden zugehörigen Listen anzuzeigen. Wenn nicht alle der folgenden zugehörigen Listen für ein Integrationsprofil in der Standardansicht sichtbar sind, können Sie die anwenderdefinierte Integrationsansicht auf der Registerkarte Details auswählen:
    • Softwaremodelle
    • Nicht erkannte Abonnementbezeichner
    • Geplante Aufgaben
    • Ergebnisse der geplanten Aufgabe
    • Software-Abonnements
    • Ausschlussregel für Abonnementbezeichner
    • Ausschlussregel für Abonnementanwender

    Nach dem Erstellen eines Integrationsprofils können Sie Abonnementausschlussregeln definieren, um bestimmte Abonnements von den Berechnungen der Lizenzkosten zu befreien. Weitere Informationen finden Sie unter Abonnementausschlüsse für SaaS Und SSO-Anwendungen.

    Wenn Sie mehrere Integrationsprofile mit eindeutigen Verbindungen einrichten möchten, erstellen Sie untergeordnete Aliasse, um verschiedene Konfigurationen und Einstellungen für jedes Integrationsprofil zu verwalten. Weitere Informationen finden Sie unter Erstellen Sie einen untergeordneten Alias, um mehrere Integrationsprofile einzurichten.

    Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Reklamationsregel.

    Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software mit eigener Software zu verfolgen.
    Der Abgleich wird auch für Ihre Abonnements als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichsergebnisse in anzeigen Lizenz-Workbench ( Software Asset Management Klassische Anwendung) oder Lizenznutzungsansicht (Software-Asset-Arbeitsbereich). Verwenden Sie diese Ergebnisse, um Ihre Lizenz-Compliance-Position zu bestimmen und Nichteinhaltung zu beheben.