.NETコマンダーCLI

.NETで記述されたコマンダーer CLI

概要

.NETコマンダーCLIは、Keeper .NET SDKを基盤に構築された高機能なコマンドラインアプリケーションです。Keeperボルトへの対話的またはスクリプトによるアクセスを可能にし、レコード管理、フォルダ操作、共有、エンタープライズ管理などを実行できます。

コマンダーのビルドと実行

リポジトリのクローン

git clone https://github.com/Keeper-Security/keeper-sdk-dotnet.git
cd keeper-sdk-dotnet

コマンダーCLIのビルド

# Commanderプロジェクトのみをビルド
dotnet build Commander/Commander.csproj

# もしくはソリューション全体をビルド
dotnet build KeeperSdk.sln

ビルド出力場所

• .NET 8.0: Commander/bin/Debug/net8.0/

• .NET Framework 4.7.2 (Windows): Commander/bin/Debug/net472/

実行方法

プロジェクトから実行

# LinuxまたはmacOSを使用する場合
dotnet run Commander --framework=net8.0

# Windowsを使用する場合
dotnet run Commander --framework=net472

クイックスタートガイド

初回セットアップ

1. コマンダーの起動 起動すると次のような対話型プロンプトが表示されます。

   Not Logged In>

2. Keeperへのログイン

   My Vault> login

   プロンプトが表示されたら以下の情報を入力します。

   • メールアドレス

   • マスターパスワード

   • 2要素認証コード (有効な場合)

   • デバイス承認(必要な場合)

3. ボルトの同期

   My Vault> sync-down
   # またはエイリアスを使用
   My Vault> d

4. レコードの一覧表示

   My Vault> list
   # または
   My Vault> ls -l

5. レコードの詳細を取得

   My Vault> get <record-uid-or-title>

コマンド一覧

以下は、コマンダーCLIで利用できるすべてのコマンドです (リンク)。

すべてのコマンドで --help を指定すると、使用方法を確認できます。

認証コマンド

コマンド	エイリアス	説明
login		Keeperアカウントにログイン
sync-down	d	ボルトデータをダウンロードして復号化
logout		ログアウトしてセッションを削除
whoami		現在のユーザー情報を表示

生体認証コマンド

コマンド	エイリアス	説明
biometric register		新しいWindows Helloキーを登録
biometric verify		生体認証でログインを検証
biometric list		Keeperアカウントに登録されている生体認証を一覧表示
biometric remove		現在のプラットフォームに紐づく認証情報を削除

ボルトのナビゲーションと検索

コマンド	エイリアス	説明
search	list	ボルトを検索 (正規表現パターンに対応)
ls		現在のフォルダ内容を一覧表示
cd		現在のフォルダを変更
tree		フォルダ構造をツリー表示

レコード管理

コマンド	エイリアス	説明
get		レコード、フォルダ、チームなどの詳細情報を取得
add-record	add	新しいレコードを作成
update-record	edit	既存のレコードを更新
rm		レコードを削除 (複数可)
mv		レコードまたはフォルダを別の場所に移動
record-history		レコードのバージョン履歴を表示
record-type-info	rti	レコードタイプ情報を取得
share-record		レコード共有の権限を管理

添付ファイル管理

コマンド	エイリアス	説明
download-attachment		レコードから添付ファイルをダウンロード
upload-attachment		レコードに添付ファイルをアップロード
delete-attachment		レコードから添付ファイルを削除

フォルダ管理

コマンド	エイリアス	説明
mkdir		新しいフォルダを作成
rmdir		フォルダを削除
update-dir		フォルダのプロパティを更新

共有フォルダ管理

コマンド	エイリアス	説明
sf-list		すべての共有フォルダを一覧表示
sf-user		共有フォルダのユーザー権限を管理
sf-record		共有フォルダ内のレコード権限を管理

ゴミ箱管理

コマンド	エイリアス	説明
trash		ゴミ箱内の削除済みレコードを管理

デバイス管理

コマンド	エイリアス	説明
devices		他のデバイスを管理
this-device		現在使用中のデバイス設定を管理

エンタープライズコマンド

コマンド	エイリアス	説明
enterprise-get-data	eget	エンタープライズデータを取得
enterprise-node	en	エンタープライズの組織ノードを管理
enterprise-user	eu	エンタープライズユーザーを管理
enterprise-team	et	エンタープライズチームを管理
enterprise-role	er	エンタープライズロールを管理
enterprise-device	ed	ユーザーデバイスを管理
transfer-user		ユーザーアカウントの所有権を譲渡
audit-report		監査レポートを実行

レコードタイプ管理

コマンド	エイリアス	説明
record-type-add		新しいカスタムレコードタイプを追加
record-type-update		既存のレコードタイプを更新
record-type-delete		カスタムレコードタイプを削除
load-record-types		JSONファイルからレコードタイプを一括読み込み
download-record-types		レコードタイプをJSONファイルにエクスポート

セキュリティとレポート

コマンド	エイリアス	説明
password-report		パスワードセキュリティの包括的レポートを生成
breachwatch		BreachWatchによるセキュリティ監視を実行

その他のコマンド

コマンド	エイリアス	説明
ksm		Keeperシークレットマネージャー関連コマンド
one-time-share		セキュアなワンタイム共有を管理
import		JSONファイルからレコードをインポート
clear	c	画面をクリア
help	?	ヘルプ情報を表示
quit	q	コマンダーを終了

生体認証ログインの例

生体認証でログイン

Connected to "keepersecurity.com".

Username: user_email
Biometric authentication successful.
Authentication completed successfully.

Syncing...
Decrypted 62 record(s)

生体認証情報の登録

このコマンドは、現在CLIでログイン中のユーザーのメールアドレスに新しいパスキーを作成します。このパスキーは、生体認証ログインをデバイスに登録した後、ログイン時の認証に使用されます。

このコマンドを使用するには、CLIでログインしている必要があります。

備考

1. コマンド実行後は、生体認証をデフォルトのログイン方法として使用するために、デバイスをKeeperに登録する必要があります。

2. 永続ログインが有効なデバイスでは、生体認証よりも永続ログインが優先されるため、ログイン時に生体認証は不要です。

My Vault> biometric register
Registering Windows Hello biometric credential...
Windows Hello credential registered successfully
Provider: Windows Hello

You can now use Windows Hello to log in to Keeper.

生体認証情報で認証

このコマンドは、保存済みの生体認証情報を使用してセッションを認証します。この機能は、生体認証によるログイン時にも同様に使用されます。

My Vault> biometric verify
Verifying Windows Hello authentication for '<user_email>' (purpose: vault)...
Windows Hello verification successful.

My Vault> biometric verify --purpose=login
Verifying Windows Hello authentication for '<user_email>' (purpose: login)...
Windows Hello verification successful.

登録済み生体認証情報の一覧表示

このコマンドは、指定したアカウントに登録されているすべての生体認証情報を表示します。認証デバイスタイプ、クレデンシャルID、作成日、最終使用日を含みます。

このコマンドを使用するには、CLIでログインしている必要があります。

My Vault> biometric list
Listing Windows Hello biometric credentials...


    #  Friendly Name  Provider                Created           Last Used         Status
  ---  -------------  ----------------------  ----------------  ----------------  ------
    1  Windows Hello  Windows Hello           2025-10-10 19:41  2025-10-10 19:42  Active
    2  Windows Hello  Windows Hello           2025-10-29 12:59  2025-10-29 14:14  Active

生体認証情報の削除

このコマンドは、Keeperから生体認証クレデンシャルを無効化します。削除後、Keeperプラットフォームは該当する認証情報を使用してログインを許可しなくなります。

My Vault> biometric remove
Are you sure you want to remove Windows Hello biometric credential for '<user_email>'? (y/N): y
Biometric credential removed for user: '<user_email>'