Konfigurieren Sie mit geführtem Setup

Yokohama Now Platform-Fähigkeiten

Release

yokohama

ft:locale

de-DE

ft:publication_title

Yokohama Now Platform-Fähigkeiten

ft:clusterId

platcap

bundleId

platcap

workflow

Platform

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

Freigeben Version: Yokohama

Aktualisiert 30. Januar 2025

8 Minuten Lesedauer

Richten Sie geplante Importaufträge zum Abrufen ein Azure API ManagementDaten in Ihr CMDB.

Vorbereitungen

Wichtig:

Sofern keine Probleme auftreten, verwenden Sie SGC CentralAnzeigen, da die Methode des geführten Setups veraltet ist. Wenn eine Verbindung mithilfe des geführten Setups konfiguriert wird, wird die Verbindung möglicherweise nicht in angezeigt SGC CentralAnsicht.

Abhängigkeiten und Anforderungen:

Die Store-App „Integration Commons für CMDB“, die automatisch installiert wird. Siehe Integrationsgemeinschaften 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.
ITOM-Lizenzierung-Plugin (com.snc.itom.license). Weitere Informationen finden Sie unter Request Discovery.

Rufen Sie die OAuth-Anmeldeinformationen von ab AzureAdministrator. 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 ManagementAnwendung mithilfe der Anwendungsauswahl.
Weitere Informationen finden Sie unter Anwendungsauswahl .
Navigieren zu Alle > Service Graph Connectors > Azure API-Verwaltung > Einrichtungan.
Auf API Service Graph Connector für Azure API ManagementSeite, ü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 ManagementAnwendung.

In Konfigurieren Sie die Verbindung und Anmeldeinformationen Abschnitt von API Service Graph Connector für Azure API ManagementSeite 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 Sie nach, und wählen Sie aus Bearbeiten Für Azure API-Verwaltungsverbindung .

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

Tabelle : 1. Verbindungsinformation
Feld	Beschreibung
Azure API-Verwaltung – Verbindungsname	Name zur Identifizierung von Azure API ManagementVerbindungsdatensatz. `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, um eine Verbindung mit herzustellen Azure API ManagementService. Basierend auf der Region von AzureClient-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 im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung bearbeiten“ die Felder 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 Clientschlüssel von AzureClient-Anwendung wie in angegeben Bevor Sie beginnen Abschnitt.
OAuth-Token-URL	Token-URL von AzureClient-Anwendung. Basierend auf der Region von AzureClient-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 AzureClient-Anwendung wie in angegeben Bevor Sie beginnen Abschnitt.

Wählen Sie Aus Bearbeiten und rufen Sie das OAuth-Token ab .
Wählen Sie Aktualisieren.
Wenn der OAuth-Token-Flow erfolgreich abgeschlossen wurde, kehren Sie zur Seite „geführtes Setup“ 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 AzureRessourcen ü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.
SammlungNutzungsdaten	Aktivieren Sie die Erfassung von Nutzungsdaten, um API-Nutzungsdaten für eine angegebene Dauer abzurufen.
Discovery-Bereich	Discovery-Bereich von AzureClient-Anwendung. Verfügbare Optionen: Verwaltungsgruppe Wählen Sie Aus Verwaltungsgruppe Wenn ServiceNowService-Account hat Zugriff auf Daten in AzureVerwaltungsgruppe. Abonnement Wählen Sie Aus Abonnement Wenn ServiceNowService-Account hat Zugriff auf Daten in AzureNur Abonnement.
Services ausschließen	Azure API ManagementServices Die von der Verbindung ausgeschlossen werden soll. Trennen Sie für mehrere Services diese 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 ManagementServices . Trennen Sie für mehrere Verwaltungsgruppen diese durch Kommas.
Partitionsgröße	Partitionsgröße für AzureVerwaltete APIs, wenn paralleles Laden aktiviert ist. Akzeptiert einen numerischen Wert größer als null. Wenn leer gelassen, wird der Wert automatisch berechnet.
Ressourcengruppen	Ressourcengruppenname von Azure API ManagementServices . Trennen Sie für mehrere 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 ManagementServices . 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 , Auswählen Aktualisieren .
  Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.
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 ManagementInstanzen.
1. In Fügen Sie Mehrere Instanzen Hinzu Abschnitt von API Service Graph Connector für Azure API ManagementSeite auswählen Starten .
2. Aktivieren Sie die Erstellung von Datenquellen für die neue Azure API ManagementVerbindung.
  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. Wählen Sie aus, um den Datensatz zu bearbeiten 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 aktualisiert werden , Und Kann löschen Kontrollkästchen.
  5. Wählen Sie Aktualisieren.
  6. Wählen Sie in der Anwendungsauswahl aus API-Servicediagramm-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 einer geplanten Importaufgabe für die neue Azure API ManagementVerbindung.
  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 Auf Den Geplanten Datenimport Aufgabe.
  3. Wählen Sie aus, um den Datensatz zu bearbeiten Global Anwendungsbereich aus der Anwendungsauswahl.
  4. Wählen Sie in der zugehörigen Liste „Anwendungszugriff“ des Formulars „Geplanter Datenimport“ die aus Kann erstellen , Kann aktualisiert werden , Und Kann löschen Kontrollkästchen.
  5. Wählen Sie Aktualisieren.
  6. Wählen Sie in der Anwendungsauswahl aus API-Servicediagramm-Connector für Azure API-Management Anwendungsbereich.
  7. Legen Sie fest Aktualisieren Sie Den Zugriff Auf 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. Wählen Sie aus, um den Datensatz zu bearbeiten Global Anwendungsbereich aus der Anwendungsauswahl.
  3. In Skript ausführen Geben Sie den folgenden Code 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");
```
  4. Wählen Sie Aus Skript ausführen .
  5. Wählen Sie in der Anwendungsauswahl aus API-Servicediagramm-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 ManagementInstanz.
  1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API-Servicediagramm-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 Aus OAuth-Token erstellen und abrufen .
  6. Schließen Sie die Seite „Verbindungen“, und kehren Sie zur Registerkarte „geführte Einrichtung“ 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-Servicediagramm-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 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 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 , Auswählen Aktualisieren .
    Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.
  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 ManagementDaten.
1. In Richten Sie geplante Importaufträge ein Abschnitt von API Service Graph Connector für Azure API ManagementSeite auswählen Starten .
2. Wählen Sie aus SGA Azure 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 API Service Graph Connector für Azure API ManagementSeite 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 Nachrichtenfeld aus Fertig .