CyberArk PAM
このドキュメントでは、CyberArk Privileged Access Manager(PAM)を Google Security Operations SOAR と統合する方法について説明します。
統合バージョン: 6.0
始める前に
統合で動作するように CyberArk PAM を構成するには、統合用のユーザーを作成し、必要な CyberArk PAM Vault にアクセスする権限をそのユーザーに付与する必要があります。
ユーザーを作成する
統合用のユーザーを作成する手順は次のとおりです。
- 管理者として PrivateArk Client にログインします。
- [ツール] > [管理ツール] > [ユーザーとグループ] に移動します。
- [ユーザーとグループ] ダイアログで、ユーザーの場所を選択し、[新規] をクリックして、[ユーザー] を選択します。
- [新しいユーザー] ダイアログの各タブで、必要に応じて情報を入力します。[全般] タブと [認証] タブは必須です。
ユーザーの作成について詳しくは、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 |
必須 選択すると、統合によって CyberArk サーバーへの接続用の SSL 証明書が有効かどうかが検証されます。 デフォルトで選択されています。 |
CA Certificate |
必須 API ルートへの安全な接続の検証に使用する CA 証明書。 このパラメータは、Base64 エンコード文字列の形式で CA 証明書を受け入れます。 |
Client Certificate |
Optional CyberArk PAM 用に構成されている場合は、API ルートへの接続の確立に使用する CyberArk クライアント証明書を指定します。証明書を PFX ファイル(PKCS #12 形式)として提供します。 |
Client Certificate Passphrase |
Optional クライアント証明書に必要なパスフレーズ。 |
Google SecOps SOAR で統合を構成する方法について詳しくは、統合を構成するをご覧ください。
操作
CyberArk PAM 統合には、次のアクションが含まれます。
アカウントのパスワードの値を取得する
Get Account Password Value アクションを使用して、CyberArk からアカウントのパスワード値を取得します。
この操作を行うと、パスワードと SSH 認証鍵の両方を取得できます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクション入力
[Get Account Password Value] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Account |
必須
パスワード値を取得するアカウントの ID。 注: アカウント ID は、アカウントを一覧表示アクションから取得できます。 |
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 エンティティに対しては実行されません。
アクション入力
アカウントを一覧表示アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Search Query |
必須 使用する検索クエリ。 |
Search operator |
必須 指定された検索クエリに基づいて検索を実行するために使用する検索演算子。 指定できる値は次のとおりです。
デフォルト値は |
Max Records To Return |
必須 返すレコード数。値を指定しない場合、アクションは 50 件のレコード(API のデフォルト)を返します。 |
Records Offset |
必須 値を返すアクションのオフセット。 |
Filter Query |
必須 使用するフィルタ クエリ。フィルタは、 |
Saved Filter |
必須 使用する保存済みフィルタのクエリ。 このパラメータは |
アクションの出力
アカウントを一覧表示アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| 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
}
出力メッセージ
アカウントを一覧表示アクションでは、次の出力メッセージが表示されます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "List Accounts". Reason:
ERROR_REASON |
操作を実行できませんでした。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、アカウントを一覧表示アクションを使用した場合のスクリプト結果出力の値を示します。
| スクリプトの結果名 | 値 |
|---|---|
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 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。