---
sourceDocument: Xanadu – IT Asset Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/it-asset-management

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu – IT Asset Management

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Integration mit GitHub Enterprise Server

# Integration mit GitHub Enterprise Server {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

Sie können Ihre Instanz ServiceNow mit der Anwendung GitHub Enterprise Server integrieren, um Ihre Softwareabonnements nachzuverfolgen und nicht verwendete Lizenzen zurückzufordern.  
Wichtig:  
Minimieren Sie Sicherheitsrisiken und schützen Sie Informationen, indem Sie nur den erforderlichen Anwender- oder API-Berechtigungen Zugriff gewähren.{#integrating-with-github-server__table_box__entry__3}

| Prozess | Erforderliche Anwenderrolle in der Anwendung GitHub Enterprise Server | Authentifizierungsbereiche |
|-|-|-|
| Abonnements herunterladen | Site-Administrator | Site_Administrator |
| Abonnement zurückfordern | Site-Administrator | Site_Administrator |
[Tabelle : 1. Minimale Benutzerberechtigungen]

{#integrating-with-github-server__box-title}

## Generieren Sie ein API-Zugriffstoken für GitHub Enterprise Server {#ariaid-title2}

Generieren Sie ein Token, das Sie für den Zugriff auf die Enterprise Server-API GitHub verwenden können.

### Vorbereitungen

GitHub Erforderliche Rolle: Site-Administrator

### Warum und wann dieser Vorgang ausgeführt wird

Der Hosting-Service für das GitHub -Repository 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 Generieren eines persönlichen Zugriffstokens zum Autorisieren Ihrer GitHub Enterprise Server-API-Anforderungen können Sie auf die GitHub Enterprise Server-API zugreifen.

### Prozedur

1. Öffnen Sie in einem Webbrowser die Instanz Ihres GitHub Enterprise Server.
2. Melden Sie sich bei Ihrem Konto GitHub an.
3. Wählen Sie im Header der Seite GitHub Ihr Profilfoto und 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. Wählen Sie auf der Seite Persönliche Zugriffstoken die Option Neues Token generierenaus.
7. Wenn Sie aufgefordert werden, Ihr Passwort zu bestätigen, bevor Sie fortfahren, geben Sie Ihr Passwort GitHub ein, und wählen Sie dann Passwort bestätigenaus.
8. Beschreiben Sie im Formular Neues persönliches Zugriffstoken den Zweck des Tokens im Feld Notiz.
9. Aktivieren Sie im Formularabschnitt „Bereiche auswählen" den OAuth-Bereich „site_admin", indem Sie das Kontrollkästchen „ site_admin " aktivieren.  
   OAuth-Bereiche schränken die Zugriffsebene ein, die die Anwendung auf Ihre geschützten Ressourcen hat. Mit dem OAuth-Bereich „site_admin" können Sie Ihre Unternehmensanwender, Organisationen und Repositorys verwalten.
10. Wählen Sie Token generieren aus.  
    Ihr persönliches Zugriffstoken wird generiert.
11. Kopieren Sie das Zugriffstoken, und speichern Sie es zur späteren Verwendung an einem sicheren Ort.
{#generate-api-key-github-server__steps_n2p_pn5_vnb}

## Erstellen Sie eine GitHub Enterprise Server-Verbindung {#ariaid-title3}

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

### Vorbereitungen

Wenn Sie einen MID-Server für die Kommunikation zwischen Ihrer Instanz ServiceNow 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](https://www.servicenow.com/docs/access?context=mid-server-landing&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

ServiceNow Erforderliche Rolle: admin

### Prozedur

1. Navigieren Sie in Ihrer Instanz von ServiceNow zu ProzessautomatisierungFlow Designer.  
   Flow Designer wird auf einer neuen Registerkarte gestartet.
2. Wählen Sie die Registerkarte Verbindungen.
3. Wählen Sie Details für Ihre GitHub Serververbindung anzeigen.
4. Suchen Sie in der Liste der verfügbaren Verbindungen nach dem Server GitHub, und wählen Sie dann Konfigurierenaus.
5. Füllen Sie die Felder im Dialogfeld „Verbindung konfigurieren" aus.  
   {#create-github-server-connection__table_skk_54h_wnb__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Verbindungsname | Name der GitHub Serververbindung. |
   | Verbindungs-URL | URL Ihrer Instanz GitHub. |
   | MID-Server verwenden | Option, die Ihrer -Instanz ServiceNow die Verwendung eines MID-Server für die Kommunikation mit Ihren GitHub Enterprise Server-Anwendungen ermöglicht. * Wenn Ihre Instanz MID-Servererfordert, legen Sie dieses Feld auf <kbd class="ph userinput">true</kbd>fest. * Lassen Sie dieses Feld leer, wenn für Ihre Instanz kein MID-Servererforderlich ist. {#create-github-server-connection__ul_vqw_gjr_dcc} Wichtig: Um diese Option zu aktivieren, müssen Sie in Ihrer -Instanz bereits ein MID-Server -Element eingerichtet haben. Ausführliche Anweisungen finden Sie [unter MID-Server](https://www.servicenow.com/docs/access?context=mid-server-landing&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). |
   | API Key | Persönliches Zugriffstoken, mit dem Sie auf die Enterprise Server-API GitHub zugreifen können. Geben Sie <kbd class="ph userinput">&lt;<var class="keyword varname">api-key</var>&gt;</kbd>ein, wobei \<<var class="keyword varname">api-key</var>\> das persönliche Zugriffstoken ist, das Sie in [Generieren Sie ein API-Zugriffstoken für GitHub Enterprise Server](https://servicenow-prod.fluidtopics.net/zYhij4IiyRXkaBXfpGAMFA#generate-api-key-github-server "Generieren Sie ein Token, das Sie für den Zugriff auf die Enterprise Server-API GitHub verwenden können.")generiert haben. |
   [Tabelle : 2. Dialogfeld „Verbindung konfigurieren".]

   {#create-github-server-connection__table_skk_54h_wnb}
6. Wählen Sie Verbindung konfigurieren aus.
{#create-github-server-connection__steps_wpm_dth_wnb}

## Erstellen Sie ein GitHub Enterprise Server-Integrationsprofil {#ariaid-title4}

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

### Vorbereitungen

Zum Erstellen eines GitHub Enterprise Server-Integrationsprofils fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (com.sn_sam_saas_int) im [ServiceNow Store](https://store.servicenow.com/)an.

ServiceNow Erforderliche Rolle: sam_integrator oder admin

### Warum und wann dieser Vorgang ausgeführt wird

Wenn Sie Software-Asset-Arbeitsbereichverwenden, ist die Option zum Erstellen des Serverintegrationsprofils GitHub in Core-UI inaktiv.

### Prozedur

1. Navigieren Sie zum -Integrationsprofil.

   | Schnittstelle | Aktion |
   | Core-UI | 1. Navigieren zu AlleSoftware AssetSaaS-LizenzProfile für direkte Integration. 2. Wählen Sie Neu. 3. Wählen Sie das GitHub-Server-Abonnementprofil aus. {#create-integration-profile-github-server__ol_ijd_bjk_qtb} |
   | Software-Asset-Arbeitsbereich | 1. Navigieren zu LizenzvorgängeAnwenderabonnementsProfile für direkte Integration. 2. Wählen Sie Neu. 3. Wählen Sie in der Dropdown-Liste GitHub-Server aus. 4. Wählen Sie Fortsetzen aus. {#create-integration-profile-github-server__ol_wjd_bjk_qtb} |
   |-|-|

   {#create-integration-profile-github-server__choicetable_o3p_z3k_qtb}
2. Füllen Sie die Felder des Formulars aus.  
   {#create-integration-profile-github-server__table_wqc_y5h_wnb__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Name | Name des Integrationsprofils. Beispiel: <kbd class="ph userinput">GitHub-Serverintegration</kbd>. |
   | Verbindung und Anmeldeinformationen | Alias für Verbindungen und Anmeldeinformationen für die GitHub -Spoke. 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 Entwurffestgelegt. * Wenn Sie das Integrationsprofil bereits veröffentlicht haben, wird dieses Feld automatisch auf Veröffentlichtgesetzt. {#create-integration-profile-github-server__ul_lc3_tjr_dcc} |
   | Profiltyp | Integrationsprofiltyp. Dieses Feld wird automatisch auf github_server_subscription festgelegt. |
   [Tabelle : 3. Formular „Integrationsprofil".]

   {#create-integration-profile-github-server__table_wqc_y5h_wnb}
3. Stellen Sie auf der Registerkarte Subflow zum Herunterladen des Abonnements sicher, dass das Feld Subflow auf GitHub Server Download Subscriptionsfestgelegt ist.  
   Sie können Ereignisse anzeigen, die von einzelnen Anwendern bis zu einem Jahr vor dem aktuellen Datum durchgeführt wurden. Weitere Informationen finden Sie unter [Überprüfen Sie eine Softwarereklamationsregel](https://servicenow-prod.fluidtopics.net/N~LqaOTb~b624x0iPfd7~g "Verwenden Sie Reklamationsregeln, um Benutzerabonnements zu stornieren, für die eine Beschränkung auf keine Aktivität festgelegt wurde.").  
   Hinweis:  
   Software Asset Management ruft die Ereignisse 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 „Subflow Abonnement zurückfordern" sicher, dass das Feld Subflow auf GitHub Server Abonnementzurückfordern festgelegt ist.
5. Wählen Sie Speichern.  
   Ihre Instanz ServiceNow erstellt einen Integrationsprofilentwurf. Das -Integrationsprofil verwendet die Subflows GitHub \] Serverdownload-Abonnements und GitHub Serverrückforderungsabonnements, um Daten aus Ihren GitHub Enterprise Server-Anwendungen abzurufen.
6. Nachdem das Formular neu geladen wurde, wählen Sie Veröffentlichen.
7. Wählen Sie im Dialogfeld „Bestätigung veröffentlichen" die Option OKaus.
{#create-integration-profile-github-server__steps_hkb_zxh_wnb}

### Nächste Maßnahme

Nachdem die Integration hergestellt wurde, erstellt Ihre Instanz ServiceNow automatisch Softwaremodelle, Reklamationsregeln und Benutzerabonnements, die täglich aktualisiert werden.

Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter [Überprüfen Sie eine Softwarereklamationsregel](https://servicenow-prod.fluidtopics.net/N~LqaOTb~b624x0iPfd7~g "Verwenden Sie Reklamationsregeln, um Benutzerabonnements zu stornieren, für die eine Beschränkung auf keine Aktivität festgelegt wurde.").  
Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software im Vergleich zu eigener Software nachzuverfolgen.

* Weitere Informationen zum Erstellen von Softwareberechtigungen in der klassischen Anwendung \[ Software Asset Management finden Sie unter [Erstellen Sie Berechtigungen in Software Asset Management Classic](https://servicenow-prod.fluidtopics.net/cXIPH2Gt1MySV1Nq1EFh_w "Erstellen Sie Berechtigungen in der klassischen Anwendung Software Asset Management, um Ihre -Lizenzdetails aufzuzeichnen und erworbene Softwarerechte Benutzern oder Geräten zuzuweisen.").
* Weitere Informationen zum Erstellen von Softwareberechtigungen im Software-Asset-Arbeitsbereich finden Sie unter [Erstellen Sie Berechtigungen im Arbeitsbereich](https://servicenow-prod.fluidtopics.net/IeYNOyHDtVZ1wYkgPqMj~w "Erstellen Sie im Software-Asset-Arbeitsbereich Berechtigungen, um Lizenzdetails einzugeben und erworbene Softwarerechte Benutzern oder Geräten zuzuweisen.").
* Weitere Informationen zum Erstellen von Softwareberechtigungen mit dem Playbook Software Asset Management finden Sie unter [Erstellen Sie Berechtigungen mithilfe der geführten Tour](https://servicenow-prod.fluidtopics.net/8bbgwiXjQy2FWTBmtCjVMQ "Verwenden Sie das Playbook mit geführten Anleitungen, um eine schrittweise Anleitung zum Erstellen von Berechtigungen zu erhalten.").
{#create-integration-profile-github-server__ul_cbz_vhr_sqb}  
Der Abgleich wird für Ihre Abonnements auch als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichergebnisse in der [Lizenz-Workbench](https://servicenow-prod.fluidtopics.net/Ffzv17MfqitHYVJScRk2ng "Überprüfen Sie die Abgleichergebnisse in einer vereinfachten Workbench-Ansicht.") (Software Asset Management klassische Anwendung) oder in der [Ansicht](https://servicenow-prod.fluidtopics.net/2ZfLQdvo_8r0dxKfDLMJgQ "Verwenden Sie die Lizenznutzungsansicht als zentrale Anzeige, um die Lizenzposition aller Softwareprodukte zu verstehen, Nicht-Compliance zu beheben, Abgleichergebnisse anzuzeigen, Kandidaten für die Entfernung anzuzeigen oder hinzuzufügen und Software Asset Management -bezogene Berichte anzuzeigen.") Lizenznutzung (Software Asset Workspace) anzeigen. Verwenden Sie diese Ergebnisse, um Ihre Position bei der Lizenz-Compliance zu bestimmen und etwaige Nichteinhaltungen zu beheben.

* Weitere Informationen zum Ausführen des Abgleichs in der klassischen Anwendung \[ Software Asset Management finden Sie unter [Führen Sie einen Softwareabgleich aus](https://servicenow-prod.fluidtopics.net/wb0JsxI~BDh_r6xUtDh6_Q "Ein Abgleich wird als regelmäßige Aufgabe ausgeführt (Standard ist wöchentlich). Sie können den Abgleich jedoch auch manuell ausführen, um Softwareprodukte in Ihrer Umgebung bei Bedarf abzugleichen.").
* Weitere Informationen zum Ausführen des Abgleichs im Software-Asset-Arbeitsbereich finden Sie unter [Führen Sie im -Arbeitsbereich einen Softwareabgleich aus](https://servicenow-prod.fluidtopics.net/t9JtZWw66qlUhV5rh6o~Rg "Der Abgleich wird als regelmäßige Aufgabe ausgeführt (standardmäßig einmal pro Woche). Sie können den Abgleich jedoch auch manuell ausführen, um Softwareprodukte im Software-Asset-Arbeitsbereich nach Bedarf abzugleichen.").
{#create-integration-profile-github-server__ul_qgf_zhr_sqb}

