Konfigurieren API Service Graph Connector für Kong Gateway Mit dem geführten Setup
Richten Sie geplante Importaufträge zum Abrufen ein Kong Gateway Daten in Ihrem Configuration Management Database (CMDB).
Vorbereitungen
- 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.
Rufen Sie für die Standardauthentifizierung den Anwendernamen und das Passwort ab, die für die Authentifizierung von Anforderungen an erforderlich sind Kong-Gateway-Administrator API.
Rufen Sie für die tokenbasierte Authentifizierung den API-Schlüssel für die Verbindung mit ab Kong Gateway Service.
Erforderliche Rolle: Administrator
Prozedur
-
Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für Kong GatewayAnwendung mithilfe der Anwendungsauswahl.
Weitere Informationen finden Sie unter Anwendungsauswahl .
- Navigieren zu Alle > Service Graph Connectors > Kong-Gateway > Setupan.
-
Konfigurieren Sie den Authentifizierungstyp, die Anmeldeinformationen und die HTTP-Verbindungsdetails.
- In Konfigurieren Sie Verbindung und Anmeldeinformationen Abschnitt von Kong-Gateway-Integration mit CMDB Seite auswählen Erste Schritte .
-
Konfigurieren Sie den Authentifizierungstyp.
- Für Legen Sie den Authentifizierungstyp fest Aufgabe, wählen Sie aus Konfigurieren .
- Legen Sie fest Auth TypeEigenschaft für einen der folgenden Werte:
Standard: Standardauthentifizierung, die einen Anwendernamen und ein Passwort verwendet.Token: Token-basierte Authentifizierung, die einen Anwendernamen und ein Passwort zum Abrufen eines Tokens verwendet.
- Wählen Sie Aktualisieren.
- Legen Sie fest Legen Sie den Authentifizierungstyp fest Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
-
Konfigurieren Sie die Anmeldeinformationen für die Authentifizierung, die zum Senden von Anforderungen an verwendet werden Kong-Gateway-Administrator API.
- Für Konfigurieren Sie die Verbindung Aufgabe, wählen Sie aus Konfigurieren .
- Wählen Sie basierend auf dem Authentifizierungstyp den Verbindungstyp aus.
- Suchen Sie für die Standardauthentifizierung auf der Seite „Verbindungen“ nach , und wählen Sie sie aus Kong-Standardauthentifizierung Und wählen Sie dann aus Details Anzeigen .
- Suchen Sie für die tokenbasierte Authentifizierung auf der Seite „Verbindungen“ nach , und wählen Sie aus Kong-RBAC-Authentifizierung Und wählen Sie dann aus Details Anzeigen .
- Bearbeiten Sie die Standardauthentifizierungsdetails, die standardmäßig verfügbar sind.Hinweis:Überspringen Sie diesen Schritt, wenn Sie eine tokenbasierte Authentifizierung verwenden.
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ aus.
Tabelle : 1. Verbindungsinformation Feld Beschreibung Verbindungsname Name zur Identifizierung von Kong Gateway Verbindungsdatensatz. Kong-StandardauthentifizierungIst der Standardverbindungsname. Sie können mehrere hinzufügen Kong Gateway Instanzen. Versuchen Sie jedoch, den Standardverbindungsnamen nicht zu ändern.Hostname Zieldomänenname oder IP-Adresse, der für den Zugriff auf verwendet wird Kong Gateway Instanz. Protokoll Protokoll, das für die Verbindung verwendet wird, um eine gesicherte Kommunikation zwischen dem Client und dem sicherzustellen Kong Server. Dieses Feld wird automatisch auf festgelegt https. Gültige Werte sind:- http
- https
Standardport überschreiben Von verwendeter Port Kong-Administrator API. - Füllen Sie die Felder im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung bearbeiten“ aus.
Tabelle : 2. Anmeldedaten Feld Beschreibung Anwendername Anwendername, der zum Authentifizieren von Anforderungen an erforderlich ist Kong-Gateway-Administrator API wie in angegeben Bevor Sie beginnen Abschnitt. Passwort Passwort, das dem Anwendernamen zugeordnet ist, der für die Authentifizierung von Anforderungen erforderlich ist, wie in angegeben Bevor Sie beginnen Abschnitt. - Wählen Sie Aus Bearbeiten Sie Die Verbindung .
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ aus.
- Bearbeiten Sie die standardmäßig verfügbaren Details zur tokenbasierten Authentifizierung.Hinweis:Überspringen Sie diesen Schritt, wenn Sie die Standardauthentifizierung verwenden.
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ aus.
Tabelle : 3. Verbindungsinformation Feld Beschreibung Verbindungsname Name zur Identifizierung von Kong Gateway Verbindungsdatensatz. Kong-RBAC-AuthentifizierungIst der Standardverbindungsname. Sie können mehrere hinzufügen Kong Gateway Instanzen. Versuchen Sie jedoch, den Standardverbindungsnamen nicht zu ändern.Hostname Zieldomänenname oder IP-Adresse, der für den Zugriff auf verwendet wird Kong Gateway Instanz. Protokoll Protokoll, das für die Verbindung verwendet wird, um eine gesicherte Kommunikation zwischen dem Client und dem sicherzustellen Kong Server. Dieses Feld wird automatisch auf festgelegt https. Gültige Werte sind:- http
- https
Standardport überschreiben Von verwendeter Port Kong-Administrator API. - Im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung bearbeiten“ in API-Schlüssel Geben Sie das geheime Authentifizierungsgeheimnis ein, um eine Verbindung mit herzustellen Kong Gateway Service wie in angegeben Bevor Sie beginnen Abschnitt.
- Wählen Sie Aus Bearbeiten Sie Die Verbindung .
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung bearbeiten“ aus.
- Legen Sie fest Konfigurieren Sie die Verbindung Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
-
Konfigurieren Sie die Eigenschaften, um den Umfang des Datenabrufs zu steuern.
- Für Legen Sie Konfigurationseigenschaften fest Aufgabe, wählen Sie aus Konfigurieren .
- Konfigurieren Sie in der zugehörigen Liste Service Graph-Verbindungseigenschaften die Eigenschaften.
Tabelle : 4. Eigenschaften Eigenschaft Beschreibung Arbeitsbereiche ausschließen Name des auszuschließenden Arbeitsbereichs. Entitäten in diesem Arbeitsbereich werden nicht in ausgefüllt Kong Gateway Service. Trennen Sie mehrere Arbeitsbereiche durch Kommas. Beispiel:
Arbeitsbereich1,Arbeitsbereich2.Wenn Sie dieses Feld leer lassen, importieren die Datenquellen im Connector Daten aus allen Arbeitsbereichen.
Tags importieren Tags, die aus erfasst werden sollen Kong Gateway Service. Trennen Sie mehrere Tags durch Kommas.
Wenn angegeben, geben Sie das Schlüssel-Wert-Paartrennzeichen für Tags in ein Tags Value SeparatorEigenschaft. Wenn nicht angegeben, werden Tags nicht abgerufen.
Tag-Werttrennzeichen Trennzeichen für Schlüssel und Wert in Tags. Beispiel: Wenn das Tag-Werttrennzeichen auf festgelegt ist
=, Das Tagenv=prodWird mit gespeichertumgebungAls Schlüssel undprodAls Wert.Wenn leer gelassen, werden keine Tags erfasst.
Hinweis:Die Auth Type, Workspaces, Und Load BalancersEigenschaften werden automatisch ausgefüllt. - Legen Sie fest Legen Sie Konfigurationseigenschaften fest Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
-
Testen Sie die Verbindung.
- Für Verbindung testen Aufgabe, wählen Sie aus Konfigurieren .
- 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.
- Wenn Status Feld ist auf festgelegt Erfolg , Wählen Sie aus Aktualisieren .
Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Korrekturvorschläge.
- Legen Sie fest Verbindung testen Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
- Wahlweise:
Fügen Sie mehrere Instanzen hinzu.
Hinweis:Wenn Sie nicht mehrere Instanzen hinzufügen müssen, können Sie diesen Schritt überspringen.
- In Fügen Sie mehrere Instanzen hinzu Abschnitt von Kong-Gateway-Integration mit CMDB Seite auswählen Erste Schritte .
-
Aktivieren Sie die Erstellung von Datenquellen für die neue Kong Gateway Verbindung.
- Stellen Sie sicher, dass Sie über Bearbeitungsberechtigungen für die Tabelle „Datenquelle“ [sys_Data_Source] verfügen.
- Für Aktualisieren Sie den Datenquellenzugriff Aufgabe, wählen Sie aus Konfigurieren .
- Um den Datensatz zu bearbeiten, wählen Sie aus Global Anwendungsbereich aus der Anwendungsauswahl.
- Wählen Sie in der zugehörigen Liste „Anwendungszugriff“ des Formulars „Datenquellenzugriff aktualisieren“ die Option aus Kann erstellen , Kann aktualisieren , Und Kann löschen Kontrollkästchen.
- Wählen Sie Aktualisieren.
- Wählen Sie aus API Service Graph Connector für Kong Gateway Anwendung mithilfe der Anwendungsauswahl.
- Legen Sie fest Aktualisieren Sie den Datenquellenzugriff Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
-
Um das Erstellen von Datenquellen für die neue Verbindung zu ermöglichen, leeren Sie den Cache der Tabellen „Datenquelle“ [sys_Data_Source] und „Tabellen“ [sys_DB_object].
So leeren Sie den Cache:
- Für Leeren Sie den Cache Aufgabe, wählen Sie aus Konfigurieren .
- 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("sys_db_object"); GlideCacheManager.flushTable("sys_db_object"); - Wählen Sie Aus Skript Ausführen Um das Hintergrundskript in auszuführen Global Umfang.
Die Ausführung des Skripts kann einige Minuten dauern.
- Wählen Sie nach der Ausführung des Skripts aus Schließen .
- Wählen Sie aus API Service Graph Connector für Kong Gateway Anwendung mithilfe der Anwendungsauswahl.
- Legen Sie fest Leeren Sie den Cache Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
-
Fügen Sie eine neue Verbindung hinzu.
- Für Fügen Sie eine weitere Verbindung hinzu Aufgabe, wählen Sie aus Konfigurieren .
- Wählen Sie basierend auf dem Authentifizierungstyp den Verbindungstyp aus.
- Suchen Sie für die Standardauthentifizierung auf der Seite „Verbindungen“ nach , und wählen Sie sie aus Kong-Standardauthentifizierung Und wählen Sie dann aus Verbindung Hinzufügen .
- Suchen Sie für die tokenbasierte Authentifizierung auf der Seite „Verbindungen“ nach , und wählen Sie aus Kong-RBAC-Authentifizierung Und wählen Sie dann aus Verbindung Hinzufügen .
- Geben Sie die Details zur Standardauthentifizierung ein.Hinweis:Überspringen Sie diesen Schritt, wenn Sie eine tokenbasierte Authentifizierung verwenden.
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung erstellen“ aus.
Tabelle : 5. Verbindungsinformation Feld Beschreibung Verbindungsname Name zur Identifizierung von Kong Gateway Verbindungsdatensatz. Hostname Zieldomänenname oder IP-Adresse, der für den Zugriff auf verwendet wird Kong Gateway Instanz. Protokoll Protokoll, das für die Verbindung verwendet wird, um eine gesicherte Kommunikation zwischen dem Client und dem sicherzustellen Kong Server. Dieses Feld wird automatisch auf festgelegt https. Gültige Werte sind:- http
- https
Standardport überschreiben Von verwendeter Port Kong-Administrator API. - Füllen Sie die Felder im Abschnitt „Anmeldeinformationen“ des Fensters „Verbindung erstellen“ aus.
Tabelle : 6. Anmeldedaten Feld Beschreibung Anwendername Anwendername, der zum Authentifizieren von Anforderungen an erforderlich ist Kong-Gateway-Administrator API wie in angegeben Bevor Sie beginnen Abschnitt. Passwort Passwort, das dem Anwendernamen zugeordnet ist, der für die Authentifizierung von Anforderungen erforderlich ist, wie in angegeben Bevor Sie beginnen Abschnitt. - Wählen Sie Aus Verbindung Erstellen .
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung erstellen“ aus.
- Geben Sie die Details zur tokenbasierten Authentifizierung ein.Hinweis:Überspringen Sie diesen Schritt, wenn Sie die Standardauthentifizierung verwenden.
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung erstellen“ aus.
Tabelle : 7. Verbindungsinformation Feld Beschreibung Verbindungsname Name zur Identifizierung von Kong Gateway Verbindungsdatensatz. Hostname Zieldomänenname oder IP-Adresse, der für den Zugriff auf verwendet wird Kong Gateway Instanz. Protokoll Protokoll, das für die Verbindung verwendet wird, um eine gesicherte Kommunikation zwischen dem Client und dem sicherzustellen Kong Server. Dieses Feld wird automatisch auf festgelegt https. Gültige Werte sind:- http
- https
Standardport überschreiben Von verwendeter Port Kong-Administrator API. - Im Abschnitt Anmeldeinformationen des Fensters Verbindung erstellen in API-Schlüssel Geben Sie das geheime Authentifizierungsgeheimnis ein, um eine Verbindung mit herzustellen Kong Gateway Service wie in angegeben Bevor Sie beginnen Abschnitt.
- Wählen Sie Aus Verbindung Erstellen .
- Füllen Sie die Felder im Abschnitt „Verbindungsinformationen“ des Fensters „Verbindung erstellen“ aus.
- Legen Sie fest Fügen Sie eine weitere Verbindung hinzu Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
-
Konfigurieren Sie die Eigenschaften für die neue Verbindung.
- Für Legen Sie Konfigurationseigenschaften für die neue Verbindung fest Aufgabe, wählen Sie aus Konfigurieren .
- Wählen Sie in der Spalte Name den Verbindungsdatensatz der neuen Verbindung aus.
- Konfigurieren Sie in der zugehörigen Liste Service Graph-Verbindungseigenschaften die Eigenschaften.
Tabelle : 8. Eigenschaften Eigenschaft Beschreibung Arbeitsbereiche ausschließen Name des auszuschließenden Arbeitsbereichs. Entitäten in diesem Arbeitsbereich werden nicht in ausgefüllt Kong Gateway Service. Trennen Sie mehrere Arbeitsbereiche durch Kommas. Beispiel:
Arbeitsbereich1,Arbeitsbereich2. Wenn Sie dieses Feld leer lassen, importieren die Datenquellen im Connector Daten aus allen Arbeitsbereichen.Tags importieren Tags, die aus erfasst werden sollen Kong Gateway Service. Trennen Sie mehrere Tags durch Kommas.
Wenn angegeben, geben Sie das Schlüssel-Wert-Paartrennzeichen für Tags in ein Tags Value SeparatorEigenschaft. Wenn nicht angegeben, werden Tags nicht abgerufen.
Tag-Werttrennzeichen Trennzeichen für Schlüssel und Wert in Tags. Beispiel: Wenn das Tag-Werttrennzeichen auf festgelegt ist
=, Das Tagenv=prodWird mit gespeichertumgebungAls Schlüssel undprodAls Wert.Wenn leer gelassen, werden keine Tags erfasst.
Hinweis:Die Auth Type, Workspaces, Und Load BalancersEigenschaften werden automatisch ausgefüllt. - Wählen Sie Aktualisieren.
- Legen Sie fest Legen Sie Konfigurationseigenschaften für die neue Verbindung fest Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
-
Testen Sie die neue Verbindung.
- Für Testen Sie neue Verbindungen Aufgabe, wählen Sie aus Konfigurieren .
- Wählen Sie in der Spalte Name den Verbindungsdatensatz der neuen Verbindung aus.
- 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.
- Wenn Status Feld ist auf festgelegt Erfolg , Wählen Sie aus Aktualisieren .
Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Korrekturvorschläge.
- Legen Sie fest Testen Sie neue Verbindungen Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .
- Wiederholen Sie die Schritte von 4.aBis 4.fUm eine weitere Instanz hinzuzufügen.
-
Richten Sie die geplanten Importaufträge ein.
- In Richten Sie geplante Importaufträge ein Abschnitt von Kong-Gateway-Integration mit CMDB Seite auswählen Erste Schritte .
- Für Konfigurieren Sie den geplanten Import Aufgabe, wählen Sie aus Konfigurieren .
- Wählen Sie in der Spalte Name die übergeordnete geplante Aufgabe aus SG-Kong-Gateway .
-
Überprüfen Sie im Formular „Geplanter Datenimport“ die Feldwerte für die geplante Aufgabe.
Weitere Informationen finden Sie unter Schedule a data import.
- Wählen Sie aus Aktiv Kontrollkästchen zum Aktivieren des geplanten Imports des SG-Kong-Gateways.
- In Ausführen Feld auswählen Regelmäßig Um anzugeben, wie oft der Auftrag ausgeführt wird.
- Wählen Sie Aktualisieren.
- Legen Sie fest Konfigurieren Sie den geplanten Import Aufgabe, die durch Auswahl abgeschlossen werden soll Als abgeschlossen markieren .