تتيح واجهة برمجة التطبيقات Credential Manager Holder API لتطبيق الحافظة على Android (المعروف أيضًا باسم "المحفظة") إدارة بيانات الاعتماد الرقمية وتقديمها إلى جهات التحقّق.
تنسيقات بيانات الاعتماد
يمكن تخزين بيانات الاعتماد في تطبيقات الحفظ بتنسيقات مختلفة. هذه التنسيقات هي مواصفات لكيفية تمثيل بيانات الاعتماد، ويحتوي كل منها على المعلومات التالية حول بيانات الاعتماد:
- النوع: الفئة، مثل شهادة جامعية أو رخصة قيادة
- الخصائص: سمات مثل الاسم الأول واسم العائلة
الترميز: طريقة تنظيم بيانات الاعتماد، مثل SD-JWT أو mdoc
الصلاحية: طريقة للتحقّق من صحة بيانات الاعتماد باستخدام التشفير
يتم ترميز كل تنسيق من تنسيقات بيانات الاعتماد والتحقّق منه بطريقة مختلفة قليلاً، ولكنّها متشابهة من الناحية الوظيفية.
يتيح السجلّ تنسيقَين:
- SD-JWT: يتوافق مع مواصفات بيانات الاعتماد القابلة للتحقّق المستندة إلى SD-JWT الصادرة عن مجموعة مهندسي الإنترنت (IETF).
- المستندات المتوافقة مع الأجهزة الجوّالة (mdocs): تتوافق مع مواصفات ISO/IEC 18013-5:2021.
يمكن لجهة التحقّق تقديم طلب OpenID4VP للحصول على بيانات SD-JWT وmdocs عند استخدام Credential Manager. ويختلف الاختيار حسب حالة الاستخدام واختيار المجال.
تسجيل البيانات الوصفية لبيانات الاعتماد
لا يخزّن Credential Manager بيانات اعتماد حاملها مباشرةً، بل يخزّن
البيانات الوصفية لبيانات الاعتماد. يجب أن يسجّل تطبيق المحفظة أولاً البيانات الوصفية لبيانات الاعتماد
باستخدام Credential Manager من خلال RegistryManager. تنشئ عملية التسجيل هذه سجلّاً يخدم غرضَين رئيسيَّين:
- المطابقة: يتم استخدام البيانات الوصفية لبيانات الاعتماد المسجّلة لمطابقتها مع طلبات جهات التحقّق المستقبلية.
- العرض: تظهر عناصر في واجهة المستخدم المخصّصة للمستخدم في واجهة أداة اختيار بيانات الاعتماد.
استخدِم الفئة OpenId4VpRegistry لتسجيل بيانات الاعتماد الرقمية، لأنّها متوافقة مع تنسيقَي mdoc وSD-JWT. سترسل جهات التحقّق
طلبات OpenID4VP لطلب بيانات الاعتماد هذه.
طرق إصدار بيانات الاعتماد
يمكن إصدار بيانات الاعتماد بطريقتَين:
- عملية يطلقها جهة الإصدار: يرسل المستخدم طلبًا لإصدار بطاقة دفع افتراضية من تطبيق أو موقع إلكتروني تابع لجهة الإصدار. على سبيل المثال، قد يوفّر موقع إلكتروني للمستخدمين خيار "إضافة جواز سفرك إلى محفظتك". تتصل جهة الإصدار بواجهة برمجة التطبيقات لإصدار بيانات الاعتماد في Credential Manager لتقديم طلب عرض بيانات اعتماد OpenID4VCI. للتعامل مع هذه الطلبات، يجب أن يتكامل حامل المستند أولاً مع Credential Manager لتسجيل بياناته الوصفية. سيعرض Credential Manager الخيارات ذات الصلة ليختار منها المستخدم. بعد أن يحدّد المستخدم خيارًا من خيارات تطبيق الحامل، سيتم استدعاء تطبيق الحامل ويمكنه المتابعة في الخطوات اللازمة لإكمال عملية الإصدار.
- العملية التي يبدأها حامل البطاقة: يطلب المستخدم إضافة بطاقة دفع افتراضية من تطبيق حامل البطاقة. على سبيل المثال، قد يوفّر حامل البطاقة زرًا "لإضافة جواز سفرك". في هذه الحالة، يحتفظ الحامل بقائمة جهات الإصدار المتوافقة والبيانات الوصفية. ولا يحتاج إلى التكامل مع Android Credential Manager لإكمال هذه الوظيفة.