نظرة عامة على محاكاة البطاقة المستنِدة إلى المضيف

تتيح العديد من الأجهزة التي تعمل بنظام التشغيل Android والتي توفّر وظيفة NFC محاكاة بطاقة NFC. في معظم الحالات، تتم محاكاة البطاقة بواسطة شريحة منفصلة في الجهاز تُسمى العنصر الآمن. تحتوي أيضًا العديد من شرائح SIM التي يوفّرها مشغّلو شبكات الجوّال على عنصر آمن.

يوفّر الإصدار 4.4 من نظام التشغيل Android والإصدارات الأحدث طريقة إضافية لمحاكاة البطاقة لا تتضمّن عنصرًا آمنًا، وتُعرف باسم محاكاة البطاقة المستندة إلى المضيف. يتيح ذلك لأي تطبيق Android محاكاة بطاقة والتواصل مباشرةً مع قارئ NFC. يتناول هذا الموضوع طريقة عمل وظيفة محاكاة البطاقة المُضيفة (HCE) على نظام التشغيل Android وكيفية تطوير تطبيق يحاكي بطاقة NFC باستخدام هذه التقنية.

محاكاة البطاقة باستخدام عنصر آمن

عند توفير محاكاة بطاقة NFC باستخدام عنصر آمن، يتم توفير البطاقة المطلوب محاكاتها في العنصر الآمن على الجهاز من خلال تطبيق Android. بعد ذلك، عندما يحمل المستخدم الجهاز فوق محطة NFC، يقوم وحدة تحكم NFC في الجهاز بتوجيه جميع البيانات من القارئ مباشرة إلى العنصر الآمن. يوضّح الشكل 1 هذا المفهوم:

مخطّط بياني يوضّح قارئ NFC يمرّ عبر وحدة تحكّم NFC لاسترداد المعلومات من عنصر آمن
الشكل 1: محاكاة بطاقة مزوّدة بتقنية NFC مع عنصر آمن

يُجري العنصر الآمن نفسه الاتصال بمحطة NFC، ولا يشارك أي تطبيق Android في المعاملة. بعد اكتمال المعاملة، يمكن لتطبيق Android الاستعلام عن العنصر الآمن مباشرةً لمعرفة حالة المعاملة وإشعار المستخدم.

محاكاة البطاقة المضيفة

عند محاكاة بطاقة NFC باستخدام محاكاة البطاقة المستندة إلى المضيف، يتم توجيه البيانات مباشرةً إلى وحدة المعالجة المركزية المضيفة بدلاً من توجيهها إلى عنصر آمن. يوضّح الشكل 2 طريقة عمل وظيفة محاكاة البطاقة المُضيفة:

مخطّط بياني يوضّح قارئ NFC يمرّ عبر وحدة تحكّم NFC لاسترداد المعلومات من وحدة المعالجة المركزية
الشكل 2: محاكاة بطاقة مزوّدة بتقنية NFC بدون عنصر آمن

بطاقات وبروتوكولات NFC المتوافقة

مخطّط بياني يعرض حزمة بروتوكول وظيفة محاكاة البطاقة المُضيفة (HCE)
الشكل 3: مجموعة بروتوكولات HCE في Android

تتيح معايير NFC استخدام العديد من البروتوكولات المختلفة، وهناك أنواع مختلفة من البطاقات التي يمكنك محاكاتها.

يتيح نظام التشغيل Android 4.4 والإصدارات الأحدث استخدام العديد من البروتوكولات الشائعة في السوق اليوم. تستند العديد من البطاقات الحالية التي تتيح الدفع بدون تلامس الأجهزة إلى هذه البروتوكولات، مثل بطاقات الدفع بدون تلامس الأجهزة. تتوافق هذه البروتوكولات أيضًا مع العديد من أجهزة قراءة NFC المتوفّرة في السوق اليوم، بما في ذلك أجهزة Android التي تتضمّن تقنية NFC وتعمل كأجهزة قراءة (راجِع الفئة IsoDep). يتيح لك ذلك إنشاء ونشر حلّ شامل لتقنية NFC حول وظيفة محاكاة البطاقة المُضيفة (HCE) باستخدام الأجهزة التي تعمل بنظام التشغيل Android فقط.

على وجه التحديد، يتيح نظام التشغيل Android 4.4 والإصدارات الأحدث محاكاة البطاقات التي تستند إلى مواصفات NFC-Forum ISO-DEP (استنادًا إلى ISO/IEC 14443-4) ومعالجة وحدات بيانات بروتوكول التطبيق (APDU) على النحو المحدّد في مواصفات ISO/IEC 7816-4. يفرض Android محاكاة ISO-DEP فقط على تقنية Nfc-A (ISO/IEC 14443-3 النوع A). ويُعدّ دعم تكنولوجيا Nfc-B (ISO/IEC 14443-4 النوع B) اختياريًا. يوضّح الشكل 3 طبقات كل هذه المواصفات.

خدمات HCE

تستند بنية HCE في Android إلى مكوّنات Android Service (المعروفة باسم خدمات HCE). من المزايا الرئيسية للخدمة أنّها يمكن أن تعمل في الخلفية بدون أي واجهة مستخدم. وهذا مناسب تمامًا للعديد من تطبيقات HCE، مثل بطاقات الولاء أو بطاقات النقل العام، والتي لا يحتاج المستخدم إلى تشغيل تطبيق لاستخدامها. بدلاً من ذلك، يؤدي النقر على الجهاز على قارئ NFC إلى بدء الخدمة الصحيحة إذا لم تكن قيد التشغيل بالفعل وتنفيذ المعاملة في الخلفية. Of course, you are free to launch additional UI (such as user notifications) from your service when appropriate.

اختيار الخدمة

عندما ينقر المستخدم على جهاز قارئ NFC، يحتاج نظام Android إلى معرفة خدمة HCE التي يريد قارئ NFC الاتصال بها. تحدّد مواصفات ISO/IEC 7816-4 طريقة لاختيار التطبيقات، وتتمحور حول رقم تعريف التطبيق (AID). يتكوّن معرّف AID من 16 بايت كحدّ أقصى. إذا كنت تحاكي بطاقات لبنية أساسية حالية لقارئ NFC، فإن معرّفات AID التي تبحث عنها تلك القارئات تكون عادةً معروفة ومسجّلة بشكل علني (على سبيل المثال، معرّفات AID لشبكات الدفع مثل Visa وMasterCard).

إذا أردت نشر بنية أساسية جديدة لأجهزة القراءة في تطبيقك، عليك تسجيل معرّفات التطبيقات الخاصة بك. يتم تحديد إجراءات تسجيل معرّفات التطبيقات في مواصفات ISO/IEC 7816-5. ننصحك بتسجيل معرّف AID وفقًا للمعيار 7816-5 إذا كنت تنشر تطبيقًا يستخدم وظيفة محاكاة البطاقة المُضيفة (HCE) على Android، لأنّ ذلك يمنع حدوث تداخل مع التطبيقات الأخرى.

مجموعات AID

في بعض الحالات، قد تحتاج خدمة HCE إلى تسجيل أرقام تعريف تطبيقات متعددة وضبطها كمعالج تلقائي لجميع أرقام تعريف التطبيقات من أجل تنفيذ تطبيق معيّن. لا يمكن نقل بعض معرّفات التطبيقات في المجموعة إلى خدمة أخرى.

تُعرف قائمة معرّفات التطبيقات التي يتم الاحتفاظ بها معًا باسم "مجموعة معرّفات التطبيقات". بالنسبة إلى جميع معرّفات التطبيقات في مجموعة معرّفات التطبيقات، يضمن Android أحد الخيارات التالية:

  • يتم توجيه جميع معرّفات التطبيقات في المجموعة إلى خدمة HCE هذه.
  • لا يتم توجيه أي معرّفات تطبيقات في المجموعة إلى خدمة HCE هذه (على سبيل المثال، لأنّ المستخدم فضّل خدمة أخرى طلبت معرّف تطبيق واحدًا أو أكثر في مجموعتك أيضًا).

بعبارة أخرى، لا توجد حالة وسيطة، حيث يمكن توجيه بعض معرّفات التطبيقات في المجموعة إلى خدمة HCE واحدة، وبعضها إلى خدمة أخرى.

مجموعات وفئات AID

يمكنك ربط كل مجموعة AID بفئة. يتيح ذلك لنظام Android تجميع خدمات HCE معًا حسب الفئة، ما يتيح للمستخدم ضبط الإعدادات التلقائية على مستوى الفئة بدلاً من مستوى معرّف التطبيق (AID). تجنَّب ذِكر معرّفات AID في أي أجزاء من تطبيقك موجّهة للمستخدمين، لأنّها لا تعني شيئًا للمستخدم العادي.

يتيح الإصدار 4.4 من نظام التشغيل Android والإصدارات الأحدث فئتين:

  • CATEGORY_PAYMENT (تغطي تطبيقات الدفع المتّبعة في المجال)
  • CATEGORY_OTHER (لجميع تطبيقات HCE الأخرى)

لا يمكن للتطبيقات التي تسجّل معرّفات AID ضمن CATEGORY_PAYMENT معالجة معاملة إلا في الحالات التالية:

  • يضبط المستخدم التطبيق كتطبيق الدفع التلقائي (صاحب دور "محفظة Google" على أجهزة Android 15 والإصدارات الأحدث)، أو
  • يكون التطبيق في المقدّمة ويستدعي setPreferredService.

تنفيذ خدمة HCE

لمحاكاة بطاقة NFC باستخدام محاكاة البطاقة المُضيفة، عليك إنشاء مكوّن Service يعالج المعاملات عبر اتصال NFC.

التحقّق من توافق الجهاز مع وظيفة محاكاة البطاقة المُضيفة (HCE)

يمكن لتطبيقك التحقّق مما إذا كان الجهاز يتيح استخدام وظيفة HCE من خلال البحث عن ميزة FEATURE_NFC_HOST_CARD_EMULATION. استخدِم العلامة <uses-feature> في ملف بيان تطبيقك للإشارة إلى أنّ تطبيقك يستخدم ميزة HCE، وما إذا كانت هذه الميزة مطلوبة ليعمل التطبيق أم لا.

تنفيذ الخدمة

يوفّر الإصدار 4.4 من Android والإصدارات الأحدث فئة Service ملائمة يمكنك استخدامها كأساس لتنفيذ خدمة HCE، وهي فئة HostApduService.

الخطوة الأولى هي توسيع HostApduService، كما هو موضّح في عيّنة التعليمات البرمجية التالية:

class MyHostApduService : HostApduService() {

    override fun processCommandApdu(commandApdu: ByteArray, extras: Bundle?): ByteArray {
        // ...
    }

    override fun onDeactivated(reason: Int) {
        // ...
    }
}

تُعلن HostApduService عن طريقتَين مجرّدتين يجب تجاوزهما وتنفيذهما. يتم استدعاء إحدى هذه الطرق، وهي processCommandApdu()، عندما يرسل قارئ NFC وحدة بيانات بروتوكول التطبيق (APDU) إلى الخدمة. يتم تحديد وحدات APDU في مواصفات ISO/IEC 7816-4. وحدات APDU هي حِزم على مستوى التطبيق يتم تبادلها بين قارئ NFC وخدمة HCE. ويكون هذا البروتوكول على مستوى التطبيق الازدواج النصفي: يرسل قارئ NFC وحدة APDU للأوامر، وينتظر منك إرسال وحدة APDU للاستجابة في المقابل.

كما ذكرنا سابقًا، يستخدم Android معرّف AID لتحديد خدمة HCE التي يريد القارئ الاتصال بها. عادةً ما تكون أول وحدة APDU يرسلها قارئ NFC إلى جهازك هي وحدة APDU SELECT AID، وتحتوي وحدة APDU هذه على معرّف AID الذي يريد القارئ التواصل معه. يستخرج Android معرّف AID من وحدة APDU، ويحلّله إلى خدمة HCE، ثم يعيد توجيه وحدة APDU إلى الخدمة التي تم تحليلها.

يمكنك إرسال وحدة APDU للاستجابة من خلال عرض وحدات البايت الخاصة بوحدة APDU للاستجابة من processCommandApdu(). يُرجى العِلم أنّه يتم استدعاء هذه الطريقة في سلسلة التعليمات الرئيسية لتطبيقك، والتي يجب عدم حظرها. إذا لم تتمكّن من احتساب وحدة APDU للاستجابة وإرجاعها على الفور، يمكنك إرجاع قيمة فارغة. يمكنك بعد ذلك تنفيذ العمل اللازم في سلسلة محادثات أخرى واستخدام طريقة sendResponseApdu() المحدّدة في فئة HostApduService لإرسال الردّ عند الانتهاء.

يواصل Android إعادة توجيه وحدات APDU الجديدة من القارئ إلى خدمتك إلى أن يحدث أيّ مما يلي:

  • يرسل قارئ NFC وحدة APDU أخرى من النوع SELECT AID، ويحلّها نظام التشغيل إلى خدمة مختلفة.
  • انقطع اتصال NFC بين قارئ NFC وجهازك.

في كلتا الحالتين، يتم استدعاء تنفيذ onDeactivated() لفئتك باستخدام وسيطة تشير إلى أي من الحالتين حدثت.

إذا كنت تعمل مع بنية أساسية حالية لأجهزة القراءة، عليك تنفيذ بروتوكول مستوى التطبيق الحالي الذي تتوقّعه أجهزة القراءة في خدمة HCE.

إذا كنت تنشر بنية أساسية جديدة للقارئ تتحكّم فيها أيضًا، يمكنك تحديد البروتوكول وتسلسل APDU الخاصَّين بك. حاوِل الحدّ من عدد وحدات APDU وحجم البيانات التي يتم تبادلها، ما يضمن عدم اضطرار المستخدمين إلى وضع أجهزتهم فوق قارئ NFC لفترة طويلة. ويبلغ الحد الأعلى المعقول حوالي 1 كيلوبايت من البيانات، والتي يمكن عادةً تبادلها في غضون 300 ملي ثانية.

بيان بيان الخدمة وتسجيل AID

يجب الإعلان عن الخدمة في ملف البيان كالمعتاد، ولكن يجب إضافة بعض الأجزاء الإضافية إلى بيان الخدمة أيضًا:

  1. لإعلام المنصة بأنّها خدمة وظيفة محاكاة البطاقة المُضيفة (HCE) تستخدم واجهة HostApduService، أضِف intent filter لإجراء SERVICE_INTERFACE إلى بيان الخدمة.

  2. لإعلام المنصة بمجموعات معرّفات التطبيقات التي تطلبها هذه الخدمة، يجب تضمين علامة SERVICE_META_DATA <meta-data> في بيان الخدمة، مع الإشارة إلى مورد XML يتضمّن معلومات إضافية حول خدمة HCE.

  3. اضبط السمة android:exported على true، واطلب إذن android.permission.BIND_NFC_SERVICE في بيان الخدمة. يضمن الإجراء الأول إمكانية ربط الخدمة بالتطبيقات الخارجية. بعد ذلك، يفرض الأخير أنّه لا يمكن ربط خدمتك إلا بالتطبيقات الخارجية التي لديها إذن android.permission.BIND_NFC_SERVICE. بما أنّ android.permission.BIND_NFC_SERVICE هو إذن تابع لنظام التشغيل، يفرض هذا الإذن بشكل فعّال أن يتم ربط نظام التشغيل Android فقط بخدمتك.

في ما يلي مثال على تعريف بيان HostApduService:

<service android:name=".MyHostApduService" android:exported="true"
         android:permission="android.permission.BIND_NFC_SERVICE">
    <intent-filter>
        <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE"/>
    </intent-filter>
    <meta-data android:name="android.nfc.cardemulation.host_apdu_service"
               android:resource="@xml/apduservice"/>
</service>

تشير علامة البيانات الوصفية هذه إلى ملف apduservice.xml. في ما يلي مثال على ملف يتضمّن بيانًا واحدًا لمجموعة AID يحتوي على معرّفَي AID خاصَّين:

<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
           android:description="@string/servicedesc"
           android:requireDeviceUnlock="false">
    <aid-group android:description="@string/aiddescription"
               android:category="other">
        <aid-filter android:name="F0010203040506"/>
        <aid-filter android:name="F0394148148100"/>
    </aid-group>
</host-apdu-service>

يجب أن تحتوي علامة <host-apdu-service> على سمة <android:description> تتضمّن وصفًا سهل الاستخدام للخدمة التي يمكنك عرضها في واجهة مستخدم التطبيق. يمكنك استخدام السمة requireDeviceUnlock لتحديد أنّه يجب فتح قفل الجهاز قبل استدعاء هذه الخدمة لمعالجة وحدات APDU.

يجب أن تحتوي العلامة <host-apdu-service> على علامة <aid-group> واحدة أو أكثر. يجب أن تنفّذ كل علامة <aid-group> ما يلي:

  • يجب أن تحتوي على سمة android:description تتضمّن وصفًا سهل الاستخدام لمجموعة AID، ومناسبًا للعرض في واجهة المستخدم.
  • يجب ضبط سمة android:category للإشارة إلى الفئة التي تنتمي إليها مجموعة AID، مثل ثوابت السلسلة المحدّدة بواسطة CATEGORY_PAYMENT أو CATEGORY_OTHER.
  • تحتوي على علامة <aid-filter> واحدة أو أكثر، وتتضمّن كل علامة رقم تعريف إعلان واحدًا. حدِّد معرّف التطبيق بنظام العد الستة عشري، وتأكَّد من أنّه يحتوي على عدد زوجي من الأحرف.

يجب أن يحصل تطبيقك أيضًا على إذن NFC للتسجيل كخدمة HCE.

حلّ التعارض في AID

يمكن تثبيت عدة مكوّنات من HostApduService على جهاز واحد، ويمكن تسجيل رقم تعريف التطبيق نفسه من خلال أكثر من خدمة واحدة. يحدّد Android الخدمة التي سيتم استدعاؤها باتّباع الخطوات التالية:

  1. إذا كان تطبيق المحفظة التلقائي الذي اختاره المستخدم قد سجّل معرّف AID، يتم استدعاء هذا التطبيق.
  2. إذا لم يسجّل تطبيق المحفظة التلقائي معرّف التطبيق، يتم استدعاء الخدمة التي سجّلت معرّف التطبيق.
  3. إذا سجّلت أكثر من خدمة معرّف AID، يطلب Android من المستخدم اختيار الخدمة التي يريد استدعاءها.

تفضيل الخدمة التي تعمل في المقدّمة

يمكن للتطبيقات التي تعمل في المقدّمة استدعاء setPreferredService لتحديد خدمة محاكاة البطاقة التي يجب تفضيلها أثناء تشغيل نشاط معيّن في المقدّمة. يؤدي هذا الإعداد المفضّل للتطبيق الذي يعمل في المقدّمة إلى إلغاء حلّ التعارض في AID. يُنصح باتّباع هذه الممارسة عندما يتوقّع التطبيق أنّ المستخدم قد يستخدم ميزة محاكاة بطاقة NFC.

‫Android 13 والإصدارات الأحدث

لتناسب قائمة اختيار طريقة الدفع التلقائية في واجهة مستخدم الإعدادات بشكل أفضل، يمكنك تعديل متطلبات البانر إلى رمز مربّع. من الأفضل أن يكون مطابقًا لتصميم رمز مشغّل التطبيقات. يؤدي هذا التعديل إلى مزيد من الاتساق ومظهر أكثر أناقة.

الإصدار 12 من نظام التشغيل Android والإصدارات الأقدم

اضبط حجم بانر الخدمة على 260×96 بكسل مستقل الكثافة، ثم اضبط حجم بانر الخدمة في ملف XML للبيانات الوصفية من خلال إضافة السمة android:apduServiceBanner إلى علامة <host-apdu-service> التي تشير إلى المورد القابل للرسم. فيما يلي مثال:

<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
        android:description="@string/servicedesc"
        android:requireDeviceUnlock="false"
        android:apduServiceBanner="@drawable/my_banner">
    <aid-group android:description="@string/aiddescription"
               android:category="payment">
        <aid-filter android:name="F0010203040506"/>
        <aid-filter android:name="F0394148148100"/>
    </aid-group>
</host-apdu-service>

تطبيقات المحفظة

يتضمّن الإصدار 15 من Android والإصدارات الأحدث دورًا تلقائيًا لتطبيق المحفظة يمكن للمستخدم اختياره من خلال الانتقال إلى الإعدادات > التطبيقات > التطبيقات التلقائية. يحدّد هذا الإعداد تطبيق المحفظة التلقائي الذي يتم استخدامه عند النقر على محطة دفع. يعتبر Android خدمات HCE التي أعلنت عن مجموعة AID مع فئة الدفع على أنّها تطبيقات محفظة.

التحقّق مما إذا كان تطبيقك هو تطبيق المحفظة التلقائي

يمكن للتطبيقات التحقّق مما إذا كانت هي تطبيق المحفظة التلقائي من خلال تمرير RoleManager.ROLE_WALLET إلى RoleManager.isRoleHeld().

إذا لم يكن تطبيقك هو التطبيق التلقائي، يمكنك طلب دور المحفظة التلقائية من خلال تمرير RoleManager.ROLE_WALLET إلى RoleManager.createRequestRoleIntent().

مواد العرض المطلوبة لتطبيقات المحفظة

لتقديم تجربة مستخدم أكثر جاذبية من الناحية المرئية، يجب أن توفّر تطبيقات محفظة HCE بانر للخدمة.

وضع المراقبة

يقدّم Android 15 ميزة وضع المراقبة. عند تفعيل "وضع المراقبة"، يسمح للجهاز بمراقبة حلقات استطلاع NFC وإرسال إشعارات بشأنها إلى مكوّنات HostApduService المناسبة حتى تتمكّن من الاستعداد للتفاعل مع محطة NFC معيّنة. يمكن لـ HostApduService ضبط الجهاز على "وضع المراقبة" من خلال تمرير true إلى setObserveModeEnabled(). يؤدي ذلك إلى توجيه حزمة NFC إلى عدم السماح بالمعاملات عبر اتصال NFC، وبدلاً من ذلك، مراقبة حلقات الاستطلاع بشكل سلبي.

فلاتر حلقة الاستطلاع

يمكنك تسجيل فلاتر حلقة الاستطلاع لـ HostApduService باستخدام إحدى الطريقتين التاليتين:

عندما يتطابق فلتر حلقة الاستطلاع مع إطارات استطلاع غير عادية، توجّه حزمة NFC إطارات الاستطلاع هذه إلى HostApduService المقابل من خلال استدعاء طريقة processPollingFrames() الخاصة به. يتيح ذلك للخدمة اتخاذ أي خطوات ضرورية لضمان استعداد المستخدم لإجراء المعاملة ونيته في ذلك، مثل مصادقة المستخدم. إذا كان قارئ NFC يستخدم فقط الإطارات العادية في حلقة الاستطلاع، فإنّ حزمة NFC توجّه إطارات الاستطلاع هذه إلى الخدمة المفضّلة التي تعمل في المقدّمة إذا كانت هذه الخدمة تعمل في المقدّمة أو إلى صاحب دور المحفظة التلقائي في الحالات الأخرى.

تتضمّن إشعارات إطارات الاستطلاع أيضًا قياسًا خاصًا بالمورّد لقوة المجال يمكنك استرداده من خلال طلب getVendorSpecificGain(). يمكن للمورّدين تقديم القياسات باستخدام مقياسهم الخاص طالما أنّه يتناسب مع بايت واحد.

الاستجابة لحلقات الاستطلاع والخروج من "وضع المراقبة"

عندما تكون الخدمة جاهزة لإجراء المعاملات، يمكنها الخروج من "وضع الملاحظة" من خلال تمرير false إلى setObserveModeEnabled(). ستسمح حزمة NFC بعد ذلك بمتابعة المعاملات.

يمكن أن تشير مكوّنات HostApduService إلى أنّه يجب تفعيل "وضع المراقبة" عندما تكون خدمة الدفع المفضّلة من خلال ضبط shouldDefaultToObserveMode على true في البيان أو من خلال طلب CardEmulation.setShouldDefaultToObserveModeForService().

HostApduService وOffHostApduService يمكن أيضًا أن يشير إلى أنّ فلاتر حلقة الاستطلاع التي تتطابق مع إطارات حلقة الاستطلاع المستلَمة يجب أن توقف تلقائيًا "وضع المراقبة" وتسمح بمواصلة المعاملات من خلال ضبط autoTransact على true في بيان PollingLoopFilter في ملف البيان.

تفضيل الخدمة التي تعمل في المقدّمة

يمكن للتطبيقات التي تعمل في المقدّمة استدعاء setPreferredService لتحديد خدمة محاكاة البطاقة التي يجب تفضيلها أثناء تشغيل نشاط معيّن في المقدّمة. يتجاهل هذا الإعداد المفضّل للتطبيق الذي يعمل في المقدّمة حالة "وضع المراقبة" للجهاز المقابلة لقيمة shouldDefaultToObserveMode لخدمة معيّنة، والتي يمكن ضبطها بإحدى الطرق التالية:

إيقاف الشاشة وسلوك شاشة القفل

يختلف سلوك خدمات HCE حسب إصدار Android الذي يعمل على الجهاز.

الإصدار 15 من نظام التشغيل Android والإصدارات الأحدث

إذا فعّل تطبيق المحفظة التلقائي "وضع المراقبة" على جهاز متوافق، سيتجاوز هذا التطبيق سلوك فتح القفل وإطفاء الشاشة، لأنّه يتحكّم في وقت تنفيذ المعاملة. قد تتطلّب بعض تطبيقات المحفظة فتح قفل الجهاز قبل إجراء المعاملة إذا لم يرصد "وضع المراقبة" نمطًا يمكن التعرّف عليه لحلقة الاستقصاء.

ننصح المطوّرين بالعمل مع أجهزة القراءة لإصدار أنماط حلقة استطلاع يمكن التعرّف عليها والتسجيل للتعامل مع هذه الأنماط من تطبيقاتهم.

الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث

في التطبيقات التي تستهدف الإصدار 12 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 31) والإصدارات الأحدث، يمكنك تفعيل الدفع من خلال الاتصال القصير المدى (NFC) بدون تشغيل شاشة الجهاز من خلال ضبط requireDeviceScreenOn على false.

الإصدار 10 من نظام التشغيل Android والإصدارات الأحدث

تتيح الأجهزة التي تعمل بنظام التشغيل Android 10 (مستوى واجهة برمجة التطبيقات 29) أو الإصدارات الأحدث استخدام ميزة تقنية الاتصال القصير المدى (NFC) الآمنة. عندما تكون ميزة "NFC الآمن" مفعّلة، لا تتوفّر جميع محاكيات البطاقات (التطبيقات المستضافة والتطبيقات غير المستضافة) عندما تكون شاشة الجهاز مطفأة. وعندما تكون ميزة "NFC الآمن" غير مفعّلة، تتوفّر التطبيقات غير المستضافة عندما تكون شاشة الجهاز مطفأة. يمكنك التحقّق من توفّر ميزة "NFC الآمن" باستخدام isSecureNfcSupported().

على الأجهزة التي تعمل بنظام التشغيل Android 10 والإصدارات الأحدث، تنطبق الوظيفة نفسها لضبط android:requireDeviceUnlock على true كما هو الحال مع الأجهزة التي تعمل بنظام التشغيل Android 9 والإصدارات الأقدم، ولكن فقط عند إيقاف ميزة "NFC الآمن". أي إذا كانت ميزة "NFC الآمن" مفعّلة، لا يمكن لخدمات HCE العمل من شاشة القفل بغض النظر عن إعداد android:requireDeviceUnlock.

الإصدار 9 من نظام التشغيل Android والإصدارات الأقدم

على الأجهزة التي تعمل بنظام التشغيل Android 9 (مستوى واجهة برمجة التطبيقات 28) والإصدارات الأقدم، يتم إيقاف وحدة التحكّم في NFC ومعالج التطبيقات تمامًا عند إيقاف شاشة الجهاز، وبالتالي لا تعمل خدمات HCE عندما تكون الشاشة مطفأة.

على نظام التشغيل Android 9 والإصدارات الأقدم، يمكن أن تعمل خدمات HCE من شاشة القفل. ومع ذلك، يتم التحكّم في ذلك من خلال السمة android:requireDeviceUnlock في علامة <host-apdu-service> لخدمة HCE. لا يُطلب فتح قفل الجهاز تلقائيًا، ويتم استدعاء الخدمة حتى إذا كان الجهاز مقفلاً.

إذا ضبطت السمة android:requireDeviceUnlock على true لخدمة HCE، سيطلب Android من المستخدم فتح قفل الجهاز في الحالات التالية:

  • ينقر المستخدم على قارئ NFC.
  • يختار قارئ NFC معرّف AID يتم تحليله إلى خدمتك.

بعد فتح القفل، يعرض Android مربّع حوار يطلب من المستخدم النقر مرة أخرى لإكمال المعاملة. هذا الإجراء ضروري لأنّ المستخدم قد يكون أبعد الجهاز عن قارئ NFC لفتح قفله.

التعايش مع بطاقات تتضمّن عنصرًا آمنًا

هذا القسم مخصّص للمطوّرين الذين نشروا تطبيقًا يعتمد على عنصر آمن لمحاكاة البطاقة. تم تصميم وظيفة محاكاة البطاقة المُضيفة (HCE) في Android لتعمل بالتوازي مع الطرق الأخرى لتنفيذ محاكاة البطاقة، بما في ذلك استخدام العناصر الآمنة.

يعتمد هذا التعايش على مبدأ يُعرف باسم توجيه AID. يحتفظ وحدة التحكّم في NFC بجدول توجيه يتكوّن من قائمة (محدودة) من قواعد التوجيه. تحتوي كل قاعدة توجيه على AID ووجهة. ويمكن أن تكون الوجهة إما وحدة المعالجة المركزية (CPU) المضيفة التي تعمل عليها تطبيقات Android أو عنصرًا آمنًا متصلاً.

عندما يرسل قارئ NFC وحدة APDU مع SELECT AID، يحلّلها جهاز التحكّم في NFC ويتحقّق مما إذا كانت معرّفات AID تتطابق مع أي معرّف AID في جدول التوجيه. وفي حال تطابقها، يتم إرسال وحدة APDU هذه وجميع وحدات APDU التالية لها إلى الوجهة المرتبطة بمعرّف AID، إلى أن يتم استلام وحدة APDU أخرى من نوع SELECT AID أو ينقطع اتصال NFC.

يوضّح الشكل 4 هذه البنية:

مخطّط بياني يوضّح قارئ NFC يتواصل مع كل من العنصر الآمن ووحدة المعالجة المركزية
الشكل 4 نظام Android يعمل مع كل من العنصر الآمن ووظيفة محاكاة البطاقة المُضيفة

عادةً ما تحتوي وحدة التحكّم في NFC أيضًا على مسار تلقائي لوحدات APDU. وعندما لا يتم العثور على معرّف AID في جدول التوجيه، يتم استخدام المسار التلقائي. على الرغم من أنّ هذا الإعداد قد يختلف من جهاز لآخر، يجب أن تضمن أجهزة Android توجيه معرّفات التطبيقات التي يسجّلها تطبيقك بشكل صحيح إلى المضيف.

لا داعي للقلق بشأن ضبط جدول التوجيه في تطبيقات Android التي تستخدم خدمة HCE أو عنصرًا آمنًا، لأنّ Android يتولّى ذلك تلقائيًا. يحتاج Android فقط إلى معرفة معرّفات التطبيقات التي يمكن معالجتها من خلال خدمات HCE وتلك التي يمكن معالجتها من خلال العنصر الآمن. يتم ضبط جدول التوجيه تلقائيًا استنادًا إلى الخدمات المثبّتة والخدمات التي ضبطها المستخدم كخدمات مفضّلة.

يوضّح القسم التالي كيفية تعريف معرّفات التطبيقات (AID) للتطبيقات التي تستخدم عنصرًا آمنًا لمحاكاة البطاقة.

تسجيل معرّف التطبيق (AID) للعنصر الآمن

يمكن للتطبيقات التي تستخدم عنصرًا آمنًا لمحاكاة البطاقات أن تعرّف عن خدمة خارج المضيف في ملف البيان الخاص بها. ويكون بيان هذه الخدمة مطابقًا تقريبًا لبيان خدمة HCE. الاستثناءات هي كما يلي:

  • يجب ضبط الإجراء المستخدَم في intent filter على SERVICE_INTERFACE.
  • يجب ضبط سمة اسم البيانات الوصفية على SERVICE_META_DATA.
  • يجب أن يستخدم ملف XML للبيانات الوصفية علامة الجذر <offhost-apdu-service>.

    <service android:name=".MyOffHostApduService" android:secureElementName="eSE"
           android:exported="true" android:permission="android.permission.BIND_NFC_SERVICE">
      <intent-filter>
          <action android:name="android.nfc.cardemulation.action.OFF_HOST_APDU_SERVICE"/>
      </intent-filter>
      <meta-data android:name="android.nfc.cardemulation.off_host_apdu_service"
                 android:resource="@xml/apduservice"/>
    </service>

في ما يلي مثال على ملف apduservice.xml المقابل الذي يسجّل معرّفَي تطبيق:

<offhost-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
           android:description="@string/servicedesc">
    <aid-group android:description="@string/subscription" android:category="other">
        <aid-filter android:name="F0010203040506"/>
        <aid-filter android:name="F0394148148100"/>
    </aid-group>
</offhost-apdu-service>

لا تنطبق السمة android:requireDeviceUnlock على الخدمات غير المستضافة، لأنّ وحدة المعالجة المركزية (CPU) للمضيف لا تشارك في المعاملة، وبالتالي لا يمكنها منع العنصر الآمن من تنفيذ المعاملات عندما يكون الجهاز مقفلاً.

سمة android:apduServiceBanner مطلوبة للخدمات التي لا تستضيفها الأجهزة والتي تُعدّ تطبيقات دفع ويمكن اختيارها كتطبيق دفع تلقائي.

استدعاء خدمة خارج المضيف

لا يبدأ Android أبدًا أو يرتبط بخدمة تم تعريفها على أنّها "خارج المضيف"، لأنّ المعاملات الفعلية يتم تنفيذها من خلال العنصر الآمن وليس من خلال خدمة Android. يسمح بيان الخدمة للتطبيقات فقط بتسجيل معرّفات التطبيقات (AIDs) الموجودة في العنصر الآمن.

وظيفة محاكاة البطاقة المُضيفة (HCE) والأمان

توفّر بنية HCE جزءًا أساسيًا من الأمان: نظرًا لأنّ خدمتك محمية بإذن النظام BIND_NFC_SERVICE، لا يمكن إلا لنظام التشغيل الربط بخدمتك والتواصل معها. يضمن ذلك أنّ أي وحدة APDU تتلقّاها هي في الواقع وحدة APDU تلقّاها نظام التشغيل من وحدة التحكّم في NFC، وأنّ أي وحدة APDU ترسلها مرة أخرى تذهب فقط إلى نظام التشغيل، والذي بدوره يعيد توجيه وحدات APDU مباشرةً إلى وحدة التحكّم في NFC.

المشكلة الأخيرة المتبقية هي من أين تحصل على بياناتك التي يرسلها تطبيقك إلى قارئ NFC. تم فصل هذا الإجراء عن قصد في تصميم وظيفة محاكاة البطاقة المُضيفة (HCE)، إذ لا يهمّ مصدر البيانات، بل يهمّ فقط التأكّد من نقلها بأمان إلى وحدة التحكّم في تقنية NFC وإلى قارئ NFC.

لتخزين البيانات التي تريد إرسالها من خدمة HCE واستردادها بأمان، يمكنك مثلاً الاعتماد على وضع الحماية لتطبيقات Android الذي يعزل بيانات تطبيقك عن التطبيقات الأخرى. لمزيد من التفاصيل حول أمان Android، يُرجى الاطّلاع على نصائح الأمان.

مَعلمات البروتوكول وتفاصيله

هذا القسم مخصّص للمطوّرين الذين يريدون فهم مَعلمات البروتوكول التي تستخدمها أجهزة HCE أثناء مرحلتَي منع التصادم والتفعيل في بروتوكولات NFC. يتيح ذلك إنشاء بنية أساسية للقارئ متوافقة مع أجهزة Android التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE).

بروتوكول Nfc-A (ISO/IEC 14443 من النوع A) لمنع التصادم والتفعيل

كجزء من تفعيل بروتوكول Nfc-A، يتم تبادل إطارات متعددة.

في الجزء الأول من عملية التبادل، يعرض جهاز HCE معرّف UID الخاص به، ويُفترض أن يكون لأجهزة HCE معرّف UID عشوائي. هذا يعني أنّه عند كل نقرة، يكون معرّف UID الذي يظهر للقارئ هو معرّف UID تم إنشاؤه عشوائيًا. لهذا السبب، يجب ألا تعتمد قارئات NFC على المعرّف الفريد لأجهزة HCE كشكل من أشكال المصادقة أو تحديد الهوية.

يمكن لقارئ NFC بعد ذلك اختيار جهاز HCE عن طريق إرسال أمر SEL_REQ. يجب أن يتضمّن ردّ SEL_RES من جهاز HCE على الأقل البت السادس (0x20)، ما يشير إلى أنّ الجهاز متوافق مع بروتوكول ISO-DEP. يُرجى العِلم أنّه يمكن أيضًا ضبط وحدات بت أخرى في SEL_RES، ما يشير مثلاً إلى التوافق مع بروتوكول NFC-DEP (p2p). بما أنّه قد يتم ضبط وحدات بت أخرى، على أجهزة القراءة التي تريد التفاعل مع أجهزة HCE التحقّق صراحةً من وحدة البت السادسة فقط، وعدم مقارنة SEL_RES الكاملة بقيمة 0x20.

تفعيل ISO-DEP

بعد تفعيل بروتوكول Nfc-A، يبدأ قارئ NFC في تفعيل بروتوكول ISO-DEP. يرسل أمر RATS (طلب الإجابة عن الاختيار). تنشئ وحدة التحكّم في تكنولوجيا NFC استجابة RATS، وهي ATS، ولا يمكن ضبط ATS من خلال خدمات HCE. ومع ذلك، يجب أن تستوفي عمليات تنفيذ وظيفة HCE متطلبات &quot;منتدى NFC&quot; لاستجابة ATS، حتى تتمكّن قارئات NFC من الاعتماد على هذه المَعلمات التي يتم ضبطها وفقًا لمتطلبات &quot;منتدى NFC&quot; لأي جهاز HCE.

يقدّم القسم أدناه مزيدًا من التفاصيل حول وحدات البايت الفردية لاستجابة ATS التي توفّرها وحدة التحكّم في NFC على جهاز HCE:

  • ‫TL: طول ردّ ATS يجب ألا يشير إلى طول أكبر من 20 بايت.
  • ‫T0: يجب ضبط وحدات البت 5 و6 و7 على جميع الأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE)، ما يشير إلى أنّ TA(1)‎ وTB(1)‎ وTC(1)‎ مضمّنة في استجابة ATS. تشير وحدات البت من 1 إلى 4 إلى FSCI، وتشفير الحد الأقصى لحجم الإطار. على الأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE)، يجب أن تكون قيمة FSCI بين 0 و8 ساعات.
  • ‫T(A)1: يحدّد معدّلات نقل البيانات بين القارئ والمحاكي، وما إذا كان يمكن أن تكون غير متماثلة. لا توجد متطلبات أو ضمانات لمعدل نقل البيانات للأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE).
  • ‫T(B)1: تشير وحدات البت من 1 إلى 4 إلى عدد صحيح لوقت حماية إطار بدء التشغيل (SFGI). على الأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE)، يجب أن تكون قيمة SFGI أقل من أو تساوي 8 ساعات. تشير وحدات البت من 5 إلى 8 إلى عدد صحيح لوقت انتظار الإطار (FWI) وترميز وقت انتظار الإطار (FWT). على الأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE)، يجب أن تكون قيمة FWI أقل من أو تساوي 8 ساعات.
  • ‫T(C)1: يشير البت 5 إلى إتاحة "ميزات البروتوكول المتقدّمة". قد تتيح الأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE) "ميزات البروتوكول المتقدّمة" أو لا تتيحها. يشير البت 2 إلى دعم DID. قد تتيح الأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE) ميزة DID أو لا تتيحها. يشير البت 1 إلى إتاحة NAD. يجب ألا تتيح الأجهزة التي تستخدم وظيفة HCE استخدام NAD، ويجب ضبط البت 1 على صفر.
  • بايتات السجلّ: قد تعرض أجهزة HCE ما يصل إلى 15 بايت من السجلّ. يجب ألا تضع أجهزة قراءة NFC التي ترغب في التفاعل مع خدمات HCE أي افتراضات حول محتوى وحدات البايت السابقة أو وجودها.

يُرجى العِلم أنّ العديد من الأجهزة التي تستخدم وظيفة محاكاة البطاقة المُضيفة (HCE) من المرجّح أن تكون متوافقة مع متطلبات البروتوكول التي حدّدتها شبكات الدفع الموحّدة في EMVCo في مواصفات "بروتوكول الاتصال بدون تلامس الأجهزة". ويشمل ذلك على وجه الخصوص:

  • يجب أن يتراوح FSCI في T0 بين ساعتَين و8 ساعات.
  • يجب ضبط T(A)1 على 0x80، ما يشير إلى أنّ معدل نقل البيانات الذي يبلغ 106 كيلوبت في الثانية هو فقط المتوافق، وأنّ معدلات نقل البيانات غير المتماثلة بين القارئ والمحاكي غير متوافقة.
  • يجب أن يكون مؤشر FWI في T(B)1 أقل من أو يساوي 7 ساعات.

تبادل بيانات APDU

كما ذكرنا سابقًا، لا تتيح عمليات تنفيذ وظيفة محاكاة البطاقة المُضيفة (HCE) سوى قناة منطقية واحدة. لا تنجح محاولة اختيار التطبيقات على قنوات منطقية مختلفة على جهاز يستخدم وظيفة محاكاة البطاقة المُضيفة (HCE).