Konfigurieren API Service Graph Connector für Apigee X Verwenden SGC Central

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

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

    Vorbereitungen

    Installieren API Service Graph Connector für Apigee X Version 1.0.0 oder höher aus ServiceNow Store. Für ServiceNow StoreInstallationsschritte, siehe Installieren Sie eine ServiceNow Store-Anwendung .

    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 Apigee X 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. Erfüllen Sie die Voraussetzungen für die Einrichtung von Apigee X Umgebung.
      1. 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. In Voraussetzungen Phase des Playbooks wählen Sie aus Überprüfen Sie die Setup-Anweisungen Aktivität.
        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.

          Sie müssen einen Service-Account erstellen, Rollen zuweisen, Rollen an den Service-Account binden, APIs aktivieren, eine P12-Datei erstellen und in registrieren ServiceNow Instanz.

          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. Wählen Sie aus Ich habe die Setup-Anweisungen gelesen Kontrollkästchen, um zu bestätigen, dass Sie eingerichtet haben Apigee X Umgebung gemäß den Anweisungen.
        4. Wählen Sie Fortsetzen.
      2. Erstellen Sie ein X.509-Zertifikat, um das JKS-Zertifikat (Java Keystore) für zuzuordnen Apigee X Anwendung mit dem Connector.
        Hinweis:
        Sie können diesen Schritt überspringen, wenn Sie ein zuvor erstelltes Zertifikat wiederverwenden.
        1. In Voraussetzungen Phase des Playbooks wählen Sie aus Erstellen Sie ein X.509-Zertifikat Aktivität.
        2. 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 .
          Schlüsselspeicher-Passwort Passwort für den Zugriff auf das JKS-Zertifikat, wie in angegeben Vorheriger Schritt .
          Kurzbeschreibung Beschreibung des X.509-Zertifikats.
        3. Wählen Sie im Abschnitt Anhänge die Option aus Datei Hinzufügen .
        4. Durchsuchen und wählen Sie die P12-Datei für das JKS-Zertifikat aus, das Sie in erstellt haben Vorheriger Schritt .
        5. Wählen Sie im Dialogfeld Datei hochladen die Option aus Hochladen .
        6. Wählen Sie Fortsetzen.
    7. Geben Sie Verbindungsdetails ein, und testen Sie die API-Verbindung für den Import Apigee X 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 : 2. Verbindungsformular konfigurieren und testen
        Feld Beschreibung
        Verbindungsname Name zur Identifizierung von Apigee X Verbindungsdatensatz.
        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 Vorheriger Schritt .
        X.509-Zertifikat Name des X.509-Zertifikats, wie in angegeben Vorheriger Schritt .
        Schlüsselspeicher-Passwort Passwort, das dem Schlüsselspeicher zugeordnet ist, wie in angegeben Vorheriger Schritt .
      3. Wählen Sie Aus Verbindung erstellen und testen .
      4. Sobald der Verbindungstest abgeschlossen ist, wählen Sie aus Fahren Sie Fort .
    8. Legen Sie die Konfigurationseigenschaften für die Verbindung fest.
      1. In Setup Phase des Playbooks wählen Sie aus Legen Sie Konfigurationseigenschaften fest Aktivität.
      2. Geben Sie die Eigenschaften ein.
        Tabelle : 3. Service Graph-Verbindungseigenschaften
        Eigenschaft Beschreibung
        Apigee-Identifizierung
        Organisations-ID Organisation innerhalb von Apigee X System, zu dem die Projekte gehören.
        Projekt-ID Projektbezeichner innerhalb von Apigee X Umgebung, mit der die Verbindung verknüpft wird.

        Trennen Sie mehrere Projekt-IDs durch Kommas.
        Datenabrufkonfiguration
        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.
        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.
        Sammlungszeitraum (in Tagen) Dauer in Tagen für die Erfassung von API-Nutzungsdaten.
        Nutzungsdaten erfassen Option zum Aktivieren der Nutzungsdatensammlung zum Abrufen von API-Nutzungsdaten über einen angegebenen Zeitraum.
        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 Methoden durch Kommas. Alle aufgeführten Methoden werden für die Weiterleitungsverarbeitung berücksichtigt.
        Leistungskonfiguration
        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.
      3. Wählen Sie Fortsetzen.
    9. 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. Wählen Sie Aus Konfigurieren Sie den Importzeitplan .
      3. In Konfigurieren Sie den Importzeitplan Dialogfeld im Name Geben Sie ein Organisation Zeitplan importieren.
      4. Wählen Sie 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.

      5. Wählen Sie Speichern.
      6. Für Konfigurieren Sie den Importzeitplan Aktivität, wählen Sie aus Fahren Sie Fort .
    10. 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 konfigurierte Verbindung wird in der Liste der installierten Verbindungen angezeigt.