CyberArk PAM を Google SecOps と統合する

このドキュメントでは、CyberArk Privileged Access Manager を Google Security Operations と統合する方法について説明します。

始める前に

統合と連携するように CyberArk PAM を構成するには、統合用のユーザーを作成し、必要な CyberArk PAM Vault にアクセスする権限をそのユーザーに付与する必要があります。

ユーザーを作成する

統合用のユーザーを作成する手順は次のとおりです。

  1. 管理者として PrivateArk Client にログインします。
  2. [Tools] > [Administrative Tools] > [Users and Groups] に移動します。
  3. [Users and Groups] ダイアログで、ユーザーの場所を選択し、[New] をクリックして、[User] を選択します。
  4. [New User] ダイアログのさまざまなタブで、必要に応じて情報を入力します。[General] タブと [Authentication] タブは必須です。

ユーザーの作成の詳細については、Vault にユーザーを追加するをご覧ください。

作成したユーザーに権限を付与する

新しく作成したユーザーに Vault へのアクセス権を追加する手順は次のとおりです。

  1. 管理者として PrivateArk Client にログインします。
  2. アクセス権を付与する Vault を選択してログインします(ダブルクリックします)。
  3. トップメニューで [所有者] をクリックします。
  4. 新しいユーザーを追加するには、[追加] をクリックします。
  5. ダイアログでユーザーを選択します。
  6. [承認先] セクションで、少なくとも次の権限を選択します。
    • Monitor Safe
    • Retrieve files from Safe
    • Store files in Safe
    • Admisiter Safe
  7. 変更を保存するには、[OK] をクリックします。
  8. ダイアログ ウィンドウを閉じるには、[閉じる] をクリックします。

省略可: クライアント証明書を構成する

既存のクライアント証明書を使用するか、新しいクライアント証明書を作成して、CyberArk PAM インスタンスと Google SecOps SOAR 間の安全な通信を行うことができます。クライアント証明書の構成方法については、Central Credential Provider ウェブサービスの構成をご覧ください。

CyberArk PAM と Google SecOps を統合する

この統合には、次のパラメータが必要です。

パラメータ 説明
API Root 必須

API ルート URL。

値は https://IP_ADDRESS :PORT の形式で指定します。

Username 必須

接続に使用するユーザー名。

Password 必須

接続に使用するパスワード。

Verify SSL Optional

選択すると、統合によって CyberArk サーバーへの接続用の SSL 証明書が有効かどうかが検証されます。

デフォルトで選択されます。

CA Certificate 必須

API ルートへのセキュア接続の検証に使用する CA 証明書。

このパラメータは、Base64 でエンコードされた文字列の形式で CA 証明書を受け入れます。

Client Certificate Optional

CyberArk PAM 用に構成されている場合は、API ルートへの接続を確立するために使用する CyberArk クライアント証明書を指定します。証明書を PFX ファイル(PKCS #12 形式)として指定します。

Client Certificate Passphrase Optional

クライアント証明書に必要なパスフレーズ。

Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

アカウントのパスワードの値を取得する

[Get Account Password Value] アクションを使用して、CyberArk からアカウント パスワードの値を取得します。

この操作により、パスワードと SSH 認証鍵の両方を取得できます。

このアクションは Google SecOps エンティティでは実行されません。

アクションへの入力

Get Account Password Value アクションには、次のパラメータが必要です。

パラメータ 説明
Account 必須

パスワード値を取得するアカウント ID。

注: アカウント ID は、[List Accounts] アクションから取得できます。

Reason 必須

アカウントのパスワード値にアクセスする理由。

デフォルト値は Google SecOps SOAR から自動的に取得されます。

Ticketing System Name 省略可

チケット発行システムの名前。

Ticket ID 省略可

チケット発行システムのチケット ID。

Version 省略可

取得するアカウント パスワード値のバージョン。

アクションの出力

Get Account Password Value アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Get Account Password Value アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
 "content": "PASSWORD_VALUE"
}
出力メッセージ

[Get Account Password Value] アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
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.

アクションが成功しました。
Error executing action "Get Account Password Value". Reason: ERROR_REASON

操作を実行できませんでした。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、Get Account Password Value アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

アカウントの一覧表示

[List Accounts] アクションを使用して、指定した条件に基づいて CyberArk PAM で使用可能なアカウントを一覧表示します。

このアクションは Google SecOps SOAR エンティティでは実行されません。

アクションへの入力

List Accounts アクションには、次のパラメータが必要です。

パラメータ 説明
Search Query 必須

使用する検索クエリ。

Search operator 必須

指定された検索クエリに基づいて検索を実行するために使用する検索演算子。

指定できる値は次のとおりです。
  • contains
  • startswith
。

デフォルト値は contains です。

Max Records To Return 必須

返されるレコード数。値を指定しない場合、アクションは 50 件のレコードを返します(API のデフォルト)。

Records Offset 必須

値を返すアクションのオフセット。

Filter Query 必須

使用するフィルタクエリ。フィルタは、safeName パラメータまたは modificationTime パラメータに基づいて設定できます。

Saved Filter 必須

使用する保存済みフィルタクエリ。

このパラメータは Filter Query パラメータよりも優先されます。

アクションの出力

List Accounts アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

ケースウォールで、[List Accounts] アクションにより次の表が表示されます。

テーブル名: Available PAM Accounts

テーブル列:

  • ID
  • Safe Name
  • User Name(ユーザー名)
  • シークレット タイプ
JSON の結果

次の例は、List Accounts アクションを使用した場合に受信する JSON 結果の出力を示しています。

{
   "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
}
出力メッセージ

List Accounts アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明

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.

アクションが成功しました。
Error executing action "List Accounts". Reason: ERROR_REASON

操作を実行できませんでした。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、List Accounts アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

Ping

*Ping アクションを使用して、CyberArk への接続をテストします。

このアクションは Google SecOps エンティティでは実行されません。

統合入力

なし

アクションの出力

Ping アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

Ping アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Successfully connected to the CyberArk PAM installation with the provided connection parameters! アクションが成功しました。
Failed to connect to the CyberArk PAM installation! Error is ERROR_REASON

操作を実行できませんでした。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

アカウントのパスワードの変更

アカウントのパスワードを変更アクションを使用して、CyberArk PAM で即時パスワード変更タスクをキューに入れます。

このアクションは Google SecOps エンティティでは実行されません。

アクションへの入力

アカウント パスワードの変更アクションには、次のパラメータが必要です。

パラメータ 説明
Account ID 必須

即時パスワード変更タスクのキューに追加するアカウント ID のカンマ区切りのリスト。

注: ターゲット アカウント ID 文字列は、List Accounts アクションの出力パラメータから直接取得できます。

アクションの出力

アカウントのパスワードの変更アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、アカウントのパスワードを変更するアクションを使用した場合に受信する JSON 結果の出力を示しています。

{
  "successful_accounts": [
    "28_12"
  ],
  "failed_accounts": [
    {
      "account_id": "36_4",
      "error": "The account is not managed by the CPM"
    }
  ]
}
出力メッセージ

アカウントのパスワードの変更アクションでは、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Successfully queued immediate password change task for the following accounts: ACCOUNT_IDS アクションが成功しました。
Error executing action "Change Account Password". Reason: ERROR_REASON

操作を実行できませんでした。

サーバーへの接続、ターゲット アカウント ID の値、または管理 CPM の構成設定を確認してください。

スクリプトの結果

次の表に、アカウントのパスワードを変更するアクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

ジョブ

ジョブの詳細については、 新しいジョブを構成すると 高度なスケジューリングをご覧ください。

CyberArk PAM - 統合認証情報の同期ジョブ

CyberArk PAM - Sync Integration Credentials Job を使用して、CyberArk PAM からアカウント認証情報とシークレットを自動的に取得し、統合インスタンス、コネクタ、スケジュール設定されたジョブの構成を動的に更新して、Google SecOps SOAR に同期します。

ジョブ パラメータ

CyberArk PAM - Sync Integration Credentials Job には、次のパラメータが必要です。

パラメータ 説明
API Root

必須。

CyberArk PAM の API ルート URL。

値が指定されていない場合、ジョブは統合構成で指定された値を参照します。

Username

必須。

CyberArk PAM への接続に使用するユーザー名。

値が指定されていない場合、ジョブは統合構成で指定された値を参照します。

Password

必須。

CyberArk PAM への接続に使用するパスワード。

値が指定されていない場合、ジョブは統合構成で指定された値を参照します。

Verify SSL

必須。

選択すると、CyberArk PAM サーバーへの接続時に SSL 証明書が検証されます。

デフォルトで有効になっています。

CA Certificate

省略可。

API ルートへの SSL 接続の検証に使用される Base64 でエンコードされた CA 証明書。

Client Certificate

省略可。

相互 TLS 認証に使用される Base64 エンコードのクライアント証明書。

Client Certificate Passphrase

省略可。

クライアント証明書に必要なパスフレーズ(暗号化されている場合)。

Environment Name

必須。

統合インスタンス、コネクタ、ジョブを検索して更新する Google SecOps SOAR 環境の名前。共有環境の場合は、* を指定します。

デフォルト値は Default Environment です。

Credential Mapping

必須。

SOAR 統合インスタンス、コネクタ、ジョブを CyberArk PAM アカウントパスにマッピングする JSON または YAML マッピング文字列。

値は accounts/<account_id> または accounts/<account_id>/versions/<version_id> の形式にする必要があります。

デフォルト値は {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "accounts/Account_ID"}}} です。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。