Akeyless in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Akeyless in Google Security Operations einbinden.

Anwendungsfälle

Die Akeyless-Integration verwendet Google SecOps-Funktionen, um die folgenden Anwendungsfälle zu unterstützen:

  • Integrationsanmeldedaten synchronisieren: Anmeldedaten und vertrauliche Parameter werden automatisch für alle Google SecOps-Integrationsinstanzen, Connectors und Jobs aktualisiert, indem in Akeyless gespeicherte Secrets verwendet werden.

  • Secrets in Playbooks abrufen: Rufen Sie während der Playbook-Ausführung statische Secrets oder bestimmte Secret-Versionen von Akeyless ab, um sich bei externen Diensten zu authentifizieren.

  • Rotation von Anmeldedaten automatisieren: Rotierte API-Schlüssel, Tokens und Passwörter von Akeyless an Google SecOps-Integrationen, ‑Connectors und ‑Jobs weitergeben, indem Parameter der Secret-Version latest zugeordnet werden, um Unterbrechungen durch abgelaufene Anmeldedaten zu vermeiden.

  • Anmeldedaten-Updates mit Versionsfixierung steuern: Fixieren Sie Integrations-, Connector- oder Jobparameter an eine bestimmte Secret-Version in Akeyless, um Anmeldedatenänderungen zu validieren oder bei Bedarf ein Rollback auf eine frühere Version durchzuführen.

  • Hartcodierte Secrets in Workflows eliminieren: Sensible Anmeldedaten werden in Akeyless zentralisiert, anstatt sie direkt in Playbook-Eingaben oder benutzerdefinierte Skripts einzubetten. Dadurch wird die Offenlegung von Anmeldedaten in SOC-Workflows reduziert.

Hinweis

Bevor Sie die Integration in der Google SecOps-Plattform konfigurieren, prüfen Sie, ob Folgendes vorhanden ist:

  • API-Schlüssel-Anmeldedaten: Eine Akeyless-Zugriffs-ID und ein Zugriffsschlüssel für die Authentifizierung.

    Weitere Informationen finden Sie unter Akeyless API-Schlüssel-Authentifizierung.

  • Zugriffsberechtigungen: Leseberechtigungen, die Ihrer Authentifizierungsmethode für die Secrets gewährt wurden, die Google SecOps abruft.

    Weitere Informationen finden Sie unter Akeyless Role-Based Access Control (RBAC).

  • Netzwerkverbindung: Netzwerkzugriff von Ihrer Google SecOps-Instanz oder Ihrem Remote-Agent auf die URL Ihres Akeyless API-Gateways.

Integrationsparameter

Für die Akeyless-Integration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Gateway URL

Optional.

Die URL Ihres Akeyless API-Gateways.

Der Standardwert ist https://api.akeyless.io.
Access ID

Erforderlich.

Die Zugriffs-ID für Ihre Akeyless-API-Schlüssel-Authentifizierungsmethode.
Access Key

Erforderlich.

Der Zugriffsschlüssel, der Ihrer Akeyless-Zugriffs-ID zugeordnet ist.
Verify SSL

Erforderlich.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum Akeyless-Server validiert.

Standardmäßig aktiviert.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen in „Mein Arbeitsbereich“ reagieren und Manuelle Aktion ausführen.

Secret-Wert abrufen

Verwenden Sie die Aktion Secret-Wert abrufen, um einen Secret-Wert aus Akeyless zur Verwendung in Playbooks abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Secret-Wert abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Secret Name

Erforderlich.

Der Name oder Pfad des Secrets, das von Akeyless abgerufen werden soll.

Wenn Sie die aktuelle Version abrufen möchten, geben Sie SECRET_NAME oder SECRET_NAME:latest ein.

Wenn Sie eine bestimmte Version abrufen möchten, geben Sie SECRET_NAME:VERSION_NUMBER ein, wobei VERSION_NUMBER eine positive Ganzzahl ist (z. B. /prod/api-key:2).

Aktionsausgaben

Die Aktion Secret-Wert abrufen gibt die folgenden Ausgaben zurück:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle im Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get Secret Value (Secret-Wert abrufen) empfangen wird:

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
Ausgabenachrichten

In der Case Wall (Fallwand) werden für die Aktion Get Secret Value (Secret-Wert abrufen) die folgenden Ausgabenachrichten angezeigt:

Ausgabemeldung Beschreibung der Nachricht
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Die Aktion war erfolgreich.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie, ob der Secret-Pfad und die Secret-Version in Akeyless vorhanden sind und ob Ihre Authentifizierungsdaten Lesezugriff auf das Secret haben.
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').

Die Aktion ist fehlgeschlagen.

Überprüfen Sie das Format des Parameters Secret Name.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get Secret Value (Secret-Wert abrufen) verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Ping

Verwenden Sie die Aktion Ping, um die Verbindung zum Akeyless-Server zu testen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle im Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Ausgabenachrichten

Auf der Fallpinnwand werden für die Aktion Ping die folgenden Ausgabenachrichten angezeigt:

Ausgabemeldung Beschreibung der Nachricht
Successfully connected to the Akeyless server with the provided connection parameters! Die Aktion war erfolgreich.
Failed to connect to the Akeyless server! Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie Ihre API Gateway URL-, Access ID-, Access Key- und SSL-Einstellungen.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping aufgeführt:

Name des Skriptergebnisses Wert
is_success true oder false

Jobs

Weitere Informationen zu Jobs finden Sie unter Neuen Job konfigurieren und Erweiterte Planung.

Synchronisierungsauftrag für Integrationsanmeldedaten

Mit dem Job „Integrationsanmeldedaten synchronisieren“ können Sie in Akeyless gespeicherte Secrets automatisch mit Ihren konfigurierten Google SecOps-Integrationsinstanzen, ‑Connectors und ‑Jobs synchronisieren.

Jobparameter

Für den Job zum Synchronisieren von Integrationsanmeldedaten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Gateway URL

Optional.

Die URL Ihres Akeyless API-Gateways.

Der Standardwert ist https://api.akeyless.io.
Access ID

Erforderlich.

Die Zugriffs-ID für Ihre Akeyless-API-Schlüssel-Authentifizierungsmethode.
Access Key

Erforderlich.

Der Zugriffsschlüssel, der Ihrer Akeyless-Zugriffs-ID zugeordnet ist.
Verify SSL

Erforderlich.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung zum Akeyless-Server validiert.

Standardmäßig aktiviert.
Environment Name

Erforderlich.

Die Google SecOps-Umgebung, in der die Zielintegrationsinstanzen, Connectors und Jobs konfiguriert sind.

Der Standardwert ist Default Environment.
Credential Mapping

Erforderlich.

Ein JSON- oder YAML-Wörterbuch, das Zielintegrationsinstanzen, Connectors und Jobs den Akeyless-Secrets zuordnet, die ihre Parameterwerte enthalten.

Fügen Sie mindestens einen zugeordneten Parameter unter den Schlüsseln integration_instances, connectors oder jobs ein.

Ein Beispiel finden Sie unter Beispiel: Credential Mapping.

Der Standardwert ist {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}.

Beispiel Credential Mapping

Im folgenden Beispiel wird gezeigt, wie Parameter für Integrationsinstanzen, Connectors und Jobs im Parameter Credential Mapping zugeordnet werden:

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

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