قبل‌از شروع به کار در محیط تولید، بااستفاده از شناسه دیجیتال آزمایشی خود در محیط ایمن، تأیید کنید که ادغام شما به‌طور کامل کار می‌کند، سپس یک ویدیو نمایشی از جریان کامل ضبط کنید. Google این ویدیو را درطول آماده‌سازی در مرحله ۵ بازبینی می‌کند.
مسیرتان را انتخاب کنید طرف تکیه‌کننده، ثبت‌کننده درستی‌سنج، یا حضوری
مراحل در این صفحه
مراجع ضروری آزمایش
اعتبارنامه‌ها و مشخصه‌های پشتیبانی‌شده
doctype_value شناسه‌ها و مسیرهای ادعای دقیق پشتیبانی‌شده در گواهینامه‌های رانندگی دیجیتال، شناسه‌های دیجیتال، و مدارک شناسایی عکس‌دار را بررسی کنید.
صادرکنندگان و گواهینامه‌های IACA پشتیبانی‌شده
گواهینامه‌های ریشه IACA صادرکننده تولید و گواهی Utopia Sandbox را بارگیری کنید.
ابزار درستی‌سنج وب تعاملی
ادغام خود را به‌صورت پهلو‌به‌پهلو با درستی‌سنج مرجع میزبانی‌شده OpenWallet Foundation مقایسه کنید.
مرحله الف: درستی‌سنجی راه‌اندازی آزمایش جعبه شنی
قبل‌از اجرای آزمایش سرتاسری، مطمئن شوید این چهار پیش‌نیاز برقرار باشد:
- دستگاه در حالت جعبه امن با شناسه آزمایشی: دستگاه آزمایشی Android شما به جعبه امن (مرحله ۱) تغییر کرده است و شناسه دیجیتال Utopia به «کیف پول Google» اضافه شده است (مرحله ۲).
- امضای درخواست جعبه شنی:
- طرف‌های متکی: سرور شما درخواست‌ها را با جفت کلید و فراداده آزمایشی Sandbox که ازقبل مورداعتماد است امضا می‌کند.
- ثبت‌کنندگان تأییدکننده: Google تأیید کرده است که «مرجع صدور گواهی ریشه» جعبه امن شما در
مخزن گواهی‌های جعبه امن قرار دارد و سرور شما درخواست‌ها را با گواهینامه نهایی
زنجیرشده به «مرجع صدور گواهی ریشه» جعبه امن شما امضا می‌کند و شامل
gw_rp_metadata_bytesکدگذاری‌شده با CBOR شما است (مرحله ۳.الف: مشخصات ثبت‌کنندگان تأییدکننده).
- درخواست شامل نوع سند شناسه دیجیتال است: چون شناسه آزمایشی جعبه امن شناسه دیجیتال است،
dcql_queryشماcom.google.wallet.idcard.1یاorg.iso.23220.photoid.1را درخواست می‌کند (یا از درخواست چنداعتباری از مرحله ۳.الف استفاده می‌کند). - سرور به گواهی Utopia Sandbox اعتماد دارد: مخزن گواهی‌های سرور شما شامل
گواهی Utopia Sandbox است
بنابراین درستی‌سنجی امضای
issuerAuthبرای شناسه آزمایشی Utopia با موفقیت انجام می‌شود.
مرحله ب: آزمایش کردن درخواست، تجربه کاربری، و مدیریت خطا
هریک از بررسی‌های زیر را در هر پلاتفرمی که پشتیبانی می‌کنید (برنامه Android، وب تلفن همراه، و وب بین‌دستگاهی رایانه) اجرا کنید:
- نقطه ورود نمایان: دکمه‌ای واضح (مثل «درستی‌سنجی با مدرک شناسایی دیجیتال») که با تک‌ضرب زدن/کلیک کردن کاربر، درخواست را آغاز می‌کند.
- برنامه Android (درصورت وجود):
CredentialManager.getCredential()انتخابگر اطلاعات کاربری Android را باز می‌کند و شناسه دیجیتال آزمایشی جعبه امن شما را نمایش می‌دهد. - وب (درصورت وجود):
navigator.credentials.get()انتخابگر اعتبارنامه را در مرورگرهای تلفن همراه باز می‌کند—و هنگام استفاده از درخواست‌های امضاشده، رمزینه پاسخ‌سریع بین‌دستگاهی را در مرورگرهای رایانه‌ای نمایش می‌دهد. - صفحه رضایت «کیف پول Google»: با تک‌ضرب زدن روی اطلاعات کاربری، «کیف پول Google» باز می‌شود
و نام نمایشی، نشان‌واره، و پیوند خط‌مشی رازداری موردانتظار را از
gw_rp_metadata_bytesشما، به‌همراه فقط مشخصه‌هایی که درخواست کرده‌اید، نمایش می‌دهد. - کمینه‌سازی جمع‌آوری داده: فقط مشخصه‌هایی که برای مورد استفاده شما لازم است درخواست می‌شود (به مشخصه‌ها و اطلاعات کاربری پشتیبانی‌شده مراجعه کنید)، و
intent_to_retainبرای هر ادعا به‌طور دقیق تنظیم می‌شود. - لغو کاربر و بازگشت: لغو کردن برگه (
GetCredentialCancellationExceptionدر Android یا وعده ردشده در وب) یا آزمایش بدون شناسه منطبق (NoCredentialException) به‌خوبی در میانای کاربر شما مدیریت می‌شود.
مرحله ۳: آزمایش رمزگشایی سمت سرور و اعتبارسنجی رمزنگاری
پس‌از تأیید صفحه رضایت در «کیف پول Google»، درستی‌سنجی کنید که سرورتان همه بررسی‌های رمزنگاری لازم را انجام می‌دهد:
- رمزگشایی JWE: سرور شما
identityTokenبرگردانده‌شده را بااستفاده از کلید خصوصی مربوط به کلید عمومی رمزگذاریclient_metadata.jwksرمزگشایی می‌کند وvp_tokenرا استخراج می‌کند. - بازسازی
SessionTranscript: سرور شماSessionTranscriptرا بااستفاده ازOpenID4VPDCAPIHandoverبا درخواست دقیقnonce، اثر انگشت JWK رمزگذاری، و مبدأ پلاتفرم (android:apk-key-hash:...یا نشانی وب مبدأ وب) بازسازی می‌کند. - اعتبارسنجی زنجیره گواهینامه IACA (
issuerAuth): سرور شما زنجیره گواهینامه صادرکننده را ازissuerAuthاستخراج می‌کند و آن را درمقابل گواهینامه Utopia Sandbox در محیط ایمن و درمقابل گواهینامه‌های ریشه تولید رسمی در صادرکنندگان پشتیبانی‌شده و گواهینامه‌های IACA برای تولید اعتبارسنجی می‌کند. هرگز این بررسی را رد نکنید. - درستی‌سنجی MSO،
ValueDigests، وdeviceSignature: سرور شما امضای «شیء امنیتی تلفن همراه» (MSO) را درستی‌سنجی می‌کند، مطابقتValueDigestsبا عناصر داده برگردانده‌شده را تأیید می‌کند، وdeviceSignatureرا اعتبار سنجی می‌کند (بخش‌های ۹.۱.۲ و ۹.۱.۳ از ISO/IEC 18013-5). - اثبات دانایی صفر (درصورت پیاده‌سازی): اگر
mso_mdoc_zkرا درخواست می‌کنید، سرور شما اثبات برگردانده‌شده را بااستفاده از longfellow-zk اعتبارسنجی می‌کند.
مرحله ۴: ویدیو نمایشی سرتاسری‌تان را ضبط کنید
وقتی ادغام شما مراحل «ب» و «پ» را با موفقیت پشت سر گذاشت، ویدیویی از ضبط صفحه‌نمایش بگیرید که کل مسیر کاربر را از برنامه یا وب‌سایت شما تا رضایت «کیف پول Google» و بازگشت به وضعیت تأییدشده شما نشان دهد. جدول زیر نشان می‌دهد که براساس مسیر آماده‌سازی‌تان چه چیزی را باید اضافه کنید:
| الزامات ویدیو | طرف‌های اتکا (مستقیم) | ثبت‌کنندگان درستی‌سنج (تجمیع‌کنندگان) |
|---|---|---|
| صفحه‌هایی که نشان داده می‌شود | مسیر کامل کاربر: صفحه ورودی ← انتخابگر اطلاعات کاربری ← موافقت و اصالت‌سنجی «کیف پول Google» ← نتیجه درستی‌سنجی‌شده در برنامه یا سایت شما | مسیر کامل کاربر برای «طرف اتکاکننده» پایین‌دستی اولیه (اول) شما |
| جریان‌های ضبط | جریان ادغام وب و/یا برنامه Android شما | هر دو جریان میزبانی‌شده توسط درستی‌سنج (میزبانی‌شده توسط خود) و میزبانی‌شده توسط فروشنده (میزبانی‌شده توسط طرف تکیه‌کننده)، درصورت لزوم |
| دارایی‌های نمایش و نمانام‌سازی | نام نمایشی، نشان‌واره، و نشانی‌های وب خط‌مشی رازداری / شرایط خدمات واقعی شما | دارایی‌های نمایشی واقعی فروشنده (نام، نشان‌واره، نشانی وب «شرایط خدمات») و دارایی‌های نمایشی تجمیع‌کننده شما |
مرحله بعدی
مسیر آماده‌سازی خود را برای ارسال ویدیو و راه‌اندازی در تولید انتخاب کنید: