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

Richten Sie geplante Importaufträge zum Abrufen ein Apigee XDaten in Ihr CMDB.

Vorbereitungen

Wichtig:

Sofern keine Probleme auftreten, verwenden Sie SGC CentralAnzeigen, da die Methode des geführten Setups veraltet ist. Wenn eine Verbindung mithilfe des geführten Setups konfiguriert wird, wird die Verbindung möglicherweise nicht in angezeigt SGC CentralAnsicht.

Abhängigkeiten und Anforderungen:

• Die Store-App „Integration Commons für CMDB“, die automatisch installiert wird. Siehe Integrationsgemeinschaften 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.
• ITOM-Lizenzierung-Plugin (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 XAnwendung mithilfe der Anwendungsauswahl.
   Weitere Informationen finden Sie unter Anwendungsauswahl .
2. Navigieren zu Alle > Service Graph Connectors > Apigee X > Einrichtungan.
3. Auf API Service Graph Connector für Apigee XSeite auswählen Fahren Sie Fort .
4. Konfigurieren Sie die Anmeldeinformationen für die Authentifizierung, um Anforderungen an zu senden Apigee XAnwendung.
   1. In Konfigurieren Sie die Verbindung und Anmeldeinformationen Abschnitt von API Service Graph Connector für Apigee XSeite auswählen Starten .
   2. Gewähren Sie die Berechtigung zum Aktualisieren des Anhangs, damit die SGA Apigee X-Frontend-Back-End-Datenquelle Dateien von abrufen kann Apigee XUnd an Datensätze anhängen.
      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 auf der Unterseite „Anhang“ die Option aus  Kann aktualisiert werden  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 XUmgebung und erstellen Sie ein Java-Schlüsselspeicher-Zertifikat (JKS), um die von einem abgerufenen Sicherheitszertifikate zu verschlüsseln Apigee XAnwendung.
      1. Wählen Sie aus Apigee X-Setup-Anweisungen Aufgabe.
      2. Überprüfen und schließen Sie die Setup-Anweisungen auf ab API-Servicediagramm-Connector für Apigee X – Setup-Anweisungen [KBB0010364] artikel in Now SupportKnowledge 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 XAnwendung.

      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 Java Keystore-Zertifikat (JKS) für zuzuordnen Apigee XAnwendung 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“ aus ( ).
      5. Wählen Sie Aus Wählen Sie die Datei aus Zum Durchsuchen und Hochladen der Datei „Keystore.p12“ für das in Schritt erstellte JKS-Zertifikat 4.c.
      6. Schließen Sie das Dialogfeld.
      7. Wählen Sie aus Validieren Sie 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 XAnwendung 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 Sie nach, und wählen Sie aus Bearbeiten Für SGA-Apigee-X-Verbindung .
      5. Füllen Sie im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ die Felder aus.

         Tabelle : 2. Verbindungsinformation

         Feld	Beschreibung
         Verbindungsname	Name zur Identifizierung von Apigee XVerbindungsdatensatz. SGA-Apigee-X-Verbindung Ist der standardmäßige Aliasname für Anmeldeinformationen. Sie können mehrere hinzufügen Apigee XInstanzen. Versuchen Sie jedoch, den Standardverbindungsnamen nicht zu ändern.

      6. Füllen Sie im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung bearbeiten“ die Felder aus.

         Tabelle : 3. Anmeldedaten

         Feld	Beschreibung
         Service-Account-E-Mail	E-Mail-Adresse, die dem zugeordnet ist ServiceNowService-Account, der für die Authentifizierung mit verwendet wird Apigee XWie 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 rufen Sie das OAuth-Token ab .
      8. Wählen Sie Aktualisieren.
      9. Wenn der OAuth-Token-Flow erfolgreich abgeschlossen wurde, kehren Sie zur Seite „geführtes Setup“ 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
         Sammlungszeitraum (Tage)	Dauer in Tagen für die Erfassung von API-Nutzungsdaten.
         SammlungNutzungsdaten	Aktivieren Sie die Erfassung von Nutzungsdaten, um API-Nutzungsdaten für eine angegebene Dauer abzurufen.
         Discovery-Bereich	Discovery-Bereich von Apigee XAnwendung. Verfügbare Optionen: Organisation Wählen Sie Aus Organisation Wenn ServiceNowService-Account hat Zugriff auf Daten in Apigee XOrganisation. Projekte Wählen Sie Aus Projekte Wenn ServiceNowService-Account hat Zugriff auf Daten in Apigee XNur Projekte.
         Umgebungen Ausschließen	Apigee X Umgebungen, die von der Verbindung ausgeschlossen werden sollen. Trennen Sie sie für mehrere Umgebungen durch Kommas. Alle Gateways mit Ausnahme der in aufgeführten Exclude EnvironmentsEigenschaft wird abgerufen.
         Organisations-ID	Organisation innerhalb von Apigee XSystem, zu dem das Projekt gehört.
         Seitengröße	Anzahl der Datensätze pro Seite. Standard ist 100 , Minimum ist 2 .
         Partitionsgröße	Partitionsgröße für Apigee XVerwaltete 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 XUmgebung, mit der die Verbindung verknüpft wird. Trennen Sie für mehrere Projekt-IDs diese 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 , Auswählen Aktualisieren .

         Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.

      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 XInstanzen.
   1. In Fügen Sie Mehrere Instanzen Hinzu Abschnitt von API Service Graph Connector für Apigee XSeite auswählen Starten .
   2. Aktivieren Sie die Erstellung von Datenquellen für die neue Apigee XVerbindung.
      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. Wählen Sie aus, um den Datensatz zu bearbeiten 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 aktualisiert werden , 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 einer geplanten Importaufgabe für die neue Apigee XVerbindung.
      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 Auf Den Geplanten Datenimport Aufgabe.
      3. Wählen Sie aus, um den Datensatz zu bearbeiten Global Anwendungsbereich aus der Anwendungsauswahl.
      4. Wählen Sie in der zugehörigen Liste „Anwendungszugriff“ des Formulars „Geplanter Datenimport“ die aus Kann erstellen , Kann aktualisiert werden , 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 Auf 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. Wählen Sie aus, um den Datensatz zu bearbeiten Global Anwendungsbereich aus der Anwendungsauswahl.
      3. In Skript ausführen Geben Sie 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");

      4. Wählen Sie Aus Skript ausführen .
      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. Zum Erstellen eines X.509-Zertifikats für das neue Apigee XInstanz, 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 XInstanz.
      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 Verbindungs-, Service-Account- und Schlüsselspeicherdetails ein, einschließlich Schlüsselspeicher-Passwort.

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

      5. Wählen Sie Aus OAuth-Token erstellen und abrufen .
      6. Schließen Sie die Seite „Verbindungen“, und kehren Sie zur Registerkarte „geführte Einrichtung“ 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 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 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 , Auswählen Aktualisieren .

         Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.

      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 XDaten.
   1. In Richten Sie geplante Importaufträge ein Abschnitt von API Service Graph Connector für Apigee XSeite auswählen Starten .
   2. Wählen Sie aus SGA-Apigee X-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 API Service Graph Connector für Apigee XSeite 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 Nachrichtenfeld aus Fertig .