Konfigurieren Sie API Service Graph Connector für Apigee X mithilfe des geführten Setups
Richten Sie geplante Importaufträge ein, um Apigee X -Daten in Ihre CMDBabzurufen.
Vorbereitungen
- Die Store App Integration Common for CMDB (Integration Common für CMDB), die automatisch installiert wird. Siehe Gemeinsame Komponenten für CMDB-Integrationen.
- Die Store-App CMDB CI-Klassenmodelle, die automatisch installiert wird. Weitere Informationen finden Sie unter CMDB CI-Klassenmodelle.
- Plugin „ITOM Discovery License“ (com.snc.itom.discovery.license). Sie müssen dieses Plugin aktivieren.
- ITOM-Lizenzierungs-Plugin (com.snc.itom.license). Weitere Informationen finden Sie unter Request Discovery.
Erforderliche Rolle: Administrator
Prozedur
-
Stellen Sie mithilfe der Anwendungsauswahl sicher, dass der Anwendungsbereich auf die Anwendung API Service Graph Connector für Apigee X festgelegt ist.
Weitere Informationen finden Sie unter Anwendungsauswahl.
- Navigieren zu Alle > Service Graph Connectors > Apigee X > Setup.
- Wählen Sie auf der Seite API Service Graph Connector für Apigee X die Option Fortsetzenaus.
-
Konfigurieren Sie die Authentifizierungsanmeldeinformationen, um Anforderungen an die Anwendung Apigee X zu senden.
- Wählen Sie auf der Seite API Service Graph Connector für Apigee X im Abschnitt „Verbindung und Anmeldeinformationen konfigurieren“Startenaus.
-
Erteilen Sie die Berechtigung zum Aktualisieren von Anhängen, damit die Datenquelle „SGA Apigee X Front-End Back-End“ Dateien von Apigee X abrufen und an Datensätze anhängen kann.
- Wählen Sie die Aufgabe Zugriff auf Anhang aktualisieren aus.
- Wählen Sie in der Anwendungsauswahl den Anwendungsbereich Global aus.
- Aktivieren Sie in der zugehörigen Liste „Anwendungszugriff“ der Unterseite „Anhang“ das Kontrollkästchen Kann aktualisieren, und wählen Sie dann Aktualisierenaus.
- Wählen Sie in der Anwendungsauswahl den Anwendungsbereich API Service Graph Connector für Apigee X aus.
- Legen Sie die Aufgabe Zugriff auf Anhang aktualisieren auf Abgeschlossen fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und dann Fortsetzenwählen.
-
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.
- Wählen Sie die Aufgabe „Apigee X Setup-Anweisungen“ aus.
- Ü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.
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.
- Legen Sie die Aufgabe „Apigee X-Setup-Anweisungen“ auf „Abgeschlossen“ fest, indem Sie das Kontrollkästchen „ Als abgeschlossen markieren“ aktivieren und dann Fortfahrenauswählen.
-
Erstellen Sie ein X.509-Zertifikat, um das Java KeyStore-Zertifikat (JKS) für die Anwendung Apigee X dem Connector zuzuordnen.
- Wählen Sie die Aufgabe X.509-Zertifikat erstellen aus.
- Wählen Sie Neu.
- 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.Benachrichtigung bei Ablauf Benutzer, die benachrichtigt werden sollen, wenn das Zertifikat abläuft. Wenn keine Benutzer ausgewählt sind, wird der angemeldete Benutzer standardmäßig zusammen mit den letzten beiden angemeldeten Benutzern mit der Administratorrolle hinzugefügt. Tage vor Ablauf benachrichtigen Anzahl der Tage zum Senden einer Benachrichtigung, bevor das Zertifikat abläuft. Aktiv Option zum Aktivieren des -Zertifikats. Typ Zertifikatcontainer, der automatisch auf Java Key Storefestgelegt ist. Belassen Sie den Feldwert auf Java Key Store. 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 im vorherigen Schrittnotiert. Kurzbeschreibung Beschreibung des X.509-Zertifikats. - Wählen Sie das Symbol zum Verwalten von Anhängen (
).
- Wählen Sie Datei wählen aus, um die Datei keystore.p12 für das JKS-Zertifikat zu durchsuchen und hochzuladen, das Sie in Schritt 4.cerstellt haben.
- Schließen Sie das Dialogfeld.
- Wählen Sie den zugehörigen Link Speicher/Zertifikate validieren aus.
- Wählen Sie bei erfolgreicher Validierung Aktualisieren aus, um zur Seite des geführten Setups zurückzukehren.
- Legen Sie die Aufgabe X.509-Zertifikat erstellen auf Abgeschlossen fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und anschließend Fortsetzenwählen.
-
Konfigurieren Sie die Verbindung.
- Stellen Sie mithilfe der Anwendungsauswahl sicher, dass der Anwendungsbereich auf die Anwendung API Service Graph Connector für Apigee X festgelegt ist.
- Wählen Sie die Aufgabe Verbindung konfigurieren aus.
- Wählen Sie Hier klicken, um die Seite „Verbindungen“ in einer separaten Browserregisterkarte zu öffnen.
- Suchen Sie nach Bearbeiten für SGA Apigee X-Verbindung, und wählen Sie Bearbeiten.
- Füllen Sie im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ die Felder aus.
Tabelle : 2. Verbindungsinformation Feld Beschreibung Verbindungsname Name zur Identifizierung des Apigee X -Verbindungsdatensatzes. „SGA Apigee X Connection“ist der standardmäßige Aliasname für Anmeldeinformationen. Sie können mehrere Apigee X -Instanzen hinzufügen. Versuchen Sie jedoch nicht, den Standardverbindungsnamen zu ändern. - Füllen Sie im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung bearbeiten“ die Felder aus.
Tabelle : 3. Anmeldedaten Feld Beschreibung 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 Abschnitt „ Bevor Sie beginnen“ angegeben. X.509-Zertifikat In Schritt 4.derstelltes X.509-Zertifikat. Schlüsselspeicher-Passwort Passwort, das dem Schlüsselspeicher zugeordnet ist, wie im Abschnitt „Bevor Sie beginnen“ angegeben. - Wählen Sie Bearbeiten und OAuth-Token abrufen aus.
- Wählen Sie Aktualisieren.
- Wenn der OAuth-Token-Flow erfolgreich abgeschlossen wurde, kehren Sie zur Seite des geführten Setups zurück, und legen Sie die Aufgabe Konfiguration der Verbindung auf abgeschlossen fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren und dann Fortsetzenwählen.
-
Konfigurieren Sie die Eigenschaften des Connectors für den Zugriff auf -Ressourcen.
- Wählen Sie die Aufgabe Konfigurationseigenschaften hinzufügen aus.
- Geben Sie in der zugehörigen Liste Service Graph-Verbindungseigenschaften die Werte für die Eigenschaften ein.
Tabelle : 4. Service Graph-Verbindungseigenschaften Eigenschaft Beschreibung CollectionPeriod (Tage) Dauer der Erfassung von API-Nutzungsdaten in Tagen. SammlungNutzungsdaten Aktivieren Sie die Nutzungsdatenerfassung, um API-Nutzungsdaten über einen angegebenen Zeitraum abzurufen. 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.
Organisations-ID Organisation im System Apigee X, zu der das Projekt gehört. Seitengröße Anzahl der Datensätze pro Seite. Der Standardwert ist 100, der Mindestwert2.Partitionsgröße 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.
Projekt-ID Projektbezeichner in der Umgebung Apigee X, mit dem 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 die Zelle Wert für die Eigenschaft einzugeben. - Legen Sie die Aufgabe Konfigurationseigenschaften hinzufügen auf den Abschluss fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren, und wählen Sie dann Weiteraus.
-
Testen Sie die Verbindung.
- Wählen Sie die Aufgabe Verbindung testen aus.
- Testen Sie die Verbindung, indem Sie den zugehörigen Link Test Connection (Verbindung testen) auswählen.
Das Testen der Verbindung kann einige Minuten dauern. Die Seite wird aktualisiert, um die Testergebnisse anzuzeigen.
- Wenn das Feld Status auf Erfolgfestgelegt ist, wählen Sie Aktualisieren.
Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.
- Setzen Sie die Aufgabe Testverbindung auf den Abschluss, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und dann Fortsetzenwählen.
- Wahlweise:
Integration mit mehreren Apigee X -Instanzen.
- Wählen Sie auf der Seite API Service Graph Connector für Apigee X im Abschnitt „Mehrere Instanzen hinzufügen“ Startenaus.
-
Aktivieren Sie die Erstellung von Datenquellen für die neue Apigee X -Verbindung.
- Vergewissern Sie sich, dass Sie über Bearbeitungsberechtigungen für die Tabelle Datenquelle [sys_data_source] verfügen.
- Wählen Sie die Aufgabe Datenquellenzugriff aktualisieren aus.
- Um den Datensatz zu bearbeiten, wählen Sie in der Anwendungsauswahl den Anwendungsbereich Global aus.
- Aktivieren Sie in der zugehörigen Liste „Anwendungszugriff“ des Formulars „Datenquelle“, das auf einer anderen Registerkarte geöffnet wird, die Kontrollkästchen „ Kann erstellen“, „Kann aktualisieren“ und „Kann löschen“.
- Wählen Sie Aktualisieren.
- Wählen Sie in der Anwendungsauswahl den Anwendungsbereich API Service Graph Connector für Apigee X aus.
- Legen Sie die Aufgabe „Datenquellenzugriff aktualisieren“ auf „Abgeschlossen“ fest, indem Sie das Kontrollkästchen „Als abgeschlossen markieren“ aktivieren, und wählen Sie dann Weiteraus.
-
Aktivieren Sie die Erstellung eines geplanten Importauftrags für die neue Verbindung Apigee X.
- Vergewissern Sie sich, dass Sie über Bearbeitungsberechtigungen für die Tabelle „Geplanter Datenimport“ [schedule_import_set] verfügen.
- Wählen Sie die Aufgabe Zugriff für geplanten Datenimport aktualisieren aus.
- Um den Datensatz zu bearbeiten, wählen Sie in der Anwendungsauswahl den Anwendungsbereich Global aus.
- Aktivieren Sie in der zugehörigen Liste „Anwendungszugriff“ des Formulars „Geplanter Datenimport“ die Kontrollkästchen „ Kann erstellen“, „Kann aktualisieren“ und „Kann löschen“.
- Wählen Sie Aktualisieren.
- Wählen Sie in der Anwendungsauswahl den Anwendungsbereich API Service Graph Connector für Apigee X aus.
- Legen Sie die Aufgabe „Zugriff für geplanten Datenimport aktualisieren“ auf „Abgeschlossen“ fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und anschließend Fortfahrenwählen.
-
Leeren Sie den Cache in den Tabellen „Datenquelle“ [sys_data_source] und „Geplante Datenimporte“ [schedule_import_set].
- Wählen Sie die Aufgabe Cache für Datenquellen und geplante Datenimporte leeren aus.
- Um den Datensatz zu bearbeiten, wählen Sie in der Anwendungsauswahl den Anwendungsbereich Global aus.
- Geben Sie im Feld Skript ausführen den folgenden Code 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"); - Wählen Sie Skript ausführenaus.
- Wählen Sie in der Anwendungsauswahl den Anwendungsbereich API Service Graph Connector für Apigee X aus.
- Legen Sie die Aufgabe Cache für Tabellen mit Datenquellen und geplanten Datenimporten leeren auf den Abschluss fest, indem Sie Als abgeschlossen markierenwählen.
- Zum Erstellen eines X.509-Zertifikats für die neue Instanz Apigee X wiederholen Sie Schritt 4.dund markieren dann die Aufgabe X.509-Zertifikat erstellen zum Abschließen, indem Sie Als abgeschlossen markierenwählen.
-
Fügen Sie eine weitere Verbindung für die neue Instanz Apigee X hinzu.
- Stellen Sie mithilfe der Anwendungsauswahl sicher, dass der Anwendungsbereich auf die Anwendung API Service Graph Connector für Apigee X festgelegt ist.
- Wählen Sie die Aufgabe Weitere Verbindung hinzufügen und dann Klicken Sie hieraus.
- Wählen Sie auf der Seite „Verbindungen“, die in einer anderen Browserregisterkarte geöffnet wird, Verbindung hinzufügen.
- Füllen Sie im Fenster Verbindung erstellen die Verbindungs-, Service-Account- und Schlüsselspeicherdetails einschließlich Schlüsselspeicherpasswort aus.
Sie haben den Schlüsselspeicher in Schritt 5.eerstellt.
- Wählen Sie OAuth-Token erstellen und abrufen aus.
- Schließen Sie die Seite „Verbindungen“, und kehren Sie zur Registerkarte des geführten Setups zurück.
- Setzen Sie die Aufgabe Weitere Verbindung hinzufügen auf den Abschluss, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren, und wählen Sie dann Weiteraus.
-
Fügen Sie Eigenschaften für die neue Verbindung hinzu.
- Stellen Sie mithilfe der Anwendungsauswahl sicher, dass der Anwendungsbereich auf die Anwendung API Service Graph Connector für Apigee X festgelegt ist.
- Wählen Sie die Aufgabe Konfigurationseigenschaften hinzufügen aus.
- Wählen Sie in der Spalte „Name“ den Verbindungsnamen aus, den Sie in Schritt 5.ferstellt haben.
- 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 die Zelle Wert für die Eigenschaft einzugeben. - Legen Sie die Aufgabe Konfigurationseigenschaften hinzufügen auf den Abschluss fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren, und wählen Sie dann Weiteraus.
-
Testen Sie die neue Verbindung.
- Wählen Sie die Aufgabe Neue Verbindungen testen aus.
- Wählen Sie in der Spalte „Name“ den Verbindungsnamen aus, den Sie in Schritt 5.ferstellt haben.
- Testen Sie die Verbindung, indem Sie den zugehörigen Link Test Connection (Verbindung testen) auswählen.
Das Testen der Verbindung kann einige Minuten dauern. Die Seite wird aktualisiert, um die Testergebnisse anzuzeigen.
- Wenn das Feld Status auf Erfolgfestgelegt ist, wählen Sie Aktualisieren.
Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.
- Legen Sie die Aufgabe Neue Verbindungen testen auf den Abschluss fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und dann Fortfahrenwählen.
-
Konfigurieren Sie die geplante Aufgabe für den Import von Apigee X -Daten.
- Wählen Sie im Abschnitt Geplante Importaufträge einrichten der Seite API Service Graph Connector für Apigee XStarten aus.
-
Wählen Sie die geplante Aufgabe „SGA Apigee X Organization“ aus.
Wählen Sie für ein Setup mit mehreren Instanzen den geplanten Import aus, der mit der Verbindung in Schritt 5.ferstellt wurde.
-
Überprüfen Sie im Formular „Geplanter Datenimport“ die Feldwerte.
Weitere Informationen finden Sie unter Schedule a data import.
- Aktivieren Sie das Kontrollkästchen Aktiv, um die geplante Aufgabe zu aktivieren.
- Wählen Sie im Feld Ausführen die Option Regelmäßig aus, um anzugeben, wie häufig die Aufgabe ausgeführt werden soll.
- Wählen Sie Aktualisieren.
- Legen Sie die Aufgabe Geplante Importaufträge einrichten auf den Abschluss fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und anschließend Fortfahrenwählen.
- Wählen Sie auf der Seite API Service Graph Connector für Apigee X die Option Abschließen aus, um Ihre Änderungen zu speichern.
- Wählen Sie im Dialogfeld Setup abschließen die Option Abschließen aus, um das Setup abzuschließen.
- Wählen Sie im angezeigten Meldungsfeld Fertig aus.