این سند نحوه استفاده از «مدیر اطلاعات کاربری» را برای دریافت نشانی ایمیل درستی‌سنجی‌شده با رمزنگاری از دستگاه کاربر شرح می‌دهد. این فرایند نیاز کاربران برنامه شما را به درستی‌سنجی ایمیلشان با گذرواژه‌های یک‌بارمصرف (OTP) یا پیوندهای جادویی برطرف می‌کند.
این سند موارد زیر را توضیح می‌دهد:
- سازگاری Android
- تجربه کاربری
- حساب‌های پشتیبانی‌شده
- پیامد قابلیت تحویل ایمیل
- مقایسه با ورود به سیستم با Google
این راهنما فرض می‌کند که شما با مفاهیم زیر آشنا هستید:
سازگاری Android
این ویژگی در تلفن‌های همراه، رایانه‌های لوحی، و دستگاه‌های تاشو با Android 9 (سطح میانای برنامه‌سازی کاربردی ۲۸) و بالاتر پشتیبانی می‌شود. حداقل نسخه موردنیاز «خدمات Google Play» (GMS) نسخه 25.49.x است.
تجربه کاربری
بخش‌های زیر تجربه کاربری را درطول جریان درستی‌سنجی، نیاز به گنجاندن روش‌های درستی‌سنجی جایگزین، و همچنین تجربه کاربری توصیه‌شده برای موارد استفاده مختلف را شرح می‌دهند.
جریان درستی‌سنجی
تجربه کاربری برای هم‌رسانی ایمیل تأییدشده به‌صورت زیر است:
- کاربر روی فیلد ورودی تمرکز می‌کند یا روی دکمه‌ای که Credential Manager API را فرامی‌خواند تک‌ضرب می‌زند. بسته به طراحی صفحه، می‌توانید API را در بارگیری صفحه برنامه‌تان نیز فراخوانی کنید.
- برگه پایینی ظاهر می‌شود و اطلاعاتی را که با برنامه هم‌رسانی خواهد شد نشان می‌دهد. اگر اطلاعاتی در آن دستگاه دردسترس نباشد، کاربر پیام خطای عمومی می‌بیند.
- پس‌از اینکه کاربر روی موافقت و ادامه تک‌ضرب زد، پیام موفقیت یا شکست را نمایش دهید.
- توجه: اگر ایمیل درستی‌سنجی‌شده‌ای که دریافت می‌کنید با آنچه انتظار دارید مطابقت ندارد، به کاربر اطلاع دهید که عدم تطابق وجود دارد و از او بخواهید دوباره با اعتبارنامه دیگری امتحان کند یا روش درستی‌سنجی دیگری، مانند گذرواژه یک‌بارمصرف، ارائه دهد.
- (اختیاری، توصیه می‌شود) اگر کاربر درحال ثبت‌نام برای سرویس شما است، باید از کاربر بخواهید گذرکلید ایجاد کند تا ورود به سیستم در دفعات بعدی برای او آسان‌تر شود.
- توجه: فرایند درستی‌سنجی ایمیل به‌طور خودکار باعث ایجاد گذرکلید نمی‌شود. بااین‌حال، اکیداً توصیه می‌شود مراحل ایجاد گذرکلید را اضافه کنید. گذرکلیدها با آسان‌تر و ایمن‌تر کردن ورود به سیستم به کاربران کمک می‌کنند و نیاز به تعامل سنتی با نام کاربری و گذرواژه را ازبین می‌برند.
گنجاندن جریان‌های اصلی و بازگشتی
برای اطمینان از تجربه کاربری ساده، گزینه‌های زیر را در صفحه‌هایی که به درستی‌سنجی ایمیل نیاز دارند اضافه کنید:
- گزینه درستی‌سنجی اصلی: فیلد ایمیل یا دکمه‌ای برای راه‌اندازی جریان Credential Manager API برای درستی‌سنجی سریع.
- گزینه‌های درستی‌سنجی جایگزین: پیوند یا دکمه‌ای برای کاربران برای «درستی‌سنجی به روشی دیگر» یا با «گزینه‌های دیگر» برای وارد کردن دستی ایمیل درصورت ناموفق بودن، مثلاً عدم وجود اطلاعات دردسترس در دستگاه، یا عدم تطابق بین ایمیل بازیابی‌شده و ایمیل موردانتظار. این کار باید به کاربران اجازه دهد درستی‌سنجی را با اعتبارنامه دیگری یا با ارائه گذرواژه یک‌بارمصرف دستی امتحان کنند.
موارد استفاده
بخش‌های زیر موارد استفاده توصیه‌شده و همچنین تجربه کاربری پیشنهادی را برای درستی‌سنجی ایمیل شرح می‌دهند.
ثبت‌نام
کاربران می‌توانند بلافاصله با ایمیل درستی‌سنجی‌شده و بدون مرحله درستی‌سنجی جداگانه، حساب ایجاد کنند. به‌صورت اختیاری، از کاربر بخواهید گذرکلید اضافه کند. اگر کاربر تصمیم گرفت گذرکلید اضافه کند، جریان ایجاد گذرکلید را راه‌اندازی کنید.
بازیابی حساب
برای ازبین بردن ناامیدی کاربران از جستجوی کدهای بازیابی در پوشه‌های هرزنامه، به آن‌ها اجازه دهید حسابشان را بااستفاده از ایمیل درستی‌سنجی‌شده که به‌طور ایمن در دستگاهشان ذخیره شده است بازیابی کنند. علاوه‌براین، به او پیشنهاد کنید که برای استفاده در آینده گذرکلید ایجاد کند.
اصالت‌سنجی مجدد برای کنش‌های حساس
با الزامی کردن مرحله اصالت‌سنجی مجدد سریع، از کنش‌های حساس کاربر، مثل تغییر تنظیمات یا به‌روزرسانی جزئیات نمایه، محافظت کنید.
حساب‌های پشتیبانی‌شده
درستی‌سنجی ایمیل ازطریق Credential Manager فقط از درستی‌سنجی «حساب‌های Google» مصرف‌کننده پشتیبانی می‌کند. از حساب‌های Workspace و حساب‌های تحت نظارت پشتیبانی نمی‌شود.
«حساب Google» مصرف‌کننده را می‌توان با نشانی ایمیل از هر ارائه‌دهنده‌ای ایجاد کرد، نه لزوماً @gmail.com. بااین‌حال، Google این حساب‌ها را به‌طور متفاوتی تأیید می‌کند:
- برای حساب‌های @gmail.com: Google منبع معتبر است و ایمیل به‌عنوان تأییدشده شناخته می‌شود.
- برای حساب‌های غیر gmail.com@: Google در درازمدت منبع معتبری برای این نشانی‌های ایمیل نیست. درحالی‌که Google ایمیل را هنگام ایجاد حساب درستی‌سنجی می‌کند، مالکیت آن نشانی ایمیل ممکن است درطول زمان تغییر کند. بنابراین، برای نشانی‌های غیر @gmail.com، باید یک مرحله درستی‌سنجی اضافی، مانند ارسال گذرواژه یک‌بارمصرف، را درنظر بگیرید تا مطمئن شوید که کاربر همچنان به حساب ایمیل دسترسی دارد.
برای اطلاعات بیشتر درباره آنچه درستی‌سنجی بر آن دلالت دارد، به اعتبارنامه‌های دیجیتال مراجعه کنید.
توجه: علاوه‌بر اطلاعات ایمیل کاربر، می‌توانید فیلدهای تأییدنشده دیگری را نیز درخواست کنید، مانند نام کوچک، نام خانوادگی، نام، و عکس نمایه «حساب Google» کاربر. بااین‌حال، فقط ایمیل توسط Google درستی‌سنجی می‌شود.
برای درستی‌سنجی شماره تلفن، به درستی‌سنجی شماره تلفن با اطلاعات کاربری دیجیتال مراجعه کنید. برای راهکار Firebase، به درستی‌سنجی شماره تلفن Firebase مراجعه کنید.
اعتبار و تازگی
سیستم اطلاعات اعتباری قابل‌تأیید (VC) را براساس ایمیل فعلی کاربر از «حساب‌های Google» فعال در دستگاه صادر می‌کند. این اطلاعات کاربری ازقبل برای دستگاه صادر می‌شود، معمولاً زمانی که دستگاه غیرفعال است. درحالی‌که این اعتبارنامه‌ها ممکن است برای چند روز معتبر باقی بمانند، سیستم در لحظه هم‌رسانی اعتبارنامه‌ها بررسی می‌کند تا مطمئن شود که حساب هنوز وجود دارد، در دستگاه است، و نشانی ایمیل معتبر است—به‌طور مؤثر وضعیت فوری حساب را بر پنجره اعتبار اعتبارنامه اولویت می‌دهد.
برای کمک به اطمینان از اصالت، امضای «اتصال کلید» (kb) در زمان هم‌رسانی تولید می‌شود و عدد یک‌بارمصرف را دربرمی‌گیرد.
اگر دستگاهی آفلاین باشد یا حساب برداشته شده باشد، فرایند ناموفق خواهد بود و کارت مجازی منقضی‌شده یا کارت مجازی برای «حساب Google» غیرفعال ارائه نمی‌شود.
قابلیت تحویل ایمیل
اگرچه این فرایند مشروعیت حساب را تأیید می‌کند، اما تحویل به صندوق ورودی را تضمین نمی‌کند (برای مثال، ممکن است ایمیل به هرزنامه منحرف شود). گذرواژه یک‌بارمصرف همچنان روش قطعی برای تأیید قابلیت تحویل ایمیل است.
مقایسه با «ورود به سیستم با Google»
درحالی‌که هر دو راهکار «مدارک دیجیتال» و ورود به سیستم با Google ایمیل درستی‌سنجی‌شده ارائه می‌دهند، جریان‌های کاربر و موارد استفاده آن‌ها متفاوت است:
- موارد استفاده: جریان درستی‌سنجی ایمیل «مدیر اطلاعات کاربری» منحصراً در موارد استفاده ثبت‌نام یا ورود به سیستم استفاده نمی‌شود، بلکه می‌تواند در هر مورد استفاده‌ای که شامل بازیابی ایمیل درستی‌سنجی‌شده باشد استفاده شود. این مورد می‌تواند شامل بازیابی حساب نیز باشد.
- ثبت‌نام: برخلاف «ورود به سیستم با Google»، جریان Credential Manager به ثبت‌نام Google نیاز ندارد.
پشتیبانی پلاتفرم: جریان Credential Manager راه‌حلی مختص Android است.
گستره‌ها: برخلاف «ورود به سیستم با Google» که می‌تواند از OAuth 2.0 برای درخواست دسترسی به داده‌های کاربر (مانند «تقویم» یا Drive ازطریق گستره‌ها) استفاده کند، Digital Credentials API صرفاً برای بازیابی مشخصه‌های هویتی درستی‌سنجی‌شده است. از آن نمی‌توان برای درخواست گستره‌های مجوز اضافی استفاده کرد.
مراحل بعدی
برای پیاده‌سازی این ویژگی در برنامه‌تان، راهنمای پیاده‌سازی را ببینید.