Tinkey 是 Tink 的指令列公用程式，可用來管理金鑰。Tinkey 可讓您使用儲存在遠端 KMS 中的金鑰加密金鑰，加密或解密金鑰集。Tinkey 內建支援 AWS KMS 和 Google Cloud KMS。
安裝
您可以從預先建構的二進位檔安裝 Tinkey、使用 Homebrew，或從 Tink 來源建構 Tinkey：
預先建構的二進位檔
Tinkey 的最新版本為 1.14.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，請使用 Bazel 和 Bazelisk：
TINKEY_URL="https://github.com/tink-crypto/tink-tinkey/archive/refs/tags/v1.14.0.zip"
TINKEY_SHA256="0ef4cd6a01e4b500c33a782dc34eb29858d0e0399022fa9e94b4ad0837190dc1"
curl -LsS "${TINKEY_URL}" -o tinkey.zip
echo "${TINKEY_SHA256} tinkey.zip" | sha256sum -c
unzip tinkey.zip && cd "tink-tinkey-1.14.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 |
刪除金鑰集中指定的金鑰。 |
disable-key |
停用金鑰集中指定的金鑰。 |
enable-key |
啟用金鑰組中的指定金鑰。 |
list-keyset |
列出金鑰集中的金鑰。 |
promote-key |
將指定金鑰升級為主要金鑰。 |
rotate-keyset |
[已淘汰] 新增金鑰並設為主要金鑰。(建議先使用 add-key 新增金鑰，再使用 promote-key 明確將其設為主金鑰。在分散式系統中，必須先確認每個伺服器都能使用新加入的金鑰，才能將其升級為主要金鑰。 |