Integrieren Sie mit GitHub Enterprise Server

Sie können Ihre Instanz von ServiceNow mit der Anwendung GitHub Enterprise Server integrieren, um Ihre Softwareabonnements nachzuverfolgen und nicht verwendete Lizenzen zurückzufordern.

Generieren Sie ein API-Zugriffstoken für GitHub Enterprise Server

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

Vorbereitungen

GitHub Erforderliche Rolle: Site-Administrator

Warum und wann dieser Vorgang ausgeführt wird

Der GitHub -Repository-Hosting-Service verwendet persönliche Zugriffstoken, um Benutzern Zugriff auf die GitHub -API zu gewähren. Persönliche Zugriffstoken funktionieren ähnlich wie OAuth-Zugriffstoken, indem sie API-Anforderungen autorisieren. Durch die Generierung eines persönlichen Zugriffstokens zur Autorisierung Ihrer GitHub Enterprise Server-API-Anforderungen erhalten Sie Zugriff auf die GitHub Enterprise Server-API.

Prozedur

  1. Öffnen Sie in einem Webbrowser Ihre GitHub Enterprise Server-Instanz.
  2. Melden Sie sich bei Ihrem GitHub -Konto an.
  3. Klicken Sie im Header der Seite GitHub auf Ihr Profilfoto, und wählen Sie dann Einstellungenaus.
    Ihre Profileinstellungen werden geöffnet.
  4. Wählen Sie im linken Navigationsbereich Entwicklereinstellungenaus.
    Ihre Entwicklereinstellungen werden geöffnet.
  5. Wählen Sie im linken Navigationsbereich Persönliche Zugriffstokenaus.
  6. Klicken Sie auf der Seite „Persönliche Zugriffstoken“ auf Neues Token generieren.
  7. Wenn Sie aufgefordert werden, Ihr Passwort zu bestätigen, bevor Sie fortfahren, geben Sie Ihr Passwort GitHub ein, und klicken Sie dann auf Passwort bestätigen.
  8. Beschreiben Sie im Formular „Neues persönliches Zugriffstoken“ den Zweck des Tokens im Feld Hinweis.
  9. Aktivieren Sie im Formularabschnitt „Bereiche auswählen“ den OAuth-Bereich site_admin, indem Sie das Kontrollkästchen site_admin aktivieren.
    OAuth-Bereiche begrenzen die Zugriffsebene der Anwendung auf Ihre geschützten Ressourcen. Mit dem OAuth-Bereich site_admin können Sie Ihre Unternehmensbenutzer, Organisationen und Repositorys verwalten.
  10. Klicken Sie auf 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 eine GitHub Enterprise Server-Verbindung

Erstellen Sie eine Verbindung zwischen Ihren GitHub Enterprise Server-Anwendungen und Ihrer ServiceNow -Instanz.

Vorbereitungen

Wenn Sie einen MID-Server für die Kommunikation zwischen Ihrer ServiceNow -Instanz und Ihren GitHub Enterprise Server-Anwendungen verwenden möchten, müssen Sie zuerst einen MID-Server in Ihrer Instanz einrichten. Ausführliche Anweisungen finden Sie unter MID Server.

ServiceNow Erforderliche Rolle: admin

Prozedur

  1. Navigieren Sie in Ihrer Instanz ServiceNow zu Prozessautomatisierung > Flow Designer.
    Der Flow Designer wird in einer neuen Registerkarte gestartet.
  2. Wählen Sie die Registerkarte Verbindungen aus.
  3. Klicken Sie auf Details anzeigen für Ihre GitHub Serververbindung.
  4. Suchen Sie in der Liste der verfügbaren Verbindungen nach GitHub Server, und klicken Sie dann auf Konfigurieren.
    Das Dialogfeld „Verbindung konfigurieren“ wird geöffnet.
  5. Füllen Sie im Dialogfeld die Felder aus.
    Tabelle : 1. Dialogfeld „Verbindung konfigurieren“.
    Feld Beschreibung
    Verbindungsname Name der GitHub Serververbindung.
    Verbindungs-URL URL Ihrer Instanz GitHub.
    MID-Server verwenden Option, mit der Ihre ServiceNow -Instanz einen MID-Server für die Kommunikation mit Ihren GitHub Enterprise Server-Anwendungen verwenden kann. Wenn für Ihre Instanz ein MID-Servererforderlich ist, legen Sie dieses Feld auf truefest. Wenn für Ihre Instanz kein MID-Servererforderlich ist, lassen Sie dieses Feld leer.
    Wichtig:
    Um diese Option zu aktivieren, muss in Ihrer Instanz bereits ein MID-Server eingerichtet sein. Ausführliche Anweisungen finden Sie unter MID Server.
    API Key Persönliches Zugriffstoken, mit dem Sie auf die GitHub Enterprise Server-API zugreifen können. Geben Sie <api-key>ein, wobei <api-key> das persönliche Zugriffstoken ist, das Sie in Generieren Sie ein API-Zugriffstoken für GitHub Enterprise Servergeneriert haben.
  6. Klicken Sie auf Verbindung konfigurieren.

Erstellen Sie ein GitHub Enterprise Server-Integrationsprofil

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

Vorbereitungen

Um ein GitHub Enterprise Server-Integrationsprofil zu erstellen, fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (com.sn_sam_saas_int) aus dem ServiceNow Storean.

ServiceNow Erforderliche Rolle: sam_integrator oder admin

Warum und wann dieser Vorgang ausgeführt wird

Wenn Sie Software Asset Workspace verwenden, ist die Option zum Erstellen des GitHub Server-Integrationsprofils in der Core-UI inaktiv.

Prozedur

  1. Navigieren Sie zum Integrationsprofil.
    SchnittstelleAktion
    Core-UI
    1. Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integration.
    2. Wählen Sie Neu.
    3. Wählen Sie GitHub-Serverabonnementprofil aus.
    Software-Asset-Arbeitsbereich
    1. Navigieren zu Lizenzvorgänge > Benutzerabonnements > Profile für direkte Integration.
    2. Wählen Sie Neu.
    3. Wählen Sie GitHub-Server aus der Dropdown-Liste aus.
    4. Wählen Sie Fortsetzen aus.
  2. Füllen Sie die Felder des Formulars aus.
    Tabelle : 2. Formular „Integrationsprofil“
    Feld Beschreibung
    Name Name des Integrationsprofils. Beispiel: GitHub-Server-Integration.
    Verbindung und Anmeldeinformationen Alias für Verbindungen und Anmeldeinformationen für die Spoke GitHub. Dieses Feld wird automatisch auf sn_github_spoke.GitHub_Server festgelegt.
    Status Status des Integrationsprofils. Wenn Sie das Integrationsprofil nicht veröffentlicht haben, wird dieses Feld automatisch auf Entwurfgesetzt. Wenn Sie das Integrationsprofil bereits veröffentlicht haben, wird dieses Feld automatisch auf Veröffentlichtgesetzt.
    Profiltyp Integrationsprofiltyp. Dieses Feld wird automatisch auf github_server_subscription festgelegt.
  3. Stellen Sie auf der Registerkarte Abonnement-Subflow herunterladen sicher, dass das Feld Subflow auf GitHub Server Download Subscriptionsfestgelegt ist.
    Sie können Events anzeigen, die von einzelnen Benutzern bis zu einem Jahr vor dem aktuellen Datum durchgeführt wurden. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Rückforderungsregel.
    Hinweis:
    Software Asset Management ruft die Events ab dem Zeitpunkt ab, zu dem Sie mit dem Herunterladen von Benutzerabonnements beginnen, unabhängig vom Datum der Profilerstellung.
  4. Stellen Sie auf der Registerkarte Abonnement-Subflow zurückfordern sicher, dass das Feld Subflow auf GitHub Server Abonnementzurückfordern festgelegt ist.
  5. Klicken Sie auf Speichern.
    Ihre Instanz ServiceNow erstellt ein Entwurfs-Integrationsprofil. Das Integrationsprofil verwendet die Subflows GitHub Server-Download-Abonnements und GitHub Server-Abonnement zurückfordern, um Daten aus Ihren GitHub Enterprise Server-Anwendungen abzurufen.
  6. Klicken Sie nach dem erneuten Laden des Formulars auf Veröffentlichen.
    Das Dialogfeld „Bestätigung veröffentlichen“ wird geöffnet.
  7. Klicken Sie im Dialogfeld auf OK.

Nächste Maßnahme

Nachdem die Integration eine Verbindung hergestellt hat, erstellt Ihre ServiceNow -Instanz automatisch Softwaremodelle, Rückforderungsregeln und Benutzerabonnements, die täglich aktualisiert werden.

Überprüfen Sie alle automatisch generierten Rückforderungsregeln, um Benutzerabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Rückforderungsregel.

Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software gegen eigene Software nachzuverfolgen.
Der Abgleich wird auch für Ihre Abonnements als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichergebnisse in der Lizenz-Workbench (klassische AnwendungSoftware Asset Management ) oder in der Lizenznutzungsansicht (Software Asset Workspace) anzeigen. Verwenden Sie diese Ergebnisse, um Ihre Lizenz-Compliance-Position zu bestimmen und etwaige Nichteinhaltungen zu beheben.