טינקי

‫Tinkey הוא כלי שורת הפקודה של Tink לניהול מפתחות. באמצעות Tinkey אפשר להצפין או לפענח קבוצות מפתחות באמצעות מפתחות הצפנה שמאוחסנים ב-KMS מרוחק. ל-Tinkey יש תמיכה מובנית ב-AWS KMS וב-Google Cloud KMS.

הערה: כדי להפעיל את Tinkey נדרשת גרסה 11 ומעלה של Java.

התקנה

אפשר להתקין את Tinkey מקובצי בינארי מוכנים מראש, להשתמש ב-Homebrew או ליצור את Tinkey מקוד המקור של Tink:

קובצי בינארי מוכנים מראש

הגרסה האחרונה של Tinkey היא 1.14.0 (להורדה). הוא פועל ב-Linux, ב-macOS וב-Windows.

Homebrew

כדי להתקין את Tinkey באמצעות Homebrew, מריצים את הפקודה הבאה:

brew tap tink-crypto/tink-tinkey https://github.com/tink-crypto/tink-tinkey
brew install tinkey

מהמקור

כדי ליצור את הגרסה העדכנית של Tinkey מקוד המקור של Tink, משתמשים ב-Bazel עם 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

כך נוצר הקובץ הבינארי bazel-bin/tinkey.

הפניה לפקודה

אפשר להשתמש ב-Tinkey כדי ליצור מפתחות ולבצע משימות ניהול אחרות, כמו הצפנה, פענוח או החלפה של מפתחות.

התחביר לשימוש בפקודות שמפורטות בטבלה הוא tinkey <command> [<args>].

הערה: כדי לקבל מידע על הארגומנטים הזמינים או הנדרשים לפקודה, מריצים את tinkey <command> בלי ארגומנטים נוספים.

פקודה	פעולה
help	מדפיסה הודעת עזרה לכל הפקודות הזמינות.
add-key	יוצרת מפתח חדש ומוסיפה אותו לקבוצת מפתחות.
convert-keyset	שינוי הפורמט, הצפנה ופענוח של קבוצת מפתחות.
create-keyset	יוצרת קבוצת מפתחות חדשה.
create-public-keyset	יצירת קבוצת מפתחות ציבוריים מקבוצת מפתחות פרטיים.
list-key-templates	מציגה את כל תבניות המפתחות הנתמכות.
delete-key	מחיקת מפתח מסוים בקבוצת מפתחות.
disable-key	השבתת מפתח מסוים בקבוצת מפתחות.
enable-key	הפעלת מפתח מסוים בקבוצת מפתחות.
list-keyset	הצגת רשימה של מפתחות בקבוצת מפתחות.
promote-key	הופכת מפתח מסוים למפתח ראשי.
rotate-keyset	[הוצא משימוש] הוספת מפתח חדש והגדרתו כמפתח הראשי. (במקום זאת, מומלץ קודם להוסיף מפתח חדש באמצעות add-key ואחר כך להגדיר אותו במפורש כמפתח הראשי באמצעות promote-key. במערכות מבוזרות, צריך לוודא שהמפתח החדש שנוסף זמין בכל שרת לפני שמקדמים אותו למפתח ראשי).