CyberArk PAM in Google SecOps einbinden

In diesem Dokument finden Sie eine Anleitung zum Einbinden von CyberArk Privileged Access Manager in Google Security Operations.

Hinweis

Wenn Sie CyberArk PAM für die Integration konfigurieren möchten, müssen Sie einen Nutzer für die Integration erstellen und diesem Nutzer die Berechtigungen für den Zugriff auf die erforderlichen CyberArk PAM-Vaults gewähren.

Nutzer erstellen

So erstellen Sie einen Nutzer für die Integration:

  1. Melden Sie sich als Administrator im PrivateArk-Client an.
  2. Gehen Sie zu Tools > Verwaltungstools > Nutzer und Gruppen.
  3. Wählen Sie im Dialogfeld Nutzer und Gruppen den Nutzerstandort aus, klicken Sie auf Neu und wählen Sie Nutzer aus.
  4. Geben Sie in den verschiedenen Tabs des Dialogfelds Neuer Nutzer die erforderlichen Informationen ein. Die Tabs Allgemein und Authentifizierung sind obligatorisch.

Weitere Informationen zum Erstellen eines Nutzers finden Sie unter Nutzer zu einem Vault hinzufügen.

Dem erstellten Nutzer Berechtigungen gewähren

Führen Sie die folgenden Schritte aus, um einem neu erstellten Nutzer Zugriff auf einen Vault zu gewähren:

  1. Melden Sie sich als Administrator im PrivateArk-Client an.
  2. Wählen Sie den Vault aus, auf den Sie Zugriff gewähren möchten, und melden Sie sich an (Doppelklick).
  3. Klicken Sie im Menü oben auf Inhaber.
  4. Klicken Sie auf Hinzufügen, um einen neuen Nutzer hinzuzufügen.
  5. Wählen Sie im Dialogfeld den Nutzer aus.
  6. Wählen Sie im Abschnitt Autorisiert für mindestens die folgenden Berechtigungen aus:
    • Monitor Safe
    • Retrieve files from Safe
    • Store files in Safe
    • Admisiter Safe
  7. Klicken Sie auf OK, um die Änderungen zu speichern.
  8. Klicken Sie auf Schließen, um das Dialogfeld zu schließen.

Optional: Clientzertifikat konfigurieren

Sie können ein vorhandenes Clientzertifikat verwenden oder ein neues erstellen, um eine sichere Kommunikation zwischen der CyberArk PAM-Instanz und Google SecOps SOAR zu ermöglichen. Weitere Informationen zum Konfigurieren des Clientzertifikats finden Sie unter Konfiguration des Webdienstes des zentralen Anmeldedatenanbieters.

CyberArk PAM und Google SecOps integrieren

Für die Integration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root Erforderlich

Die API-Stamm-URL.

Geben Sie den Wert im folgenden Format an: https://IP_ADDRESS :PORT.

Username Erforderlich

Der Nutzername für die Verbindung.

Password Erforderlich

Das Passwort für die Verbindung.

Verify SSL Optional

Wenn diese Option ausgewählt ist, wird bei der Integration geprüft, ob das SSL-Zertifikat für die Verbindung zum CyberArk-Server gültig ist.

Standardmäßig ausgewählt.

CA Certificate Erforderlich

Das CA-Zertifikat, das zur Validierung der sicheren Verbindung zum API-Stamm verwendet werden soll.

Dieser Parameter akzeptiert das CA-Zertifikat in Form eines Base64-codierten Strings.

Client Certificate Optional

Wenn für CyberArk PAM konfiguriert, geben Sie das CyberArk-Clientzertifikat an, das zum Herstellen einer Verbindung zum API-Stamm verwendet werden soll. Stellen Sie das Zertifikat als PFX-Datei (im PKCS #12-Format) bereit.

Client Certificate Passphrase Optional

Die für das Clientzertifikat erforderliche Passphrase.

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 im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Kontopasswortwert abrufen

Verwenden Sie die Aktion Kontopasswortwert abrufen, um den Kontopasswortwert von CyberArk abzurufen.

Mit dieser Aktion können Sie sowohl das Passwort als auch den SSH-Schlüssel abrufen.

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

Aktionseingaben

Für die Aktion Kontopasswortwert abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Account Erforderlich

Die Konto-ID, für die der Passwortwert abgerufen werden soll.

Hinweis: Die Konto-ID kann über die Aktion Konten auflisten abgerufen werden.

Reason Erforderlich

Der Grund für den Zugriff auf den Wert des Kontopassworts.

Der Standardwert wird automatisch aus Google SecOps SOAR abgerufen.

Ticketing System Name Optional

Der Name des Ticketsystems.

Ticket ID Optional

Die Ticket-ID des Ticketsystems.

Version Optional

Die Version des Kontopasswortwerts, die abgerufen werden soll.

Aktionsausgaben

Die Aktion Kontopasswortwert abrufen liefert die folgenden Ausgaben:

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

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Kontopasswortwert abrufen empfangen wird:

{
 "content": "PASSWORD_VALUE"
}
Ausgabenachrichten

Die Aktion Kontopasswortwert abrufen liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully fetched password value for account ID ACCOUNT_ID

Password value for account with ID ACCOUNT_ID and supplied version VERSION was not found in the CyberArk PAM.

Aktion erfolgreich.
Error executing action "Get Account Password Value". Reason: ERROR_REASON

Aktion fehlgeschlagen.

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

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Skriptausgabe beschrieben, wenn die Aktion Get Account Password Value verwendet wird:

Name des Skriptergebnisses Wert
is_success True oder False

Konten auflisten

Verwenden Sie die Aktion Konten auflisten, um die in CyberArk PAM verfügbaren Konten anhand der angegebenen Kriterien aufzulisten.

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

Aktionseingaben

Für die Aktion Konten auflisten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Search Query Erforderlich

Die zu verwendende Suchanfrage.

Search operator Erforderlich

Der Suchoperator, der für die Suche basierend auf der angegebenen Suchanfrage verwendet werden soll.

Folgende Werte sind möglich:
  • contains
  • startswith
.

Der Standardwert ist contains.

Max Records To Return Erforderlich

Die Anzahl der zurückzugebenden Datensätze. Wenn Sie keinen Wert angeben, gibt die Aktion 50 Einträge zurück (API-Standard).

Records Offset Erforderlich

Der Offset für die Aktion, um die Werte zurückzugeben.

Filter Query Erforderlich

Die zu verwendende Filterabfrage. Sie können den Filter auf den Parameter safeName oder modificationTime basieren lassen.

Saved Filter Erforderlich

Die zu verwendende gespeicherte Filterabfrage.

Dieser Parameter hat Vorrang vor dem Parameter Filter Query.

Aktionsausgaben

Die Aktion Konten auflisten liefert die folgenden Ausgaben:

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

Auf einer Case Wall bietet die Aktion Konten auflisten die folgende Tabelle:

Tabellenname: Verfügbare PAM-Konten

Tabellenspalten:

  • ID
  • Name des Tresors
  • Nutzername
  • Secret-Typ
JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Konten auflisten empfangen wird:

{
   "value": [
       {
           "categoryModificationTime": 1672051160,
           "platformId": "WinDomain",
           "safeName": "UserTestSafe",
           "id": "33_3",
           "name": "user@example.com",
           "address": "user@example.com",
           "userName": "user",
           "secretType": "password",
           "platformAccountProperties": {},
           "secretManagement": {
               "automaticManagementEnabled": true,
               "lastModifiedTime": 1672051160
           },
           "createdTime": 1672051160
       }
   ],
   "count": 1
}
Ausgabenachrichten

Die Aktion Konten auflisten liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht

Successfully found accounts for the criteria provided in CyberArk PAM.

No accounts were found for the criteria provided in CyberArk PAM.

Both the Filter Query and Saved Filter parameters are provided, Saved Filter takes priority.

Aktion erfolgreich.
Error executing action "List Accounts". Reason: ERROR_REASON

Aktion fehlgeschlagen.

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

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Konten auflisten beschrieben:

Name des Skriptergebnisses Wert
is_success True oder False

Ping

Verwenden Sie die Aktion *Ping, um die Verbindung zu CyberArk zu testen.

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

Integrationseingaben

Keine.

Aktionsausgaben

Die Aktion Ping liefert die folgenden Ausgaben:

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

Die Aktion Ping liefert die folgenden Ausgabenachrichten:

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

Aktion fehlgeschlagen.

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

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping beschrieben:

Name des Skriptergebnisses Wert
is_success True oder False

Kontopasswort ändern

Verwenden Sie die Aktion Kontopasswort ändern, um eine sofortige Passwortänderung in CyberArk PAM in die Warteschlange zu stellen.

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

Aktionseingaben

Für die Aktion Change Account Password sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Account ID Erforderlich

Eine durch Kommas getrennte Liste der Konto-IDs, die für eine sofortige Passwortänderung in die Warteschlange gestellt werden sollen.

Hinweis: Sie können die Konto-ID-Strings des Zielkontos direkt aus den Ausgabeparametern der Aktion Konten auflisten abrufen.

Aktionsausgaben

Die Aktion Kontopasswort ändern liefert die folgenden Ausgaben:

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

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Kontopasswort ändern empfangen wird:

{
  "successful_accounts": [
    "28_12"
  ],
  "failed_accounts": [
    {
      "account_id": "36_4",
      "error": "The account is not managed by the CPM"
    }
  ]
}
Ausgabenachrichten

Die Aktion Kontopasswort ändern liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht
Successfully queued immediate password change task for the following accounts: ACCOUNT_IDS Aktion erfolgreich.
Error executing action "Change Account Password". Reason: ERROR_REASON

Aktion fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Werte der Zielkonto-ID oder die administrativen CPM-Konfigurationseinstellungen.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Kontopasswort ändern beschrieben:

Name des Skriptergebnisses Wert
is_success True oder False

Jobs

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

CyberArk PAM – Job zum Synchronisieren von Integrationsanmeldedaten

Verwenden Sie den Job CyberArk PAM - Sync Integration Credentials Job, um Kontoanmeldedaten und Secrets automatisch aus CyberArk PAM abzurufen und in Google SecOps SOAR zu synchronisieren. Dazu werden die Konfigurationen für Integrationsinstanzen, Connectors und geplante Jobs dynamisch aktualisiert.

Jobparameter

Für den Job CyberArk PAM – Sync Integration Credentials sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root

Pflichtangabe.

Die API-Stamm-URL von CyberArk PAM.

Wenn kein Wert angegeben ist, bezieht sich der Job auf den Wert, der in der Integrationskonfiguration angegeben ist.

Username

Pflichtangabe.

Der Nutzername für die Verbindung mit CyberArk PAM.

Wenn kein Wert angegeben ist, bezieht sich der Job auf den Wert, der in der Integrationskonfiguration angegeben ist.

Password

Pflichtangabe.

Das Passwort für die Verbindung mit CyberArk PAM.

Wenn kein Wert angegeben ist, bezieht sich der Job auf den Wert, der in der Integrationskonfiguration angegeben ist.

Verify SSL

Pflichtangabe.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum CyberArk PAM-Server hergestellt wird.

Standardmäßig aktiviert.

CA Certificate

Optional.

Das Base64-codierte CA-Zertifikat, das zur Validierung der SSL-Verbindung zum API-Stamm verwendet wird.

Client Certificate

Optional.

Das Base64-codierte Clientzertifikat, das für die gegenseitige TLS-Authentifizierung verwendet wird.

Client Certificate Passphrase

Optional.

Die für das Clientzertifikat erforderliche Passphrase (falls verschlüsselt).

Environment Name

Pflichtangabe.

Der Name der Google SecOps SOAR-Umgebung, in der Integrationsinstanzen, Connectors und Jobs gesucht und aktualisiert werden sollen. Geben Sie für freigegebene Umgebungen * an.

Der Standardwert ist Default Environment.

Credential Mapping

Pflichtangabe.

Der JSON- oder YAML-Zuordnungsstring, der SOAR-Integrationsinstanzen, Connectors und Jobs ihren CyberArk PAM-Kontopfaden zuordnet.

Werte müssen das Format accounts/<account_id> oder accounts/<account_id>/versions/<version_id> haben.

Der Standardwert ist {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "accounts/Account_ID"}}}.

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