ティンキー

Tinkey は、鍵を管理するための Tink のコマンドライン ユーティリティです。Tinkey を使用すると、リモート KMS に保存されている鍵暗号鍵を使用して鍵セットを暗号化または復号できます。Tinkey には、AWS KMS と Google Cloud KMS のサポートが組み込まれています。他の KMS のサポートを追加する場合、Tinkey を変更する必要はありません。

インストール

Tinkey は、ビルド済みのバイナリからインストールするか、Homebrew を使用するか、Tink ソースからビルドできます。

ビルド済みのバイナリ

Tinkey の最新リリースは 1.12.0 です(ダウンロード)。Linux、macOS、Windows で動作します。

Homebrew

Homebrew を使用して Tinkey をインストールするには、次のコマンドを実行します。

brew tap tink-crypto/tink-tinkey https://github.com/tink-crypto/tink-tinkey
brew install tinkey

ソースから

Tink のソースコードから Tinkey の最新バージョンをビルドするには、BazeliskBazel を使用します。

 TINKEY_URL="https://github.com/tink-crypto/tink-tinkey/releases/download/v1.12.0/tink-tinkey-1.12.0.zip"
 TINKEY_SHA256="425a551254847323078aaa80c0087bb228d7672e0c8663807aa06c50dcffa75a"
 curl -LsS "${TINKEY_URL}" -o tinkey.zip
 echo "${TINKEY_SHA256} tinkey.zip" | sha256sum -c
 unzip tinkey.zip && cd "tink-tinkey-1.12.0"
 bazelisk build //:tinkey

これにより、バイナリ bazel-bin/tinkey が生成されます。

コマンド リファレンス

Tinkey を使用して鍵を生成したり、鍵の暗号化、復号、ローテーションなどの管理タスクを実行したりできます。

表に記載されているコマンドを使用する構文は tinkey <command> [<args>] です。

コマンド アクション
help 使用可能なすべてのコマンドのヘルプ メッセージを出力します。
add-key キーセットに新しいキーを生成して追加します。
convert-keyset キーセットの形式を変更、暗号化、復号します。
create-keyset 新しい鍵セットを作成します。
create-public-keyset 秘密鍵セットから公開鍵セットを作成します。
list-key-templates サポートされているすべての鍵テンプレートを一覧表示します。
delete-key 鍵セット内の指定された鍵を削除します。
destroy-key 非推奨。鍵セット内の指定された鍵の鍵マテリアルを破棄します。(これは非推奨です。破棄された鍵を含む鍵セットでの Tink の動作は、Tink のバージョンによって異なる場合があります)。
disable-key 鍵セット内の指定された鍵を無効にします。
enable-key 鍵セット内の指定された鍵を有効にします。
list-keyset 鍵セット内の鍵を一覧表示します。
promote-key 指定されたキーをプライマリに昇格します。
rotate-keyset [非推奨] 新しい鍵を追加して、プライマリにします。(代わりに、最初に add-key で新しい鍵を追加し、後で promote-key で明示的にプライマリにすることをおすすめします。分散システムでは、新しいキーをプライマリに昇格させる前に、すべてのサーバーで新しいキーが使用可能であることを確認する必要があります)。