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:
- Melden Sie sich als Administrator im PrivateArk-Client an.
- Gehen Sie zu Tools > Verwaltungstools > Nutzer und Gruppen.
- Wählen Sie im Dialogfeld Nutzer und Gruppen den Nutzerstandort aus, klicken Sie auf Neu und wählen Sie Nutzer aus.
- 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:
- Melden Sie sich als Administrator im PrivateArk-Client an.
- Wählen Sie den Vault aus, auf den Sie Zugriff gewähren möchten, und melden Sie sich an (Doppelklick).
- Klicken Sie im Menü oben auf Inhaber.
- Klicken Sie auf Hinzufügen, um einen neuen Nutzer hinzuzufügen.
- Wählen Sie im Dialogfeld den Nutzer aus.
- Wählen Sie im Abschnitt Autorisiert für mindestens die folgenden Berechtigungen aus:
Monitor SafeRetrieve files from SafeStore files in SafeAdmisiter Safe
- Klicken Sie auf OK, um die Änderungen zu speichern.
- 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: |
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
|
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:
Der Standardwert ist |
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 |
Saved Filter |
Erforderlich Die zu verwendende gespeicherte Filterabfrage. Dieser Parameter hat Vorrang vor dem Parameter |
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 |
|---|---|
|
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 Der Standardwert ist |
Credential Mapping |
Pflichtangabe. Der JSON- oder YAML-Zuordnungsstring, der SOAR-Integrationsinstanzen, Connectors und Jobs ihren CyberArk PAM-Kontopfaden zuordnet. Werte müssen das Format Der Standardwert ist |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten