Konfigurieren API Service Graph Connector für AWS – API-GatewayMit dem geführten Setup

Freigeben Version: Yokohama

Aktualisiert 30. Januar 2025

7 Minuten Lesedauer

Richten Sie geplante Importaufträge zum Abrufen ein AWS API GatewayDaten 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.

Der vom Connector verwendete Authentifizierungsmechanismus ist AWS-Signaturtyp (HMAC-Authentifizierungstechnik) mit AWSSecurity Token Service (STS)-Token. Informationen zu Berechtigungen finden Sie unter API-Servicediagramm-Connector für AWS-API-Gateway – Setup-Anweisungen [KB1962734] artikel in Now SupportKnowledge Base.

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

Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für AWS – API-GatewayAnwendung mithilfe der Anwendungsauswahl.
Weitere Informationen finden Sie unter Anwendungsauswahl .
Navigieren zu Alle > Service Graph Connectors > AWS API-Gateway > Einrichtungan.
Wählen Sie auf der Seite „geführtes Setup“ die Option aus Fahren Sie Fort .
Konfigurieren Sie die Anmeldeinformationen für die Authentifizierung, um Anforderungen an zu senden AWS API Gateway.
1. In Konfigurieren Sie die Verbindung und Anmeldeinformationen Abschnitt von API Service Graph Connector für AWS – API-GatewaySeite auswählen Starten .
2. Konfigurieren Sie die Verbindung.
  1. Wählen Sie aus Konfigurieren Sie Anmeldeinformationen für die AWS-Authentifizierung Aufgabe.
  2. In Name Geben Sie einen Namen für die Authentifizierung ein.
    SGAwsApiAnmeldeinformationen Ist der standardmäßige Aliasname für Anmeldeinformationen. Sie können mehrere hinzufügen AWS API GatewayInstanzen. Versuchen Sie jedoch, den Standardverbindungsalias nicht zu ändern.
  3. Geben Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel in ein Zugriffsschlüssel-ID Und Geheimer Zugriffsschlüssel Felder.
    Die AWS-Zugriffsschlüssel sind langfristige Anmeldeinformationen für den IAM-Anwender und umfassen zwei Teile: Eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel. Sie müssen sowohl die Zugriffsschlüssel-ID als auch den geheimen Zugriffsschlüssel zusammen verwenden, um Anforderungen zu authentifizieren.
  4. Wählen Sie Aktualisieren.
  5. Legen Sie fest Konfigurieren Sie Anmeldeinformationen für die AWS-Authentifizierung 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. Aktualisieren Sie die erforderlichen Konfigurationseigenschaften für AWS API GatewayInstanz und testen Sie die Verbindung.
  1. Wählen Sie aus Konfigurieren und testen Sie AWS-Kontodetails Aufgabe.
  2. In Service Graph-Verbindungen Überprüfen und ändern Sie die Eigenschaftsdetails, indem Sie eine Eigenschaft aus auswählen Eigenschaft Spalte in der zugehörigen Liste „Service Graph-Verbindungseigenschaften“.
    Sie können die folgenden Eigenschaften konfigurieren:
    
    AccountId
    
    Ein numerischer Bezeichner von AWSAccount-ID.
    
    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.
    
    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-Konfigurationsservice konfiguriert wurde.
    
    Region(en)
    
    Eine Liste von kommagetrennten Regionen, in denen AWS API GatewayBefindet sich.
    
    Partitionsgröße
    
    Partitionsgröße für von AWS verwaltete APIs, wenn das parallele Laden aktiviert ist.
    Akzeptiert einen numerischen Wert größer als null. Wenn leer gelassen, wird der Wert automatisch berechnet.
    
    StandaloneAccountId
    
    Die ID eines Mitglieds-Accounts, der zugeordnet ist AWS API GatewayAccount.
    
    ConfigAggregatorName
    
    Der Name des Aggregator-Ressourcentyps im AWS-Konfigurationsservice.
    
    ManagementAccount-ID
    
    Die Verwaltungs-Account-ID, die dem zugeordnet ist AWS API GatewayAccount.
    
    ConfigAggregatorRegion
    
    Die Region, in der sich der Aggregator-Ressourcentyp befindet.
    
    StsRoleName
    
    Der STS-Übernahmerollenname von AWSAccount Das zum Abfragen von verwendet wird STS – Rolle übernehmen API zum Abrufen der API-Anmeldeinformationen.
  3. Wählen Sie Aus Aktualisieren Im Abschnitt „Service Graph-Verbindungseigenschaften“.
  4. 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.
  5. Wenn Status Feld ist auf festgelegt Erfolg , Auswählen Aktualisieren .
    Wenn bei einem der Tests Fehler auftreten, befolgen Sie die Vorschläge zur Korrektur.
  6. Legen Sie fest Konfigurieren und testen Sie AWS-Kontodetails 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 .
Wahlweise: Integration mit mehreren AWS API GatewayInstanzen.
1. In Fügen Sie Mehrere Instanzen Hinzu Abschnitt von API Service Graph Connector für AWS – API-GatewaySeite auswählen Starten .
2. Aktivieren Sie die Erstellung von Datenquellen für die neue AWS API GatewayVerbindung.
  1. Stellen Sie sicher, dass Sie über Bearbeitungsberechtigungen für die Datenquellentabelle [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 neuen 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 AWS – API-GatewayAnwendungsbereich.
  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 AWS API GatewayVerbindung.
  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 Für 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 AWS – API-GatewayAnwendungsbereich.
  7. Legen Sie fest Aktualisieren Sie Den Zugriff Für 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");
```
  4. Wählen Sie Aus Skript ausführen .
  5. Wählen Sie in der Anwendungsauswahl aus API Service Graph Connector für AWS – API-GatewayAnwendungsbereich.
  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. Fügen Sie eine weitere Verbindung für die neue hinzu AWS API GatewayInstanz.
  1. Stellen Sie sicher, dass der Anwendungsbereich auf festgelegt ist API Service Graph Connector für AWS – API-GatewayAnwendung mithilfe der Anwendungsauswahl.
  2. Wählen Sie aus Fügen Sie Weitere Verbindungen 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“ den Verbindungsnamen, den Zugriffsschlüssel und die Details zum geheimen Schlüssel ein.
  5. Wählen Sie Aus Verbindung Erstellen .
  6. Schließen Sie Workflow-StudioUnd kehren Sie zur Registerkarte „geführtes Setup“ zurück.
  7. Legen Sie fest Fügen Sie Weitere Verbindungen 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 .
6. Aktualisieren Sie die erforderlichen Konfigurationseigenschaften für neu AWS API GatewayVerbindung herstellen und Verbindung testen.
  1. Wählen Sie aus Testen Sie Neue Verbindungen Aufgabe.
  2. Wählen Sie den Verbindungsdatensatz aus, den Sie in Schritt erstellt haben 5.e.
  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 .
Konfigurieren Sie die geplante Aufgabe für den Import von AWS API GatewayDaten.
1. In Richten Sie geplante Importaufträge ein Abschnitt von API Service Graph Connector für AWS – API-GatewaySeite auswählen Starten .
2. Wählen Sie aus SGA-AWS-API-Gateway-Managed-API-REST Geplante Aufgabe.
  Wählen Sie für mehrere Instanzen die geplante Aufgabe für die Datenquelle „SGA-AWS-API-Gateway-Managed-API-REST“ aus.
3. Überprüfen Sie im Formular „Geplanter Datenimport“ die Feldwerte für die geplante Aufgabe.
  
  Weitere Informationen finden Sie unter Schedule a data import.
4. Wählen Sie Aus Aktiv Kontrollkästchen zum Aktivieren der geplanten Aufgabe für die Datenquelle „SGA-AWS-API-Gateway-Managed-API-REST“.
5. Wählen Sie Aktualisieren.
6. 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 .
Auf API Service Graph Connector für AWS – API-GatewaySeite auswählen Abgeschlossen Um Ihre Änderungen zu speichern.
Wählen Sie im Dialogfeld „Setup abschließen“ die Option aus Abgeschlossen Um das Setup abzuschließen.
Wählen Sie im angezeigten Nachrichtenfeld aus Fertig .

Konfigurieren Sie mit geführtem Setup

Yokohama Now Platform-Fähigkeiten

Konfigurieren API Service Graph Connector für AWS – API-GatewayMit dem geführten Setup

Vorbereitungen

Prozedur