Credential Manager Holder API به برنامه دارنده Android شما (که «کیف پول» نیز نامیده می‌شود) اجازه می‌دهد تا اعتبارنامه‌های دیجیتال را مدیریت کند و به درستی‌سنج‌ها ارائه دهد.
قالب‌های اعتبارنامه
اعتبارنامه‌ها را می‌توان در قالب‌های مختلف اعتبارنامه در برنامه‌های دارنده ذخیره کرد. این قالب‌ها مشخصاتی برای نحوه نمایش اعتبارنامه هستند و هرکدام حاوی اطلاعات زیر درباره اعتبارنامه هستند:
- نوع: دسته‌ای مثل مدرک دانشگاهی یا گواهینامه رانندگی.
- ویژگی‌ها: مشخصه‌هایی مانند نام و نام خانوادگی.
کدبندی: نحوه ساختاردهی مدرک، برای مثال SD-JWT یا mdoc
اعتبار: روشی برای درستی‌سنجی اصالت اطلاعات کاربری ازطریق رمزنگاری.
هر قالب اطلاعات کاربری، کدگذاری و اعتبارسنجی را کمی متفاوت انجام می‌دهد، اما ازنظر عملکردی یکسان هستند.
این دفتر ثبت از دو قالب پشتیبانی می‌کند:
- SD-JWT: با مشخصات «اعتبارنامه‌های قابل‌تأیید مبتنی بر SD-JWT» (SD-JWT VC) از IETF مطابقت دارد.
- اسناد تلفن همراه یا mdocs: با مشخصات ISO/IEC 18013-5:2021 مطابقت دارد.
درستی‌سنج می‌تواند هنگام استفاده از Credential Manager، درخواست OpenID4VP برای SD-JWT و mdocs ارسال کند. انتخاب بسته به مورد استفاده و انتخاب صنعت متفاوت است.
ثبت فراداده اعتبارنامه
«مدیر اطلاعات کاربری» اطلاعات کاربری دارنده را مستقیماً ذخیره نمی‌کند، بلکه
فراداده اطلاعات کاربری را ذخیره می‌کند. برنامه دارنده ابتدا باید فراداده اطلاعات کاربری را
بااستفاده از RegistryManager در Credential Manager ثبت کند. این فرایند ثبت‌نام
یک سابقه ثبتی ایجاد می‌کند که دو هدف کلیدی را دنبال می‌کند:
- مطابقت دادن: از فراداده‌های اطلاعات کاربری ثبت‌شده برای مطابقت دادن با درخواست‌های درستی‌سنجی آینده استفاده می‌شود.
- نمایش: عناصر سفارشی‌شده واسط کاربر در میانای انتخابگر اطلاعات کاربری به کاربر نشان داده می‌شود.
از کلاس OpenId4VpRegistry برای ثبت اطلاعات اعتباری دیجیتال خود استفاده کنید،
زیرا از هر دو قالب اطلاعات اعتباری mdoc و SD-JWT پشتیبانی می‌کند. درستی‌سنج‌ها برای درخواست این اطلاعات کاربری،
درخواست‌های OpenID4VP ارسال می‌کنند.
روش‌های صدور اعتبارنامه
صدور اعتبارنامه را می‌توان به دو روش راه‌اندازی کرد:
- جریان آغازشده توسط صادرکننده: کاربر درخواستی را برای صدور کارت پرداخت مجازی از وب‌سایت یا برنامه صادرکننده راه‌اندازی می‌کند. برای مثال، وب‌سایتی ممکن است به کاربرانش گزینه‌ای برای «افزودن گذرنامه به کیف پول» ارائه دهد. صادرکننده Credential Manager issuance API را برای ایجاد درخواست «پیشنهاد مدرک OpenID4VCI» فرامی‌خواند. برای رسیدگی به چنین درخواست‌هایی، دارنده باید ابتدا با «مدیر اطلاعات کاربری» ادغام شود تا فراداده‌هایش را ثبت کند. «مدیر اطلاعات کاربری» گزینه‌های مربوطه را برای انتخاب کاربر نمایش می‌دهد. پس‌از اینکه کاربر گزینه دارنده را انتخاب کرد، برنامه دارنده فراخوانده می‌شود و می‌تواند مراحل لازم برای تکمیل صدور را ادامه دهد.
- جریان آغازشده توسط دارنده: کاربر درخواست می‌کند که یک VDC از برنامه دارنده خود اضافه کند. برای مثال، دارنده ممکن است دکمه‌ای برای «افزودن گذرنامه» ارائه دهد. در این حالت، دارنده فهرست صادرکنندگان پشتیبانی‌شده و فراداده‌هایش را حفظ می‌کند. برای تکمیل این عملکرد، نیازی به ادغام با «مدیر اطلاعات اعتباری Android» ندارد.