API Service Graph Connector für Apigee X mit SGC Centralkonfigurieren

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

    • Richten Sie geplante Importaufträge ein, um Apigee X -Daten in Ihre CMDBabzurufen.

    Vorbereitungen

    Installieren Sie API Service Graph Connector für Apigee X Version 1.0.0 oder höher aus ServiceNow Store. Die Schritte zur ServiceNow Store-Installation finden Sie unter ServiceNow Store-Anwendungen installieren.

    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 Apigee X 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. Füllen Sie die Voraussetzungen für das Einrichten der Umgebung Apigee X aus.
      1. Richten Sie die Umgebung Apigee X ein, und erstellen Sie ein Java KeyStore-Zertifikat (JKS), um die von einer Anwendung Apigee X erhaltenen Sicherheitszertifikate zu verschlüsseln.
        1. Wählen Sie in der Phase „Voraussetzungen“ des Playbooks die Aktivität Setup-Anweisungen überprüfen aus.
        2. Überprüfen und schließen Sie die Setupanweisungen im Artikel API Service Graph Connector für Apigee X – Setupanweisungen [KBB0010364] in der Knowledge Base Now Support ab.

          Sie müssen ein Servicekonto erstellen, Rollen zuweisen, Rollen an das Servicekonto binden, APIs aktivieren, eine P12-Datei erstellen und diese in Ihrer Instanz ServiceNow registrieren.

          Notieren Sie sich das Passwort des Zielschlüsselspeichers. Sie müssen dieses Passwort beim Importieren des JKS-Zertifikats in die Anwendung API Service Graph Connector für Apigee X angeben.

        3. Aktivieren Sie das Kontrollkästchen Ich habe die Setup-Anweisungen gelesen, um zu bestätigen, dass Sie die Umgebung Apigee X gemäß den Anweisungen eingerichtet haben.
        4. Wählen Sie Fortsetzen.
      2. Erstellen Sie ein X.509-Zertifikat, um das Java KeyStore-Zertifikat (JKS) für die Anwendung Apigee X dem Connector zuzuordnen.
        Hinweis:
        Sie können diesen Schritt überspringen, wenn Sie ein zuvor erstelltes Zertifikat wiederverwenden.
        1. Wählen Sie in der Phase „Voraussetzungen“ des Playbooks die Aktivität X.509-Zertifikat erstellen aus.
        2. Füllen Sie die Felder des Formulars aus.
          Tabelle : 1. X.509-Zertifikatformular
          Feld Beschreibung
          Name Name des X.509-Zertifikats. Beispiel: SGA-ApigeeX-509Zertifikat.
          Schlüsselspeicher-Passwort Passwort für den Zugriff auf das JKS-Zertifikat, wie im vorherigen Schrittnotiert.
          Kurzbeschreibung Beschreibung des X.509-Zertifikats.
        3. Wählen Sie im Abschnitt „Anhänge “ Datei hinzufügen.
        4. Durchsuchen und wählen Sie die P12-Datei für das JKS-Zertifikat, das Sie im vorherigen Schritterstellt haben.
        5. Wählen Sie im Dialogfeld „Eine Datei hochladen“ die Option Hochladen aus.
        6. Wählen Sie Fortsetzen.
    7. Geben Sie die Verbindungsdetails ein, und testen Sie die API-Verbindung für den Import von Apigee X -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 : 2. Formular zum Konfigurieren und Testen der Verbindung
        Feld Beschreibung
        Verbindungsname Name zur Identifizierung des Apigee X -Verbindungsdatensatzes.
        E-Mail-Adresse des Service-Accounts E-Mail-Adresse, die dem Servicekonto ServiceNow zugeordnet ist, das für die Authentifizierung bei Apigee X verwendet wird, wie im vorherigen Schrittangegeben.
        X.509-Zertifikat Name des X.509-Zertifikats wie im vorherigen Schrittnotiert.
        Schlüsselspeicher-Passwort Passwort, das dem Schlüsselspeicher zugeordnet ist (siehe vorheriger Schritt).
      3. Wählen Sie Verbindung erstellen und testen aus.
      4. Wählen Sie nach Abschluss des Verbindungstests Fortsetzen aus.
    8. Legen Sie die Konfigurationseigenschaften für die Verbindung fest.
      1. Wählen Sie in der Phase „Setup “ des Playbooks die Aktivität „Konfigurationseigenschaften festlegen“ aus.
      2. Geben Sie die Eigenschaften ein.
        Tabelle : 3. Service Graph-Verbindungseigenschaften
        Eigenschaft Beschreibung
        Identifizierung des Apigee
        Organisations-ID Organisation im System Apigee X, zu der die Projekte gehören.
        Projekt-ID Projektbezeichner in der Umgebung Apigee X, mit dem die Verbindung verknüpft wird.

        Trennen Sie mehrere Projekt-IDs durch Kommas.
        Konfiguration des Datenabrufs
        Discovery-Bereich Discovery-Bereich der Anwendung Apigee X. Verfügbare Optionen:
        Organisation
        Wählen Sie Organisation aus, wenn der Serviceaccount ServiceNow Zugriff auf Daten innerhalb der Organisation Apigee X hat.
        Projekte
        Wählen Sie Projekte aus, wenn der Serviceaccount ServiceNow nur Zugriff auf Daten innerhalb von Apigee X -Projekten hat.
        Umgebungen ausschließen Apigee X Umgebungen, die von der Verbindung ausgeschlossen werden sollen.

        Trennen Sie mehrere Umgebungen durch Kommas. Alle Gateways mit Ausnahme der in der Eigenschaft Exclude Environments aufgeführten werden abgerufen.

        Wenn Sie dieses Feld leer lassen, importieren die Datenquellen im Connector Daten aus allen Umgebungen.
        Sammlungszeitraum in Tagen Dauer der Erfassung von API-Nutzungsdaten in Tagen.
        Nutzungsdaten sammeln Option zum Aktivieren der Nutzungsdatenerfassung zum Abrufen von API-Nutzungsdaten über einen angegebenen Zeitraum.
        Leistungskonfiguration
        Seitengröße Anzahl der Datensätze pro Seite. Der Standardwert ist 100, der Mindestwert 2.
        Partitionsgröße in Byte Partitionsgröße für Apigee X verwaltete APIs, wenn paralleles Laden aktiviert ist.

        Akzeptiert einen numerischen Wert größer als null. Wenn es leer gelassen wird, wird der Wert automatisch berechnet.
      3. Wählen Sie Fortsetzen.
    9. 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. Wählen Sie Importzeitplan konfigurierenaus.
      3. Erweitern Sie den übergeordneten geplanten Datenimport in der Liste der Importzeitpläne, um den Importzeitplan der SGA Apigee X-Organisation auszuwählen.
      4. 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.

      5. Wählen Sie Speichern.
        Alternativ können Sie Jetzt ausführen wählen, um den Importzeitplan sofort auszuführen.
      6. Wählen Sie Fortsetzen.
    10. 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 konfigurierte Verbindung wird in der Liste Installierte Verbindungen angezeigt.