Konfigurieren Sie die Eigenschaften Service Graph Connector Integration for Claroty CTD
Lassen Sie sich vom geführten Setup für Service Graph Connector Integration for Claroty CTD durch die Integrationsschritte führen.
Vorbereitungen
- Die Store-App Integration Commons for CMDB, die automatisch installiert wird.
- CMDB CI Class Models, das automatisch installiert wird.
- 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 Discovery anfordern.
- Das Plugin „Datastream Action“ (com.glide.hub.action_type.datastream), das automatisch installiert wird.
Erforderliche Rolle: Administrator
Prozedur
-
Stellen Sie mithilfe der Anwendungsauswahl sicher, dass die Anwendung auf Service Graph Connector Integration for Claroty CTD festgelegt ist.
Weitere Informationen finden Sie unter Application picker.
- Navigieren zu Alle > Service Graph Connector – Claroty CTD > Geführtes Setup.
- Wählen Sie auf der Seite „Erste Schritte “ Erste Schritteaus.
-
Führen Sie zum Konfigurieren eines MID-ServerFolgendes aus:
- Wählen Sie im Abschnitt „Verbindungen und Anmeldeinformationen einrichten“ die Aufgabe MID-Server konfigurieren aus.
- Wählen Sie Als abgeschlossen markieren aus, sobald Sie die Konfiguration MID-Server abgeschlossen haben.
-
Führen Sie zum Einrichten der Verbindungsdatensätze Folgendes aus:
- Wählen Sie im Abschnitt „Verbindungen und Anmeldeinformationen einrichten“ die Aufgabe Verbindungen konfigurieren aus.
- Wählen Sie Konfigurieren.
- Öffnen Sie den Claroty CTD API-Datensatz in der Verbindungstabelle.
-
Geben Sie im Feld Verbindungs-URL den Namen der URL für Ihre Claroty CTD Enterprise Management Console (EMC) ein.
Beispiel: https://192.168.1.100.
-
Wenn Sie MID-Serververwenden, aktivieren Sie das Kontrollkästchen MID-Server verwenden im -Datensatz.
Hinweis:Wenn Sie kein MID-Serververwenden, fahren Sie mit Schritt 5g fort.
- Wählen Sie in der zugehörigen Liste Erweiterte Konfiguration MID-Server eine MID-Server und eine MID-Auswahl aus.
- Wählen Sie Aktualisieren.
- Wiederholen Sie die Schritte 5a bis 5h, um den Datensatz „Claroty CTD EMC Base Auth“ zu aktualisieren.
-
Führen Sie zum Einrichten der Anmeldeinformationsdatensätze Folgendes aus:
- Wählen Sie im Abschnitt „Verbindungen und Anmeldeinformationen einrichten“ die Aufgabe Anmeldeinformationen konfigurieren aus.
- Wählen Sie Konfigurieren.
- Öffnen Sie den Datensatz „Claroty CTD EMC Base Auth“ in der Tabelle „Anmeldeinformationen“.
- Geben Sie im Feld Anwendername den Anwendernamen ein, mit dem Sie sich bei Claroty CTD EMC angemeldet haben.
- Geben Sie im Feld Passwort das Passwort ein, mit dem Sie sich bei Claroty CTD EMC angemeldet haben.
- Wählen Sie Aktualisieren.
-
Um die Verbindung zu testen, führen Sie Folgendes aus:
- Wählen Sie im Abschnitt „Verbindungen und Anmeldeinformationen einrichten“ die Aufgabe Verbindung testen/validieren aus.
-
Wählen Sie im Datenquellen-Datensatz für Sensoren im Abschnitt „Zugehörige Links“ die UI-Aktion Verbindung testen aus.
Zeigen Sie nach Abschluss des Verbindungstests die Ergebnisse an. Sie müssen die vorgeschlagenen Problembehandlungsschritte ausführen, bis das Testergebnis Erfolgzurückgibt.
-
Überprüfen Sie, ob der Verbindungsmanager über ein gültiges Zertifikat verfügt.
Für eine Produktionsumgebung muss ein gültiges Zertifikat installiert sein. Für eine Instanz außerhalb der Produktion oder für eine Proof of Concept-Instanz (POC) können Sie die Systemeigenschaften so konfigurieren, dass die Integration funktioniert, wenn der Verbindungsmanager nicht über ein gültiges Zertifikat verfügt. In der folgenden Tabelle sind die Systemeigenschaften aufgeführt, die Sie für eine Umgebung außerhalb der Produktion konfigurieren können.
Tabelle : 1. Systemeigenschaften für eine Umgebung außerhalb der Produktion Eigenschaft Wert com.glide.communications.httpclient.verify_hostname Auf „false“festlegen. com.glide.communications.httpclient.verify_revoked_certificate Auf „false“festlegen. Wenn Sie diese Systemeigenschaft hinzufügen müssen, finden Sie weitere Informationen unter Systemeigenschaft hinzufügen.
com.glide.communications.trustmanager_trust_all Auf wahr festlegen. -
Überprüfen Sie die MID-Sicherheitsrichtlinie.
Überprüfen Sie im Intranetdatensatz, ob die Spalten in der folgenden Tabelle die angegebenen Werte anzeigen.
Tabelle : 2. Intranet-Datensatzwerte Spalte Wert Zertifikatkettenprüfung false Hostnamenprüfung false Widerrufsprüfung false Weitere Informationen finden Sie unter Richtlinien für MID-Server-Zertifikatprüfung.
-
Um die Systemeigenschaften festzulegen, mit denen die API-Ressourcenpfade, Paginierungsgrößen und Ablaufzeiten der API-Schlüssel konfiguriert werden, gehen Sie wie folgt vor:
- Wählen Sie im Abschnitt Konfigurieren von Systemeigenschaften die Option Konfigurieren aus.
-
Konfigurieren Sie die Systemeigenschaften in der folgenden Tabelle:
Eigenschaft Beschreibung sn_clarotyctdsgc.resourcepath.site Eigenschaft zum Festlegen des Ressourcenpfads für die Sites:
Hinweis:Der Ressourcenpfad für die Sites wird standardmäßig für die API-Version Claroty CTD Enterprise Management Console (EMC) V4.4.3 für die CTD-Sites und -Geräte bereitgestellt.Wenn Sie eine andere API-Version verwenden möchten, können Sie die Pfade überschreiben.
sn_clarotyctdsgc.resourcepath.device Eigenschaft zum Festlegen des Ressourcenpfads für die Geräte:
Hinweis:Der Ressourcenpfad für die Geräte wird standardmäßig für die API-Version CTD EMC V4.4.3 für die CTD-Sites und -Geräte bereitgestellt.Wenn Sie eine andere API-Version verwenden möchten, können Sie die Pfade überschreiben.
sn_clarotyctdsgc.pagesize.device Eigenschaft zum Festlegen der Anzahl der Gerätedatensätze, die in einem paginierten REST-Aufruf an die Claroty CTD EMC abgerufen werden sollen. Der Standardwert beträgt 500 Datensätze pro Seite.
Hinweis:Die maximale Anzahl von Geräten pro Seite beträgt 500.sn_clarotyctdsgc.resourcepath.baseline Eigenschaft zum Festlegen des Ressourcenpfads für die Baselines:
Hinweis:Der Ressourcenpfad für die Baselines wird standardmäßig für die API-Version CTD EMC V4.4.3 für die CTD-Sites und -Geräte bereitgestellt.Wenn Sie eine andere API-Version verwenden möchten, können Sie die Pfade überschreiben.
sn_clarotyctdsgc.pagesize.baseline Eigenschaft zum Festlegen der Anzahl der Baseline-Datensätze, die in einem paginierten REST-Aufruf an die Claroty CTD EMC abgerufen werden sollen. Der Standardwert beträgt 500 Datensätze pro Seite.
sn_clarotyctdsgc.get_all_baselines Eigenschaft zum Abrufen aller Datensätze für Baselines oder nur der neuen Datensätze seit der Startzeit des letzten erfolgreichen Imports.
Hinweis:Wenn Sie Baselines zum ersten Mal importieren, werden alle Datensätze unabhängig von der Einstellung für diese Eigenschaft importiert.sn_clarotyctdsgc.resourcepath.entity Eigenschaft zum Festlegen des Ressourcenpfads für die Entitäten:
Hinweis:Der Ressourcenpfad für die Entitäten wird standardmäßig für die API-Version CTD EMC V4.4.3 für die CTD-Sites und -Geräte bereitgestellt. Wenn Sie eine andere API-Version verwenden möchten, können Sie die Pfade überschreiben.sn_clarotyctdsgc.resourcepath.program Eigenschaft zum Festlegen des Ressourcenpfads für die installierten Programme:
Hinweis:Der Ressourcenpfad für die installierten Programme wird standardmäßig für die API-Version CTD EMC V4.4.3 für die CTD-Sites und -Geräte bereitgestellt.Wenn Sie eine andere API-Version verwenden möchten, können Sie die Pfade überschreiben.
sn_clarotyctdsgc.pagesize.entity Eigenschaft zum Festlegen der Anzahl der Entitätsdatensätze, die in einem paginierten REST-Aufruf an die Claroty CTD EMC abgerufen werden sollen. Der Standardwert beträgt 500 Datensätze pro Seite.
sn_clarotyctdsgc.pagesize.program Eigenschaft zum Festlegen der Anzahl der Programmdatensätze, die in einem paginierten REST-Aufruf an die Claroty CTD EMC abgerufen werden sollen. Der Standardwert beträgt 500 Datensätze pro Seite.
sn_clarotyctdsgc.api_token_life_in_minutes Eigenschaft zum Festlegen der Anzahl der Minuten, für die die API als aktiv betrachtet wird. Nach Ablauf der Zeit ruft der Service Graph Connector beim nächsten Import einen neuen API-Schlüssel ab. Der Standardwert ist 0, und für jeden REST-Aufruf wird ein neues Token abgerufen.
Hinweis:Sie können den Wert so ändern, dass dasselbe Token maximal 24 Stunden lang beibehalten und die Anzahl der REST-Aufrufe reduziert wird.sn_clarotyctdsgc.classify_based_on_os Eigenschaft, um eine Liste von Klassen bereitzustellen, die die Klassifizierung nach Betriebssystem als Teil von Service Graph Connector Integration for Claroty CTDunterstützen. Wenn die Kennzeichnung auf truefestgelegt ist, wird die Klassifizierung nach Betriebssystem unterstützt. Wenn sie auf Falsefestgelegt ist, klassifiziert der Service Graph Connector nicht mehr nach Betriebssystem. Zum Beispiel:{ "cmdb_ci_ip_switch":true, "cmdb_ci_nids":false }sn_clarotyctdsgc.filter.asset_type_code Eigenschaft zum Bereitstellen einer Liste von Codes für Gerätetypen, getrennt durch das Trennzeichen ($). Weitere Informationen zu Claroty-Typen und -Codes finden Sie unter Angestrebte CMDB-Klassen. Um beispielsweise nur SPS- und HMI-Gerätetypen zu importieren, geben Sie den Claroty-Typcode als 0$1ein.
sn_clarotyctdsgc.filter.asset_purdue_level Eigenschaft, um eine Liste von Purdue-Ebenen bereitzustellen, getrennt durch das Trennzeichen ($). Um beispielsweise nur Geräte mit den Purdue-Ebenen 1 und 2 zu filtern, legen Sie, um nur Geräte mit den Purdue-Ebenen 1 und 2 zu filtern, den Wert 1.0$2.0fest. - Wählen Sie Speichern.
-
Um CTD-Sites zu importieren, gehen Sie wie folgt vor:
- Wählen Sie im Abschnitt „CTD-Sites konfigurieren“ die Aufgabe CTD-Sites importieren aus.
- Wählen Sie Konfigurieren.
- Klicken Sie auf die Schaltfläche Jetzt ausführen.
-
Führen Sie zum Konfigurieren von Netzwerkangriffserkennungssystemen (NIDS) Folgendes aus:
- Wählen Sie im Abschnitt „CTD-Sites konfigurieren“ die Aufgabe Konfigurieren von NIDS aus.
- Wählen Sie „Als abgeschlossen markieren“ aus, sobald Sie das NIDS eingerichtet haben, das zum Abrufen von Geräten von Claroty CTD verwendet wird.
-
Führen Sie die folgenden Schritte aus, um die Importzeitpläne für die Ausführung der Sites, Geräte, Baselines und installierten Programme zu konfigurieren:
- Wählen Sie im Abschnitt Importzeitpläne konfigurieren die Aufgabe Importzeitplan für Sites konfigurieren aus.
- Wählen Sie Konfigurieren.
-
Wählen Sie in der Tabelle „Geplante Datenimporte“ Geplanter Import von SG-OT CTD-Sitesaus.
- Standardmäßig ist der Importzeitplan für Sites so konfiguriert, dass er jeden Tag um Mitternacht ausgeführt wird.
- Sie müssen die CTD-Sites importieren und validieren, bevor Sie die Geräte importieren.
-
Führen Sie die folgenden Aktionen nach Bedarf aus, um den Importzeitplan nach Bedarf zu überprüfen oder zu ändern:
Aktion Beschreibung Geben Sie ein bedingtes Skript ein Geben Sie ein bedingtes Skript ein, das bestimmt, ob ein geplanter Import ausgeführt werden soll, indem Sie Bedingungauswählen. Ändern Sie den standardmäßigen Importzeitplan Ändern Sie den standardmäßigen Importzeitplan, indem Sie das Feld Ausführen nach Bedarf festlegen. Verweisen Sie in der Benutzertabelle auf einen Benutzer Verweisen Sie in der Tabelle „Benutzer“ auf einen Benutzer, indem Sie ihn im Feld Wird ausgeführt als auswählen.
Hinweis:Standardmäßig ist dieses Feld auf „Systemadministrator“ festgelegt. Dem ausgewählten Anwender muss die Administratorrolle zugewiesen werden, damit der Import erfolgreich ist. Wenn leer gelassen, verwendet der Importzeitplan die Rollen des angemeldeten Benutzers.Import ausführen Führen Sie einen Import aus, indem Sie „Jetzt ausführen“ auswählen. Sie können entweder alle Datensätze oder nur neue Datensätze seit der Startzeit des letzten erfolgreichen Imports importieren, basierend auf den konfigurierten Systemeigenschaften. Weitere Informationen finden Sie unter Konfigurieren Sie das geführte Setup. Aktivieren Sie den Import Aktivieren Sie den Import, indem Sie das Kontrollkästchen Aktiv aktivieren. Speichern Sie alle Zeitplanänderungen Speichern Sie alle Zeitplanänderungen, indem Sie Aktualisierenauswählen. - Wählen Sie im Abschnitt „Importzeitpläne konfigurieren“ die Aufgabe Importzeitplan für Geräte konfigurieren aus.
- Wählen Sie Konfigurieren.
-
Wählen Sie in der Tabelle „Geplante Datenimporte“ Geplanter Import von SG-OT CTD-Geräten aus, um den Importzeitplan für Ihre Geräte zu überprüfen oder zu ändern.
- Standardmäßig ist der Zeitplan für den Geräteimport so konfiguriert, dass er jeden Tag um Mitternacht ausgeführt wird.
- Geräte werden von der CTD-Site abgefragt. Der Service Graph Connector fragt nur Geräte ab, die von validierten CTD-Sites erkannt wurden.
-
Führen Sie die folgenden Aktionen nach Bedarf aus, um den Importzeitplan nach Bedarf zu überprüfen oder zu ändern:
Aktion Beschreibung Geben Sie ein bedingtes Skript ein Geben Sie ein bedingtes Skript ein, das bestimmt, ob ein geplanter Import ausgeführt werden soll, indem Sie Bedingungauswählen. Ändern Sie den standardmäßigen Importzeitplan Ändern Sie den standardmäßigen Importzeitplan, indem Sie das Feld Ausführen nach Bedarf festlegen. Verweisen Sie in der Benutzertabelle auf einen Benutzer Verweisen Sie in der Tabelle „Benutzer“ auf einen Benutzer, indem Sie ihn im Feld Wird ausgeführt als auswählen.
Hinweis:Standardmäßig ist dieses Feld auf „Systemadministrator“ festgelegt. Dem ausgewählten Anwender muss die Administratorrolle zugewiesen werden, damit der Import erfolgreich ist. Wenn leer gelassen, verwendet der Importzeitplan die Rollen des angemeldeten Benutzers.Import ausführen Führen Sie einen Import aus, indem Sie „Jetzt ausführen“ auswählen. Sie können entweder alle Datensätze oder nur neue Datensätze seit der Startzeit des letzten erfolgreichen Imports importieren, basierend auf den konfigurierten Systemeigenschaften. Weitere Informationen finden Sie unter Konfigurieren Sie das geführte Setup. Aktivieren Sie den Import Aktivieren Sie den Import, indem Sie das Kontrollkästchen Aktiv aktivieren. Speichern Sie alle Zeitplanänderungen Speichern Sie alle Zeitplanänderungen, indem Sie Aktualisierenwählen. - Wählen Sie im Abschnitt „Importzeitpläne konfigurieren“ die Aufgabe Importzeitplan für Baselines konfigurieren aus.
- Wählen Sie Konfigurieren.
-
Wählen Sie in der Tabelle „Geplante Datenimporte“ SG-OT CTD-Baselines Geplanter Import aus, um den Importzeitplan für die Baselines zu überprüfen oder zu ändern.
Standardmäßig ist der Importzeitplan für Baselines so konfiguriert, dass er nach der Ausführung des übergeordneten OT-Steuerungssystems ausgeführt wird.
-
Führen Sie die folgenden Aktionen nach Bedarf aus, um den Importzeitplan nach Bedarf zu überprüfen oder zu ändern.
Aktion Beschreibung Geben Sie ein bedingtes Skript ein Geben Sie ein bedingtes Skript ein, das bestimmt, ob ein geplanter Import ausgeführt werden soll, indem Sie Bedingungauswählen. Ändern Sie den standardmäßigen Importzeitplan Ändern Sie den standardmäßigen Importzeitplan, indem Sie das Feld Ausführen nach Bedarf festlegen. Verweisen Sie in der Benutzertabelle auf einen Benutzer Verweisen Sie in der Tabelle „Benutzer“ auf einen Benutzer, indem Sie ihn im Feld Wird ausgeführt als auswählen.
Hinweis:Standardmäßig ist dieses Feld auf „Systemadministrator“ festgelegt. Dem ausgewählten Anwender muss die Administratorrolle zugewiesen werden, damit der Import erfolgreich ist. Wenn leer gelassen, verwendet der Importzeitplan die Rollen des angemeldeten Benutzers.Import ausführen Führen Sie einen Import aus, indem Sie „Jetzt ausführen“ auswählen. Sie können entweder alle Datensätze oder nur neue Datensätze seit der Startzeit des letzten erfolgreichen Imports importieren, basierend auf den konfigurierten Systemeigenschaften. Weitere Informationen finden Sie unter Konfigurieren Sie das geführte Setup. Aktivieren Sie den Import Aktivieren Sie den Import, indem Sie das Kontrollkästchen Aktiv aktivieren. Speichern Sie alle Zeitplanänderungen Speichern Sie alle Zeitplanänderungen, indem Sie Aktualisierenwählen. - Wählen Sie im Abschnitt „Importzeitpläne konfigurieren“ die Aufgabe Importzeitplan für installierte Sites konfigurieren aus.
- Wählen Sie Konfigurieren.
-
Wählen Sie in der Tabelle „Geplante Datenimporte“ SG-OT CTD Geplanter Import von installierten Programmen aus, um den Zeitplan für den Import von installierten Programmen zu überprüfen oder zu ändern.
Standardmäßig ist der Importzeitplan für installierte Programme so konfiguriert, dass er jeden Tag um Mitternacht ausgeführt wird.
-
Führen Sie die folgenden Aktionen nach Bedarf aus, um den Importzeitplan nach Bedarf zu überprüfen oder zu ändern.
Aktion Beschreibung Geben Sie ein bedingtes Skript ein Ändern Sie den standardmäßigen Importzeitplan, indem Sie das Feld Ausführen nach Bedarf festlegen. Ändern Sie den standardmäßigen Importzeitplan Ändern Sie den standardmäßigen Importzeitplan, indem Sie das Feld Ausführen nach Bedarf festlegen. Verweisen Sie in der Benutzertabelle auf einen Benutzer Verweisen Sie in der Tabelle „Benutzer“ auf einen Benutzer, indem Sie ihn im Feld Wird ausgeführt als auswählen.
Hinweis:Standardmäßig ist dieses Feld auf „Systemadministrator“ festgelegt. Dem ausgewählten Anwender muss die Administratorrolle zugewiesen werden, damit der Import erfolgreich ist. Wenn leer gelassen, verwendet der Importzeitplan die Rollen des angemeldeten Benutzers.Import ausführen Führen Sie einen Import aus, indem Sie „Jetzt ausführen“ auswählen. Sie können entweder alle Datensätze oder nur neue Datensätze seit der Startzeit des letzten erfolgreichen Imports importieren, basierend auf den konfigurierten Systemeigenschaften. Weitere Informationen finden Sie in Schritt 7c. Aktivieren Sie den Import Aktivieren Sie den Import, indem Sie das Kontrollkästchen Aktiv aktivieren. Speichern Sie alle Zeitplanänderungen Speichern Sie alle Zeitplanänderungen, indem Sie Aktualisierenwählen.
- Wahlweise:
Wenn Konfigurationselemente (CIs) in CMDBerstellt werden, werden Asset-Datensätze erstellt.
Der Asset-Datensatz enthält die Modellkategorie des CI. Weitere Informationen zu den Modellkategorien für Operational Technology (OT) finden Sie unter Modellkategorien für Operational Technology. Führen Sie Folgendes aus, um die Modellkategorie für ein OT-Gerät anzuzeigen:
- Navigieren zu Alle > Operative Technologien (OT) > Alle OT-Geräte.
- Wählen Sie das OT-Gerät aus, für das Sie den Asset-Datensatz anzeigen möchten.
- Wählen Sie neben dem Feld Asset das Symbol Vorschau auf diesen Datensatz anzeigen (
) aus.
- Wählen Sie Datensatz öffnen.
- Wahlweise:
Führen Sie Folgendes aus, um Probleme mit Service Graph Connector Integration for Claroty CTDzu beheben:
- Wählen Sie den Abschnitt [OPTIONAL] Problembehandlung bei Service Graph Connector für Claroty CTD aus.
- Wählen Sie in der Aufgabe Geplante Validierungen ausführen die Option Konfigurieren aus.
-
Wählen Sie Jetzt ausführen.
Dieser Auftrag führt Aufgaben aus, um die Konfigurationen für SGC und die Verbindung zu Claroty CTD zu validieren. Wenn Konfigurationsprobleme gefunden werden, melden die Validierungsergebnisse das Problem und schlagen Problembehandlungsschritte vor. Warten Sie, bis die geplante Aufgabe abgeschlossen ist.
- Navigieren Sie nach Abschluss der geplanten Aufgabe zurück zum Abschnitt [OPTIONAL] Problembehandlung bei Service Graph Connector für Claroty CTD.
-
Wählen Sie in der Aufgabe Validierungsergebnisse überprüfen die Option Konfigurieren aus.
Dieser Schritt öffnet die Ausführungsprotokolle und Vorschläge der letzten Problembehandlung, damit Sie sie anzeigen können.
-
Behandeln Sie die Vorschläge nach Bedarf.
Hinweis:Sie können das geplante Skript jederzeit nach der Erstkonfiguration von Service Graph Connector Integration for Claroty CTDverwenden. Um Validierungen auszulösen, navigieren Sie zu Alle > Service Graph Connector für Claroty CTD > Problembehandlung > Problembehandlung ausführen. Um die Validierungsergebnisse anzuzeigen, navigieren Sie zu Alle > Service Graph Connector für Claroty CTD > Problembehandlung > Ergebnisse.
Weitere Informationen zur Behebung von Problemen bei der Verwendung von Service Graph Connector Integration for Claroty CTDfinden Sie unter Problembehandlungsszenarien für die Service Graph Connector-Integration für Claroty CTD (KB1502041).