Konfigurieren API Service Graph Connector für Azure API Management Verwenden SGC Central

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

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

    Vorbereitungen

    Installieren API Service Graph Connector für Azure API Management Version 1.0.0 oder höher aus ServiceNow Store. Für ServiceNow StoreInstallationsschritte, siehe Installieren Sie eine ServiceNow Store-Anwendung .
    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: cmdb_inst_admin oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Die Playbook-Experience für Onboarding-Connectors wird mit aktiviert SGC Central In CMDB-Arbeitsbereich. Zum Konfigurieren von SGC Central Anwendung, siehe SGC Central konfigurieren Weitere Informationen zur Interaktion mit einem Playbook finden Sie unter Interagieren Sie mit Playbook .

    Prozedur

    1. Navigieren zu Arbeitsbereiche > CMDB-Arbeitsbereichan.
    2. In CMDB-Arbeitsbereich, Wählen Sie aus SGC Central.
    3. Wählen Sie auf der Seite Übersicht die Option aus Verbindung erstellen .
      Tipp:
      Alternativ können Sie auswählen Verbindung erstellen Auf der Seite „alle Verbindungen“.
    4. Wählen Sie im Fenster Verbindung erstellen die aus Azure API Management Connector-Typ, und wählen Sie dann aus Verbindung erstellen .
    5. Erfüllen Sie die ersten Voraussetzungen, wenn Sie eine Verbindung zum ersten Mal mit einem Connector einrichten.
      Hinweis:
      Dieser Schritt ist nur während des erstmaligen Setups erforderlich. Weitere Informationen finden Sie unter Führen Sie beim Erstellen einer Verbindung in erste Setup-Aufgaben aus SGC Central.
    6. Geben Sie Verbindungsdetails ein, und testen Sie die API-Verbindung für den Import Azure API Management Daten.
      1. In Setup Phase des Playbooks wählen Sie aus Verbindung erstellen und testen Aktivität.
      2. Füllen Sie im Formular die Felder aus.
        Tabelle : 1. Verbindungsformular erstellen und testen
        Feld Beschreibung
        Azure API-Management-Verbindungsname Name zur Identifizierung von Azure API Management Verbindungsdatensatz.

        Beispiel: Azure API-Verwaltungsverbindung .
        Verbindungs-URL Basis-URL für die Verbindung mit Azure API Management Service.
        Hinweis:
        Dieses Feld wird automatisch auf die URL festgelegt, um eine Verbindung mit der Anwendung herzustellen. Lassen Sie den Feldwert unverändert.
        OAuth-Client-ID Anwendungs-ID (Client) von 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.
      3. Wählen Sie Aus Verbindung erstellen und testen .
      4. Sobald der Verbindungstest abgeschlossen ist, wählen Sie aus Fahren Sie Fort .
    7. Wahlweise: Legen Sie die Konfigurationseigenschaften für die Verbindung fest.
      Hinweis:
      Um diesen Schritt zu überspringen, wählen Sie aus Fahren Sie Fort Für Legen Sie Konfigurationseigenschaften fest Aktivität.
      1. In Setup Phase des Playbooks wählen Sie aus Legen Sie Konfigurationseigenschaften fest Aktivität.
      2. Geben Sie die Eigenschaftsdetails ein.
        Tabelle : 2. Konfigurationseigenschaften von Azure API Management
        Eigenschaft Beschreibung
        Verbindung zu Azure API-Verwaltung
        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.
        Abonnement
        Abonnement-ID(s) 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.
        Verwaltungsgruppe
        Verwaltungsgruppen-ID(s) Verwaltungsgruppen-IDs von Azure API Management Services .

        Trennen Sie mehrere Verwaltungsgruppen durch Kommas.
        Ruft Geschachtelte Gruppenabonnements Ab Option zum Aktivieren des Abrufs von Daten aus allen geschachtelten untergeordneten Abonnements, wenn Verwaltungsgruppe Ist als Discovery-Bereich festgelegt.

        Deaktivieren Sie die Eigenschaft, um geschachtelte untergeordnete Abonnements auszuschließen.
        Optionale exklusive Konfiguration
        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.
        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.
        Konfiguration Der Nutzungsdaten
        CollectUsageData Option zum Aktivieren der Nutzungsdatensammlung zum Abrufen von API-Nutzungsdaten über einen angegebenen Zeitraum.
      3. Wählen Sie Fortsetzen.
    8. Konfigurieren Sie den Importzeitplan, um Daten in regelmäßigen Abständen zu importieren.
      1. In Setup Phase des Playbooks wählen Sie aus Konfigurieren Sie den Importzeitplan Aktivität.
      2. Erweitern Sie den übergeordneten geplanten Datenimport in der Liste Zeitpläne importieren, um auszuwählen API-Verwaltungsservices Importzeitplan, der Ihrer Verbindung zugeordnet ist.
        Hinweis:
        Der Verbindungsname wird dem Zeitplannamen vorangestellt.
      3. In Konfigurieren Sie den Importzeitplan Wählen Sie das Dialogfeld aus Aktiv Aktivieren Sie das Kontrollkästchen, und geben Sie dann den Zeitplan und die Zeitdetails der Ausführung ein.

        Weitere Informationen finden Sie unter Schedule a data import.

      4. Wählen Sie Speichern.
        Alternativ wählen Sie aus Jetzt Ausführen Um den Importzeitplan sofort auszuführen.
      5. Wählen Sie Fortsetzen.
    9. In Setup Phase des Playbooks wählen Sie aus Bestätigen Sie die Verbindungserstellung Aktivität zum Überprüfen, ob die Verbindung erstellt wurde.

    Nächste Maßnahme

    Wählen Sie Aus Zeigen Sie alle Verbindungen an Dient zum Überprüfen der Verbindungsdetails. Die erstellte Verbindung wird in der Liste der installierten Verbindungen angezeigt.