execコマンド

任意のシステムコールを実行し、テンプレート化された環境変数をKeeperボルトのシークレットに置換

exec コマンド

テンプレート化した環境変数を、実行時にシークレットの値へ置き換えるには、ksm exec コマンドを使用します。

パラメータ:

置き換えられた環境変数を使用して、実行するシステムコールまたはスクリプト

形式: ksm exec -- <SYSTEM CALL OR SCRIPT>

Windowsでは、-- 以降 (ラップするコマンドとその引数) は入力どおりに子プロセスへ渡されます。これらの引数では %VAR% や $VAR は展開されず、$$ も $ に置き換わりません。

Linux bashスクリプト例

my_script.sh

#!/bin/bash

# Keeperシークレットを取得するBashスクリプト 

connect_db() {
  echo "Database Password:" $DB_PASSWORD
}

call_stripe() {
  echo "API Key:" $API_KEY
}

connect_db
call_stripe

2つの環境変数を設定して、スクリプトを実行します。

$ export DB_PASSWORD="keeper://XXX/field/password"
$ export API_KEY="keeper://XXX/custom_field/API Key"

$ ksm exec -- ./my_script.sh

Database Password: ksv33110sbnb7W@b3VGCHb
API Key: sk_test_MY2A30Ofg6Ukkq2NjMQVo87c

Windowsバッチファイルの例

C:\> ksm exec -- my_script.bat

PowerShellスクリプトの例

PS C:\> ksm exec -- powershell my_script.ps1

環境変数の置換

環境変数は、CLIが正しく検索および置換できるようにテンプレート化する必要があります。表記法のクエリ形式と機能については、Keeper表記法をご参照ください。以下は、その例です。

export DB_PASSWORD="keeper://XXX/field/password"
export API_KEY="keeper://XXX/custom_field/API Key"

ksm exec で環境変数に入れたシークレットは、子プロセスの環境に残ります。同じユーザーやrootがLinuxの /proc/<pid>/environ を読む、WindowsのProcess Explorerを使うなど、そのプロセスを見られる場合は値も読めます。他のローカルプロセスやユーザーを信頼できる環境でのみ使ってください。

シェルスクリプトの例

以下はLinuxのbashスクリプトの例です。 アプリケーションを起動する前、またはコマンドを実行する前に、keeper:// で始まる環境変数は、ボルトのシークレット値に置き換えられます。XXXXは、シークレットのレコードUIDに置き換えてください。

export MY_PASSWORD=keeper://XXXX/field/password
export MY_OTHER_PASSWORD=keeper://XXXX/field/password[0]
export MY_LAST_NAME=keeper://XXXX/custom_field/Name 2[last]
export MY_SECOND_PHONE=keeper://XXXX/custom_field/phone[1][number]

以下は、シークレットをコンソールに出力する簡単なbashスクリプトです。

#!/usr/bin/env bash
echo
echo "My Password = \${MY_PASSWORD}"
echo "Other Password = \${MY_OTHER_PASSWORD}"
echo "My Last Name = \${MY_LAST_NAME}"
echo "My Second Phone = \${MY_SECOND_PHONE}"

以下は、ksm exec を使用してbashスクリプトを実行した結果です。

$ ksm exec -- ./my_script.sh

My Password = $71387feh24fE%4416ffFHA
Other Password = YYFash328f^F^@#Fsdfjhsgblqef'f;
My Last Name = Smith
My Second Phone = 123-456-7890