שלב 2: יוצרים מזהה לבדיקה בארגז החול (Sandbox)

תעודה מזהה לבדיקה מאפשרת לכם להריץ את תהליך ההצגה המלא ולוודא שהשירות שלכם מקבל ומאמת את התגובה של Google Wallet, בלי צורך בתעודה מזהה רשמית אמיתית. כדי ליצור את התעודה המזהה לבדיקה, סורקים דרכון אלקטרוני מדומה ל-Google Wallet במכשיר בסביבת ה-Sandbox.

התחלה

בחרו את הנתיב שלכם RP,‏ VR או פנים אל פנים

1
הגדרת ארגז החול הוספת החשבון לרשימת ההיתרים והחלפת המכשיר
2כאן
יצירת מסמך זיהוי לבדיקה הוספת מסמך זיהוי לבדיקה ל-Wallet
3
שילוב בונים את המסלול:
הגורם המסתמך← רשם האימות←
4
בדיקת השילוב מריצים את רשימת המשימות מקצה לקצה ומתעדים את התהליך בסרטון
5
התחלת סטרימינג בשידור חי התחלת השידור בדרך שמתאימה לכם:
הגורם המסתמך← רשם האימות←

השלבים בדף הזה

א' מגדירים שני מכשיריםטלפון סימולטור + טלפון עם Wallet בארגז חול ב' מוסיפים מסמך זיהוי לבדיקה ל-Walletסורקים את ה-MRZ ומצמידים את המכשיר באמצעות NFC ג' בודקים את מסמך הזיהוי ב-Walletבודקים את פרטי הכרטיס ב-Google Wallet ד' משתמשים במסמך הזיהוי לבדיקהמבקשים את סוג המסמך של מסמך הזיהוי ובודקים את התהליך

שלב א': מגדירים את שני מכשירי Android

אתם צריכים שני מכשירי Android: המכשיר הראשון מדמה דרכון ביומטרי, ובמכשיר השני אתם מוסיפים את מסמכי הזיהוי שנגזרו מהדרכון הביומטרי המדומה.

תהליך בן שלושה שלבים באמצעות שני טלפונים עם Android ו-NFC להוספת מסמכי זיהוי לבדיקה של Utopia ל-Google Wallet

דרישה מכשיר 1: סימולטור של דרכון מכשיר 2: Google Wallet לבדיקה
תפקיד הדמיה של דרכון ביומטרי עם NFC שמירת מסמכי הזיהוי לבדיקה ב-Google Wallet
שלבי ההגדרה
  1. מתקינים את האפליקציה Utopia ePassport Simulator.
  2. פותחים את האפליקציה ומוסיפים רשומת דרכון חדשה. תסרקו את הרשומה הזו בשלב ב'.
  1. מתקינים או מעדכנים את אפליקציית Google Wallet מחנות Play.
  2. מוודאים שגרסת Google Play Services היא 24.38.xx ומעלה (איך בודקים).
  3. מוודאים שהמכשיר לא משמש לניפוי באגים או מכשיר עם הרשאות בסיס.
  4. מעבירים את Google Wallet לסביבת ארגז החול (אם עושים את זה במכשיר אישי, נתוני הייצור הקיימים נמחקים).
  5. נכנסים לחשבון Google עם סיומת ‎@gmail.com.

שלב ב': הוספת מזהה הבדיקה ל-Wallet

  1. במכשיר 2, פותחים את אפליקציית Google Wallet ולוחצים על הוספה ל-Wallet.
  2. לוחצים על תעודה מזהה > מסמכי זיהוי.
  3. פועלים לפי ההוראות במסך עד לסיום התהליך:
    1. סריקת MRZ: במכשיר 1, לוחצים על הרשומה שיצרתם קודם באפליקציית הסימולטור, ומזינים ידנית את פרטי הדרכון במכשיר 2.
    2. סריקת NFC: מצמידים את מכשיר 1 (כשדף ה-MRZ של אפליקציית הסימולטור פתוח) לחלק האחורי של מכשיר 2 במהלך סריקת ה-NFC.

שלב ג': הצגת הפרטים ב-Wallet

  1. אחרי שמוסיפים את מסמכי הזיהוי ל-Google Wallet, לוחצים על סמל האפשרויות הנוספות (3 נקודות) בפינה השמאלית העליונה ובוחרים באפשרות פרטי מסמכי הזיהוי.
  2. לוחצים על האפשרויות שמופיעות ברשימה ומוודאים שהן פועלות כצפוי. חשוב במיוחד לפתוח את הקטע של פרטי הכרטיס כדי לוודא שהמאפיינים תואמים לרשומה שיצרתם.

שלב ד': משתמשים במזהה הבדיקה בבקשות

התעודה המזהה לבדיקה בארגז החול היא מסמכי זיהוי. כדי ש-Google Wallet יתאים ויציג את המסמך, ה-OpenID4VP dcql_query צריך לבקש סוג מסמך של מסמכי זיהוי:

  • com.google.wallet.idcard.1 (מסמכי זיהוי), או
  • org.iso.23220.photoid.1 (מסמכי זיהוי עם תמונה מסוג ISO)

בקשה שכוללת רק רישיון נהיגה בנייד (org.iso.18013.5.1.mDL) לא תתאים למסמכי הזיהוי לבדיקה של Utopia. כדי לקבל כל פרטי כניסה שעומדים בדרישות, משתמשים בדוגמה dcql_query של פרטי כניסה מרובים בשלב 3א: עיצוב הבקשה, ובודקים את פרטי הכניסה והמאפיינים הנתמכים כדי לראות את נתיבי ההצהרה הזמינים.

כדי לבדוק את מסמכי הזיהוי החדשים, צריך לבצע שני שלבים:

  1. בדיקה מהירה באמצעות כלי האימות באינטרנט: פותחים את הכתובת verifier.multipaz.org במכשיר 2 (או בדפדפן במחשב כדי לבדוק את קוד ה-QR במכשירים שונים) ומבקשים מסמכי זיהוי. כך תוכלו לוודא שהמכשיר ומסמכי הזיהוי לבדיקה פועלים לפני שתבדקו את הקוד שלכם.
  2. בדיקה מול השירות שלכם: אחרי שתשלימו את שלב 3, שלחו בקשה חתומה באמצעות מפתחות הבדיקה של ארגז החול (גורמים מסתמכים) או רשות האישורים הבסיסית של ארגז החול (רשמים מאמתים), והגדירו את השרת כך שיאמת את issuerAuth מול האישור של Utopia Sandbox.

פתרון בעיות

בעיה מה צריך לבדוק
האפשרות סביבת TapAndPay חסרה בהגדרות חשבון Google שלכם עדיין לא נמצא ברשימת ההיתרים של ארגז החול. שלב 1.א: בקשת גישה לארגז החול.
האפשרות מסמכי זיהוי לא מופיעה בקטע הוספה ל-Wallet מוודאים שמכשיר 2 נמצא במצב ארגז חול (שלב 1.ג'), מחובר לחשבון @gmail.com, לא עבר תהליך רוט/ניפוי באגים ופועלת בו גרסה 24.38.xx ואילך של Google Play Services.
ההודעה "אין תעודה מזהה דיגיטלית" מופיעה כשבודקים בקשה מוודאים שהבקשה כוללת את com.google.wallet.idcard.1 או את org.iso.23220.photoid.1, ושהמכשיר השני עדיין במצב ארגז חול.
הבקשה נכשלת לפני מסך ההסכמה של Google Wallet מאמתים את חתימת ה-JWS, כותרת האישור של x5c, client_id (x509_hash) ו-gw_rp_metadata_bytes.

מחיקת מסמכי הזיהוי לבדיקה מ-Wallet

לוחצים על סמל האפשרויות הנוספות (3 נקודות) בפינה השמאלית העליונה של מסך התעודה, בוחרים באפשרות מחיקה ופועלים לפי ההנחיות כדי להסיר את מסמכי הזיהוי לבדיקה.

השלב הבא

שלב 3 (הגורם המסתמך): שילוב → שלב 3 (רשם האימות): שילוב →