> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/keeperpam/jp/commander-cli/command-reference/import-and-export-commands/cyberark-pam-import.md).

# CyberArk PAMのインポート

CyberArk PVWAまたは特権クラウドからKeeperPAMへの特権アカウント移行

<figure><img src="https://859776093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPL6k1aGsLiFiiJ3Y7zCl%2Fuploads%2Fgit-blob-ff4a3722d670eab71cfe7c4c437437a5d0d4cdef%2FImport-Keeper-Cyberark.jpg?alt=media" alt=""><figcaption></figcaption></figure>

### 要件 <a href="#prerequisites" id="prerequisites"></a>

* Keeperコマンダーがインストールされ、ログイン済みであること。
* Keeperアカウントに、PAMプロジェクトを作成および管理する権限があること。
* CyberArk PVWA APIエンドポイントに接続できること。
* 移行するセーフとアカウントを読み取る権限を持つCyberArk認証情報があること。

環境変数で指定されていない場合、コマンドの実行時にCyberArk認証情報の入力が求められます。自動実行するには、コマンダーを起動する前に適切な変数を設定します。

| 変数                            | 用途                                                   |
| ----------------------------- | ---------------------------------------------------- |
| `KEEPER_CYBERARK_ID_TENANT`   | 特権クラウドのCyberArk Identityテナント                         |
| `KEEPER_CYBERARK_USERNAME`    | CyberArkユーザー名またはサービスアカウントのクライアントID                   |
| `KEEPER_CYBERARK_PASSWORD`    | CyberArkパスワードまたはサービスアカウントのクライアントシークレット               |
| `KEEPER_CYBERARK_LOGON_TYPE`  | セルフホスト型のログオンタイプ：`CyberArk`、`LDAP`、`RADIUS`、`Windows` |
| `KEEPER_CYBERARK_AUTH_METHOD` | 必要に応じて指定する特権クラウドの認証方法                                |

### コマンド構文 <a href="#command-syntax" id="command-syntax"></a>

```
pam project cyberark-import <PVWA_HOST> [OPTIONS]
```

`<PVWA_HOST>` には、`pvwa.example.com` などのセルフホスト型PVWAホスト名、または `mycompany.cyberark.cloud` などの特権クラウドテナントを指定できます。

### クイックスタート <a href="#quick-start" id="quick-start"></a>

#### インポートをプレビューする <a href="#preview-the-import" id="preview-the-import"></a>

ボルトを変更する前に、ドライランを実行します。`--include-credentials` を明示的に指定しない限り、認証情報は省略されます。

```bash
pam project cyberark-import pvwa.example.com --dry-run
```

#### 利用可能なセーフを確認する <a href="#review-the-available-safes" id="review-the-available-safes"></a>

```bash
pam project cyberark-import pvwa.example.com --list-safes
```

#### 階層型共有フォルダのサポート <a href="#import-the-selected-safes" id="import-the-selected-safes"></a>

```bash
pam project cyberark-import pvwa.example.com --nsf
```

#### 選択したセーフをインポートする <a href="#import-the-selected-safes" id="import-the-selected-safes"></a>

```bash
pam project cyberark-import pvwa.example.com \
  --name "CyberArk Production" \
  --gateway "Production Gateway" \
  --safes "Production,Shared*"
```

`--name` を省略すると、プロジェクト名は `CyberArk Migration` になります。

#### 特権クラウドからインポートする <a href="#import-from-privilege-cloud" id="import-from-privilege-cloud"></a>

```bash
pam project cyberark-import mycompany.cyberark.cloud \
  --name "CyberArk Cloud Migration" \
  --dry-run
```

### 共通オプション <a href="#common-options" id="common-options"></a>

| オプション                    | 説明                                                                 |
| ------------------------ | ------------------------------------------------------------------ |
| `--name`, `-n`           | PAMプロジェクト名                                                         |
| `--config`, `-c`         | PAM構成UIDまたはタイトルで既存のPAMプロジェクトを拡張                                    |
| `--gateway`, `-g`        | 新規プロジェクトのゲートウェイUIDまたは名前                                            |
| `--folder-mode`          | セーフとフォルダのレイアウト: `safe` (デフォルト)、`ksm`、`exact`、`flat`                |
| `--safes`                | 一致するセーフのみをインポート。カンマ区切りの名前とglobに対応                                  |
| `--exclude-safes`        | 一致するセーフを除外。カンマ区切りの名前とglobに対応                                       |
| `--list-safes`           | アカウント数を含むセーフを表示して終了                                                |
| `--dry-run`, `-d`        | ボルトを変更せずにインポートをプレビュー                                               |
| `--output`, `-o`         | 生成されたインポートJSONをファイルに保存                                             |
| `--include-credentials`  | ドライランの出力または保存したJSONにパスワードを含める                                      |
| `--yes`, `-y`            | 確認プロンプトをスキップ                                                       |
| `--skip-users`           | `pamUser` レコードをインポートせず、リソースレコードのみをインポート                            |
| `--skip-linked-accounts` | リンクされたログオン、調整、イネーブルアカウントをスキップ                                      |
| `--skip-dependents`      | CyberArkの依存アカウントサービスマッピングをスキップ                                     |
| `--state-filter`         | 指定したCPM状態のアカウントのみをインポート                                            |
| `--platform-map`         | カスタムCyberArkプラットフォームマッピングを含むJSONファイルを使用                            |
| `--no-verify-ssl`        | セルフホスト型PVWAの証明書検証を無効化。必要な場合にのみ使用                                   |
| `--include-system-safes` | デフォルトでは除外されるCyberArkシステムセーフを含める                                    |
| `--strict-policies`      | プラットフォームのローテーションポリシーを読み取れない場合にインポートを停止                             |
| `--nsf`                  | 従来の共有フォルダではなく、階層型共有フォルダでプロジェクト (リソース、ユーザー、ローテーション設定、PAM構成レコード) を構築 |

### フォルダレイアウト <a href="#folder-layout" id="folder-layout"></a>

デフォルトの `safe` モードでは、CyberArkの各セーフに対してKeeper共有フォルダが1つ作成されます。これにより、セーフのメンバー権限が保持され、移行後のアクセス制御を管理しやすくなります。

インポートされたプロジェクトには、以下が含まれます。

* PAMマシンおよびデータベースリソース
* リソースにリンクされたPAMユーザー
* 対応するWebサイトアカウントのログインレコード
* Keeper権限にマッピングされたセーフメンバー権限
* CyberArkポリシーのローテーションおよび接続設定
* 利用可能な場合は、リンクされたログオンおよび調整アカウント

`--folder-mode exact` を使用すると、プロジェクトフォルダ内にセーフの階層を保持できます。`--folder-mode flat` を使用すると、レコードが従来の共有フォルダレイアウトに配置されます。

### インポートJSONを保存する <a href="#save-the-import-json" id="save-the-import-json"></a>

インポートせずに生成されたペイロードを確認またはアーカイブするには、以下のコマンドを実行します。

```bash
pam project cyberark-import pvwa.example.com \
  --dry-run \
  --output /tmp/cyberark-import.json
```

パスワードはデフォルトでマスキングされます。認証情報が必要で、出力ファイルが保護されている場合にのみ、`--include-credentials` を追加してください。

### インポートしたプロジェクトを削除する <a href="#remove-an-imported-project" id="remove-an-imported-project"></a>

まずクリーンアップをプレビューします。

```bash
pam project cyberark-cleanup --name "CyberArk Production" --dry-run
```

名前またはPAM構成UIDを指定してプロジェクトを削除します。

```bash
pam project cyberark-cleanup --name "CyberArk Production" --yes
pam project cyberark-cleanup --config <PAM_CONFIG_UID> --yes
```

クリーンアップでは、インポートしたプロジェクトのレコードとフォルダに加え、インポートによって作成されたゲートウェイとプロジェクトに関連付けられたSecrets Managerアプリケーションが削除されます。

### トラブルシューティング <a href="#troubleshooting" id="troubleshooting"></a>

| メッセージまたは症状                    | 確認事項                                                                                                     |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| Authentication failed         | テナントまたはPVWAホスト名とCyberArk認証情報を確認します。セルフホスト型の場合は `KEEPER_CYBERARK_LOGON_TYPE` を確認します。                      |
| No safes or accounts found    | CyberArkアカウントに対象セーフを読み取る権限があることを確認し、`--list-safes` の出力を確認します。                                            |
| SSL certificate error         | 発行元CA証明書をインストールするか、信頼できる内部テスト環境でのみ `--no-verify-ssl` を使用します。                                             |
| Rotation settings are missing | インポートするアカウントがCyberArkのプラットフォームポリシーを利用できることを確認します。マスターポリシーのデフォルトを適用せずに失敗させるには、`--strict-policies` を使用します。 |

インストールされているバージョンで利用できるコマンドの詳細を確認するには、以下のコマンドを実行します。

```
help pam project cyberark-import
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.keeper.io/keeperpam/jp/commander-cli/command-reference/import-and-export-commands/cyberark-pam-import.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.