IDE verwenden

Unterstützt in:

In diesem Dokument wird der Produktionsmodus der integrierten Entwicklungsumgebung (IDE) erläutert. Die IDE ist ein Framework zum Ansehen, Bearbeiten und Testen von Code. Sie können den Integrationscode kommerzieller Integrationen ansehen und benutzerdefinierte Integrationen von Grund auf neu erstellen oder den Integrationscode kommerzieller Integrationen duplizieren.

In der IDE können Sie benutzerdefinierte Integrationen verwalten, importieren und exportieren.

IDE öffnen

So öffnen Sie die IDE:

  • Wenn Sie die IDE öffnen möchten, rufen Sie im Hauptmenü Automatisierung > IDE auf. Die Seite IDE wird geöffnet.

Auf der Seite IDE können Sie auf die folgenden Optionen zugreifen:

Option Beschreibung
Integrationstypen
 Wählen Sie zwischen Integrationen oder Typen (Connectors, Aktionen, Jobs, Manager) aus.
Export
Import		 Einzelne oder mehrere Elemente aus einer Integration exportieren. Abhängige Elemente werden beim Exportieren einzelner Elemente berücksichtigt, aber nicht beim Exportieren eines vollständigen Pakets.
Die exportierte Datei ist ein ZIP-Archiv, das eine JSON-Datei enthält. Beim Importieren können Sie einer vorhandenen Integration einzelne Elemente hinzufügen oder ein vollständiges Paket importieren. Für das Legacy-Export-/Importformat (V1 – Datenebene deaktiviert) muss das Paket eine Datei „integrations.def“ und die Ordner ActionsDefinitions, ActionsScripts, Dependencies und Managers enthalten. Für das neue Export-/Importformat (V2 – Dataplane aktiviert) muss der Paketordner eine metadata.json-Datei enthalten und kann die Ordner actions, connectors, jobs und dependencies enthalten.
Hinweis: Das Exportieren einer Integration aus einer Umgebung mit aktivierter Dataplane und das Importieren in eine Umgebung, in der die Dataplane nicht aktiviert ist, wird nicht unterstützt. Der umgekehrte Weg (Export aus einer Umgebung, in der die Datenebene nicht aktiviert ist, in eine Umgebung, in der die Datenebene aktiviert ist) wird unterstützt.
Klicken Sie auf den Schalter Inaktive ausblenden/Alle anzeigen, um deaktivierte Elemente (Aktionen, Connectors) anzuzeigen oder auszublenden.
Fügen Sie eine neue benutzerdefinierte Integration, einen Connector, eine Aktion, einen Job oder einen Manager hinzu.

Connector hinzufügen

So fügen Sie einen Connector hinzu:

  1. Klicken Sie auf Neues Element erstellen und wählen Sie Connector aus.
  2. Geben Sie einen Namen und die erforderliche Integration ein.
  3. Klicken Sie auf Erstellen.
  4. Fügen Sie Integrationsdetails hinzu.
  5. Fügen Sie die erforderlichen Parameter hinzu.
  6. Klicken Sie auf den Ein/Aus-Button Connector, um den Connector zu aktivieren.
  7. Klicken Sie abschließend auf Speichern oder drücken Sie Ctrl + S.

Auf dem Tab Details sind die folgenden Optionen verfügbar:

Option Beschreibung
Löschen Nur für Elemente in benutzerdefinierten Integrationen verfügbar.
Play Führt die Testmethode des Scripts aus. Die Ergebnisse werden auf dem Tab Testen und die Debug-Ausgabe im Abschnitt Debug-Ausgabe angezeigt.
file_json JSON-Beispielcode verwalten Achten Sie im Dialogfeld zum Importieren/Exportieren von JSON-Beispielen darauf, dass JSON-Ergebnis einschließen aktiviert ist. Anschließend können Sie JSON-Ergebnisbeispiele für Aktionen importieren oder exportieren.
DetailsGeben Sie die vom Nutzer bereitgestellten Eingaben und andere Parameter ein, z. B. den Integrationsnamen.
Versionsverwaltung Versionsverwaltung – Wählen Sie eine Aktion, einen Job oder einen Connector aus und klicken Sie darauf, um die folgenden Optionen aufzurufen: Als neue Version speichern: Speichern Sie das Objekt als neue Version mit optionalen Kommentaren. Versionsverlauf ansehen: Frühere Versionen aufrufen und wiederherstellen. Nur verfügbar, wenn mindestens eine Version gespeichert wurde. Klicken Sie auf „Wiederherstellen“, um jederzeit eine der vorherigen Versionen wiederherzustellen. Diese Option ist nur verfügbar, wenn Sie zuvor für eine Aktion, einen Job, einen Connector oder einen Manager auf Als neue Version speichern geklickt haben.
 Doppelt vorhandener Artikel Element (Job, Aktion, Connector, Manager) duplizieren. Nach dem Speichern wird das Duplikat in der Liste ohne das Schloss-Symbol Schloss angezeigt.

Benutzerdefinierte Integration erstellen

  1. Klicken Sie auf Neues Element erstellen und wählen Sie Integration aus.
  2. Geben Sie einen Namen ein und klicken Sie auf Erstellen.
  3. Wählen Sie die erstellte Integration aus der Liste aus und geben Sie die folgenden Informationen an:
    • Beschreibung: Wird im Content Hub angezeigt und ist für alle Google Security Operations-Nutzer sichtbar.
    • SVG-Symbol: Laden Sie ein SVG-Symbol hoch, das mit der Integration angezeigt wird.
    • Bild: Laden Sie ein Content Hub-Bild für Google SecOps-Nutzer hoch.
    • Bibliotheken: Fügen Sie Python-Bibliotheken mit pip hinzu.
    • Skriptabhängigkeiten: Laden Sie.WHL-, .PY-, .TAR- oder.GZ-Dateien hoch. Diese Scripts fügen Ihrer Integration weitere Funktionen hinzu.
    • Parameter: Fügen Sie konfigurierbare Felder mit definierten Typen, Standardwerten und erforderlichem Status hinzu.
  4. Klicken Sie abschließend auf Speichern.

Job erstellen

So erstellen Sie einen Job:

  1. Klicken Sie auf Neues Element erstellen und wählen Sie Job aus.
  2. Geben Sie einen Namen und die erforderliche Integration ein.
  3. Klicken Sie auf Erstellen.
  4. Optional: Fügen Sie Parameter für Nutzer- oder Skripteingaben hinzu.
  5. Klicken Sie auf Speichern oder drücken Sie Ctrl + S.
  6. Klicken Sie auf arrow_right Element abspielen, um das Script auszuführen.
  7. Gehen Sie zu Automatisierung > Jobplaner.
  8. Klicken Sie auf add Neuen Job erstellen und wählen Sie den gerade erstellten Job aus.
  9. Wählen Sie unter Antwort > Jobplaner die gewünschte Zeit für die Ausführung des von Ihnen erstellten Jobs (Skripts) aus.

Neue Aktion zur Verwendung in einem Playbook erstellen

So erstellen Sie eine neue Aktion für ein Playbook:

  1. Klicken Sie auf Neues Element erstellen und wählen Sie Aktion aus.
  2. Geben Sie einen Namen und die erforderliche Integration ein > klicken Sie auf Erstellen.
  3. Bearbeiten Sie den Code nach Bedarf.
  4. Aktivieren Sie JSON-Ergebnis einschließen, wenn die Aktion in einem Playbook ein JSON-Ergebnis zurückgeben soll.
  5. Optional: Fügen Sie Parameter hinzu, die als Eingabefelder angezeigt werden sollen.
  6. Aktivieren Sie die Aktion und klicken Sie auf Speichern.
  7. In der Polling-Konfiguration können Sie ein Zeitlimit und einen Standardrückgabewert festlegen, falls die Aktion das Zeitlimit überschreitet. Sie können auch einen Standardwert festlegen, der zurückgegeben wird, wenn die Aktion nicht innerhalb des definierten Zeitlimits abgeschlossen wird.

Die Aktion kann jetzt unter Playbook > Aktionen verwendet werden.

Benutzerdefinierten Manager erstellen

So erstellen Sie einen benutzerdefinierten Manager:

  1. Klicken Sie auf Neues Element erstellen und wählen Sie Manager aus. Geben Sie einen Namen und die erforderliche Integration ein.
  2. Klicken Sie auf Erstellen.
  3. Bearbeiten Sie den Code nach Bedarf.
  4. Klicken Sie auf Speichern.

Sicherheit von benutzerdefiniertem Code in der IDE

Um eine sichere Code-Ausführungsumgebung zu gewährleisten, wird der gesamte benutzerdefinierte Python-Code in der IDE in einer Sandbox-Umgebung ausgeführt. Diese Umgebung ist vom Hauptserver isoliert und wird mit einem Nutzer mit geringen Berechtigungen ausgeführt. Der Zugriff auf das zugrunde liegende Betriebssystem ist streng auf eine Zulassungsliste mit nicht administrativen Befehlen und Verzeichnissen beschränkt, die für typische Integrations- und Automatisierungsaufgaben erforderlich sind. Dieser Sandboxing-Ansatz ermöglicht robuste Sicherheit und bietet gleichzeitig die Flexibilität, eine Vielzahl von Python-Code auszuführen.

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten