Credential Manager Holder API מאפשר לאפליקציית הניהול (שנקראת גם "ארנק") ב-Android לנהל ולהציג מסמכים דיגיטליים לאימות לגורמים מאמתים.
פורמטים של פרטי כניסה
אפשר לאחסן את פרטי הכניסה באפליקציות לאחסון פרטי כניסה בפורמטים שונים. הפורמטים האלה הם מפרטים שמגדירים איך לייצג את פרטי הכניסה, וכל אחד מהם מכיל את המידע הבא על פרטי הכניסה:
- סוג: הקטגוריה, כמו תואר אוניברסיטאי או רישיון נהיגה.
- מאפיינים: מאפיינים כמו שם פרטי ושם משפחה.
קידוד: האופן שבו פרטי הכניסה בנויים, למשל SD-JWT או mdoc
תוקף: שיטה לאימות קריפטוגרפי של האותנטיות של פרטי הכניסה.
כל פורמט של פרטי כניסה מבצע את הקידוד והאימות באופן שונה, אבל מבחינה פונקציונלית הם זהים.
המרשם תומך בשני פורמטים:
- SD-JWT: תואם למפרט של IETF לאישורים שניתנים לאימות ומבוססים על SD-JWT (SD-JWT VC).
- מסמכים לנייד או mdocs: תואמים למפרט ISO/IEC 18013-5:2021.
גורם מאמת יכול לשלוח בקשת OpenID4VP ל-SD-JWT ול-mdocs כשמשתמשים ב-Credential Manager. האפשרויות משתנות בהתאם לתרחיש לדוגמה ולתחום שנבחר.
רישום מטא-נתונים של פרטי כניסה
ב-Credential Manager לא מאוחסנים פרטי הכניסה של המחזיק באופן ישיר, אלא המטא-נתונים של פרטי הכניסה. אפליקציית הארנק צריכה קודם לרשום את המטא-נתונים של פרטי הכניסה ב-Credential Manager באמצעות RegistryManager. תהליך הרישום הזה יוצר רשומת רישום שמשרתת שתי מטרות עיקריות:
- התאמה: המטא-נתונים של פרטי הכניסה הרשומים משמשים להתאמה לבקשות אימות עתידיות.
- תצוגה: רכיבים מותאמים אישית של ממשק המשתמש מוצגים למשתמש בממשק לבחירת פרטי הכניסה.
כדי לרשום את פרטי הכניסה הדיגיטליים, צריך להשתמש במחלקה OpenId4VpRegistry, כי היא תומכת גם בפורמטים של פרטי כניסה מסוג mdoc וגם בפורמטים של פרטי כניסה מסוג SD-JWT. גורמי האימות ישלחו בקשות OpenID4VP כדי לבקש את פרטי הכניסה האלה.
שיטות להנפקת פרטי כניסה
יש שתי דרכים להנפיק פרטי כניסה:
- תהליך שמופעל על ידי המנפיק: המשתמש מפעיל בקשה להנפקת VDC מאפליקציה או מאתר של מנפיק. לדוגמה, אתר מסוים יכול להציע למשתמשים את האפשרות "הוספת הדרכון לארנק". מנפיק האישורים קורא ל-API להנפקת אישורים של Credential Manager כדי לשלוח בקשה להצעת אישור OpenID4VCI. כדי לטפל בבקשות כאלה, בעל המסמך צריך קודם לשלב את Credential Manager כדי לרשום את המטא-נתונים שלו. ב-Credential Manager יוצגו אפשרויות רלוונטיות לבחירת המשתמש. אחרי שהמשתמש בוחר אפשרות של מחזיק, אפליקציית המחזיק תופעל ותוכל להמשיך בשלבים הנדרשים להשלמת ההנפקה.
- תהליך שמתחיל באפליקציה של בעל הכרטיס: המשתמש מבקש להוסיף VDC מהאפליקציה של בעל הכרטיס. לדוגמה, יכול להיות שיופיע כפתור "הוספת הדרכון". במקרה כזה, בעל התעודה מנהל את רשימת המנפיקים הנתמכים ואת המטא-נתונים. כדי להשלים את הפונקציה הזו, לא צריך לשלב את האפליקציה עם Credential Manager ב-Android.