Konfigurieren API Service Graph Connector für Azure API ManagementWird verwendet SGC Central

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

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

    Vorbereitungen

    Installieren API Service Graph Connector für Azure API ManagementVersion 1.0.0 oder höher von ServiceNow Store. Die Schritte zur ServiceNow Store-Installation finden Sie unter ServiceNow Store-Anwendungen installieren.
    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

    Warum und wann dieser Vorgang ausgeführt wird

    Die Playbook-Experience für Onboarding-Connectors wird mit aktiviert SGC CentralIn CMDB-Arbeitsbereich. 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, Auswählen 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 ManagementConnector-Typ und dann auswählen Verbindung erstellen .
    5. Füllen Sie die ersten Voraussetzungen aus, wenn Sie zum ersten Mal eine Verbindung mit einem Connector einrichten.
      Hinweis:
      Dieser Schritt ist nur beim erstmaligen Setup erforderlich. Weitere Informationen finden Sie unter Führen Sie erste Setup-Aufgaben durch, wenn Sie eine Verbindung in erstellen SGC Central.
    6. Geben Sie Verbindungsdetails ein, und testen Sie die API-Verbindung für den Import Azure API ManagementDaten.
      1. In Setup Phase des Playbooks: Wählen Sie aus Erstellen und testen Sie die Verbindung Aktivität.
      2. Füllen Sie im Formular die Felder aus.
        Tabelle : 1. Erstellen und testen Sie das Verbindungsformular
        Feld Beschreibung
        Azure API-Verwaltung – Verbindungsname Name zur Identifizierung von Azure API ManagementVerbindungsdatensatz.

        Beispiel: Azure API-Verwaltungsverbindung .
        Verbindungs-URL Basis-URL, um eine Verbindung mit herzustellen Azure API ManagementService.
        Hinweis:
        Dieses Feld wird automatisch auf die URL festgelegt, um eine Verbindung zur Anwendung herzustellen. Lassen Sie den Feldwert unverändert.
        OAuth-Client-ID Anwendungs-ID (Client) von AzureClient-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.
      3. Wählen Sie Aus Erstellen und testen Sie die Verbindung .
      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 für Azure API-Verwaltung
        Eigenschaft Beschreibung
        Verbindung zu Azure API-Verwaltung
        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.
        Abonnement
        Abonnement-ID(s) 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.
        Verwaltungsgruppe
        Verwaltungsgruppen-ID(s) Verwaltungsgruppen-IDs von Azure API ManagementServices .

        Trennen Sie für mehrere Verwaltungsgruppen diese 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
        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.
        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.
        Nutzungsdatenkonfiguration
        SammlungNutzungsdaten Option zum Aktivieren der Nutzungsdatensammlung zum Abrufen von API-Nutzungsdaten über eine angegebene Dauer.
      3. Wählen Sie Fortsetzen.
    8. Konfigurieren Sie den Importzeitplan, um Daten in regelmäßigen Intervallen 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 SGA Azure API-Verwaltungsservices Importzeitplan, der Ihrer Verbindung zugeordnet ist.
        Hinweis:
        Der Verbindungsname wird dem Zeitplannamen vorangestellt.
      3. In Konfigurieren Sie den Importzeitplan Wählen Sie aus Aktiv Aktivieren Sie das Kontrollkästchen, und geben Sie dann den Ausführungszeitplan und die Zeitdetails 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.