Konfigurieren Sie mit dem geführten Setup

Fähigkeiten der Zürcher ServiceNow-KI-Plattform

Release

zurich

ft:locale

de-DE

ft:publication_title

Fähigkeiten der Zürcher ServiceNow-KI-Plattform

ft:clusterId

platcap

bundleId

platcap

workflow

Platform

Konfigurieren API Service Graph Connector für Azure API Management Mit dem geführten Setup

Freigeben Version: Zurich

Aktualisiert 31. Juli 2025

9 Minuten Lesedauer

Richten Sie geplante Importaufträge zum Abrufen ein Azure API Management Daten in Ihrem CMDB.

Vorbereitungen

Wichtig:

Sofern keine Konfigurationsprobleme auftreten, verwenden Sie SGC Central Zeigen Sie in an CMDB-Arbeitsbereich Zum Konfigurieren der Verbindung für den Connector, da die Methode des geführten Setups veraltet ist.

Abhängigkeiten und Anforderungen:

Die Store-App „Integration Commons for CMDB“, die automatisch installiert wird. Siehe Integration Commons für CMDB .
Die Store-App für CMDB-CI-Klassenmodelle, die automatisch installiert wird. Weitere Informationen finden Sie unter CMDB CI-Klassenmodelle.
Das Plugin „ITOM Discovery-Lizenz“ (com.snc.itom.discovery.license). Sie müssen dieses Plugin aktivieren.
Plugin „ITOM-Lizenzierung“ (com.snc.itom.license). Weitere Informationen finden Sie unter Request Discovery.

Rufen Sie die OAuth-Anmeldeinformationen von ab Azure Administrator. Notieren Sie sich die folgenden Details:

Anwendungs-ID (Client)
Geheimer Clientschlüssel
Verzeichnis-ID (Mandant)
Verbindungs-URL

Erforderliche Rolle: Administrator

Prozedur

Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Azure API Management Anwendung mithilfe der Anwendungsauswahl.
Weitere Informationen finden Sie unter Anwendungsauswahl .
Navigieren zu Alle > Service Graph Connectors > Azure API-Verwaltung > Setupan.
Auf der API Service Graph Connector für Azure API Management Seite, überprüfen Sie, ob Schnellstart Option ist ausgewählt, und wählen Sie dann aus Fahren Sie Fort .

Konfigurieren Sie die Anmeldeinformationen für die Authentifizierung, um Anforderungen an zu senden Azure API Management Anwendung.

In Konfigurieren Sie die Verbindung und die Anmeldeinformationen Abschnitt von API Service Graph Connector für Azure API Management Seite auswählen Starten .

Konfigurieren Sie die Verbindung.

Wählen Sie aus Konfigurieren Sie Anmeldeinformationen für die Azure-Authentifizierung Aufgabe.
Wählen Sie Aus Klicken Sie Hier Dient zum Öffnen der Seite „Verbindungen“ in einer separaten Browserregisterkarte.
Suchen und wählen Sie aus Bearbeiten Für Azure API-Verwaltungsverbindung .

Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ aus.

Tabelle : 1. Verbindungsinformation
Feld	Beschreibung
Azure API-Management-Verbindungsname	Name zur Identifizierung von Azure API Management Verbindungsdatensatz. `Azure API-Verwaltungsverbindung` Ist der standardmäßige Aliasname für Anmeldeinformationen. Sie können mehrere hinzufügen Azure API-Verwaltung Instanzen. Versuchen Sie jedoch, den Standardverbindungsnamen nicht zu ändern.
Verbindungs-URL	Basis-URL für die Verbindung mit Azure API Management Service. Basierend auf der Region von Azure Client-Anwendung: Geben Sie die URL in einem der folgenden Formate ein: Global `https://management.azure.com` US-Regierung `htttps://management.usgovcloudapi.net` China `https://management.chinacloudapi.cn` Deutschland `https://management.microsoftazure.de/`

Füllen Sie die Felder im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung bearbeiten“ aus.

Tabelle : 2. Anmeldedaten
Feld	Beschreibung
OAuth-Client-ID	Anwendungs-ID (Client) Ihrer Azure-Client-Anwendung, wie in angegeben Bevor Sie beginnen Abschnitt.
OAuth-Client-Geheimnis	Geheimer Client-Schlüssel von Azure Client-Anwendung wie in angegeben Bevor Sie beginnen Abschnitt.
OAuth-Token-URL	Token-URL von Azure Client-Anwendung. Basierend auf der Region von Azure Client-Anwendung: Geben Sie die Token-URL in einem der folgenden Formate ein: Global `https://login.microsoftonline.com/<tenantid>/oauth2/v2.0/token` US-Regierung `https://login.microsoftonline.us/<tenantid>/oauth2/v2.0/token` China `https://login.partner.microsoftonline.cn/<tenantid>/oauth2/v2.0/token` Deutschland `https://login.microsoftonline.de/<tenantid>/oauth2/v2.0/token` Wo `<tenantid>` Ist die Mandanten-ID von Azure Client-Anwendung wie in angegeben Bevor Sie beginnen Abschnitt.

Wählen Sie Aus Bearbeiten und OAuth-Token abrufen .
Wählen Sie Aktualisieren.
Wenn der OAuth-Token-Flow erfolgreich abgeschlossen wurde, kehren Sie zur Seite des geführten Setups zurück, und legen Sie fest Konfigurieren Sie Anmeldeinformationen für die Azure-Authentifizierung Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .

Konfigurieren Sie eine zu verwaltende Verbindung Azure Ressourcen über Azure API Management.

Wählen Sie aus Konfigurieren Sie Eigenschaften Aufgabe.

Geben Sie in der zugehörigen Liste Service Graph-Verbindungseigenschaften die Werte für die Eigenschaften ein.

Tabelle : 3. Service Graph-Verbindungseigenschaften
Eigenschaft	Beschreibung
Sammlungszeitraum (Tage)	Dauer in Tagen für die Erfassung von API-Nutzungsdaten.
CollectUsageData	Aktivieren Sie die Erfassung von Nutzungsdaten, um API-Nutzungsdaten für eine angegebene Dauer abzurufen.
Discovery-Bereich	Discovery-Bereich von Azure Client-Anwendung. Verfügbare Optionen: Verwaltungsgruppe Wählen Sie Aus Verwaltungsgruppe Wenn ServiceNow Der Service-Account hat Zugriff auf Daten innerhalb von Azure Verwaltungsgruppe. Abonnement Wählen Sie Aus Abonnement Wenn ServiceNow Der Service-Account hat Zugriff auf Daten innerhalb von Azure Nur Abonnement.
AusschlussServices	Azure API Management Services Die von der Verbindung ausgeschlossen werden sollen. Trennen Sie mehrere Services durch Kommas. Alle Gateways mit Ausnahme der in aufgeführten ExcludeServicesEigenschaft wird abgerufen.
GetNestedGroupSubscriptions	Aktivieren Sie das Abrufen von Daten aus allen geschachtelten untergeordneten Abonnements, wenn Verwaltungsgruppe Ist als Discovery-Bereich festgelegt. Legen Sie die Eigenschaft auf fest `Falsch` Zum Ausschließen geschachtelter untergeordneter Abonnements.
ManagementGroupId	Verwaltungsgruppen-IDs von Azure API Management Services . Trennen Sie mehrere Verwaltungsgruppen durch Kommas.
PartitionSize	Partitionsgröße für Azure Verwaltete APIs, wenn paralleles Laden aktiviert ist. Akzeptiert einen numerischen Wert größer als null. Wenn leer gelassen, wird der Wert automatisch berechnet.
ResourceGroups	Ressourcengruppenname von Azure API Management Services . Trennen Sie bei mehreren Ressourcengruppen ihre Namen durch Kommas. Wenn Sie dieses Feld leer lassen, importieren die Datenquellen im Connector Daten aus allen verfügbaren Ressourcengruppen.
SubscriptionId	Abonnement-IDs von Azure API Management Services . Trennen Sie für mehrere Abonnement-IDs diese durch Kommas. Wenn der Discovery-Bereich auf festgelegt ist Abonnement Und dieses Feld leer gelassen wird, werden alle Abonnements für den angegebenen Mandanten in den Anmeldeinformationen erkannt.

Tipp:

Um einen Eigenschaftswert einzugeben, doppelklicken Sie (oder verwenden Sie die Tastenkombination), um einen Wert in einzugeben Wert Zelle für die Eigenschaft.

Legen Sie fest Konfigurieren Sie Eigenschaften Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .

Testen Sie die Verbindung.
1. Wählen Sie aus Verbindung Testen Aufgabe.
2. Testen Sie die Verbindung, indem Sie auswählen Verbindung Testen Zugehöriger Link.
  Das Testen der Verbindung kann einige Minuten dauern. Die Seite wird aktualisiert, um die Testergebnisse anzuzeigen.
3. Wenn Status Feld ist auf festgelegt Erfolg , Wählen Sie aus Aktualisieren .
  Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Korrekturvorschläge.
4. Legen Sie fest Verbindung Testen Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .

Wahlweise: Integration mit mehreren Azure API Management Instanzen.
1. In Fügen Sie Mehrere Instanzen Hinzu Abschnitt von API Service Graph Connector für Azure API Management Seite auswählen Starten .
2. Aktivieren Sie die Erstellung von Datenquellen für die neue Azure API Management Verbindung.
  1. Vergewissern Sie sich, dass Sie über Bearbeitungsberechtigungen für die Tabelle Datenquelle [sys_data_source] verfügen.
  2. Wählen Sie aus Aktualisieren Sie Den Datenquellenzugriff Aufgabe.
  3. Um den Datensatz zu bearbeiten, wählen Sie aus Global Anwendungsbereich aus der Anwendungsauswahl.
  4. Wählen Sie in der zugehörigen Liste „Anwendungszugriff“ des Formulars „Datenquelle“, das in einer anderen Registerkarte geöffnet wird, die aus Kann erstellen , Kann aktualisieren , Und Kann löschen Kontrollkästchen.
  5. Wählen Sie Aktualisieren.
  6. Wählen Sie in der Anwendungsauswahl aus API Service Graph Connector für Azure API Management Anwendungsbereich.
  7. Legen Sie fest Aktualisieren Sie Den Datenquellenzugriff Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .
3. Aktivieren Sie die Erstellung eines geplanten Importauftrags für den neuen Azure API Management Verbindung.
  1. Stellen Sie sicher, dass Sie über Bearbeitungsberechtigungen für die Tabelle „Geplanter Datenimport“ [scheduled_Import_Set] verfügen.
  2. Wählen Sie aus Aktualisieren Sie Den Zugriff Für Den Geplanten Datenimport Aufgabe.
  3. Um den Datensatz zu bearbeiten, wählen Sie aus Global Anwendungsbereich aus der Anwendungsauswahl.
  4. Wählen Sie in der zugehörigen Liste Anwendungszugriff des Formulars Geplanter Datenimport die Option aus Kann erstellen , Kann aktualisieren , Und Kann löschen Kontrollkästchen.
  5. Wählen Sie Aktualisieren.
  6. Wählen Sie in der Anwendungsauswahl aus API Service Graph Connector für Azure API Management Anwendungsbereich.
  7. Legen Sie fest Aktualisieren Sie Den Zugriff Für Den Geplanten Datenimport Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .
4. Leeren Sie den Cache in den Tabellen „Datenquelle“ [sys_Data_Source] und „geplante Datenimporte“ [scheduled_Import_Set].
  1. Wählen Sie aus Leeren Sie den Cache für die Tabellen „Datenquelle“ und „geplante Datenimporte“ Aufgabe.
  2. In Skript ausführen Textfeld der Seite „Hintergrundskript“: Geben Sie das folgende Skript ein:
```
GlideTableManager.invalidateTable("sys_data_source");
GlideCacheManager.flushTable("sys_data_source");
GlideTableManager.invalidateTable("scheduled_import_set");
GlideCacheManager.flushTable("scheduled_import_set");
GlideTableManager.invalidateTable("sys_db_object");
GlideCacheManager.flushTable("sys_db_object");
```
  3. Wählen Sie Aus Skript Ausführen Um das Hintergrundskript in auszuführen Global Umfang.
    Die Ausführung des Skripts kann einige Minuten dauern.
  4. Wählen Sie nach der Ausführung des Skripts aus Schließen .
  5. Wählen Sie in der Anwendungsauswahl aus API Service Graph Connector für Azure API Management Anwendungsbereich.
  6. Legen Sie fest Leeren Sie den Cache für die Tabellen „Datenquelle“ und „geplante Datenimporte“ Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
5. Fügen Sie eine weitere Verbindung für die neue hinzu Azure API Management Instanz.
  1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Azure API Management Anwendung mithilfe der Anwendungsauswahl.
  2. Wählen Sie aus Fügen Sie Eine Weitere Verbindung Hinzu Aufgabe und dann auswählen Klicken Sie Hier .
  3. Wählen Sie auf der Seite „Verbindungen“, die in einer anderen Browserregisterkarte geöffnet wird, die Option aus Verbindung Hinzufügen .
  4. Geben Sie im Fenster „Verbindung erstellen“ die Details zur Verbindung, den Anmeldeinformationen und der Abonnement-ID ein.
  5. Wählen Sie OAuth-Token erstellen und abrufen aus.
  6. Schließen Sie die Seite „Verbindungen“, und kehren Sie zur Registerkarte der geführten Setup-Seite zurück.
  7. Legen Sie fest Fügen Sie Eine Weitere Verbindung Hinzu Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .
6. Fügen Sie Eigenschaften für die neue Verbindung hinzu.
  1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Azure API Management Anwendung mithilfe der Anwendungsauswahl.
  2. Wählen Sie aus Fügen Sie neuen Verbindungen Eigenschaften hinzu Aufgabe.
  3. Von Name Spalte wählen Sie den Verbindungsnamen aus, den Sie in Schritt erstellt haben 5.e.
  4. Geben Sie in der zugehörigen Liste Service Graph-Verbindungseigenschaften die Werte für die Eigenschaften ein.
    Weitere Informationen zu Eigenschaften finden Sie unter 4.c.ii.
    Tipp:
    Um einen Eigenschaftswert einzugeben, doppelklicken Sie (oder verwenden Sie die Tastenkombination), um einen Wert in einzugeben Wert Zelle für die Eigenschaft.
  5. Legen Sie fest Fügen Sie neuen Verbindungen Eigenschaften hinzu Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .
7. Testen Sie die neue Verbindung.
  1. Wählen Sie aus Testen Sie Neue Verbindungen Aufgabe.
  2. Von Name Spalte wählen Sie den Verbindungsnamen aus, den Sie in Schritt erstellt haben 5.e.
  3. Testen Sie die Verbindung, indem Sie auswählen Verbindung Testen Zugehöriger Link.
    Das Testen der Verbindung kann einige Minuten dauern. Die Seite wird aktualisiert, um die Testergebnisse anzuzeigen.
  4. Wenn Status Feld ist auf festgelegt Erfolg , Wählen Sie aus Aktualisieren .
    Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Korrekturvorschläge.
  5. Legen Sie fest Testen Sie Neue Verbindungen Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .
Konfigurieren Sie die geplante Aufgabe für den Import von Azure API Management Daten.
1. In Richten Sie geplante Importaufträge ein Abschnitt von API Service Graph Connector für Azure API Management Seite auswählen Starten .
2. Wählen Sie aus API-Verwaltungsservices Geplante Aufgabe.
  Wählen Sie für ein Setup mit mehreren Instanzen den geplanten Import aus, der mit der Verbindung in Schritt erstellt wurde 5.e.
3. Überprüfen Sie im Formular „Geplanter Datenimport“ die Feldwerte.
  
  Weitere Informationen finden Sie unter Schedule a data import.
4. Wählen Sie aus Aktiv Kontrollkästchen zum Aktivieren der geplanten Aufgabe.
5. In Ausführen Feld auswählen Regelmäßig Um anzugeben, wie oft der Auftrag ausgeführt wird.
6. Wählen Sie Aktualisieren.
7. Legen Sie fest Richten Sie geplante Importaufträge ein Aufgabe, die abgeschlossen werden soll, indem ausgewählt wird Als abgeschlossen markieren Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Fahren Sie Fort .
Auf der API Service Graph Connector für Azure API Management Seite auswählen Abgeschlossen Um Ihre Änderungen zu speichern.
Wählen Sie im Dialogfeld Setup abschließen die Option aus Abgeschlossen Um das Setup abzuschließen.
Wählen Sie im angezeigten Meldungsfeld die Option aus Fertig .