اصالت‌سنجی در همه ضرایب شکل

«مدیر اطلاعات کاربری» اصالت‌سنجی را در سراسر بوم‌سازگان Android ساده می‌کند. این ویژگی تجربه یکسانی برای کاربران و سطح میانای برنامه‌سازی کاربردی یکپارچه‌ای برای توسعه‌دهندگان فراهم می‌کند تا از گذرکلیدها، گذرواژه‌ها، و سازوکارهای ورود به سیستم فدرال مانند «ورود به سیستم با Google» استفاده کنند. درحالی‌که میانای برنامه‌نویسی اصلی در همه ضریب‌های شکل یکسان است، هر ضریب شکل ملاحظات منحصربه‌فردی برای میانای کاربر و تجربه کاربر دارد. پیاده‌سازی موفقیت‌آمیز مستلزم تطبیق دادن جریان‌های اصالت‌سنجی برنامه‌تان با روش‌های ورودی خاص، اندازه‌های صفحه‌نمایش، و زمینه‌های کاربری هر دستگاه است.

این راهنما نمای کلی از نحوه پیاده‌سازی «مدیر اطلاعات اعتباری» در عوامل مختلف فرم Android ارائه می‌دهد و ملاحظات کلیدی را برجسته می‌کند و به اسناد دقیق‌تر پیوند می‌دهد.

دستگاه‌های تلفن همراه

دستگاه‌های همراه، ازجمله تلفن‌ها، رایانه‌های لوحی، و دستگاه‌های تاشو، رایج‌ترین هدف برای توسعه Android هستند. پیاده‌سازی استاندارد Credential Manager برای این دستگاه‌ها که معمولاً دارای صفحه‌نمایش لمسی و صفحه‌کلید درون‌دستگاهی هستند بسیار مناسب است. تجربه کاربر در این عامل فرم به‌عنوان خط مبنایی عمل می‌کند که از آن برای دیگران اقتباس می‌کنید. جریان‌های اصالت‌سنجی باید با ضریب شکل متناسب باشد و از قابلیت‌های کامل فضای صفحه و روش‌های ورودی دستگاه استفاده کند.

Wear OS

دستگاه‌های Wear OS با صفحه‌نمایش کوچک و ورودی محدود در دستگاه مشخص می‌شوند. پیاده‌سازی گذرکلیدهای «مدیر اطلاعات اعتباری» محیطی امن برای کاربران فراهم می‌کند تا بدون نیاز به تلفن همراه جفت‌شده متصل و بدون نیاز به به‌خاطر سپردن گذرواژه، به سیستم برنامه‌ها وارد شوند.

میانای برنامه‌سازی کاربردی برای Wear OS با تلفن همراه یکسان است، بنابراین می‌توانید از ادغام تلفن همراه موجود مجدداً استفاده کنید. علاوه‌بر گذرکلیدها، «ورود به سیستم با Google»، و گذرواژه‌ها با Credential Manager، می‌توانید از روش‌های اصالت‌سنجی دیگری ازجمله «هم‌رسانی ژتون لایه داده»، OAuth، یا راه‌حل‌های موجود خودتان استفاده کنید. این‌ها می‌توانند به‌عنوان پشتیبان درحین انتقال کاربران به Credential Manager یا درصورت «هم‌رسانی کردن کد لایه داده» به‌عنوان راه‌حل بلندمدت استفاده شوند.

استفاده از Credential Manager برای Wear OS الزامات زیر را دارد:

  • حداقل سطح میانای برنامه‌سازی کاربردی: minSdkVersion ۳۳ یا بالاتر
    • شامل پشتیبانی از گذرواژه‌ها، گذرکلیدها، و «ورود به سیستم با Google» می‌شود
  • نسخه GMS: همانند الزامات برنامه‌های تلفن همراه

میانای کاربر در دستگاه‌های Wear OS به‌صورت زیر است:

صفحه ورود به سیستم با گذرکلید به‌عنوان روش اصالت‌سنجی ترجیحی در Wear OS نشان داده می‌شود.
شکل ۱الف. گذرکلیدها.
گذرکلیدها، گذرواژه‌ها، و گزینه‌های «ورود به سیستم با Google» برای کاربر در Wear OS دردسترس است.
شکل ۱ب. گذرکلیدها، گذرواژه‌ها، و «ورود به سیستم با Google».

برای راهنمایی دقیق درباره پیاده‌سازی و نمونه‌های کد، به منابع زیر مراجعه کنید:

محدودیت‌ها

استفاده از Credential Manager در Wear OS محدودیت‌های زیر را دارد:

Android XR

با Android XR (که شامل واقعیت مجازی و افزوده است)، برنامه‌ها در فضای سه‌بعدی پرداز می‌شوند. ورودی کاربر اساساً با ورودی‌های دیگر ضریب‌های شکل متفاوت است و به ورودی‌های طبیعی مانند اشاره‌های دست متکی است.

تطبیق Credential Manager برای XR یعنی بازاندیشی در رابط کاربری اصالت‌سنجی (چه با گذرکلیدها، گذرواژه‌ها، یا روش‌های ورود به سیستم فدرال) برای فضای سه‌بعدی. برای مثال، پیام‌واره‌های اصالت‌سنجی در پانل‌های شناور ظاهر می‌شوند و کاربران بااستفاده از اشاره‌های دست انتخاب می‌کنند. همچنین باید هرگونه پیش‌نیاز سخت‌افزاری یا نرم‌افزاری خاص را برای دستگاه‌های واقعیت گسترده هدف درنظر بگیرید.

یک چالش طراحی مهم، ایجاد تجربه اصالت‌سنجی امن و شهودی در محیط واقعیت مجازی یا واقعیت افزوده است. همچنین باید نحوه مدیریت هویت را در سناریوهای XR چندکاربره که افراد مختلف ممکن است از یک دستگاه استفاده کنند درنظر بگیرید.

استفاده از Credential Manager برای Android XR الزامات زیر را دارد:

  • حداقل سطح میانای برنامه‌سازی کاربردی: minSdkVersion ۳۴ یا بالاتر
  • نسخه «سرویس‌های تلفن همراه Google»: همان نسخه‌ای که برای برنامه‌های تلفن همراه لازم است
  • شبیه‌ساز:
    • حداقل تصویر سیستم شبیه‌ساز:
      • macOS: Google Play XR ARM 64 v8a System Image Revision 7
      • Windows: Google Play XR Intel x86_64 Atom System Image Revision 7
    • نسخه‌های شبیه‌ساز بالاتر از نسخه پایدار ۳۵.۶.۱۱

تجربه ورود به سیستم در واقعیت گسترده ممکن است به‌صورت زیر باشد:

پیام‌واره ورود به سیستم «مدیر اطلاعات اعتباری» در پانل شناور سه‌بعدی در Android XR نمایش داده می‌شود.
شکل ۲. میانای کاربر Credential Manager در «واقعیت گسترده».

‫Flows توسط «واقعیت گسترده» پشتیبانی نمی‌شود

«مدیر اطلاعات اعتباری» در Android XR از جریان‌های اصالت‌سنجی که نیاز به اسکن کردن رمزینه پاسخ‌سریع با دستگاه دیگری دارند پشتیبانی نمی‌کند. این مورد درطول فرایندهای ورود به سیستم در هدست‌های واقعیت گسترده و هنگام آزمایش با شبیه‌ساز قابل مشاهده است.

برای اطلاعات بیشتر درباره XR، به Android XR مراجعه کنید.

Android TV

دستگاه‌های Android TV معمولاً اشتراکی هستند، از فاصله دور مشاهده می‌شوند، و بااستفاده از کنترل از راه دور پد کنترل پیمایش می‌شوند. وارد کردن نام کاربری و گذرواژه در این محیط می‌تواند برای کاربران دشوار باشد. ‫Credential Manager با پشتیبانی از «ورود به سیستم با Google»، گذرواژه‌های ذخیره‌شده، و گذرکلیدهای بین‌دستگاهی، اصالت‌سنجی را در Android TV ساده می‌کند. ازآنجایی‌که اغلب چندین نمایه Google در یک تلویزیون مشترک وجود دارد، «مدیر اطلاعات کاربری» با واکشی و نمایش همه اطلاعات کاربری موجود در دستگاه، خود را با این تنظیمات مشترک تطبیق می‌دهد، به‌جای اینکه انتخاب‌ها را فقط به حساب فعال فعلی محدود کند.

پیام‌واره ورود به سیستم «مدیر اطلاعات اعتباری» در Android TV که حساب‌های ذخیره‌شده برای «ورود به سیستم با Google» و گذرواژه‌ها را به‌همراه گزینه‌ای برای استفاده از گذرکلید نمایش می‌دهد.
شکل ۳.‏ رابط کاربری Credential Manager در Android TV که «ورود به سیستم با Google»، گذرواژه‌های ذخیره‌شده، و گزینه‌های گذرکلید را نشان می‌دهد.

این ماهیت اشتراکی همچنین نحوه مدیریت گذرکلیدها را تعیین می‌کند. چون تلویزیون‌ها «عامل دانش صفحه قفل» (LSKF) شخصی ندارند، گذرکلیدها مستقیماً در تلویزیون ذخیره یا ایجاد نمی‌شوند. درعوض، اصالت‌سنجی گذرکلید از جریان ترکیبی بین‌دستگاهی استفاده می‌کند که در آن رمزینه پاسخ‌سریع در تلویزیون نمایش داده می‌شود و کاربر آن را با دستگاه همراه خود اسکن می‌کند تا اصالت‌سنجی زیست‌سنجشی را تکمیل کند.

جریان بدون کلیک در Google TV امکان‌پذیر است اگر isAutoSelectAllowed = true را تنظیم کنید، اما فقط درصورتی‌که دقیقاً یک مدرک مطابق دردسترس باشد. برگ پایین بومی تلویزیون همچنان ظاهر می‌شود و تأیید حساب کاربر را نشان می‌دهد. اگر کاربر لغو نکند، اعتبارنامه به‌طور خودکار بدون نیاز به کلیک از راه دور برگردانده می‌شود. اگر چندین اطلاعات اعتباری مطابقت داشته باشد، به‌طور خودکار انتخاب نمی‌شود و درعوض از کاربر خواسته می‌شود انتخاب کند.

اگر برنامه‌های تلفن همراه و تلویزیون شما دقیقاً از نام بسته Android و کلید امضای یکسانی استفاده کنند، «مدیر گذرواژه Google» آن‌ها را به‌عنوان هویت برنامه یکسان تشخیص می‌دهد. به همین دلیل، گذرواژه ذخیره‌شده در دستگاه همراه را می‌توان مستقیماً در تلویزیون ارائه کرد، بدون اینکه به پیکربندی «پیوندهای دارایی دیجیتال» (asset_statements) نیاز باشد. «پیوندهای دارایی دیجیتال» فقط زمانی لازم است که اطلاعات اعتباری در مرزها هم‌رسانی شود، مثلاً بین برنامه و وب‌سایت، یا بین برنامه‌هایی با نام بسته متفاوت.

استفاده از «مدیر اطلاعات اعتباری» برای Android TV الزامات زیر را دارد:

  • حداقل سطح میانای برنامه‌سازی کاربردی: Android 14 (میانای برنامه‌سازی کاربردی سطح ۳۴، minSdkVersion ۳۴) یا بالاتر
  • نسخه GMS:‏ 2026W30 یا بالاتر
  • سخت‌افزار گذرکلیدها: برای اسکن کردن رمزینه پاسخ‌سریع و تکمیل جریان ترکیبی FIDO، به دستگاه همراه ثانویه با دوربین و بلوتوث نیاز است

محدودیت‌ها

چون Android TV دستگاهی اشتراکی است، استفاده از «مدیر اطلاعات کاربری» در این پلاتفرم محدودیت‌های عمدی زیر را برای محافظت از حریم خصوصی و امنیت کاربر دارد:

  • عدم ایجاد یا ذخیره گذرکلید محلی: گذرکلیدها را نمی‌توان مستقیماً در تلویزیون ایجاد یا ذخیره کرد. چون از اعتبارنامه‌های محلی پشتیبانی نمی‌شود، در درخواست‌هایتان preferImmediatelyAvailableCredentials را روی true تنظیم نکنید؛ انجام این کار باعث می‌شود گذرکلیدهای بین‌دستگاهی فیلتر شوند و اعتبارنامه‌ها برگردانده نشوند.
  • عدم وجود ارائه‌دهندگان اطلاعات کاربری طرف سوم: Android TV از تکمیل خودکار پشتیبانی نمی‌کند، بنابراین مدیران گذرواژه طرف سوم در این پلاتفرم دردسترس نیستند. کاربران باید از «مدیر گذرواژه Google» استفاده کنند.
  • بدون «بازگرداندن اعتبارنامه‌ها»: ورود خودکار به سیستم دستگاه‌های جدید بااستفاده از درباره «بازگرداندن اعتبارنامه‌ها» در Android TV پشتیبانی نمی‌شود.

برای کسب اطلاعات بیشتر درباره توسعه تلویزیون، نمای کلی Android TV را ببینید.

سیستم عامل Android Automotive

دستگاه‌های «سیستم عامل Android Automotive» (AAOS) سیستم‌های اشتراکی هستند که در خودروها ادغام شده‌اند. Adapting Credential Manager for AAOS requires supporting secure authentication (typically while the vehicle is parked) and accommodating multiple user profiles on a shared device.

اگر برنامه‌ای با صفحه‌نمایش بزرگ یا بهینه‌سازی‌شده برای رایانه لوحی را به خودروها بیاورید و برنامه‌تان ازقبل از «مدیر اطلاعات کاربری» و گذرکلیدها در دستگاه‌های همراه یا رایانه‌های لوحی پشتیبانی کند، بدون نیاز به تغییر در جریان‌های اصالت‌سنجی شما، در سیستم‌عامل Android Automotive کار می‌کند.

اصالت‌سنجی در «سیستم عامل Android Automotive» از روش‌های زیر پشتیبانی می‌کند:

  • گذرکلیدها (جریان ترکیبی بین‌دستگاهی): کاربران می‌توانند با گذرکلیدهای موجود ازطریق جریان بین‌دستگاهی اصالت‌سنجی کنند. سیستم رمزینه پاسخ‌سریعی را در صفحه‌نمایش خودرو نمایش می‌دهد که کاربر با دستگاه همراهش اسکن می‌کند. چون درستی‌سنجی زیست‌سنجشی و قفل صفحه در تلفن کاربر انجام می‌شود، کاربران نیازی به پیکربندی قفل صفحه در نمایشگر خودرو ندارند.
  • ورود به سیستم با Google: صفحه بومی «ورود به سیستم با Google» را مستقیماً در نمایشگر خودرو نشان می‌دهد.
  • گذرواژه‌های ذخیره‌شده: کاربران می‌توانند گذرواژه‌های ذخیره‌شده را از «مدیر گذرواژه Google» بازیابی کنند تا بدون وارد کردن دستی اطلاعات کاربری در صفحه خودرو به سیستم وارد شوند.
پیام‌واره گذرکلید Credential Manager که در صفحه داخل خودرو در «سیستم‌عامل Android Automotive» نمایش داده شده است.
شکل ۵. پیام‌واره گذرکلید Credential Manager در «سیستم‌عامل Android Automotive».

سیستم‌عامل Android Automotive جلسه‌ها و اعتبارنامه‌ها را براساس نمایه مدیریت می‌کند و داده‌های جلسه مختص کاربر را بین نمایه‌ها (برای مثال، نمایه A، نمایه B، یا نمایه مهمان) جدا می‌کند.

استفاده از «مدیر اطلاعات اعتباری» برای سیستم عامل Android Automotive الزامات زیر را دارد:

  • حداقل سطح میانای برنامه‌سازی کاربردی: Android 9 (میانای برنامه‌سازی کاربردی سطح ۲۸،‏ minSdkVersion ۲۸) یا بالاتر. بازیابی گذرکلید بین‌دستگاهی به Android 14 (میانای برنامه‌سازی کاربردی سطح ۳۴) یا نسخه‌های بالاتر نیاز دارد.
  • نسخه «سرویس‌های تلفن همراه Google»: همان نسخه‌ای که برای برنامه‌های تلفن همراه لازم است.

محدودیت‌های آزمایش

آزمایش گذرکلیدها به دستگاهی فیزیکی نیاز دارد که ساخت سیستم‌عامل Android Automotive را به‌عنوان سطح اصلی اجرا کند. برای دستورالعمل‌های راه‌اندازی، آزمایش بااستفاده از سیستم‌عامل Android Automotive در Pixel Tablet را ببینید. از شبیه‌سازها نمی‌توان برای آزمایش گذرکلید استفاده کرد زیرا از «بلوتوث کم‌مصرف» (BLE) که برای جریان ترکیبی FIDO لازم است پشتیبانی نمی‌کنند.

محدودیت‌ها و جریان‌های پشتیبانی‌نشده

استفاده از «مدیر اطلاعات کاربری» در «سیستم عامل Android Automotive» محدودیت‌های زیر را دارد:

  • عدم ذخیره یا بازیابی گذرکلید محلی: بازیابی مستقیم گذرکلید محلی پشتیبانی نمی‌شود زیرا خودروها دستگاه‌های اشتراکی هستند. همگام‌سازی گذرکلیدها به‌طور مستقیم با خودرو خطر امنیتی دارد، بنابراین گذرکلیدها باید ازطریق جریان ترکیبی بین‌دستگاهی استفاده شوند.
  • اعتبارنامه‌های فوراً دردسترس پشتیبانی نمی‌شود: اگر برنامه‌تان گذرکلید درخواست کند و preferImmediatelyAvailableCredentials را روی true تنظیم کند، واسط کاربر خودرویی فوراً خاتمه می‌یابد و NoCredentialException را برمی‌گرداند. تجربه کاربری جایگزین مناسبی برای این سناریو ارائه دهید.
  • عدم وجود ارائه‌دهندگان اطلاعات کاربری شخص ثالث: مدیران گذرواژه شخص ثالث در «سیستم‌عامل Android Automotive» پشتیبانی نمی‌شوند. کاربران باید از «مدیر گذرواژه Google» یا جریان‌های ترکیبی بین‌دستگاهی برای اصالت‌سنجی استفاده کنند.
  • عدم ایجاد گذرواژه ذخیره‌شده: این API از ایجاد و ذخیره کردن گذرواژه ذخیره‌شده جدید مستقیماً از رابط خودرو پشتیبانی نمی‌کند. ایجاد اعتبارنامه به گذرکلیدهای جدیدی که از جریان ترکیبی FIDO استفاده می‌کنند محدود شده است.

برای کسب اطلاعات بیشتر درباره توسعه «سیستم عامل Automotive»، به نمای کلی «سیستم عامل Android Automotive» مراجعه کنید.

منابع بیشتر