Tinkey to narzędzie wiersza poleceń Tink do zarządzania kluczami. Tinkey umożliwia szyfrowanie i odszyfrowywanie zbiorów kluczy za pomocą kluczy szyfrujących klucze przechowywanych w zdalnej usłudze KMS. Tinkey ma wbudowaną obsługę AWS KMS i Google Cloud KMS.
Instalacja
Możesz zainstalować Tinkey z gotowych plików binarnych, użyć Homebrew lub skompilować Tinkey ze źródła Tink:
Gotowe pliki binarne
Najnowsza wersja Tinkey to 1.14.0 (pobierz). Działa na systemach Linux, macOS i Windows.
Homebrew
Aby zainstalować Tinkey za pomocą Homebrew, uruchom to polecenie:
brew tap tink-crypto/tink-tinkey https://github.com/tink-crypto/tink-tinkey
brew install tinkey
Ze źródła
Aby utworzyć najnowszą wersję Tinkey z kodu źródłowego Tink, użyj Bazel z 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
Spowoduje to utworzenie pliku binarnego bazel-bin/tinkey.
Dokumentacja poleceń
Tinkey może służyć do generowania kluczy i wykonywania innych zadań związanych z zarządzaniem, takich jak szyfrowanie, odszyfrowywanie czy rotacja kluczy.
Składnia poleceń wymienionych w tabeli to tinkey <command>
[<args>].
| Polecenie | Działanie |
|---|---|
help |
Wyświetla komunikat pomocy dotyczący wszystkich dostępnych poleceń. |
add-key |
Generuje i dodaje nowy klucz do zestawu kluczy. |
convert-keyset |
Zmienia format, szyfruje i odszyfrowuje zbiór kluczy. |
create-keyset |
Tworzy nowy zestaw kluczy. |
create-public-keyset |
Tworzy publiczny zestaw kluczy z prywatnego zestawu kluczy. |
list-key-templates |
Wyświetla listę wszystkich obsługiwanych szablonów kluczy. |
delete-key |
Usuwa określony klucz ze zbioru kluczy. |
disable-key |
Wyłącza określony klucz w zbiorze kluczy. |
enable-key |
Włącza określony klucz w zestawie kluczy. |
list-keyset |
Wyświetla listę kluczy w zbiorze kluczy. |
promote-key |
Awansuje określony klucz na klucz podstawowy. |
rotate-keyset |
[Wycofane] Dodaje nowy klucz i ustawia go jako podstawowy.
(Zamiast tego zalecamy najpierw dodać nowy klucz za pomocą add-key, a później wyraźnie ustawić go jako podstawowy za pomocą promote-key. W systemach rozproszonych przed ustawieniem nowo dodanego klucza jako podstawowego należy upewnić się, że jest on dostępny na każdym serwerze). |