---
sourceDocument: Yokohama IT Asset Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/it-asset-management
Release :
- yokohama
ft:locale :
- de-DE
ft:publication_title :
- Yokohama IT Asset Management
ft:clusterId :
- itam
bundleId :
- itam
workflow :
- Technology
---
# Integrieren Sie mit GitHubEnterprise-Cloud
# Integrieren Sie mit GitHubEnterprise-Cloud {#ariaid-title1}
* Freigeben Version: Yokohama
*
* Aktualisiert 30. Januar 2025
*
*  7 Minuten Lesedauer
Integration von Software Asset ManagementAnwendung mit GitHubDie Enterprise Cloud-Anwendung hilft Ihnen, 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.{#integrate-github-cloud__table_box__entry__3}
| Prozess | Erforderliche Anwenderrolle in GitHubEnterprise-Cloud-Anwendung | Authentifizierungsbereiche |
|-|-|-|
| Abonnements herunterladen | Organisationsbesitzer | Lesen:org |
| Anwenderaktivität abrufen | Organisationsbesitzer | * Lesen:org * Repository {#integrate-github-cloud__ul_bh5_t3f_4bc} |
| Abonnement zurückfordern | Organisationsbesitzer | Schreiben:org |
[Tabelle : 1. Minimale Anwenderberechtigungen]
{#integrate-github-cloud__box-title}
## Generieren Sie ein API-Zugriffstoken für GitHubEnterprise-Cloud {#ariaid-title2}
Generieren Sie ein Token, mit dem Sie auf zugreifen können GitHubEnterprise-Cloud-API.
### Vorbereitungen
GitHub Erforderliche Rolle: Organisationsbesitzer
Der Anwender-Account, den Sie für die Authentifizierung verwenden, sollte in der Lage sein, alle Repositorys in der Organisation zu lesen, zu der er gehört.
### Warum und wann dieser Vorgang ausgeführt wird
Die GitHubDer Repository-Hosting-Service verwendet persönliche Zugriffstoken, um Anwendern Zugriff auf zu gewähren GitHubAPI. Persönliche Zugriffstoken funktionieren ähnlich wie OAuth-Zugriffstoken, indem API-Anforderungen autorisiert werden. Indem Sie ein persönliches Zugriffstoken generieren, um Ihre zu autorisieren GitHubEnterprise Cloud-API-Anforderungen, können Sie Zugriff auf erhalten GitHubEnterprise-Cloud-API.
### Prozedur
1. Öffnen Sie in einem Webbrowser [GitHub](https://github.com/).
2. Melden Sie sich bei an GitHubAccount.
3. Auf GitHubSeitenheader, 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 Aus Token (klassisch) .
7. Wählen Sie auf der Seite „persönliche Zugriffstoken" die Option aus Neues Token generieren .
8. Wählen Sie Aus Neues Token generieren (klassisch) .
9. Wenn Sie aufgefordert werden, Ihr Passwort zu bestätigen, bevor Sie fortfahren, geben Sie ein GitHubPasswort, und wählen Sie dann aus Passwort bestätigen .
10. Beschreiben Sie im Formular „Neues persönliches Zugriffstoken" den Zweck des Tokens in Hinweis Feld.
11. Um Ihrem Token einen Ablauf zu geben, wählen Sie das Dropdown-Menü „Ablauf" aus, und wählen Sie einen Standardwert aus, oder verwenden Sie die Kalenderauswahl.
12. Aktivieren Sie im Formularabschnitt „Umfänge auswählen" die OAuth-Umfänge „Repository", „write:org" und „read:org".
OAuth-Umfänge beschränken die Zugriffsebene, die die Anwendung auf Ihre geschützten Ressourcen hat. Der Repository-OAuth-Bereich bietet Ihnen die volle Kontrolle über Ihre privaten Repositorys. Mit den OAuth-Umfängen „write:org" und „read:org" können Sie Ihre gesamte Organisation verwalten, einschließlich aller Teams, Projekte und Mitgliedschaften. Siehe [Umfänge für OAuth-Apps](https://docs.github.com/en/free-pro-team@latest/developers/apps/scopes-for-oauth-apps)Für weitere Informationen zu GitHubOAuth-Umfänge.
1. Aktivieren Sie den Repository-OAuth-Bereich, indem Sie auswählen Repository Kontrollkästchen.
Durch Aktivieren dieses OAuth-Bereichs aktivieren Sie automatisch die OAuth-Bereiche „Repository:Status", „repo_Deployment", „public_repo", „repo:einladen" und „Security_Events".
2. Aktivieren Sie den OAuth-Bereich „write:org" und „read:org".
{#generate-api-key-github-cloud__substeps_uh3_zpp_wnb}
13. Wählen Sie Aus Token generieren .
Ihr persönliches Zugriffstoken wird generiert.
14. Kopieren Sie das Zugriffstoken, und speichern Sie es zur späteren Verwendung an einem sicheren Ort.
15. Um Ihr Token für den Zugriff auf Ressourcen zu verwenden, die Eigentum einer Organisation sind, die SAML Single Sign-on verwendet, autorisieren Sie das Token.
Weitere Informationen finden Sie unter [Autorisierung eines persönlichen Zugriffstoken zur Verwendung mit SAML Single Sign-on](https://docs.github.com/en/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on).
## Erstellen Sie ein GitHubEnterprise-Cloud-Verbindung {#ariaid-title3}
Erstellen Sie eine Verbindung zwischen GitHubEnterprise-Cloud-Anwendungen und Ihr ServiceNowInstanz.
### Vorbereitungen
Wenn Sie verwenden möchten MID-ServerFür die Kommunikation zwischen ServiceNowInstanz und Ihr GitHubEnterprise-Cloud-Anwendungen müssen Sie zuerst einrichten MID-ServerIn Ihrer Instanz. Siehe [MID-Server](https://www.servicenow.com/docs/access?context=mid-server-landing&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)Für detaillierte Anweisungen.
ServiceNow Erforderliche Rolle: administrator
### Prozedur
1. Von Ihrem ServiceNowInstanz, navigieren Sie zu ProzessautomatisierungFlow Designeran.
Die Registerkarte Flow Designer wird erstellt.
2. Wählen Sie aus Verbindungen Registerkarte.
3. Wählen Sie Aus Details Anzeigen Für Ihr GitHubVerbindung.
4. Suchen Sie in der Liste der verfügbaren Verbindungen nach GitHubUnd wählen Sie dann aus Konfigurieren .
5. Füllen Sie im Dialogfeld Verbindung konfigurieren die Felder aus.
{#create-github-cloud-connection__table_skk_54h_wnb__entry__2}
| Feld | Beschreibung |
|-|-|
| Verbindungsname | Name von GitHubVerbindung. |
| Verbindungs-URL | URL von GitHubAPI-Endpunkt. Eingabetaste https://api.github.com . |
| Verwenden MID-Server | Option, die aktiviert ServiceNowInstanz, die verwendet werden soll MID-ServerFür die Kommunikation mit Ihrem GitHubCloud-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. {#create-github-cloud-connection__ul_gqm_t3m_xbc} Wichtig: Um diese Option zu aktivieren, müssen Sie bereits über verfügen MID-ServerRichten Sie auf Ihrer Instanz ein. Siehe [MID-Server](https://www.servicenow.com/docs/access?context=mid-server-landing&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)Für detaillierte Anweisungen. |
| API-Schlüssel | Persönliches Zugriffstoken, mit dem Sie auf zugreifen können GitHubEnterprise-Cloud-API. * Wenn GitHubDie installierte Spoke-Version ist 2.2.5 oder höher, geben Sie ein <api-key> . * Wenn GitHubDie installierte Spoke-Version ist niedriger als 2,2.5. Geben Sie die Eingabetaste ein Bearer-<api-key> . {#create-github-cloud-connection__ul_k3s_1qw_5wb}Die \< api-Schlüssel \> ist das persönliche Zugriffstoken, das Sie in generiert haben [Generieren Sie ein API-Zugriffstoken für GitHubEnterprise-Cloud](https://servicenow-prod.fluidtopics.net/rPAz~lmZlK92adpy7rp1HA#generate-api-key-github-cloud "Generieren Sie ein Token, mit dem Sie auf zugreifen können GitHubEnterprise-Cloud-API.") |
[Tabelle : 2. Dialogfeld „Verbindung konfigurieren"]
{#create-github-cloud-connection__table_skk_54h_wnb}
6. Wählen Sie Aus Konfigurieren Sie Die Verbindung .
## Erstellen Sie ein GitHub EnterpriseCloud-Integrationsprofil {#ariaid-title4}
Erstellen Sie ein GitHub EnterpriseEnterprise Cloud-Integrationsprofil zum Nachverfolgen von Softwareabonnements und Optimieren der Lizenzierung für GitHubCloud-Anwendungen für Unternehmen.
### Vorbereitungen
Zum Erstellen von GitHub EnterpriseCloud-Integrationsprofil, fordern Sie an Software Asset Management-- SaaS-LizenzmanagementPlugin (sn_sam_saas_int) von [ServiceNow-Speicher](https://store.servicenow.com/).
ServiceNow Erforderliche Rolle: sam_Integrator oder admin
Wichtig:
Sie müssen auswählen GitHub-Spoke Kontrollkästchen für diese Integration beim Installieren optionaler Funktionen auf [Application Manager](https://www.servicenow.com/docs/access?context=application-manager&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)Seite. Weitere Informationen zur Auswahl der erforderlichen SaaS-Anwendungen finden Sie unter [SaaS-Lizenzmanagement anfordern](https://servicenow-prod.fluidtopics.net/SWZloaxScoRyfBTsRewnKQ "Fordern Sie an Software Asset Management– SaaS-LizenzmanagementPlugin (sn_sam_saas_int), damit Sie Integrationen mit erstellen und verwalten können SaaSUnd Single Sign-on (SSO)-Anwendungen. Sie können diese Integrationen verwenden, um die Lizenznutzung nachzuverfolgen und nicht verwendete Lizenzen zurückzufordern.").
### Warum und wann dieser Vorgang ausgeführt wird
Wenn Sie verwenden Software-Asset-Arbeitsbereich, Die Option zum Erstellen von GitHubCloud-Integrationsprofil in Core-UIIst inaktiv.
### Prozedur
1. Navigieren Sie zum Integrationsprofil.
| Schnittstelle | Aktion |
| Core-UI | 1. Navigieren zu AlleSoftware AssetSaaS-LizenzProfile für direkte Integrationan. 2. Wählen Sie Neu. 3. Wählen Sie Aus GitHub-Cloud-Integrationsprofil . {#create-integration-profile-github-cloud__ol_ijd_bjk_qtb} |
| Software-Asset-Arbeitsbereich | 1. Navigieren zu LizenzvorgängeAnwenderabonnementsDirekte Integrationsprofilean. 2. Wählen Sie Neu. 3. Wählen Sie Aus GitHub-Cloud Aus der Dropdown-Liste. 4. Wählen Sie Fortsetzen. {#create-integration-profile-github-cloud__ol_wjd_bjk_qtb} |
|-|-|
{#create-integration-profile-github-cloud__choicetable_o3p_z3k_qtb}
2. Füllen Sie im Formular die Felder aus.
{#create-integration-profile-github-cloud__table_wqc_y5h_wnb__entry__2}
| Feld | Beschreibung |
|-|-|
| Anzeigename | Name des Integrationsprofils. Beispiel: GitHub-Cloud-Integration . |
| 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 . {#create-integration-profile-github-cloud__ul_oyn_djm_xbc} |
| Profiltyp | Typ des Integrationsprofils. Dieses Feld wird automatisch auf festgelegt github_Cloud_Subscription . |
[Tabelle : 3. Integrationsprofilformular]
{#create-integration-profile-github-cloud__table_wqc_y5h_wnb}
3. Überprüfen Sie die erforderlichen Anwenderrollen oder API-Berechtigungen, die in angegeben sind Lieferantenkonfiguration Feld für jeden Prozess, um Sicherheitsrisiken zu minimieren und zu optimieren SaaSLizenzen.
Hinweis:
Weitere Informationen finden Sie unter [Minimale Anwenderberechtigungen](https://servicenow-prod.fluidtopics.net/rPAz~lmZlK92adpy7rp1HA#integrate-github-cloud "Integration von Software Asset ManagementAnwendung mit GitHubDie Enterprise Cloud-Anwendung hilft Ihnen, Ihre Softwareabonnements nachzuverfolgen und nicht verwendete Lizenzen zurückzufordern.")Tabelle.
1. Überprüfen Sie im Abschnitt Abonnement-Subflow herunterladen, ob die Subflow Feld ist auf festgelegt GitHub Cloud -- Abonnements herunterladen .
Hinweis:
Die Abonnements herunterladen Das Kontrollkästchen ist standardmäßig aktiviert, und Sie können es nicht deaktivieren.
Software Asset Management Ruft die Mitglieder, externen Mitarbeitenden, ausstehenden Einladungen und ausstehenden externen Mitarbeitenden ab, um einen vollständigen Überblick über Ihre GitHub Enterprise Cloud-Abonnements zu erhalten.
Wichtig:
Um ausstehende externe Mitarbeitende abzurufen, aktivieren Sie sn_sam_saas_int.pull_pending_collaborator_githubSystemeigenschaft. Eine höhere Anzahl von Repositorys würde zu einer erhöhten Anzahl von API-Transaktionen führen.
2. Überprüfen Sie im Abschnitt „Aktivitäts-Subflow berechnen", ob Subflow Feld ist auf festgelegt GitHub Cloud -- Anwenderaktivität aktualisieren .
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 \ 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](https://servicenow-prod.fluidtopics.net/1nWMyGAS9USaPpcCFrBp8g "Verwenden Sie Reklamationsregeln, um Anwenderabonnements abzubrechen, die auf keine Aktivität beschränkt sind.").
Tipp:
Um Leistungsprobleme mit diesem Subflow zu vermeiden, besteht der beste Ansatz darin, festzulegen Analysieren Sie die Anwenderaktivität aus Feld bis maximal sieben Tage vor dem aktuellen Datum.
3. Überprüfen Sie im Abschnitt Subflow „Abonnement zurückfordern", ob Subflow Feld ist auf festgelegt GitHub Cloud -- Abonnement zurückfordern .
Hinweis:
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.
{#create-integration-profile-github-cloud__substeps_rcm_pwm_vcc}
4. Wählen Sie Speichern.
Ihr ServiceNowInstanz erstellt einen Entwurf für ein Integrationsprofil.
Die Verbindung Und Anmeldeinformationen Feld wird angezeigt und wird automatisch auf festgelegt sn_github_Spoke.GitHub .
5. 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".
6. Nachdem die Verbindung verifiziert wurde, wählen Sie aus Veröffentlichen .
7. 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 \ ActivityAuftrag wird gelöscht.
{#create-integration-profile-github-cloud__ul_adf_2v3_ddc}
### Nächste Maßnahme
Nachdem die Integration eine Verbindung hergestellt hat, ist Ihr ServiceNowDie Instanz erstellt automatisch Softwaremodelle, Reklamationsregeln und Softwareabonnements, die täglich aktualisiert werden.
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](https://servicenow-prod.fluidtopics.net/Y0Uo7ezlcLuiHutjgYvLQQ "Erstellen Sie einen untergeordneten Alias, um mehrere Integrationsprofile mit eindeutigen Verbindungen einzurichten und verschiedene Konfigurationen für jedes Integrationsprofil zu verwalten.").
Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter [Überprüfen Sie eine Software-Reklamationsregel](https://servicenow-prod.fluidtopics.net/1nWMyGAS9USaPpcCFrBp8g "Verwenden Sie Reklamationsregeln, um Anwenderabonnements abzubrechen, die auf keine Aktivität beschränkt sind.").
Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software mit eigener Software zu verfolgen.
* Weitere Informationen zum Erstellen von Softwareberechtigungen finden Sie in Software Asset ManagementCore-UI, siehe [Erstellen Sie Berechtigungen in Software Asset ManagementKlassisch](https://servicenow-prod.fluidtopics.net/opVnSXksHS_8wNM28tekAg "Erstellen Sie Berechtigungen in Software Asset ManagementAnwendung klassisch, um Ihre Lizenzdetails aufzuzeichnen und Anwendern oder Geräten erworbene Softwarerechte zuzuweisen.").
* Weitere Informationen zum Erstellen von Softwareberechtigungen im Software-Asset-Arbeitsbereich finden Sie unter [Erstellen Sie Berechtigungen im Arbeitsbereich](https://servicenow-prod.fluidtopics.net/7Y2gRBoTe~ED1KeWEBWfPQ "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 Software Asset ManagementPlaybook, siehe [Erstellen Sie Berechtigungen mithilfe der geführten Walk-Through](https://servicenow-prod.fluidtopics.net/Y2PngmmQR5tENlnARLs3nw "Verwenden Sie das geführte Walk-Through-Playbook für einen Schritt-für-Schritt-Prozess zum Erstellen von Berechtigungen.").
{#create-integration-profile-github-cloud__ul_cbz_vhr_sqb}
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](https://servicenow-prod.fluidtopics.net/3~5s3QlcEcJwwH2A8ac6vQ "Überprüfen Sie die Abgleichsergebnisse in einer vereinfachten Workbench-Ansicht.")( Software Asset ManagementKlassische Anwendung) oder [Lizenznutzungsansicht](https://servicenow-prod.fluidtopics.net/Mr_Swf4Bk6D85OdjcdHdbQ "Verwenden Sie die Ansicht „Lizenznutzung“ als einzelne Ebene, um die Lizenzposition aller Softwareprodukte zu verstehen, Nichteinhaltung zu beheben, Abgleichsergebnisse anzuzeigen, Entfernungskandidaten anzuzeigen oder hinzuzufügen und anzuzeigen Software Asset ManagementZugehörige Berichte.")(Software-Asset-Arbeitsbereich). Verwenden Sie diese Ergebnisse, um Ihre Lizenz-Compliance-Position zu bestimmen und Nichteinhaltung zu beheben.
* Weitere Informationen zum Ausführen des Abgleichs finden Sie in Software Asset ManagementKlassische Anwendung, siehe [Führen Sie den Softwareabgleich in aus Software Asset ManagementKlassisch](https://servicenow-prod.fluidtopics.net/uC6DHgx7BlFvc0QrU7R_bw "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 den Softwareabgleich im Arbeitsbereich aus](https://servicenow-prod.fluidtopics.net/XsHatXBSe6M9BzuJltailA "Der Abgleich wird als geplante Aufgabe ausgeführt (Standard ist wöchentlich), Sie können den Abgleich jedoch auch manuell ausführen, um Softwareprodukte in der Umgebung des Software-Asset-Arbeitsbereichs bei Bedarf abzugleichen.").
{#create-integration-profile-github-cloud__ul_qgf_zhr_sqb}