Tinkey ist das Befehlszeilenprogramm von Tink zum Verwalten von Schlüsseln. Mit Tinkey können Sie Schlüsselsätze mit Schlüsselverschlüsselungsschlüsseln verschlüsseln oder entschlüsseln, die in einem Remote-KMS gespeichert sind. Tinkey bietet integrierte Unterstützung für AWS KMS und Google Cloud KMS.
Installation
Sie können Tinkey aus vordefinierten Binärdateien installieren, Homebrew verwenden oder Tinkey aus der Tink-Quelle erstellen:
Vordefinierte Binärdateien
Die neueste Version von Tinkey ist 1.14.0 (Download). Es 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 Quellcode von Tink erstellen möchten, verwenden Sie Bazel mit 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
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 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. |
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 |
[Eingestellt] Fügt einen neuen Schlüssel hinzu und legt ihn als primären Schlüssel fest.
(Stattdessen empfehlen wir, zuerst einen neuen Schlüssel mit add-key hinzuzufügen und ihn später explizit mit promote-key zum primären Schlüssel zu machen. In verteilten Systemen muss sichergestellt werden, dass der neu hinzugefügte Schlüssel auf jedem Server verfügbar ist, bevor er zum primären Schlüssel heraufgestuft wird.) |