API Service Graph Connector für Azure API Management mit SGC Centralkonfigurieren

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

    • Richten Sie geplante Importaufträge ein, um Azure API Management -Daten in Ihre CMDBabzurufen.

    Vorbereitungen

    Installieren Sie API Service Graph Connector für Azure API Management Version 1.0.0 oder höher aus ServiceNow Store. Die Schritte zur ServiceNow Store-Installation finden Sie unter ServiceNow Store-Anwendungen installieren.
    Die OAuth-Anmeldeinformationen erhalten Sie von Ihrem Azure -Administrator. 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 SGC Central in CMDB-Arbeitsbereichaktiviert. Weitere Informationen zur Interaktion mit einem Playbook finden Sie unter Mit Playbook interagieren.

    Prozedur

    1. Navigieren zu Arbeitsbereiche > CMDB-Arbeitsbereich.
    2. Wählen Sie unter CMDB-Arbeitsbereichdie Option SGC Centralaus.
    3. Wählen Sie auf der Übersichtsseite die Option Verbindung erstellen aus.
      Tipp:
      Alternativ können Sie Verbindung herstellen auf der Seite Alle Verbindungen auswählen.
    4. Wählen Sie im Fenster Verbindung erstellen den Connector-Typ Azure API Management und dann Verbindung erstellenaus.
    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 der Ersteinrichtung erforderlich. Weitere Informationen finden Sie unter Führen Sie Ersteinrichtungsaufgaben durch, wenn Sie eine Verbindung in erstellen SGC Central.
    6. Geben Sie die Verbindungsdetails ein, und testen Sie die API-Verbindung für den Import von Azure API Management -Daten.
      1. Wählen Sie in der Phase „Setup“ des Playbooks die Aktivität Verbindung erstellen und testen aus.
      2. Füllen Sie die Felder des Formulars aus.
        Tabelle : 1. Formular zum Erstellen und Testen von Verbindungen
        Feld Beschreibung
        Verbindungsname für Azure API Management Name zur Identifizierung des Azure API Management -Verbindungsdatensatzes.

        Beispiel: Azure API Management-Verbindung.
        Verbindungs-URL Basis-URL zum Herstellen einer Verbindung mit dem Service Azure API Management.
        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) der Clientanwendung Azure, wie im Abschnitt „ Bevor Sie beginnen“ angegeben.
        OAuth-Client-Geheimnis Geheimer Clientschlüssel Ihrer Clientanwendung Azure, wie im Abschnitt „Bevor Sie beginnen“ angegeben.
        OAuth-Token-URL Token-URL Ihrer Azure -Client-Anwendung.
        Geben Sie die Token-URL basierend auf der Region Ihrer Azure -Client-Anwendung 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 Ihrer Client-Anwendung Azure , wie im Abschnitt „ Bevor Sie beginnen“ angegeben.sgcc-configure-azure-api-mgmt.html#sgcc-configure-azure-api-mgmt__prereq
      3. Wählen Sie Verbindung erstellen und testen aus.
      4. Wählen Sie nach Abschluss des Verbindungstests Fortsetzen aus.
    7. Wahlweise: Legen Sie die Konfigurationseigenschaften für die Verbindung fest.
      Hinweis:
      Um diesen Schritt zu überspringen, wählen Sie „ Fortsetzen“ für die Aktivität „Konfigurationseigenschaften festlegen“ aus.
      1. Wählen Sie in der Phase „Setup “ des Playbooks die Aktivität „Konfigurationseigenschaften festlegen“ aus.
      2. Füllen Sie die Eigenschaftsdetails aus.
        Tabelle : 2. Konfigurationseigenschaften für Azure API Management
        Eigenschaft Beschreibung
        Azure API Management-Verbindung
        Discovery-Bereich Discovery-Bereich der Clientanwendung Azure. Verfügbare Optionen:
        Verwaltungsgruppe
        Wählen Sie die Verwaltungsgruppe aus, wenn das Servicekonto ServiceNow Zugriff auf Daten innerhalb der Verwaltungsgruppe Azure hat.
        Abonnement
        Wählen Sie Abonnement aus, wenn das Servicekonto ServiceNow nur Zugriff auf Daten innerhalb des Abonnements Azure hat.
        Abonnement
        Abonnement-ID(s) Abonnement-IDs von Azure API Management Services.

        Trennen Sie mehrere Abonnement-IDs durch Kommas. Wenn der Discovery-Bereich auf Abonnement festgelegt ist 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 Mit dieser Option wird das Abrufen von Daten aus allen geschachtelten untergeordneten Abonnements aktiviert, wenn die Verwaltungsgruppe als Discovery-Bereich festgelegt ist.

        Deaktivieren Sie die Eigenschaft, um geschachtelte untergeordnete Abonnements auszuschließen.
        Optionale ausschließliche Konfiguration
        Services ausschließen Azure API Management Services, die von der Verbindung ausgeschlossen werden sollen.

        Trennen Sie mehrere Services durch Kommas. Alle Gateways mit Ausnahme der in der Eigenschaft ExcludeServices aufgeführten werden abgerufen.
        ResourceGroups Ressourcengruppenname von Azure API Management Services.

        Trennen Sie bei mehreren Ressourcengruppen deren Namen durch Kommas. Wenn Sie dieses Feld leer lassen, importieren die Datenquellen im Connector Daten aus allen verfügbaren Ressourcengruppen.
        Konfiguration der Nutzungsdaten
        SammlungNutzungsdaten Option zum Aktivieren der Nutzungsdatenerfassung zum Abrufen von API-Nutzungsdaten über einen angegebenen Zeitraum.
      3. Wählen Sie Fortsetzen.
    8. Konfigurieren Sie den Importzeitplan für den Import von Daten in regelmäßigen Intervallen.
      1. Wählen Sie in der Phase „Setup“ des Playbooks die Aktivität Importzeitplan konfigurieren aus.
      2. Erweitern Sie den übergeordneten geplanten Datenimport in der Liste Importzeitpläne, um den Importzeitplan für SGA Azure API Management-Services auszuwählen, der Ihrer Verbindung zugeordnet ist.
        Hinweis:
        Der Verbindungsname wird dem Zeitplannamen vorangestellt.
      3. Aktivieren Sie im Dialogfeld „Importzeitplan konfigurieren“ das Kontrollkästchen Aktiv, und füllen Sie dann die Ausführungszeitplan- und Zeitdetails aus.

        Weitere Informationen finden Sie unter Schedule a data import.

      4. Wählen Sie Speichern.
        Alternativ können Sie Jetzt ausführen wählen, um den Importzeitplan sofort auszuführen.
      5. Wählen Sie Fortsetzen.
    9. Wählen Sie in der Phase „Setup“ des Playbooks die Aktivität „Erstellung der Verbindung bestätigen“ aus, um zu überprüfen, ob die Verbindung erstellt wurde.

    Nächste Maßnahme

    Wählen Sie Alle Verbindungen anzeigen aus, um die Verbindungsdetails zu überprüfen. Die erstellte Verbindung wird in der Liste Installierte Verbindungen angezeigt.