ما هو رقم تعريف المثيل؟

تحذير: تم إيقاف واجهة برمجة التطبيقات Instance ID API نهائيًا. إذا كنت بحاجة إلى الوصول إلى معرّفات فريدة لعمليات تثبيت التطبيق، استخدِم واجهة برمجة التطبيقات عمليات تثبيت Firebase. اطّلِع أيضًا على عمليات تثبيت Firebase ورقم تعريف المثيل. لا تزال واجهة برمجة التطبيقات لإدارة المواضيع من جهة الخادم متاحة.

الميزات الرئيسية

بالإضافة إلى توفير أرقام تعريف فريدة للمصادقة، يمكن أن يُنشئ معرّف المثيل رموز أمان لاستخدامها مع خدمات أخرى. تشمل الميزات الأخرى ما يلي:

إنشاء الرموز الأمنية

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

التحقّق من أصالة التطبيق

أرسِل علامات تعريف مثيل التطبيق إلى خادمك واستخدِم خدمة مثيل التطبيق للتحقّق من اسم حزمة التطبيق والتحقّق مما إذا كان يحتوي على توقيع صالح. يساعد إثبات صحة الرموز المميّزة باستخدام خدمة Instance ID Cloud في تحديد التطبيقات المعروفة. لتقليل التكلفة والاتصالات المتكرّرة ذهابًا وإيابًا، يمكنك ضبط الخادم لتخزين هذه الرموز المميّزة كي لا يكون عليك التحقّق منها إلا مرة واحدة. في حال حدوث مشكلة أمنية، يمكن لتطبيقك حذف الرموز المميّزة أو رقم تعريف المثيل نفسه وإنشاء رموز جديدة. بالإضافة إلى ذلك، يُجري خادم أرقام تعريف المثيل عملية إعادة تحميل للرمز المميّز أو رقم تعريف المثيل إذا رصد أخطاء أو مشاكل في الأمان.

ملاحظة: لا تتوفّر ميزة التحقّق من أصالة التطبيق إلا للتطبيقات التي يوزّعها Google Play.

التأكّد من أنّ جهاز التطبيق نشط

يمكن لخادم "رقم تعريف الإصدار" إعلامك بآخر مرة تم فيها استخدام الجهاز الذي تم تثبيت تطبيقك عليه. استخدِم هذه الميزة لتحديد ما إذا كنت تريد الاحتفاظ بالبيانات من تطبيقك أو إرسال رسالة فورية لإعادة التفاعل مع المستخدمين.

تحديد التطبيقات وتتبُّعها

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

مراحل نشاط رقم تعريف المثال

1. تُصدر خدمة "معرّف النسخة" InstanceID عندما يصبح تطبيقك متصلاً بالإنترنت. يستند InstanceID إلى مفتاحَين عام/خاص مع تخزين المفتاح الخاص على الجهاز المحلي والمفتاح العام المسجَّل في خدمة Instance ID.
2. يمكن لتطبيقك طلب InstanceID جديد كلما لزم الأمر باستخدام getID() الطريقة. ويمكن لتطبيقك تخزينها على خادمك إذا كان لديك خادم متوافق مع تطبيقك.
3. يمكن لتطبيقك طلب الرموز المميّزة من خدمة Instance ID حسب الحاجة باستخدام طريقة getToken()، ومثل InstanceID، يمكن لتطبيقك أيضًا تخزين الرموز المميّزة على خادمك الخاص. تنتمي جميع الرموز المميّزة التي تم إصدارها لتطبيقك إلى InstanceID الخاص بالتطبيق.
4. تكون الرموز المميّزة فريدة وآمنة، ولكن قد يحتاج تطبيقك أو خدمة Instance ID إلى إعادة تحميل الرموز المميّزة في حال حدوث مشكلة في الأمان أو عندما يزيل مستخدم تطبيقك ويعيد تثبيته أثناء استعادة الجهاز. يجب أن ينفِّذ تطبيقك معالجًا للطلبات من أجل الردّ على طلبات إعادة تحميل الرموز المميّزة من "خدمة أرقام تعريف النماذج".

تنفيذ العميل

يعمل معرّف الإصدار على نظامَي التشغيل Android وiOS. ويتطلّب كل منهما تضمين المكتبة المناسبة في تطبيق العميل. ويتطلّب Android استخدام خدمات Google Play. ستحتاج إلى رقم تعريف مشروع تم إنشاؤه من خلال Google Developers Console إذا كنت تنوي إنشاء الرموز المميّزة.

للحصول على تعليمات تفصيلية، يُرجى الاطّلاع على دليلَي التنفيذ Android وiOS.