GCP Secret Manager

KeeperボルトのシークレットをGCP Secret Managerと同期

概説

Keeper Secrets Manager CLIツールのsyncコマンドを使用すると、Keeperボルトから目的のGCP Secret Managerプロジェクトにシークレットをプッシュし、目的の場所にある既存の値を上書きできます。これにより、Keeperボルトが、GCP Secret Managerを利用するGCPのすべてのサービスまたはスクリプトの信頼できる唯一の情報源となります。

機能

KeeperボルトのシークレットをGCP Secret Managerの信頼できる情報源として使用します
GCPの既存のスクリプトとサービスでKeeperボルトのシークレットがシームレスに使用できるようになります

前提条件

Keeper Secrets Managerへのアクセス（詳細は、クイックスタートガイドをご参照ください）
- KeeperサブスクリプションのSecrets Managerアドオンの有効化
- Secrets Manager強制ポリシーが有効化されたロールを割り当てられたメンバーシップ
シークレットを共有するKeeper Secrets Managerアプリケーション
- アプリケーションの作成手順については、クイックスタートガイドをご参照ください
GCP Secret Managerを使用するGCPアカウント、およびオプションでIAMサービスアカウントのクレデンシャルを作成する機能

設定

1. Keeper Secrets Manager CLIを設定

KSM CLIがすでにマシンに設定済みの場合は、この手順を省略できます。

KSM CLIツールを設定するには、Keeper Secrets Managerのワンタイムアクセストークンを使用してプロファイルを作成する必要があります。

これを行う最も簡単な方法は、次のコマンドを使用してデフォルトのプロファイルを初期化することです。

ksm profile init <TOKEN>

複数のプロファイルの作成およびその他のオプションについては、プロファイルのドキュメントをご参照ください。

2. GCPのアクセス権限を設定

GCPへのKSM同期を使用するために、GCP Secrets Managerは、同期するプロジェクトまたはサービスアカウントプリンシパルに対して、Secret Manager Adminロールが有効になった標準のIAMセキュリティクレデンシャルを必要とします。

IAMによるSecret Managerのアクセス制御:

IAM を使用したアクセス制御 | Secret Manager のドキュメント | Google CloudGoogle Cloud

サービスアカウントのクレデンシャルを作成するためのGCPの手順 (任意)

アクセス認証情報を作成する | Google Workspace | Google for DevelopersGoogle for Developers

3. GCPクレデンシャル記録の作成

KSM CLIでは、シークレットを設定するためにGCPサービスアカウントのクレデンシャルが必要です。これらのクレデンシャルはKeeperの記録に保存されており、CLIツールからは、Keeper Secrets Managerを使用してアクセスできます。

クレデンシャル記録には、以下のラベルを持つ記録フィールドが必要です。

"Google Cloud Project ID" "Google Application Credentials" - オプション

"Google Application Credentials"フィールドはオプションで、サービスアカウントのクレデンシャルを使用する場合にのみ必要です。デフォルトでは、GCPクライアントはgcloud CLIを使用して作成できるアプリケーションのデフォルトのクレデンシャルを使用します

gcloud auth application-default login

これらのクレデンシャルが不要になった場合は、取り消すことができます。

gcloud auth application-default revoke

方法 1: GCPクレデンシャルのカスタムの記録タイプを作成

必要なフィールドを使用してカスタムの記録タイプを作成できるため、記録の作成が簡単かつシンプルになります。

カスタムの記録タイプを作成するには、Keeperボルトで[カスタムの記録タイプ]タブに移動して、[タイプの作成]をクリックします。正しいフィールドラベルを持つ伏せ字項目を使用して新しい記録タイプを作成し、[発行]をクリックして新しい記録タイプを作成します。

後は、GCPクレデンシャルタイプの記録を新規作成し、対応するフィールドに詳細情報を入力するだけです。

この新しい記録が、Secrets Managerアプリケーションに関連付けられた共有フォルダに移動されていることを確認します。

方法 2: カスタムフィールドを追加

新しい記録タイプを作成せずにクレデンシャル記録を作成するには、必要なフィールドをカスタムフィールドとして標準記録に追加します。

任意のタイプの新しい記録を作成し、必要なGCPフィールドごとに[伏せ字項目]タイプのカスタムフィールドを追加します。[ラベルの編集]をクリックして、対応するフィールド名のラベルを変更します。

どの記録タイプでも有効ですが、[ファイル添付]の標準記録タイプにはフィールドがないため、カスタムフィールドを追加したときの見た目がすっきりします。

次に、各カスタムフィールドに入力し、[保存]をクリックして記録を保存します。

4. 値のマッピングを作成

KSM CLIのsyncコマンドは、コマンド呼び出しで定義されたマッピングを使用して、設定する値を識別します。コマンドに渡されたマッピングごとに、指定した名前の値にKeeperボルトから所与の値が代入されます。

これらのマッピングは次の形式に従っています。

--map "VALUE KEY" "KEEPER NOTATION"

VALUE KEYは、GCP Secret Managerで値が割り当てられるキーの名前です。

KEEPER NOTATIONは、キーに設定するKeeperの記録の値を取得するKeeper表記法を使用したクエリです。

Keeper表記法は、Keeper Secrets Managerが特定の記録の値を識別するために使用するクエリの表記法です。この表記法は、次の一般的な形式に従います。UID/[field|custom]/fieldname 例: ae3d[...]d22e/field/password

詳細については、Keeper表記法のドキュメントをご参照ください。

これらの例では、完全なUID記録が指定されていないことにご注意ください。

完全なマッピング例: --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"

Keeper表記法を使用したクエリによって参照される記録が、Secrets Managerアプリケーションと共有されている共有フォルダに格納されていることを確かにします。

これで、KSM同期を実行する準備ができました