בדף הזה מפורט מידע על התכונות הקריפטוגרפיות של Android Keystore, כפי שהן מסופקות על ידי ההטמעה הבסיסית של KeyMint (או Keymaster).
פרימיטיבים קריפטוגרפיים
מערכת Keystore מספקת את קטגוריות הפעולות הבאות:
- יצירת מפתחות, שמובילה לחומר של מפתח פרטי או סודי שנגיש רק לסביבה המאובטחת. לקוחות יכולים ליצור מפתחות בדרכים הבאות:
- יצירת מפתח חדש
- ייבוא של חומר מפתחות לא מוצפן
- ייבוא של חומר מפתחות מוצפן
- אימות מפתח: יצירת מפתח אסימטרי יוצרת אישור שמכיל את החלק של המפתח הציבורי בזוג המפתחות. האישור הזה יכול גם להכיל מידע על המטא-נתונים של המפתח ועל מצב המכשיר, וכולם חתומים על ידי מפתח שמקושר בחזרה לשורש מהימן.
- פעולות קריפטוגרפיות:
- הצפנה ופענוח סימטריים (AES, 3DES)
- פענוח אסימטרי (RSA)
- חתימה אסימטרית (ECDSA, RSA)
- חתימה ואימות סימטריים (HMAC)
- הסכם מפתח אסימטרי (ECDH)
רכיבי פרוטוקול, כמו מטרה, מצב וריפוד, וגם אילוצים של בקרת גישה, מצוינים כשמפתחות נוצרים או מיובאים, והם מקושרים למפתח באופן קבוע, כדי להבטיח שלא ניתן יהיה להשתמש במפתח בדרך אחרת.
הפרימיטיבים והמצבים שבהם ההטמעה של KeyMint חייבת לתמוך מתוארים במפרט הממשק של IKeyMintDevice HAL.
ההטמעה הבסיסית של KeyMint חייבת ליצור מספרים אקראיים כדי לתמוך ביצירת מפתחות וביצירת וקטורי אתחול (IV) או ריפוד אקראיים. כדי לתמוך בכך, מערכת Android מספקת מדי פעם אנטרופיה נוספת להטמעה של KeyMint.
בקרת גישה למפתחות
מפתחות מבוססי חומרה שאי אפשר לחלץ מהמכשיר לא מספקים אבטחה רבה אם תוקף יכול להשתמש בהם כרצונו (אם כי הם מאובטחים יותר ממפתחות שאפשר לחלץ). לכן, חשוב מאוד ש-Keystore יאכוף את אמצעי בקרת הגישה.
אמצעי בקרת הגישה מוגדרים כ "רשימת הרשאות" של צמדי תגים וערכים. תגי הרשאה הם מספרים שלמים של 32 ביט, והערכים הם מסוגים שונים. אפשר לחזור על תגים מסוימים כדי לציין כמה ערכים. האפשרות לחזור על תג מצוינת בממשק KeyMint (לשעבר Keymaster) HAL.
ערכי התגים הנתמכים מוגדרים בקובץ Tag.aidl, וכל אחד מהם משויך ל-TagType שמציין את סוג הערך המשויך (לדוגמה, מספר שלם או בייטים), ואם אפשר לחזור עליו כדי לציין כמה ערכים נתמכים.
כש-KeyMint יוצר מפתח, המתקשר מציין רשימת הרשאות למפתח. הרשימה הזו משתנה על ידי Keystore ו-KeyMint כדי להוסיף אילוצים נוספים, וההטמעה הבסיסית של KeyMint מקודדת את רשימת ההרשאות הסופית ל-keyblob שמוחזר. רשימת ההרשאות המקודדת מקושרת באופן קריפטוגרפי ל-keyblob, כך שכל ניסיון לשנות את רשימת ההרשאות (כולל הסדר) גורם ל-keyblob לא חוקי שלא ניתן להשתמש בו לפעולות קריפטוגרפיות.
אכיפה באמצעות חומרה לעומת אכיפה באמצעות תוכנה
לא כל ההטמעות של חומרה מאובטחת מכילות את אותן תכונות. כדי לתמוך במגוון גישות, KeyMint מבחין בין אכיפה מאובטחת ולא מאובטחת של בקרת גישה, או בין אכיפת חומרה ותוכנה, בהתאמה.
המידע הזה נחשף ב-KeyMint API באמצעות השדה securityLevel מסוג KeyCharacteristics. החומרה המאובטחת אחראית להצבת ההרשאות ב-KeyCharacteristics עם רמת האבטחה המתאימה, על סמך מה שהיא יכולה לאכוף. המידע הזה נחשף גם ברשומות האימות של מפתחות אסימטריים: מאפייני מפתח של SecurityLevel::TRUSTED_ENVIRONMENT או SecurityLevel::STRONGBOX מופיעים ברשימה hardwareEnforced, ומאפיינים של SecurityLevel::SOFTWARE או SecurityLevel::KEYSTORE מופיעים ברשימה softwareEnforced.
לדוגמה, בדרך כלל הסביבה המאובטחת לא אוכפת מגבלות על מרווח הזמן והתאריך שבהם אפשר להשתמש במפתח, כי אין לה גישה מהימנה למידע על התאריך והשעה. כתוצאה מכך, הרשאות כמו Tag::ORIGINATION_EXPIRE_DATETIME נאכפות על ידי Keystore ב-Android, ויהיו להן SecurityLevel::KEYSTORE.
במאמר אימות מפתח מוסבר איך בודקים אם המפתחות וההרשאות שלהם מגובים בחומרה.
הרשאות ליצירת הודעות קריפטוגרפיות
התגים הבאים משמשים להגדרת המאפיינים הקריפטוגרפיים של פעולות שמשתמשות במפתח המשויך:
Tag::ALGORITHMTag::KEY_SIZETag::BLOCK_MODETag::PADDINGTag::CALLER_NONCETag::DIGESTTag::MGF_DIGEST
התגים הבאים ניתנים לחזרה, כלומר אפשר לשייך כמה ערכים למפתח אחד:
Tag::BLOCK_MODETag::PADDINGTag::DIGESTTag::MGF_DIGEST
הערך שבו משתמשים מצוין בזמן הפעולה.
מטרה
למפתחות יש קבוצה של מטרות משויכות, שמוצגות כרשומת הרשאה אחת או יותר עם התג Tag::PURPOSE, שמגדיר איך אפשר להשתמש בהם. המטרות מוגדרות ב-KeyPurpose.aidl.
חשוב לזכור ששילובים מסוימים של ערכי מטרה יוצרים בעיות אבטחה. לדוגמה, מפתח RSA שאפשר להשתמש בו גם להצפנה וגם לחתימה מאפשר לתוקף שיכול לשכנע את המערכת לפענח נתונים שרירותיים ליצור חתימות.
ייבוא מפתחות
KeyMint תומך בייבוא של:
- זוגות מפתחות אסימטריים בפורמט PKCS#8 בקידוד DER (ללא הצפנה מבוססת-סיסמה)
- מפתחות סימטריים כבייטים גולמיים
כדי להבטיח שניתן יהיה להבחין בין מפתחות מיובאים לבין מפתחות שנוצרו באופן מאובטח, Tag::ORIGIN נכלל ברשימת הרשאות המפתחות המתאימה. לדוגמה, אם מפתח נוצר בחומרה מאובטחת, Tag::ORIGIN עם הערך KeyOrigin::GENERATED נמצא ברשימה hw_enforced של מאפייני המפתח, ואילו למפתח שיובא לחומרה מאובטחת יש את הערך KeyOrigin::IMPORTED.
אימות משתמשים
הטמעות מאובטחות של KeyMint לא מטמיעות אימות משתמשים, אלא מסתמכות על אפליקציות מהימנות אחרות שעושות זאת. כדי לראות את הממשק שהאפליקציות האלה מטמיעות, עיינו בדף Gatekeeper.
דרישות אימות המשתמשים מצוינות באמצעות שתי קבוצות של תגים. הקבוצה הראשונה מציינת אילו שיטות אימות מאפשרות להשתמש במפתח:
-
Tag::USER_SECURE_IDמכיל ערך מספרי של 64 ביט שמציין את מזהה המשתמש המאובטח שסופק באסימון אימות מאובטח כדי לבטל את הנעילה של המפתח. אם המפתח חוזר על עצמו, אפשר להשתמש בו אם אחד מהערכים מסופק באסימון אימות מאובטח.
הקבוצה השנייה מציינת אם המשתמש צריך לעבור אימות, ומתי.
אם אף אחד מהתגים האלה לא קיים, אבל Tag::USER_SECURE_ID קיים, נדרש אימות בכל שימוש במפתח.
Tag::NO_AUTHENTICATION_REQUIREDמציין שלא נדרש אימות משתמש, אבל הגישה למפתח עדיין מוגבלת לאפליקציה שבבעלותה הוא נמצא (ולכל אפליקציה שהיא מעניקה לה גישה).-
Tag::AUTH_TIMEOUTהוא ערך מספרי שמציין בשניות כמה זמן יכול לעבור מאז אימות המשתמש כדי לאשר את השימוש במפתח. זמני הקצוב לתפוגה לא נמשכים אחרי הפעלה מחדש. אחרי הפעלה מחדש, כל האימותים מבוטלים. אפשר להגדיר ערך גבוה לזמן הקצוב לתפוגה כדי לציין שנדרש אימות פעם אחת בכל הפעלה (2 בחזקת 32 שניות הן בערך 136 שנים, וסביר להניח שמכשירי Android מופעלים מחדש בתדירות גבוהה יותר).
דרישה לפתיחת הנעילה של המכשיר
אפשר להשתמש במפתחות עם Tag::UNLOCKED_DEVICE_REQUIRED רק כשהמכשיר לא נעול. לסמנטיקה המפורטת, ראו
KeyProtection.Builder#setUnlockedDeviceRequired(boolean).
האכיפה של UNLOCKED_DEVICE_REQUIRED מתבצעת על ידי Keystore, ולא על ידי KeyMint. עם זאת, ב-Android מגרסה 12 ואילך, Keystore מגן באופן קריפטוגרפי על מפתחות UNLOCKED_DEVICE_REQUIRED כשהמכשיר נעול, כדי להבטיח שברוב המקרים לא ניתן יהיה להשתמש בהם גם אם Keystore נפרץ כשהמכשיר נעול.
כל הקריפטוגרפיה והיצירה של מספרים אקראיים שמתוארות בקטע הזה משתמשות ב-BoringSSL, חוץ ממקרים שבהם השימוש ב-KeyMint מצוין במפורש. כל הסודות מאופסים ברגע שאין בהם יותר צורך.
מפתחות-על של UnlockedDeviceRequired
כדי להגן על מפתחות UNLOCKED_DEVICE_REQUIRED באמצעות הצפנה, Keystore "מצפין אותם הצפנת-על" לפני שהוא מאחסן אותם במסד הנתונים שלו. כשאפשר, היא מגינה על מפתחות ההצפנה העליונה (מפתחות-על) כשהמכשיר נעול, כך שאפשר לשחזר אותם רק אחרי פתיחה מוצלחת של המכשיר. (המונח "הצפנת-על" משמש כי שכבת ההצפנה הזו מוחלת בנוסף לשכבת ההצפנה ש-KeyMint כבר מחיל על כל המפתחות).
לכל משתמש (כולל פרופילים) יש שני מפתחות-על שמשויכים ל-UNLOCKED_DEVICE_REQUIRED:
- מפתח-העל הסימטרי של UnlockedDeviceRequired. זהו מפתח AES‑256‑GCM. הוא מצפין את המפתחות של
UNLOCKED_DEVICE_REQUIREDשיובאו, נוצרו או היו בשימוש כשהמכשיר לא היה נעול למשתמש. - מפתח-העל האסימטרי של UnlockedDeviceRequired. זהו זוג מפתחות ECDH P‑521. הוא מצפין את המפתחות של
UNLOCKED_DEVICE_REQUIREDשמיובאים או נוצרים כשהמכשיר נעול למשתמש. לפרטים נוספים, קראו את המאמר אחסון מפתחות כשהמכשיר נעול.
יצירה והגנה על מפתחות-על
כשנוצר משתמש, Keystore יוצר את מפתחות העל UnlockedDeviceRequired של המשתמש ומאחסן אותם במסד הנתונים שלו, כשהם מוצפנים (באופן עקיף) על ידי הסיסמה הסינתטית של המשתמש:
- שרת המערכת מפיק את סיסמת Keystore של המשתמש מהסיסמה הסינתטית של המשתמש באמצעות SP800‑108 KDF.
- שרת המערכת מעביר את הסיסמה של המשתמש ל-Keystore.
- מערכת Keystore יוצרת את מפתחות-העל של המשתמש.
- לכל אחד ממפתחות-העל של המשתמש:
- מערכת Keystore יוצרת ערך גיבוב אקראי.
- Keystore מפיק מפתח AES‑256‑GCM מהסיסמה של המשתמש ב-Keystore ומה-salt באמצעות HKDF‑SHA256.
- Keystore מצפין את החלק הסודי של מפתח העל באמצעות מפתח AES‑256‑GCM הזה.
- מפתח העל המוצפן וה-salt שלו מאוחסנים במסד הנתונים של Keystore. אם זה מפתח אסימטרי, גם החצי הציבורי של המפתח מאוחסן ללא הצפנה.
ההליך הזה מאפשר לפענח את מפתחות-העל האלה כשהסיסמה הסינתטית של המשתמש ידועה, למשל כשמזינים את קוד האימות, קו ביטול הנעילה או הסיסמה הנכונים של המשתמש.
בנוסף, Keystore שומר את מפתחות העל האלה במטמון בזיכרון, וכך הוא יכול לפעול על מפתחות UNLOCKED_DEVICE_REQUIRED. עם זאת, המערכת מנסה לשמור במטמון את החלקים הסודיים של המפתחות האלה רק כשהמכשיר לא נעול למשתמש. כשהמכשיר נעול למשתמש, Keystore מאפס את העותק השמור של החלקים הסודיים של מפתחות-העל האלה, אם אפשר. באופן ספציפי, כשהמכשיר נעול למשתמש, Keystore בוחר ומחיל אחת משלוש רמות הגנה על מפתחות-העל של UnlockedDeviceRequired של המשתמש:
- אם המשתמש הפעיל רק קוד אימות, קו פתיחת נעילה או סיסמה, Keystore מאפס את החלקים הסודיים של מפתחות-העל ששמורים במטמון. כך אפשר לשחזר את מפתחות-העל רק באמצעות העותק המוצפן במסד הנתונים, שאותו אפשר לפענח רק באמצעות קוד אימות, קו פתיחת נעילה או סיסמה מקבילה.
- אם המשתמש הפעיל רק מידע ביומטרי מסוג 3 ("חזק") וקוד אימות, קו פתיחת נעילה או סיסמה, Keystore מאפשר לשחזר את מפתחות-העל באמצעות כל אחד מהנתונים הביומטריים מסוג 3 שהמשתמש רשם (בדרך כלל טביעת אצבע), כחלופה לקוד אימות, קו פתיחת נעילה או סיסמה. כדי לעשות את זה, המערכת יוצרת מפתח AES‑256‑GCM חדש, מצפינה באמצעותו את החלקים הסודיים של מפתחות-העל, מייבאת את מפתח AES‑256‑GCM ל-KeyMint כמפתח שקשור לנתונים ביומטריים ודורש אימות ביומטרי שהצליח ב-15 השניות האחרונות, ומאפסת את העותקים של כל המפתחות האלה בטקסט ללא הצפנה.
- אם למשתמש יש נתונים ביומטריים מסוג 1 ("נוחות"), נתונים ביומטריים מסוג 2 ("חלש") או סוכן אמון פעיל לפתיחת נעילה, אז Keystore שומר את מפתחות העל במטמון כטקסט פשוט. במקרה כזה, לא מסופקת אבטחה קריפטוגרפית למפתחות
UNLOCKED_DEVICE_REQUIRED. המשתמשים יכולים להימנע מהאפשרות הפחות מאובטחת הזו אם הם לא יפעילו את שיטות פתיחת הנעילה האלה. השיטות הנפוצות ביותר לביטול הנעילה ששייכות לקטגוריות האלה הן פתיחה בזיהוי פנים במכשירים רבים, וביטול הנעילה באמצעות שעון חכם מותאם.
כשהמכשיר נפתח על ידי המשתמש, Keystore משחזר את מפתחות-העל של UnlockedDeviceRequired של המשתמש, אם אפשר. בפתיחת נעילה באמצעות קוד אימות, קו פתיחת נעילה או סיסמה, המערכת מפענחת את העותק של המפתחות האלה ששמור במסד הנתונים. אחרת, המערכת בודקת אם היא שמרה עותק של המפתחות האלה שמוצפנים באמצעות מפתח שקשור לנתונים ביומטריים, ואם כן, היא מנסה לפענח אותו. הפעולה הזו תצליח רק אם המשתמש אומת בהצלחה באמצעות נתונים ביומטריים מסוג Class 3 ב-15 השניות האחרונות, באכיפת KeyMint (ולא Keystore).
אחסון מפתחות כשהמכשיר נעול
Keystore מאפשר למשתמשים לייבא וליצור מפתחות UNLOCKED_DEVICE_REQUIRED כשהמכשיר נעול. הוא משתמש בסכימת הצפנה היברידית כדי להבטיח שאפשר יהיה לפענח אותם רק כשהמכשיר לא נעול:
- הצפנה (ייבוא או יצירה של מפתח
UNLOCKED_DEVICE_REQUIREDכשהמכשיר נעול):- מערכת Keystore יוצרת זוג מפתחות ECDH P‑521 זמני חדש.
- Keystore יוצר סוד משותף על ידי ביצוע הסכם מפתח ECDH בין המפתח הפרטי של זוג המפתחות הזמני הזה לבין החצי הציבורי של מפתח העל האסימטרי UnlockedDeviceRequired.
- מערכת Keystore יוצרת ערך גיבוב אקראי.
- Keystore מפיק מפתח AES‑256‑GCM מהסוד המשותף ומה-salt באמצעות HKDF‑SHA256.
- Keystore מצפין את המפתח של
UNLOCKED_DEVICE_REQUIREDבאמצעות מפתח AES‑256‑GCM הזה. - Keystore מאחסן במסד הנתונים שלו את המפתח המוצפן של
UNLOCKED_DEVICE_REQUIRED, את ה-salt ואת החצי הציבורי של זוג המפתחות הזמניים.
- פענוח (באמצעות המפתח שנוצר ב-
UNLOCKED_DEVICE_REQUIREDכשהמכשיר לא נעול):- מערכת Keystore טוענת ממסד הנתונים שלה את מפתח
UNLOCKED_DEVICE_REQUIREDהמוצפן, את ה-salt ואת החצי הציבורי של זוג המפתחות הזמניים. - מערכת Keystore יוצרת סוד משותף באמצעות הסכם מפתחות ECDH בין החצי הציבורי של זוג המפתחות הזמניים לבין החצי הפרטי של מפתח העל האסימטרי UnlockedDeviceRequired. המפתח הפרטי זמין כי המכשיר לא נעול.
- Keystore מפיק מפתח AES‑256‑GCM מהסוד המשותף ומה-salt באמצעות HKDF‑SHA256. מפתח ה-AES‑256‑GCM הזה זהה למפתח שהופק במהלך ההצפנה.
- Keystore מפענח את המפתח של
UNLOCKED_DEVICE_REQUIREDבאמצעות מפתח AES‑256‑GCM. - Keystore מצפין מחדש את המפתח
UNLOCKED_DEVICE_REQUIREDבאמצעות מפתח-העל הסימטרי של UnlockedDeviceRequired. הפעולה הזו לא משפיעה על מאפייני האבטחה של המפתח, אבל היא מאפשרת גישה מהירה יותר אליו בהמשך.
- מערכת Keystore טוענת ממסד הנתונים שלה את מפתח
התכונה הזו מאפשרת לאפליקציות לאחסן נתונים כשהמכשיר נעול, כך שאפשר לפענח אותם רק כשהמכשיר לא נעול. כדי לעשות את זה, צריך לפעול לפי השלבים הבאים:
- יוצרים מפתח AES‑256‑GCM מחוץ ל-Keystore.
- הצפנת נתונים באמצעות המפתח AES‑256‑GCM.
- מייבאים את מפתח AES‑256‑GCM ל-Keystore עם הגדרת ההגנה על המפתח
setUnlockedDeviceRequired(true). - מאפסים את העותק המקורי של המפתח.
כדי לפענח את הנתונים כשהמכשיר לא נעול, צריך להשתמש במפתח שיובא ל-Keystore.
קישור לקוח
קישור לקוח, שיוך של מפתח לאפליקציית לקוח מסוימת, מתבצע באמצעות מזהה לקוח אופציונלי ונתוני לקוח אופציונליים (Tag::APPLICATION_ID ו-Tag::APPLICATION_DATA, בהתאמה). מערכת Keystore מתייחסת לערכים האלה כאל אובייקטים בינאריים גדולים (BLOB) אטומים, ורק מוודאת שאותם אובייקטים בינאריים גדולים שהוצגו במהלך יצירת המפתח או הייבוא שלו מוצגים בכל שימוש, ושהם זהים בבייטים שלהם. נתוני הקישור של הלקוח לא מוחזרים על ידי KeyMint. המתקשר צריך לדעת את הסיסמה כדי להשתמש במפתח.
התכונה הזו לא חשופה לאפליקציות.
תפוגת תוקף
ב-Keystore אפשר להגביל את השימוש במפתחות לפי תאריך. אפשר לשייך למפתח את תאריך תחילת התוקף ותאריך סיום התוקף שלו, ו-Keystore מסרב לבצע פעולות במפתח אם התאריך או השעה הנוכחיים הם מחוץ לטווח התוקף. טווח התוקף של המפתח מצוין בתגים Tag::ACTIVE_DATETIME, Tag::ORIGINATION_EXPIRE_DATETIME ו-Tag::USAGE_EXPIRE_DATETIME. ההבחנה בין "יצירה" ל"שימוש" מבוססת על השאלה אם המפתח משמש ל"יצירה" של מידע מוצפן (ciphertext), חתימה וכו' חדשים, או ל"שימוש" במידע מוצפן, חתימה וכו' קיימים. שימו לב שההבחנה הזו לא מוצגת לאפליקציות.
התגים Tag::ACTIVE_DATETIME, Tag::ORIGINATION_EXPIRE_DATETIME ו-Tag::USAGE_EXPIRE_DATETIME הם אופציונליים. אם התגים לא קיימים, ההנחה היא שתמיד אפשר להשתמש במפתח הרלוונטי כדי לפענח או לאמת הודעות.
מכיוון שהזמן בשעון הקיר מסופק על ידי העולם הלא מאובטח, התגים שקשורים לתפוגה נמצאים ברשימה שנאכפת על ידי התוכנה.
קישור לשורש האמון (Root of trust)
ב-Keystore, המפתחות צריכים להיות מקושרים ל-Root of Trust, שהוא מחרוזת ביטים שמועברת לחומרה המאובטחת של KeyMint במהלך ההפעלה, רצוי על ידי מנהל האתחול. מחרוזת הביטים הזו קשורה באופן קריפטוגרפי לכל מפתח שמנוהל על ידי KeyMint.
שורש האמון מורכב מהגיבוב של המפתח הציבורי שמשמש לאימות החתימה בקובץ האימג' לאתחול וממצב הנעילה של המכשיר. אם המפתח הציבורי משתנה כדי לאפשר שימוש בתמונת מערכת אחרת, או אם מצב הנעילה משתנה, לא ניתן להשתמש באף אחד מהמפתחות שמוגנים על ידי KeyMint שנוצרו על ידי המערכת הקודמת, אלא אם משחזרים את שורש האמון הקודם ומפעילים מערכת שחתומה על ידי המפתח הזה. המטרה היא להגדיל את הערך של בקרות הגישה למפתחות שנאכפות על ידי תוכנה, כך שמערכת הפעלה שהותקנה על ידי תוקף לא תוכל להשתמש במפתחות KeyMint.
הגדרה מחדש של מחולל המספרים האקראיים
מכיוון שחומרה מאובטחת יוצרת מספרים אקראיים לחומר מפתחות ולווקטורי אתחול (IV), ומכיוון שלא תמיד אפשר לסמוך באופן מלא על מחוללי מספרים אקראיים בחומרה, KeyMint HAL מספק ממשק שמאפשר ל-Keystore לספק אנטרופיה נוספת, שמעורבבת במספרים האקראיים שנוצרו.
שימוש במחולל מספרים אקראיים בחומרה כמקור ה-seed הראשי. נתוני המקור שסופקו דרך ה-API החיצוני לא יכולים להיות המקור היחיד לאקראיות שמשמשת ליצירת מספרים. בנוסף, פעולת הערבוב שבה משתמשים צריכה להבטיח שהפלט האקראי לא יהיה צפוי אם אחד ממקורות ה-seed לא צפוי.