Dinde

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é stockées dans un KMS distant. Tinkey est compatible avec AWS KMS et Google Cloud KMS. L'ajout de la compatibilité avec d'autres KMS ne nécessite pas de modifier Tinkey.

Installation

Vous pouvez installer Tinkey à partir de binaires précompilés, utiliser Homebrew ou compiler Tinkey à partir de la source Tink :

Binaires prédéfinis

La dernière version de Tinkey est la version 1.12.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/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

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, comme 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 une collection de clés.
create-keyset Crée une collection de clés.
create-public-keyset Crée une collection de clés publiques à partir d'une collection 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 une collection de clés.
destroy-key Obsolète. Détruit le matériel de clé d'une clé spécifiée dans une collection de clés. (Cette méthode est obsolète : le comportement de Tink avec les ensembles de clés contenant des clés détruites peut dépendre de la version de Tink.)
disable-key Désactive une clé spécifiée dans un ensemble de clés.
enable-key Active une clé spécifiée dans une collection de clés.
list-keyset Liste les clés d'une collection de clés.
promote-key Promouvoir une clé spécifiée en tant que 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 clé avec add-key, puis de la définir explicitement comme clé primaire avec promote-key. Dans les systèmes distribués, il faut s'assurer que la clé nouvellement ajoutée est disponible sur chaque serveur avant de la promouvoir en clé primaire.)