次に、各カスタムフィールドに入力し、**\[保存]** をクリックしてレコードを保存します。
### 4. 値のマッピングを作成
KSM CLI の`sync`コマンドでは、コマンドに指定したマッピングをもとに、どのシークレットをどの名前でGCPに登録するかを判断します。マッピングごとに、Keeperボルトにある値が対応する名前でGCP Secret Managerに設定されます。
これらのマッピングは次の形式に従っています。
```
--map "VALUE KEY" "KEEPER NOTATION"
```
* `VALUE KEY`: GCP Secret Managerで値が割り当てられるキー名
* `KEEPER NOTATION`: Keeperレコードから値を取得するための記法
Keeper表記法は、Keeperシークレットマネージャーが特定のレコードの値を指定するために使う記述方法です。 基本形式は以下のようになります。
```
UID/[field または custom_field]/フィールド名
```
以下の例では、指定されたUIDのレコード内にある「password」という名前の標準フィールドの値を参照しています。
```
ae3d[...]d22e/field/password
```
詳細については、[Keeper表記法](/keeperpam/jp/secrets-manager/about/keeper-notation.md)のページをご参照ください。
{% hint style="info" %}
例では、完全なUIDレコードが指定されていません。
{% endhint %}
完全なマッピング例
```
--map "MySQL_PWD" "jd3[...]i-fd/field/password"
```
複数のマッピングを1つの`sync`コマンドに追加できます。
```
--map "MySQL_PWD" "jd3[...]i-fd/field/password" --map "MySQL_Login" "jd3[...]i-fd/field/login"
```
{% hint style="warning" %}
Keeper記法で参照するレコードは、シークレットマネージャーアプリケーションと共有されている**共有フォルダ**内にある必要があります。正しく動作させるために、対象のレコードが必ず共有フォルダに配置されていることを確認してください。
{% endhint %}
{% hint style="success" %}
これで、KSM同期を実行する準備ができました。
{% endhint %}
## 同期の実行
同期を実行するには、クレデンシャルレコードと値のマッピングを指定して、KSM CLIの`sync`コマンドを使用します。
### 1. コマンドを構成
KSM syncコマンドをGCPタイプと組み合わせます。 以下のような形式になります。
```
ksm sync --type gcp --credentials [UID] --map [...] --map [...]
```
### 2. ドライランを実行
`sync`コマンドはドライラン (dry-run) に対応しており、GCP Secret Manager に対して実際の値を反映させずに、どの値が変更されるかを事前に確認できます。マッピングの記述が正しくできているかを確認するために、まずはドライランを実行することをおすすめします。
```
ksm sync --type gcp --credentials [UID] --map [...] --map [...] --dry-run
```
### 3. 同期を実行
準備ができたら、dry-runオプションを指定せずに`sync`コマンドを実行します。 これにより、KeeperボルトからGCPシークレットマネージャーに値がプッシュされます
{% hint style="info" %}
`--map`の短縮形として、`-m`を使用できます。
{% endhint %}
```
ksm sync --type gcp --credentials [UID] -m [...] -m [...]
```
---
# Agent Instructions: 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:
```
GET https://docs.keeper.io/keeperpam/jp/secrets-manager/integrations/gcp-secret-manager.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.
