Tinkey ist das Befehlszeilentool von Tink zum Verwalten von Schlüsseln. Mit Tinkey können Sie Keysets mit Schlüsselverschlüsselungsschlüsseln, die in einem Remote-KMS gespeichert sind, verschlüsseln oder entschlüsseln. Tinkey bietet integrierte Unterstützung für AWS KMS und Google Cloud KMS. Um Unterstützung für andere KMS hinzuzufügen, muss Tinkey nicht geändert werden.
Installation
Sie können Tinkey aus vorgefertigten Binärdateien installieren, Homebrew verwenden oder Tinkey aus der Tink-Quelle erstellen:
Vordefinierte Binärdateien
Die aktuelle Version von Tinkey ist 1.12.0 (herunterladen). Sie funktioniert unter Linux, macOS und Windows.
Homebrew
Führen Sie den folgenden Befehl aus, um Tinkey mit Homebrew zu installieren:
brew tap tink-crypto/tink-tinkey https://github.com/tink-crypto/tink-tinkey
brew install tinkey
Über die Quelle.
Wenn Sie die aktuelle Version von Tinkey aus dem Tink-Quellcode erstellen möchten, verwenden Sie Bazel mit 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
Dadurch wird die Binärdatei bazel-bin/tinkey erstellt.
Befehlsreferenz
Mit Tinkey können Schlüssel generiert und andere Verwaltungsaufgaben wie das Verschlüsseln, Entschlüsseln oder Rotieren von Schlüsseln ausgeführt werden.
Die Syntax für die Verwendung der in der Tabelle aufgeführten Befehle lautet tinkey <command>
[<args>].
| Befehl | Aktion |
|---|---|
help |
Gibt eine Hilfemeldung für alle verfügbaren Befehle aus. |
add-key |
Generiert einen neuen Schlüssel und fügt ihn einem Keyset hinzu. |
convert-keyset |
Ändert das Format, verschlüsselt und entschlüsselt einen Schlüsselsatz. |
create-keyset |
Erstellt einen neuen Schlüsselsatz. |
create-public-keyset |
Erstellt einen öffentlichen Schlüsselsatz aus einem privaten Schlüsselsatz. |
list-key-templates |
Listet alle unterstützten Schlüsselvorlagen auf. |
delete-key |
Löscht einen angegebenen Schlüssel in einem Schlüsselsatz. |
destroy-key |
Veraltet. Löscht das Schlüsselmaterial eines angegebenen Schlüssels in einem Keyset. (Diese Funktion ist veraltet: Das Verhalten von Tink bei Schlüsselsätzen mit gelöschten Schlüsseln kann von der Tink-Version abhängen.) |
disable-key |
Deaktiviert einen angegebenen Schlüssel in einem Schlüsselsatz. |
enable-key |
Aktiviert einen angegebenen Schlüssel in einem Schlüsselsatz. |
list-keyset |
Listet Schlüssel in einem Schlüsselsatz auf. |
promote-key |
Stuft einen angegebenen Schlüssel zum primären Schlüssel hoch. |
rotate-keyset |
[Veraltet] Fügt einen neuen Schlüssel hinzu und macht ihn zum primären Schlüssel.
Stattdessen empfehlen wir, zuerst einen neuen Schlüssel mit add-key hinzuzufügen und ihn später explizit mit promote-key als primären Schlüssel festzulegen. In verteilten Systemen muss der neu hinzugefügte Schlüssel auf jedem Server verfügbar sein, bevor er zum primären Schlüssel hochgestuft wird.) |