CyberArk PAM を Google SecOps と統合する
このドキュメントでは、CyberArk Privileged Access Manager を Google Security Operations と統合する方法について説明します。
始める前に
統合と連携するように CyberArk PAM を構成するには、統合用のユーザーを作成し、必要な CyberArk PAM Vault にアクセスする権限をそのユーザーに付与する必要があります。
ユーザーを作成する
統合用のユーザーを作成する手順は次のとおりです。
- 管理者として PrivateArk Client にログインします。
- [Tools] > [Administrative Tools] > [Users and Groups] に移動します。
- [Users and Groups] ダイアログで、ユーザーの場所を選択し、[New] をクリックして、[User] を選択します。
- [New User] ダイアログのさまざまなタブで、必要に応じて情報を入力します。[General] タブと [Authentication] タブは必須です。
ユーザーの作成の詳細については、Vault にユーザーを追加するをご覧ください。
作成したユーザーに権限を付与する
新しく作成したユーザーに Vault へのアクセス権を追加する手順は次のとおりです。
- 管理者として PrivateArk Client にログインします。
- アクセス権を付与する Vault を選択してログインします(ダブルクリックします)。
- トップメニューで [所有者] をクリックします。
- 新しいユーザーを追加するには、[追加] をクリックします。
- ダイアログでユーザーを選択します。
- [承認先] セクションで、少なくとも次の権限を選択します。
Monitor SafeRetrieve files from SafeStore files in SafeAdmisiter Safe
- 変更を保存するには、[OK] をクリックします。
- ダイアログ ウィンドウを閉じるには、[閉じる] をクリックします。
省略可: クライアント証明書を構成する
既存のクライアント証明書を使用するか、新しいクライアント証明書を作成して、CyberArk PAM インスタンスと Google SecOps SOAR 間の安全な通信を行うことができます。クライアント証明書の構成方法については、Central Credential Provider ウェブサービスの構成をご覧ください。
CyberArk PAM と Google SecOps を統合する
この統合には、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
API Root |
必須 API ルート URL。 値は |
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
|
アクションが成功しました。 |
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 |
必須 指定された検索クエリに基づいて検索を実行するために使用する検索演算子。 指定できる値は次のとおりです。
デフォルト値は |
Max Records To Return |
必須 返されるレコード数。値を指定しない場合、アクションは 50 件のレコードを返します(API のデフォルト)。 |
Records Offset |
必須 値を返すアクションのオフセット。 |
Filter Query |
必須 使用するフィルタクエリ。フィルタは、 |
Saved Filter |
必須 使用する保存済みフィルタクエリ。 このパラメータは |
アクションの出力
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 アクションでは、次の出力メッセージが表示されます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
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 環境の名前。共有環境の場合は、 デフォルト値は |
Credential Mapping |
必須。 SOAR 統合インスタンス、コネクタ、ジョブを CyberArk PAM アカウントパスにマッピングする JSON または YAML マッピング文字列。 値は デフォルト値は |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。