ניפוי באגים ותיקון שגיאות רישום

לפעמים הפונקציה Tink יוצרת הודעות שגיאה כמו

  • No wrapper registered for type
  • No manager for type T has been registered
  • Unable to get primitive interface P for key of type T

הדף הזה עוזר לנפות באגים בבעיות כאלה.

מקרה 1: השגיאה מסומנת בכוכב עם הכיתוב 'לא נמצא wrapper' או תוכן דומה.

מתבצעת קריאה ל-GetPrimitive() כדי לקבל סוג פרימיטיבי שלא נרשם. בדרך כלל, מתקנים את הבעיה על ידי קריאה ל-TinkConfig.register() במקום כלשהו מוקדם יותר בקובץ הבינארי. מספיק להירשם פעם אחת, ואפשר לעשות זאת בהתחלה.

חלק מהפרימיטיבים זקוקים לרישום מיוחד יותר.

  • נדרש KeyDerivationConfig.register() לשימוש ב-KeysetDeriver
  • נדרש JwtMacConfig.register() לשימוש ב-JwtMac
  • ל-JwtPublicKeySign ול-JwtPublicKeyVerify נדרש JwtSignatureConfig.register()

מקרה 2: השגיאה מציינת סוג מפתח ופרימיטיבי.

לדוגמה, ייתכן שהודעת השגיאה Unable to get primitive interface P for key of type T עבור ערך ספציפי מסוים של P ו-T.

במקרה הזה, Tink לא יכולה ליצור את הפרמיטיב הספציפי שביקשתם לערכת המפתחות שיש לכם. בדרך כלל הסיבה לכך היא שיש לכם קבוצת מפתחות מסוג שגוי. לדוגמה, יכול להיות שביקשתם Mac, אבל ערכת המפתחות היא ל-Aead.

אחד מהמקרים הנפוצים הוא ניסיון להשיג מפתח ציבורי פרימיטיבי ממערך מפתחות שמכיל מפתחות פרטיים. כדי לבדוק אם זו הבעיה, כדאי במקום זאת לקרוא ל-GetPrimitive() מתוך התוצאה של GetPublicKeysetHandle().

אם זה לא פותר את הבעיה, תוכלו למצוא רשימה עדכנית של סוגי המפתחות כאן, בבדיקות של כל השפות. צריך לבדוק אם ה-P הפרמיטיבי מופיע יחד עם סוג המפתח T.

אם המפתח הראשוני מופיע עם סוג המפתח המתאים, יכול להיות שיישום Tink של השפה שלכם לא תומך בסוג המפתח T. ברשימת סוגי המפתחות אפשר לבדוק אם Tink תומך בסוג המפתח בשפה שלכם.