カスタムのレコードタイプ

KeeperシークレットマネージャーCLIでカスタムレコードタイプを活用

概要

KeeperシークレットマネージャーCLIには、利用できるデフォルトのレコードタイプが用意されています。カスタムレコードタイプを使ったレコードの作成も可能です。

カスタムレコードタイプについて、詳しくはエンタープライズガイドをご参照ください。

カスタムレコードタイプを使ったレコードを作成するには、CLI内でスキーマを定義する必要があります。Keeperコマンダーでカスタムレコードタイプをエクスポートします。

以下の例では、「My Custom」レコードタイプをJSON形式で my_record_type.json にエクスポートします。

My Vault> rti --format json -lr "My Custom" --output my_record_type.json

JSONファイルは record_type ディレクトリにコピーします。record_type は keeper.ini と同じディレクトリでなくても構いません。CLIが keeper.ini を検索する場所のいずれかに置いてください。

• 環境変数 KSM_INI_DIR で定義されたパス
• 現在のディレクトリ
• ユーザーのホームディレクトリ

  • ${HOME}
  • ${HOME}/.config/ksm
  • ${HOME}/.keeper
  • $env:USERPROFILE
• 各種システムディレクトリ

  • /etc
  • /etc/ksm
  • /etc/keeper
  • $env:APPDATA/Keeper
  • $env:ProgramData/Keeper
  • $env:ProgramFiles/Keeper

KSM CLI 1.5.0以降、カレントディレクトリの keeper.ini は KSM_INI_DIR より常に優先されます。詳しくはprofileコマンドをご参照ください。ただし、上記の record_type ディレクトリは、これまでどおり KSM_INI_DIR をカレントディレクトリより先に探します。両者が別の場所を指していると、実際に使う keeper.ini と record_type の場所がずれることがあります。

別のディレクトリを使う場合は、configコマンドで指定できます。

$ ksm config record-type-dir -d /path/to/my/record/type/schemas

ファイルを record_type ディレクトリにコピーすると、利用可能なレコードタイプの一覧に表示されます。

 $ ksm secret template record -l
 Record Type
 ------------------------
 login
 bankAccount
 address
 ...
 My Custom

この時点で、カスタムレコードタイプを使って新しいレコードを作成できます。

$ ksm secret add field --sf XXXX --rt "My Custom" -t "My Record" \
    "login=jsmith" "password=XXXX" "url=https://localhost"

カスタムレコードタイプ名にスペースが含まれる場合は、名前を引用符で囲んでください。

カスタムレコードタイプ名はすべて一意である必要があります。同じ名前のレコードタイプがすでにインポートされている場合はエラーになります。デフォルトのレコードタイプは上書きできません。