Tinkey est l'utilitaire de ligne de commande de Tink permettant de gérer les clés. Tinkey vous permet de chiffrer ou de déchiffrer des ensembles de clés avec des clés de chiffrement de clés stockées dans un KMS distant. Tinkey est compatible de manière intégrée avec AWS KMS et Google Cloud KMS.
Installation
Vous pouvez installer Tinkey à partir de binaires prédéfinis, utiliser Homebrew ou compiler Tinkey à partir de la source Tink :
Binaires prédéfinis
La dernière version de Tinkey est la 1.14.0 (télécharger). Il fonctionne sous Linux, macOS et Windows.
Homebrew
Pour installer Tinkey avec Homebrew, exécutez la commande suivante :
brew tap tink-crypto/tink-tinkey https://github.com/tink-crypto/tink-tinkey
brew install tinkey
À partir d'une source
Pour compiler la dernière version de Tinkey à partir du code source de Tink, utilisez Bazel avec 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
Cela génère le binaire bazel-bin/tinkey.
Documentation de référence sur les commandes
Tinkey peut être utilisé pour générer des clés et effectuer d'autres tâches de gestion, telles que le chiffrement, le déchiffrement ou la rotation des clés.
La syntaxe permettant d'utiliser les commandes listées dans le tableau est tinkey <command>
[<args>].
| Commande | Action |
|---|---|
help |
Affiche un message d'aide pour toutes les commandes disponibles. |
add-key |
Génère et ajoute une clé à un ensemble de clés. |
convert-keyset |
Modifie le format, chiffre et déchiffre un jeu de clés. |
create-keyset |
Crée une collection de clés. |
create-public-keyset |
Crée un ensemble de clés publiques à partir d'un ensemble de clés privées. |
list-key-templates |
Répertorie tous les modèles de clés compatibles. |
delete-key |
Supprime une clé spécifiée dans un jeu de clés. |
disable-key |
Désactive une clé spécifiée dans un jeu de clés. |
enable-key |
Active une clé spécifiée dans un jeu de clés. |
list-keyset |
Répertorie les clés d'un jeu de clés. |
promote-key |
Définit une clé spécifiée comme clé primaire. |
rotate-keyset |
[Obsolète] Ajoute une clé et la définit comme clé principale.
(Nous vous recommandons plutôt d'ajouter d'abord une nouvelle clé avec add-key, puis de la définir explicitement comme clé principale avec promote-key. Dans les systèmes distribués, vous devez vous assurer que la clé nouvellement ajoutée est disponible sur chaque serveur avant de la définir comme clé principale.) |