O Tinkey é o utilitário de linha de comando do Tink para gerenciar chaves. O Tinkey permite criptografar ou descriptografar conjuntos de chaves com chaves de criptografia de chaves armazenadas em um KMS remoto. O Tinkey tem suporte integrado para o AWS KMS e o Google Cloud KMS.
Instalação
É possível instalar o Tinkey usando binários pré-criados, o Homebrew ou o código-fonte do Tink:
Binários pré-criados
A versão mais recente do Tinkey é a 1.14.0 (download). Ele funciona no Linux, macOS e Windows.
Homebrew
Para instalar o Tinkey com o Homebrew, execute o seguinte comando:
brew tap tink-crypto/tink-tinkey https://github.com/tink-crypto/tink-tinkey
brew install tinkey
A partir da origem
Para criar a versão mais recente do Tinkey usando o código-fonte do Tink, use o Bazel com o 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
Isso produz o binário bazel-bin/tinkey.
Referência de comandos
O Tinkey pode ser usado para gerar chaves e realizar outras tarefas de gerenciamento, como criptografar, descriptografar ou alternar chaves.
A sintaxe para usar os comandos listados na tabela é tinkey <command>
[<args>].
| Comando | Ação |
|---|---|
help |
Mostra uma mensagem de ajuda para todos os comandos disponíveis. |
add-key |
Gera e adiciona uma nova chave a um conjunto de chaves. |
convert-keyset |
Muda o formato, criptografa e descriptografa um conjunto de chaves. |
create-keyset |
Cria um novo conjunto de chaves. |
create-public-keyset |
Cria um conjunto de chaves públicas com base em um conjunto de chaves privadas. |
list-key-templates |
Lista todos os modelos de chave compatíveis. |
delete-key |
Exclui uma chave especificada em um conjunto de chaves. |
disable-key |
Desativa uma chave especificada em um conjunto de chaves. |
enable-key |
Ativa uma chave especificada em um conjunto de chaves. |
list-keyset |
Lista as chaves em um conjunto de chaves. |
promote-key |
Promove uma chave especificada para primária. |
rotate-keyset |
[Descontinuado] Adiciona uma nova chave e a torna a principal.
Em vez disso, recomendamos primeiro adicionar uma nova chave com add-key e,
depois, torná-la explicitamente a principal com promote-key. Em
sistemas distribuídos, é preciso garantir que a chave recém-adicionada esteja disponível
em todos os servidores antes de promovê-la a principal. |