Konfigurieren API Service Graph Connector für Apigee X Mit dem geführten Setup

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

    • Richten Sie geplante Importaufträge zum Abrufen ein Apigee X Daten in Ihrem CMDB.

    Vorbereitungen

    Wichtig:
    Sofern keine Konfigurationsprobleme auftreten, verwenden Sie SGC Central Zeigen Sie in an CMDB-Arbeitsbereich Zum Konfigurieren der Verbindung für den Connector, da die Methode des geführten Setups veraltet ist.
    Abhängigkeiten und Anforderungen:
    • Die Store-App „Integration Commons for CMDB“, die automatisch installiert wird. Siehe Integration Commons 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.
    • Plugin „ITOM-Lizenzierung“ (com.snc.itom.license). Weitere Informationen finden Sie unter Request Discovery.

    Erforderliche Rolle: Administrator

    Prozedur

    1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Apigee X Anwendung mithilfe der Anwendungsauswahl.
      Weitere Informationen finden Sie unter Anwendungsauswahl .
    2. Navigieren zu Alle > Service Graph Connectors > Apigee X > Setupan.
    3. Auf der API Service Graph Connector für Apigee X Seite auswählen Fahren Sie Fort .
    4. Konfigurieren Sie die Anmeldeinformationen für die Authentifizierung, um Anforderungen an zu senden Apigee X Anwendung.
      1. In Konfigurieren Sie die Verbindung und die Anmeldeinformationen Abschnitt von API Service Graph Connector für Apigee X Seite auswählen Starten .
      2. Gewähren Sie die Berechtigung zum Aktualisieren des Anhangs, damit die API-Frontend-Back-End-Datenquelle Dateien von abrufen kann Apigee X Und hängen Sie sie an Datensätze an.
        1. Wählen Sie aus Aktualisieren Sie Den Anhangszugriff Aufgabe.
        2. Wählen Sie aus Global Anwendungsbereich aus der Anwendungsauswahl.
        3. Wählen Sie in der zugehörigen Liste „Anwendungszugriff“ der Unterseite „Anhang“ die Option aus  Kann aktualisieren  Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus  Aktualisieren .
        4. Wählen Sie aus API Service Graph Connector für Apigee XAnwendungsbereich aus der Anwendungsauswahl.
        5. Legen Sie fest Aktualisieren Sie Den Anhangszugriff 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. Richten Sie ein Apigee X Umgebung und erstellen Sie ein Java Keystore (JKS)-Zertifikat, um die von einem abgerufenen Sicherheitszertifikate zu verschlüsseln Apigee X Anwendung.
        1. Wählen Sie aus Apigee X-Setup-Anweisungen Aufgabe.
        2. Überprüfen und schließen Sie die Setup-Anweisungen auf dem ab API Service Graph Connector für Apigee X – Setup-Anweisungen [KBB0010364] artikel in Now Support Knowledge Base.

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

        3. Legen Sie fest Apigee X-Setup-Anweisungen 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. Erstellen Sie ein X.509-Zertifikat, um das JKS-Zertifikat (Java Keystore) für zuzuordnen Apigee X Anwendung mit dem Connector.
        1. Wählen Sie aus Erstellen Sie ein X.509-Zertifikat Aufgabe.
        2. Wählen Sie Neu.
        3. Füllen Sie im Formular die Felder aus.
          Tabelle : 1. X.509-Zertifikatformular
          Feld Beschreibung
          Name Name des X.509-Zertifikats. Beispiel: SGA-ApigeeX-509Zertifikat .
          Benachrichtigung bei Ablauf Anwender, die benachrichtigt werden sollen, wenn das Zertifikat abläuft. Wenn keine Anwender ausgewählt sind, wird standardmäßig der angemeldete Anwender zusammen mit den letzten beiden angemeldeten Anwendern mit der Administratorrolle hinzugefügt.
          Tage vor Ablauf benachrichtigen Anzahl der Tage, die eine Benachrichtigung gesendet werden soll, bevor das Zertifikat abläuft.
          Aktiv Option zum Aktivieren des Zertifikats.
          Typ Zertifikatcontainer, der automatisch auf festgelegt ist Java-Schlüsselspeicher . Lassen Sie den Feldwert auf festgelegt Java-Schlüsselspeicher .
          Läuft in Tagen ab Anzahl der Tage, bis das Zertifikat abläuft.
          Schlüsselspeicher-Passwort Passwort für den Zugriff auf das JKS-Zertifikat, wie in angegeben Vorheriger Schritt .
          Kurzbeschreibung Beschreibung des X.509-Zertifikats.
        4. Wählen Sie das Symbol Anhänge verwalten ( Symbol „Anhänge verwalten“.).
        5. Wählen Sie Aus Wählen Sie die Datei aus Um die Datei „Keystore.p12“ für das in Schritt erstellte JKS-Zertifikat zu durchsuchen und hochzuladen 4.c.
        6. Schließen Sie das Dialogfeld.
        7. Wählen Sie aus Validiert Speicher/Zertifikate Zugehöriger Link.
        8. Wählen Sie bei erfolgreicher Validierung aus Aktualisieren Um zur Seite des geführten Setups zurückzukehren.
        9. Legen Sie fest Erstellen Sie ein X.509-Zertifikat 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 .
      5. Konfigurieren Sie die Verbindung.
        1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Apigee X Anwendung mithilfe der Anwendungsauswahl.
        2. Wählen Sie aus Konfigurieren Sie die Verbindung Aufgabe.
        3. Wählen Sie Aus Klicken Sie Hier Dient zum Öffnen der Seite „Verbindungen“ in einer separaten Browserregisterkarte.
        4. Suchen und wählen Sie aus Bearbeiten Für SGA Apigee X-Verbindung .
        5. Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ aus.
          Tabelle : 2. Verbindungsinformation
          Feld Beschreibung
          Verbindungsname Name zur Identifizierung von Apigee X Verbindungsdatensatz.

          SGA Apigee X-Verbindung Ist der standardmäßige Aliasname für Anmeldeinformationen. Sie können mehrere hinzufügen Apigee X Instanzen. Versuchen Sie jedoch, den Standardverbindungsnamen nicht zu ändern.
        6. Füllen Sie die Felder im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung bearbeiten“ aus.
          Tabelle : 3. Anmeldedaten
          Feld Beschreibung
          Service-Account-E-Mail E-Mail-Adresse, die dem zugeordnet ist ServiceNow Service-Account, der für die Authentifizierung mit verwendet wird Apigee X Wie in angegeben Bevor Sie beginnen Abschnitt.
          X.509-Zertifikat X.509-Zertifikat in Schritt erstellt 4.d.
          Schlüsselspeicher-Passwort Passwort, das dem Schlüsselspeicher zugeordnet ist, wie in angegeben Bevor Sie beginnen Abschnitt.
        7. Wählen Sie Aus Bearbeiten und OAuth-Token abrufen .
        8. Wählen Sie Aktualisieren.
        9. Wenn der OAuth-Token-Flow erfolgreich abgeschlossen wurde, kehren Sie zur Seite des geführten Setups zurück, und legen Sie fest Konfigurieren Sie die Verbindung 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. Konfigurieren Sie Eigenschaften des Connectors, um auf Ressourcen zuzugreifen.
        1. Wählen Sie aus Fügen Sie Konfigurationseigenschaften hinzu Aufgabe.
        2. Geben Sie in der zugehörigen Liste Service Graph-Verbindungseigenschaften die Werte für die Eigenschaften ein.
          Tabelle : 4. Service Graph-Verbindungseigenschaften
          Eigenschaft Beschreibung
          Nutzungsdaten erfassen Aktivieren Sie die Erfassung von Nutzungsdaten, um API-Nutzungsdaten für eine angegebene Dauer abzurufen.
          Sammlungszeitraum (in Tagen) Dauer in Tagen für die Erfassung von API-Nutzungsdaten.
          Discovery-Bereich Discovery-Bereich von Apigee X Anwendung. Verfügbare Optionen:
          Organisation
          Wählen Sie Aus Organisation Wenn ServiceNow Der Service-Account hat Zugriff auf Daten innerhalb von Apigee X Organisation.
          Projekte
          Wählen Sie Aus Projekte Wenn ServiceNow Service-Account hat Zugriff auf Daten in Apigee X Nur Projekte.
          Erweitern Sie HTTP-Methodentypen Methodentypen, die für Routen berücksichtigt werden sollen, die alle HTTP-Methoden zulassen ( ABRUFEN , VERÖFFENTLICHEN , PLATZIEREN , PATCH , LÖSCHEN , OPTIONEN , KOPF , VERBINDEN , ABLAUFVERFOLGUNG ).

          Trennen Sie mehrere Methodentypen durch Kommas. Alle aufgeführten Methodentypen werden für die Weiterleitungsverarbeitung berücksichtigt.

          Wenn Sie dieses Feld leer lassen, werden standardmäßig alle HTTP-Methodentypen berücksichtigt.
          Umgebungen Einschließen Apigee X Umgebungen, die in die Verbindung aufgenommen werden sollen.

          Trennen Sie mehrere Umgebungen durch Kommas. Nur API-Proxys in den in aufgeführten Umgebungen Include environmentsEigenschaft wird importiert.

          Wenn Sie dieses Feld leer lassen, importieren die Datenquellen im Connector API-Proxys aus allen Umgebungen.
          Organisations-ID Organisation innerhalb von Apigee X System, zu dem das Projekt gehört.
          Seitengröße Anzahl der Datensätze pro Seite. Der Standardwert ist 100 , Minimum ist 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 leer gelassen, wird der Wert automatisch berechnet.
          Projekt-ID Projektbezeichner innerhalb von Apigee X Umgebung, mit der die Verbindung verknüpft wird.

          Trennen Sie mehrere Projekt-IDs durch Kommas.
          Tipp:
          Um einen Eigenschaftswert einzugeben, doppelklicken Sie (oder verwenden Sie die Tastenkombination), um einen Wert in einzugeben Wert Zelle für die Eigenschaft.
        3. Legen Sie fest Fügen Sie Konfigurationseigenschaften 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 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 , Wählen Sie aus Aktualisieren .

          Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Korrekturvorschläge.

        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 .
    5. Wahlweise: Integration mit mehreren Apigee X Instanzen.
      1. In Fügen Sie Mehrere Instanzen Hinzu Abschnitt von API Service Graph Connector für Apigee X Seite auswählen Starten .
      2. Aktivieren Sie die Erstellung von Datenquellen für die neue Apigee X Verbindung.
        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. Um den Datensatz zu bearbeiten, wählen Sie aus 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 aktualisieren , Und Kann löschen Kontrollkästchen.
        5. Wählen Sie Aktualisieren.
        6. Wählen Sie in der Anwendungsauswahl aus API Service Graph Connector für Apigee XAnwendungsbereich.
        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 eines geplanten Importauftrags für den neuen Apigee X Verbindung.
        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 Für Den Geplanten Datenimport Aufgabe.
        3. Um den Datensatz zu bearbeiten, wählen Sie aus Global Anwendungsbereich aus der Anwendungsauswahl.
        4. Wählen Sie in der zugehörigen Liste Anwendungszugriff des Formulars Geplanter Datenimport die Option aus Kann erstellen , Kann aktualisieren , Und Kann löschen Kontrollkästchen.
        5. Wählen Sie Aktualisieren.
        6. Wählen Sie in der Anwendungsauswahl aus API Service Graph Connector für Apigee XAnwendungsbereich.
        7. Legen Sie fest Aktualisieren Sie Den Zugriff Für 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. In Skript ausführen Textfeld der Seite „Hintergrundskript“: Geben Sie das folgende Skript 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");     
GlideTableManager.invalidateTable("sys_attachment");
GlideCacheManager.flushTable("sys_attachment");
        3. Wählen Sie Aus Skript Ausführen Um das Hintergrundskript in auszuführen Global Umfang.

          Die Ausführung des Skripts kann einige Minuten dauern.

        4. Wählen Sie nach der Ausführung des Skripts aus Schließen .
        5. Wählen Sie in der Anwendungsauswahl aus API Service Graph Connector für Apigee XAnwendungsbereich.
        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. Dient zum Erstellen eines X.509-Zertifikats für das neue Apigee X Instanz, wiederholen Sie den Schritt 4.d, Und markieren Sie dann Erstellen Sie ein X.509-Zertifikat Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
      6. Fügen Sie eine weitere Verbindung für die neue hinzu Apigee X Instanz.
        1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Apigee XAnwendung 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 zu Verbindung, Service-Account und Schlüsselspeicher ein, einschließlich Schlüsselspeicher-Passwort.

          Sie haben den Schlüsselspeicher in Schritt erstellt 5.e.

        5. Wählen Sie OAuth-Token erstellen und abrufen aus.
        6. Schließen Sie die Seite „Verbindungen“, und kehren Sie zur Registerkarte der geführten Setup-Seite 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 .
      7. Fügen Sie Eigenschaften für die neue Verbindung hinzu.
        1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Apigee XAnwendung mithilfe der Anwendungsauswahl.
        2. Wählen Sie aus Fügen Sie Konfigurationseigenschaften hinzu Aufgabe.
        3. Von Name Spalte wählen Sie den Verbindungsnamen aus, den Sie in Schritt erstellt haben 5.f.
        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.f.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 Konfigurationseigenschaften 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 .
      8. Testen Sie die neue Verbindung.
        1. Wählen Sie aus Testen Sie Neue Verbindungen Aufgabe.
        2. Von Name Spalte wählen Sie den Verbindungsnamen aus, den Sie in Schritt erstellt haben 5.f.
        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 , Wählen Sie aus Aktualisieren .

          Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Korrekturvorschläge.

        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 .
    6. Konfigurieren Sie die geplante Aufgabe für den Import von Apigee X Daten.
      1. In Richten Sie geplante Importaufträge ein Abschnitt von API Service Graph Connector für Apigee X Seite auswählen Starten .
      2. Wählen Sie aus Organisation 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.f.
      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 .
    7. Auf der API Service Graph Connector für Apigee X Seite auswählen Abgeschlossen Um Ihre Änderungen zu speichern.
    8. Wählen Sie im Dialogfeld Setup abschließen die Option aus Abgeschlossen Um das Setup abzuschließen.
    9. Wählen Sie im angezeigten Meldungsfeld die Option aus Fertig .