«درستی‌سنجی با کیف پول Google» از سه مسیر ادغام پشتیبانی می‌کند—دو مسیر آنلاین (برای برنامه‌ها و وب‌سایت‌های Android) و یک مسیر حضوری (برای کارت‌خوان‌های مجاورتی و پایانه‌های فروش). برای شروع، مسیرتان را انتخاب کنید.
سه مسیر یکپارچه‌سازی
طرف اتکا (RP)
برای فروشندگان، کسب‌وکارها، یا توسعه‌دهندگان نرم‌افزار که مستقیماً کاربران را برای وب‌سایت یا برنامه Android خودشان درستی‌سنجی می‌کنند.
ثبت‌کننده درستی‌سنج (VR)
برای ارائه‌دهندگان، تجمیع‌کنندگان، یا پلاتفرم‌های IDV که کاربران را ازطرف چندین کسب‌وکار پایین‌دستی (طرف‌های اتکاکننده نهایی) به‌تأیید می‌رسانند.
درستی‌سنجی حضوری
برای پایانه‌های نقطه فروش، کارت‌خوان‌های محل، یا برنامه‌های درستی‌سنج تلفن همراه که گواهینامه‌های رانندگی دیجیتال را به‌صورت آفلاین درستی‌سنجی می‌کنند—اگر پایانه شما از بازیابی ISO/IEC 18013-5 mdoc پشتیبانی کند، بدون قرار گرفتن در فهرست مجاز Google کار می‌کند (درحال‌حاضر از شناسه‌های دیجیتال به‌صورت حضوری پشتیبانی نمی‌شود).
مقایسه مسیرهای آنلاین: طرف اعتمادکننده دربرابر ثبت‌کننده درستی‌سنجی‌کننده
| جهت شیب | طرف اتکا (RP) | ثبت‌کننده درستی‌سنج (VR) |
|---|---|---|
| چه کسی درخواست‌ها را امضا می‌کند | Google گواهی شما را امضا می‌کند (شما CSR ارسال می‌کنید) | مرجع صدور گواهی خودتان را اجرا می‌کنید (مرجع صدور گواهی ریشه تولید + جعبه امن) و گواهینامه‌های نهایی را برای طرف‌های متکی نهایی امضا می‌کنید |
| اطلاعات کاربری جعبه شنی | کلیدهای آزمایشی و فراداده‌های جعبه امن هم‌رسانی‌شده Google (آزمایش را فوراً شروع کنید) | گواهی‌های امضاشده توسط «مرجع صدور گواهی ریشه جعبه امن» خودتان، پس‌از اینکه Google به آن اعتماد کرد |
| چه زمانی باید با Google تماس بگیرید | در پایان (مرحله ۵)، پس‌از تکمیل آزمایش جعبه امن | در شروع (مرحله ۱)، برای ثبت «مرجع صدور گواهی ریشه» «جعبه امن» و «تولید» |
راهنمای یکپارچه‌سازی آنلاین
مسیر ادغام آنلاین خود را انتخاب کنید تا مراحل ۱ تا ۵ را به‌ترتیب دنبال کنید. می‌توانید مراحل ۱ و ۲ (راه‌اندازی شناسه آزمایشی و جعبه امن) را به‌طور موازی تکمیل کنید، درحالی‌که تیم مهندسی شما مرحله ۳ را می‌سازد.
طرف‌های اتکا (مستقیم)
راه‌اندازی جعبه شنی
برای شروع آزمایش، به فرم پذیرش یا تأیید نیاز نیست. درخواست قرار دادن در فهرست مجاز جعبه امن برای «حساب Google» آزمایشی، تغییر حالت دستگاه Android آزمایشی به حالت جعبه امن، و بارگیری کلیدهای آزمایشی جعبه امن مشترک Google و گواهی Utopia Sandbox.
ایجاد شناسه آزمایشی در جعبه شنی
از دستگاه Android دومی که «شبیه‌ساز گذرنامه الکترونیکی Utopia» را اجرا می‌کند استفاده کنید تا شناسه دیجیتال شبیه‌سازی‌شده‌ای را در «کیف پول Google» در دستگاه محیط امنتان آماده‌سازی کنید.
ادغام به‌عنوان «طرف متکی»
چهار مرحله پیاده‌سازی را در راهنمای ادغام «طرف معتمد» دنبال کنید:
- مرحله ۳-الف — قالب‌بندی و امضای درخواست: پُرسمان OpenID4VP JSON را بسازید و JWS را در سرورتان امضا کنید.
- مرحله ۳-ب — راه‌اندازی API:
CredentialManagerAndroid یاnavigator.credentials.get()وب را فراخوانی کنید. - مرحله ۳-پ — رمزگشایی و اعتبارسنجی پاسخ: JWE را رمزگشایی کنید و زنجیره گواهینامه IACA و MSO را در سرورتان تأیید کنید.
- مرحله ۳-د (اختیاری) — افزودن اثبات‌های دانایی صفر: گزاره‌های سن را بدون دریافت تاریخ تولد کاربر تأیید کنید.
یکپارچه‌سازی‌تان را به‌طور کامل آزمایش کنید
شناسه دیجیتال آزمایشی Utopia را در سرویس خود ارائه دهید، هر مورد را در بازبینه سرتاسر (ازجمله اعتبارسنجی issuerAuth دربرابر گواهی Utopia Sandbox) درستی‌سنجی کنید، و یک ویدیو نمایشی ضبط کنید.
فعال شدن به‌عنوان «طرف معتمد»
فرم آماده‌سازی طرف متکی را با CSR تولید، دارایی‌های نمانام‌سازی، و ویدیو سرتاسر محیط ایمن ارسال کنید (با این کار، شرایط خدمات طرف متکی را رسماً می‌پذیرید). پس‌از تأیید (معمولاً ۳ تا ۵ روز کاری)، Google گواهی تولید امضاشده و gw_rp_metadata_bytes منحصربه‌فردتان را برمی‌گرداند.
ثبت‌کنندگان درستی‌سنج (تجمیع‌کنندگان)
ارسال کردن مراجع صدور گواهی ریشه و راه‌اندازی محیط ایمن
ابتدا، فرم ورودی آماده‌سازی ثبت‌کننده درستی‌سنج را با گواهی‌های CA ریشه جعبه امن و تولید ارسال کنید (شرایط خدمات ثبت‌کننده درستی‌سنج را بپذیرید) تا Google بتواند به CA ریشه جعبه امن شما اعتماد کند. به‌طور موازی، «حساب Google» آزمایشی‌تان را در فهرست مجاز قرار دهید و دستگاه Android آزمایشی را به حالت جعبه شنی تغییر دهید.
ایجاد شناسه آزمایشی در جعبه شنی
از دستگاه Android دومی که «شبیه‌ساز گذرنامه الکترونیکی Utopia» را اجرا می‌کند استفاده کنید تا شناسه دیجیتال شبیه‌سازی‌شده‌ای را در «کیف پول Google» در دستگاه محیط امنتان آماده‌سازی کنید.
ادغام به‌عنوان «ثبت‌کننده درستی‌سنج»
پنج مرحله پیاده‌سازی را در راهنمای ادغام «ثبت‌کننده تأییدکننده» دنبال کنید:
- مرحله ۳-الف — پیکربندی فراداده CA و CBOR: نمایه گواهینامه X.509 (OID
1.3.6.1.4.1.11129.10.1) و طرح‌واره فراداده CBOR را راه‌اندازی کنید. - مرحله ۳-ب — قالب‌بندی و امضای درخواست: پُرسمان JSON مربوط به OpenID4VP را بسازید و JWS را با گواهینامه نهایی End-RP خود امضا کنید.
- مرحله ۳-پ — راه‌اندازی میانای برنامه‌سازی کاربردی:
CredentialManagerAndroid یاnavigator.credentials.get()وب را فرابخوانید. - مرحله ۳-د — رمزگشایی و اعتبارسنجی پاسخ: JWE را رمزگشایی کنید و زنجیره گواهینامه IACA و MSO را در سرورتان تأیید کنید.
- مرحله ۳.هـ (اختیاری) — افزودن اثبات‌های دانایی صفر: گزاره‌های سن را بدون دریافت تاریخ تولد کاربر تأیید کنید.
یکپارچه‌سازی‌تان را به‌طور کامل آزمایش کنید
وقتی Google به شما اطلاع داد که «مرجع صدور گواهی ریشه جعبه امن» شما مورداعتماد است، گواهی «طرف متکی نهایی» آزمایشی را امضا کنید، گواهی «جعبه امن Utopia» را در سرورتان مورداعتماد قرار دهید، با شناسه دیجیتال آزمایشی Utopia آزمایش کنید، و ویدیوهای نمایشی را برای هر دو جریان «میزبانی‌شده توسط درستی‌سنج» و «میزبانی‌شده توسط فروشنده» ضبط کنید.
به‌عنوان «ثبت‌کننده تأییدکننده» فعال شوید و «طرف‌های متکی» نهایی را آماده‌سازی کنید
ویدیوهای «سر‌به‌سر» خود را برای بازبینی ارسال کنید. Google ویدیوهایتان را تأیید می‌کند و به‌طور موازی به Production Root CA شما اعتماد می‌کند. سپس، هر مشتری پایین‌دستی را بااستفاده از فرم آماده‌سازی مشتری ثبت‌کننده تأییدکننده ثبت کنید و گواهینامه‌های نهایی را با «نام متمایز» منحصربه‌فرد جهانی صادر کنید.
آنچه قبل‌از شروع نیاز دارید
- سروری که درخواست‌ها را ایجاد می‌کند و پاسخ‌ها را اعتبارسنجی می‌کند. درخواست کامل را در سرورتان تولید کنید، حتی برای برنامه‌های Android.
- دو دستگاه Android برای آزمایش: یکی شبیه‌ساز گذرنامه الکترونیکی را اجرا می‌کند و دیگری شناسه آزمایشی را در «کیف پول Google» نگه می‌دارد. از دستگاه‌های آزمایشی اختصاصی استفاده کنید، زیرا جابه‌جایی به جعبه امن داده‌های «کیف پول» تولیدی دستگاه را حذف می‌کند.
- حساب Google با نشانی @gmail.com برای استفاده در «کیف پول Google» درطول آزمایش.
- دارایی‌های نمایشی شما برای صفحه رضایت: نام نمایشی، نشان‌واره (به رهنمودهای نمانام مراجعه کنید)، نشانی وب خط‌مشی رازداری، و نشانی وب «شرایط خدمات».