Windows資格情報マネージャー

Windows資格情報マネージャーにシークレットを保存して取得


概説

Windows資格情報マネージャーは、パスワードやシークレットなどの機密情報を保存し、アプリケーションから安全にアクセスできるようにするWindowsのネイティブユーティリティです。

KeeperのWindows資格情報ユーティリティは、ネイティブWindows APIと連携し、Windows資格情報マネージャーからシークレットを保存および取得します。任意の連携、プラグイン、コードベースから利用でき、Windows資格情報マネージャーに認証情報、シークレット、パスワードをシンプルかつネイティブに保存および取得できます。

Windows資格情報ユーティリティのソースコードは以下で公開されています。

GitHub - Keeper-Security/windows-credential-utility: A utility for natively interacting with Windows Credential ManagerGitHub

利用に必要なバイナリは以下で入手できます。

Releases · Keeper-Security/windows-credential-utilityGitHub

Windows資格情報ユーティリティを利用するには、以下のいずれかを行います。

• リリースページからビルド済みバイナリをデプロイする

• コードベースにインポートする

以下では実行ファイルの使用方法を取り扱います。

使用方法 - 実行ファイル

実行ファイルのダウンロード

リリースページから最新版の実行ファイルをダウンロードし、必要に応じてPATHに追加して利用できます。

実行ファイルの使用

実行ファイルでは、以下の2つのコマンドが利用できます。

1. set

2. get

どちらのコマンドも、最初の引数としてアプリケーション name（Windows資格情報マネージャーに保存される、または保存先となる資格情報の名前）が必要です。

set

set では、保存するシークレットを第2引数として指定します。以下のいずれかです。

1. BASE64文字列

2. JSON文字列

3. 既存のJSONファイルへのパス

シークレットがWindows資格情報マネージャーに保存される際、まずBASE64形式にエンコードされます（すでにBASE64文字列でない場合）。これにより保存形式が標準化され、Keeperの連携機能および製品での利用が容易になります。

get

get は、保存されているBASE64でエンコードされた構成を stdout に返し、終了コード 0 で終了します。要求元の連携では、出力をキャプチャして利用できます。構成の取得中にエラーが発生した場合、非ゼロの終了コードが返され、stderr に書き込まれます。

例

# シークレットを保存
wcu set APPNAME eyJ1c2VybmFtZSI6ICJnb2xsdW0iLCAicGFzc3dvcmQiOiAiTXlQcmVjaW91cyJ9
# または
wcu set APPNAME config.json

# シークレットを取得
wcu get APPNAME