HashiCorp Vault

In diesem Dokument wird beschrieben, wie Sie HashiCorp Vault in Google SecOps einbinden.

HashiCorp Vault in Google Security Operations einbinden

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

Integrationseingaben

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Parameter
API Root Erforderlich

API-Stamm, zu dem eine Verbindung hergestellt werden soll.

Der Standardwert ist https://IP_ADDRESS:8200..
Token Optional

Token, das für die Verbindung verwendet werden soll. Sie können sich entweder mit einem Token oder mit der Kombination aus Nutzername und Passwort authentifizieren.
Username Optional

Nutzername, der für die Verbindung verwendet werden soll. Sie können sich entweder mit einem Token oder mit der Kombination aus Nutzername und Passwort authentifizieren.
Password Optional

Passwort, das für die Verbindung verwendet werden soll. Sie können sich entweder mit einem Token oder mit der Kombination aus Nutzername und Passwort authentifizieren.

Verify SSL Optional

Wenn diese Option aktiviert ist, wird das für den API-Stamm konfigurierte Zertifikat validiert.

Standardmäßig deaktiviert.
Key-Value Secret Engine Path Erforderlich

Pfad, der für den Schlüssel/Wert-Secret-Speicher verwendet wird. Nur Version 2 wird unterstützt. Dieser Parameter wird verwendet, um mit Secrets zu interagieren, die in einem Speicher gespeichert sind, und URLs wie https://IP_ADDRESS:8200/v1/secret/data/ zu erstellen.

Der Standardwert ist secret.

Aktionen

AWS-Anmeldedaten generieren

Anmeldedaten basierend auf der in HashiCorp Vault gespeicherten AWS-Rolle generieren.

Entitäten

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

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Parameter
AWS Secret Engine Path Optional

Pfad, der für den AWS-Secret-Speicher verwendet wird. Nur Version 2 wird unterstützt. Dieser Parameter wird verwendet, um mit Secrets zu interagieren, die in einem Speicher gespeichert sind, und URLs wie http://IP_ADDRESS:8200/v1/aws/roles/ zu erstellen.

Der Standardwert ist aws.
AWS Role Name Erforderlich

Rollenname, für den Anmeldedaten generiert werden sollen.
AWS Role ARN Optional

ARN der Rolle, die übernommen werden soll, wenn credential_type für die Vault-Rolle auf assumed_role festgelegt ist.

Dieser Parameter muss mit einem der zulässigen Rollen-ARNs in der Vault-Rolle übereinstimmen.
AWS Role Session Name Optional

Name der Rollensitzung, die an den ARN der angenommenen Rolle angehängt werden soll. Wenn kein Wert angegeben ist, wird er standardmäßig dynamisch generiert.
TTL (seconds) Optional

TTL in Sekunden für die Verwendung des STS-Tokens.

Dieser Parameter wird als String mit einem Suffix für die Dauer angegeben und ist nur gültig, wenn die AWS-Rolle credential_type in einem Vault entweder assumed_role oder federation_token ist.

Wenn dieser Parameter nicht angegeben ist, wird der für die Rolle festgelegte default_sts_ttl-Wert verwendet.

Wenn der Wert default_sts_ttl ebenfalls nicht festgelegt ist, wird der Standardwert von 3.600 Sekunden verwendet.
JSON Expression Builder Optional

JSON-Ausdruck, um eine bestimmte Teilmenge von Daten aus einem Secret zu filtern.

Beispiel: | "data" | "data" | "key0".

Aktionsausgaben

Aktionsausgabetyp
Anhang im Fall-Repository –
Link zum Fall-Repository –
Tabelle im Fall-Repository –
Anreicherungstabelle –
Entitätsstatistik –
Insight –
JSON-Ergebnis Verfügbar
Vorkonfiguriertes Widget –
Scriptergebnis Verfügbar
Scriptergebnis
Name des Skriptergebnisses Wert
is_success Wahr/falsch
JSON-Ergebnis
{
"request_id": "08fe0196-fd51-8c32-9a90-a245ad6ade29",
"lease_id": "aws/creds/my-role/MWLgJVdR2n8YwQuuX1dVN3Nv",
"renewable": true,
"lease_duration": 2764800,
"data": {
"access_key": "AKIAWP5MI7…",
"secret_key": "CwYA8StJ8r+Oe0AKS8JnBvOWNOF…",
"security_token": null
},
"wrap_info": null,
"warnings": null,
"auth": null
}
Fall-Repository

Die Aktion liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully generated credentials for the ROLE_NAME role. Aktion erfolgreich.
Error executing action "Generate AWS Credentials". Reason: Incorrect JSON value is provided for the Expression Builder.

Aktion fehlgeschlagen.

Prüfen Sie den Parameterwert JSON Expression Builder.
Error executing action "Generate AWS Credentials". Reason: ERROR_REASON

Aktion fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

AWS-Rollen auflisten

AWS-Rollen auflisten, die in HashiCorp Vault basierend auf den angegebenen Kriterien verfügbar sind.

Entitäten

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

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Parameter
AWS Secret Engine Path Optional

Pfad, der für den AWS-Secret-Speicher verwendet wird. Nur Version 2 wird unterstützt. Dieser Parameter wird verwendet, um mit Secrets zu interagieren, die in einem Speicher gespeichert sind, und URLs wie http://IP_ADDRESS:8200/v1/aws/roles/ zu erstellen.

Der Standardwert ist aws.
Max Records To Return Optional

Anzahl der zurückzugebenden Datensätze. Wenn kein Wert angegeben ist, gibt die Aktion standardmäßig 50 Einträge zurück.

Aktionsausgaben

Aktionsausgabetyp
Anhang im Fall-Repository –
Link zum Fall-Repository –
Tabelle im Fall-Repository –
Anreicherungstabelle –
Entitätsstatistik –
Insight –
JSON-Ergebnis Verfügbar
Vorkonfiguriertes Widget –
Scriptergebnis Verfügbar
Scriptergebnis
Name des Skriptergebnisses Wert
is_success Wahr/falsch
JSON-Ergebnis
{
"request_id": "7356485b-4186-3873-72e3-d2e588dc6fb6",
"lease_id": "",
"renewable": false,
"lease_duration": 0,
"data": {
"keys": [
"m",
"my-other-role",
"my-role"
]
},
"wrap_info": null,
"warnings": null,
"auth": null
}
Fall-Repository

Die Aktion liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully found AWS roles in the AWS_SECRET_ENGINE_PATH store. Aktion erfolgreich.
Error executing action "List AWS Roles". Reason: Invalid value was provided for "Max Records to Return": PROVIDED_VALUE . Positive number should be provided.

Aktion fehlgeschlagen.

Prüfen Sie den Parameterwert Max Records to Return.
Error executing action "List AWS Roles". Reason: ERROR_REASON

Aktion fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Schlüssel/Wert-Secret-Schlüssel auflisten

Listet die im HashiCorp Vault verfügbaren Secret-Schlüssel anhand der angegebenen Kriterien auf. Die Aktion gibt Schlüsselnamen zurück, die in einem Secret-Pfad ohne Werte gespeichert sind. Für den Secret-Pfad sollten Ordnernamen angegeben werden. Die Aktion funktioniert nicht, wenn der geheime Schlüssel angegeben ist.

Entitäten

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

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Parameter
Key-Value Secret Engine Path Optional

Pfad, der für den Schlüssel/Wert-Secret-Speicher verwendet wird. Nur Version 2 wird unterstützt. Dieser Parameter wird verwendet, um mit Secrets zu interagieren, die in einem Speicher gespeichert sind, und URLs wie https://IP_ADDRESS:8200/v1/secret/data/SECRET_TO_FETCH_FROM_THE_KV_STORE zu erstellen.

Der Standardwert ist secret.
Secret Path Optional

Abzurufender Secret-Pfad. Die Aktion akzeptiert Ordnernamen.

Beispiel: Wenn der Ordnername des Secret-Pfads my-secret und der Pfad des Schlüssel/Wert-Speichers secret ist, lautet der vollständige Pfad zum Abrufen https://IP_ADDRESS:8200/v1/secret/data/my-secret.

Wenn kein Wert angegeben ist, gibt die Aktion alle in der Secret-Engine gespeicherten Secret-Schlüssel zurück.

Der Standardwert ist https://IP_ADDRESS:8200..
Max Records To Return Optional

Anzahl der zurückzugebenden Datensätze.

Der Standardwert ist 50.

Aktionsausgaben

Aktionsausgabetyp
Anhang im Fall-Repository –
Link zum Fall-Repository –
Tabelle im Fall-Repository –
Anreicherungstabelle –
Entitätsstatistik –
Insight –
JSON-Ergebnis Verfügbar
Vorkonfiguriertes Widget –
Scriptergebnis Verfügbar
Scriptergebnis
Name des Skriptergebnisses Wert
is_success Wahr/falsch
JSON-Ergebnis
{
 "request_id": "ed5d30ed-0fe9-a3b5-36d1-cc81b9175fe9",
 "lease_id": "",
 "renewable": false,
 "lease_duration": 0,
 "data": {
   "keys": [
     "hello",
     "tesr2",
     "test"
   ]
 },
 "wrap_info": null,
 "warnings": null,
 "auth": null
}
Fall-Repository

Die Aktion liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully found the following secret keys for the provided criteria in the key-value store KEY-VALUE_SECRET_ENGINE_PATH. Aktion erfolgreich.
Error executing action "List Key-Value Secret Keys". Reason: Invalid value was provided for "Max Records to Return": PROVIDED_VALUE. Positive number should be provided.

Aktion fehlgeschlagen.

Prüfen Sie den Parameterwert Max Records to Return.
Error executing action "List Key-Value Secret Keys". Reason: ERROR_REASON

Aktion fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Ping

Testen Sie die Verbindung zur HashiCorp Vault-Installation mit den Parametern, die auf der Seite „Integrationskonfiguration“ im Google SecOps Content Hub angegeben sind.

Entitäten

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

Aktionseingaben

–

Aktionsausgaben

Aktionsausgabetyp
Anhang im Fall-Repository –
Link zum Fall-Repository –
Tabelle im Fall-Repository –
Anreicherungstabelle –
Entitätsstatistik –
Insight –
JSON-Ergebnis –
Vorkonfiguriertes Widget –
Scriptergebnis Verfügbar
Scriptergebnis
Name des Skriptergebnisses Wert
is_success Wahr/falsch
JSON-Ergebnis

–

Fall-Repository

Die Aktion liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully connected to the HashiCorp Vault installation with the provided connection parameters! Aktion erfolgreich.
Failed to connect to the HashiCorp Vault installation! Error is ERROR_REASON

Aktion fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Schlüssel/Wert-Secret lesen

Liest das in HashiCorp Vault gespeicherte Schlüssel/Wert-Secret anhand der angegebenen Kriterien.

Entitäten

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

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Parameter
Key-Value Secret Engine Path Optional

Pfad, der für den Schlüssel/Wert-Secret-Speicher verwendet wird. Nur Version 2 wird unterstützt. Dieser Parameter wird verwendet, um mit Secrets zu interagieren, die in einem Speicher gespeichert sind, und URLs wie https://IP_ADDRESS:8200/v1/secret/data/SECRET_TO_FETCH_FROM_THE_KV_STORE zu erstellen.

Der Standardwert ist secret.
Secret Path Erforderlich

Abzurufender Secret-Pfad. Die Aktion akzeptiert Ordnernamen.

Beispiel: Wenn der Ordnername des Secret-Pfads my-secret und der Pfad des Schlüssel/Wert-Speichers secret ist, lautet der vollständige Pfad zum Abrufen https://IP_ADDRESS:8200/v1/secret/data/my-secret.

Wenn kein Wert angegeben ist, gibt die Aktion alle in der Secret-Engine gespeicherten Secret-Schlüssel zurück.

Der Standardwert ist https://IP_ADDRESS:8200..
Secret Version Optional

Secret-Version, die abgerufen werden soll.
JSON Expression Builder Optional

JSON-Ausdruck, um eine bestimmte Teilmenge von Daten aus einem Secret zu filtern.

Beispiel: | "data" | "data" | "key0".

Aktionsausgaben

Aktionsausgabetyp
Anhang im Fall-Repository –
Link zum Fall-Repository –
Tabelle im Fall-Repository –
Anreicherungstabelle –
Entitätsstatistik –
Insight –
JSON-Ergebnis Verfügbar
Vorkonfiguriertes Widget –
Scriptergebnis Verfügbar
Scriptergebnis
Name des Skriptergebnisses Wert
is_success Wahr/falsch
JSON-Ergebnis
{
 "request_id": "8b020faf-808f-34c2-5348-c04871ee6594",
 "lease_id": "",
 "renewable": false,
 "lease_duration": 0,
 "data": {
   "data": {
     "key0": "value0"
   },
   "metadata": {
     "created_time": "2023-04-11T10:56:34.766417394Z",
     "custom_metadata": null,
     "deletion_time": "",
     "destroyed": false,
     "version": 1
   }
 },
 "wrap_info": null,
 "warnings": null,
 "auth": null
}
Fall-Repository

Die Aktion liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully fetched secret SECRET_PATH. Aktion erfolgreich.
Error executing action "Read Key-Value Secret". Reason: Incorrect JSON value is provided for the Expression Builder.

Aktion fehlgeschlagen.

Prüfen Sie den Parameterwert JSON Expression Builder.
Error executing action "Read Key-Value Secret". Reason: ERROR_REASON

Aktion fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

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