mcpField
K
keeper-setup

keeper-setup

github.com/keeper-securityセキュリティ12114 回インストール20 週間前に更新
リポジトリ

keeper-setup について

Keeper の KSM CLI と Commander の設定を支援するスキルです。シークレットへのアクセスやボルト管理を行うユーザー向けに、導入元、トークンの安全な設定、リージョン、トラブルシューティングを扱います。

主な機能

  1. 01KSM CLI と Commander のインストール
  2. 02トークンによる KSM 初期化
  3. 03認証情報の安全な取り扱い
  4. 04Keeper リージョンの一覧
  5. 05一般的な設定問題の解決

活用シーン

  1. 01ワークステーションでの KSM CLI 設定
  2. 02CI やコンテナのシークレットアクセス設定
  3. 03Commander のボルトセッション開始
  4. 04認証またはキーリングエラーの解決

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/keeper-security/keeper-agent-kit --skill keeper-setup

インストール後、Claude Code で/keeper-setupを入力して読み込まれたか確認します。

詳細

Keeper CLI のセットアップと設定

公式ドキュメント

  • Secrets Manager (KSM) - 概念、KSM CLI のインストール、アプリ／デバイスのセットアップ
  • Commander CLI - 概念、インストール、対話型シェル
  • Keeper notation - ksm exec と ksm interpolate で使用される keeper:// URI（使い方については keeper-secrets スキルを参照）

Keeper には 2 つの CLI ツールがあります。必要なものをインストールしてください。

ツールパッケージ用途
KSM CLI (ksm)keeper-secrets-manager-cliマシンシークレットの取得と注入
Commander (keeper)keepercommander管理、ボルト管理、PAM、セッション

インストール時のセキュリティ

  • PyPI を優先してください（pip install …）。公開済みパッケージを利用でき、独自の依存関係ファイルでバージョンを固定できます。これらのツールでは、これが標準の方法です。
  • 公式ソースのみを使用してください：リリースバイナリとソースコードは、GitHub の Keeper-Security 組織配下にあります。インストーラーやクローンからの pip install を実行する前に、リモート URL と公開元が Keeper の公式ドキュメントと一致することを確認してください。さらに確実性が必要な場合は、リリースページで公開されているリリースタグまたはチェックサムを使用してください。
  • エージェントはワンタイムトークン、マスターパスワード、ボルトのフィールド値をチャットや生成スクリプトで捏造したり、出力したりしてはなりません。シークレットは、ユーザー自身の安全なターミナルまたはシークレットストアでのみ貼り付けるか注入するよう案内してください。

クイックインストール

KSM CLI
# With OS-native keyring (recommended for workstations)
pip install keeper-secrets-manager-cli[keyring]

# Without keyring (for containers, CI/CD, headless)
pip install keeper-secrets-manager-cli

# Verify
ksm version

バイナリーインストーラー（Python 不要）は、Secrets Manager CLI のドキュメントからリンクされている公式の Keeper-Security/secrets-manager GitHub Releases ページで、Windows、macOS、Linux 向けに公開されています。このリリースページからのみダウンロードしてください。リリースにチェックサムや署名がある場合は、検証してください。

Commander
pip install keepercommander

# Optional: install from a local clone of the official repository (verify remote and use a tagged release)
git clone https://github.com/Keeper-Security/Commander.git
cd Commander
git checkout <release-tag>
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt && pip install -e .

# Verify
keeper version

初回セットアップ

KSM CLI のセットアップ

KSM アプリからワンタイムアクセストークンを取得する必要があります。まだお持ちでない場合は、Keeper 管理者が Vault UI または Commander から作成できます（keeper-admin スキルを参照）。

トークンが --token 引数として渡されないよう、環境変数を使用して指定してください（シェルの履歴やプロセス一覧に表示される可能性があります）。公式ドキュメント： Profile command / init。

# Prerequisite: export KSM_CLI_TOKEN in this shell from Vault or Commander output (see Keeper profile docs). Never paste token values into chat or committed files.
ksm profile init
# Optional: unset KSM_CLI_TOKEN when finished in this shell.

ksm secret list  # Verify access

CI やシークレットマネージャーでは、値をコマンドラインに記述せず、同じ変数を注入してください。コンテナーの場合は、Keeper Secrets Manager CLI のドキュメントで KSM_TOKEN / KSM_INI_DIR の動作も確認してください。

Commander のセットアップ
keeper shell
# Enter your email, master password, and 2FA code
# Then enable persistent login:
My Vault> this-device register
My Vault> this-device persistent-login ON

Keeper リージョン

リージョンホストトークンプレフィックス
USkeepersecurity.comUS:
EUkeepersecurity.euEU:
AUkeepersecurity.com.auAU:
JPkeepersecurity.jpJP:
CAkeepersecurity.caCA:
US Govgovcloud.keepersecurity.usGOV:

トラブルシューティング

問題対処方法
"Not authenticated"新しい Client Device トークンで KSM_CLI_TOKEN を設定してから、ksm profile init を再実行してください
"Token expired"Commander または Vault UI で新しい Client Device を生成してください
IP ロックエラークライアントの作成時に --unlock-ip を使用するか、ロックされた IP から初期化してください
Keyring を利用できない[keyring] エクストラを指定してインストールするか、--ini-file フラグを使用してください
Python バージョンエラーKSM CLI には Python 3.10 以降、Commander には Python 3.10 以降が必要です
keeper.ini のアクセス許可が拒否されたファイルのパーミッションは 0600 にしてください。ls -la keeper.ini で確認してください

次のステップ

  • シークレット（Keeper notation を含む）の取得と注入については、keeper-secrets スキルを参照してください
  • エンタープライズ、ユーザー、PAM の管理については、keeper-admin スキルを参照してください

コメント

Markdown 対応