Konfigurieren Sie API Service Graph Connector für AWS – API-Gateway mithilfe des geführten Setups
Richten Sie geplante Importaufträge ein, um AWS API Gateway -Daten in Ihre CMDBabzurufen.
Vorbereitungen
Der vom Connector verwendete Authentifizierungsmechanismus ist der AWS-Signaturtyp (HMAC-Authentifizierungstechnik) mit dem AWS Security Token Service-Token (STS). Informationen zu Berechtigungen finden Sie im Artikel API Service Graph Connector für AWS API Gateway – Setupanweisungen [KB1962734] in der Knowledge Base Now Support.
- 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 AWS – API-Gateway festgelegt ist.
Weitere Informationen finden Sie unter Anwendungsauswahl.
- Navigieren zu Alle > Service Graph Connectors > AWS API-Gateway > Setup.
- Wählen Sie auf der Seite des geführten Setups Fortsetzenaus.
-
Konfigurieren Sie die Anmeldeinformationen für die Authentifizierung, um Anforderungen an AWS API Gatewayzu senden.
- Wählen Sie auf der Seite API Service Graph Connector für AWS – API-Gateway im Abschnitt „Verbindung und Anmeldeinformationen konfigurieren“Startenaus.
-
Konfigurieren Sie die Verbindung.
- Wählen Sie die Aufgabe Anmeldeinformationen für AWS-Authentifizierung konfigurieren aus.
- Geben Sie im Feld Name einen Namen für die Authentifizierung ein.
„SGAwsApiCredentials“ist der Standardaliasname für Anmeldeinformationen. Sie können mehrere AWS API Gateway -Instanzen hinzufügen. Versuchen Sie jedoch nicht, den Standardverbindungsalias zu ändern. - Geben Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel in die Felder Zugriffsschlüssel-ID und Geheimer Zugriffsschlüssel ein.
Die AWS-Zugriffsschlüssel sind langfristige Anmeldeinformationen für den IAM-Benutzer und bestehen aus zwei Teilen: einer Zugriffsschlüssel-ID und einem geheimen Zugriffsschlüssel. Sie müssen die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel zusammen verwenden, um Anforderungen zu authentifizieren.
- Wählen Sie Aktualisieren.
- Legen Sie die Aufgabe Anmeldeinformationen für die AWS-Authentifizierung konfigurieren auf den Abschluss fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und anschließend Fortfahrenwählen.
-
Aktualisieren Sie die erforderlichen Konfigurationseigenschaften für eine Instanz AWS API Gateway, und testen Sie die Verbindung.
- Wählen Sie die Aufgabe „AWS-Account-Details konfigurieren und testen“ aus.
- Überprüfen und ändern Sie im Abschnitt Service Graph-Verbindungen die Eigenschaftsdetails, indem Sie in der zugehörigen Liste Service Graph-Verbindungseigenschaften in der Spalte Eigenschaft eine Eigenschaft auswählen.Sie können die folgenden Eigenschaften konfigurieren:
- AccountId
- Ein numerischer Bezeichner der Account-ID AWS.
- CollectionPeriod (Tage)
- Dauer der Erfassung von API-Nutzungsdaten in Tagen.
- SammlungNutzungsdaten
- Aktivieren Sie die Nutzungsdatenerfassung, um API-Nutzungsdaten über einen angegebenen Zeitraum abzurufen.
- IsGovCloud
- Aktivieren Sie diese Option, um anzugeben, dass das Verbindungs-Setup für AWS GovCloud gilt.
- ConfigAggregatorAccountId
- AWS-Account-ID, in der der Aggregator-Ressourcentyp im AWS Config-Service konfiguriert wurde.
- Region(en)
- Eine durch Kommas getrennte Liste von Regionen, in denen sich AWS API Gateway befindet.
- Partitionsgröße
- Partitionsgröße für von AWS 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.
- EigenständigeAccountId
- Die ID eines Mitgliedsaccounts, der dem Account AWS API Gateway zugeordnet ist.
- ConfigAggregatorName
- Der Name des Aggregator-Ressourcentyps im AWS Config-Service.
- ManagementAccountId
- Die Verwaltungs-Account-ID, die dem Account AWS API Gateway zugeordnet ist.
- ConfigAggregatorRegion
- Die Region, in der sich der Aggregator-Ressourcentyp befindet.
- STSRollenname
- Der STS-Rollenübernahmename des AWS Accounts, der für die Abfrage der STS-Rollenübernahme -API zum Abrufen der API-Anmeldeinformationen verwendet wird.
- Wählen Sie im Abschnitt Service Graph-Verbindungseigenschaften die Option Aktualisieren 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.
- Legen Sie die Aufgabe Konfigurieren und Testen von AWS-Account-Details auf Abgeschlossen fest, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren und dann Fortfahrenwählen.
- Wahlweise:
Integration mit mehreren AWS API Gateway -Instanzen.
- Wählen Sie auf der Seite API Service Graph Connector für AWS – API-Gateway im Abschnitt „Mehrere Instanzen hinzufügen“ Startenaus.
-
Aktivieren Sie die Erstellung von Datenquellen für die neue AWS API Gateway -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 neuen 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 AWS – API-Gateway 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 AWS API Gateway.
- 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 AWS – API-Gateway 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"); - Wählen Sie Skript ausführenaus.
- Wählen Sie in der Anwendungsauswahl den Anwendungsbereich API Service Graph Connector für AWS – API-Gateway aus.
- Legen Sie die Aufgabe Cache für Datenquellen und geplante Datenimporte leeren auf den Abschluss fest, indem Sie Als abgeschlossen markierenwählen.
-
Fügen Sie eine weitere Verbindung für die neue Instanz AWS API Gateway hinzu.
- Stellen Sie mithilfe der Anwendungsauswahl sicher, dass der Anwendungsbereich auf die Anwendung API Service Graph Connector für AWS – API-Gateway festgelegt ist.
- Wählen Sie die Aufgabe Weitere Verbindungen 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 den Verbindungsnamen, den Zugriffsschlüssel und den geheimen Schlüssel aus.
- Wählen Sie Verbindung erstellen aus.
- Schließen Sie Workflow-Studio, und kehren Sie zur Registerkarte des geführten Setups zurück.
- Setzen Sie die Aufgabe Weitere Verbindungen hinzufügen auf den Abschluss, indem Sie das Kontrollkästchen Als abgeschlossen markieren aktivieren, und wählen Sie dann Weiteraus.
-
Aktualisieren Sie die erforderlichen Konfigurationseigenschaften für die neue AWS API Gateway -Verbindung, und testen Sie die Verbindung.
- Wählen Sie die Aufgabe Neue Verbindungen testen aus.
- Wählen Sie den Verbindungsdatensatz aus, den Sie in Schritt 5.eerstellt 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 AWS API Gateway -Daten.
- Wählen Sie im Abschnitt Geplante Importaufträge einrichten der Seite API Service Graph Connector für AWS – API-GatewayStarten aus.
-
Wählen Sie die geplante Aufgabe SGA-AWS-API-Gateway-Managed-API-REST aus.
Wählen Sie bei mehreren Instanzen die geplante Aufgabe für die Datenquelle SGA-AWS-API-Gateway-Managed-API-REST aus.
-
Überprüfen Sie im Formular „Geplanter Datenimport“ die Feldwerte für die geplante Aufgabe.
Weitere Informationen finden Sie unter Schedule a data import.
- Aktivieren Sie das Kontrollkästchen Aktiv, um die geplante Aufgabe für die Datenquelle SGA-AWS-API-Gateway-Managed-API-REST zu aktivieren.
- 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 AWS – API-Gateway die Option Abschließen aus, um Ihre Änderungen zu speichern.
- Wählen Sie im Dialogfeld Setup abschließen die Option Abgeschlossen aus, um das Setup abzuschließen.
- Wählen Sie im angezeigten Meldungsfeld Fertig aus.