تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الميزات الرئيسية
بالإضافة إلى توفير معرّفات فريدة للمصادقة، يمكن أن تنشئ خدمة Instance ID رموزًا مميّزة للأمان لاستخدامها مع خدمات أخرى. تشمل الميزات الأخرى ما يلي:
إنشاء رموز أمان
توفّر خدمة Instance ID واجهة برمجة تطبيقات بسيطة لإنشاء رموز أمان تمنح الجهات الخارجية الإذن بالوصول إلى الموارد المُدارة من جهة الخادم في تطبيقك.
التحقّق من صحة التطبيق
إرسال رموز مميّزة لمعرّف مثيل إلى خادمك واستخدام خدمة معرّف المثيل
للتحقّق من اسم حزمة التطبيق ومعرفة ما إذا كان يتضمّن توقيعًا صالحًا
يساعد التحقّق من الرموز المميّزة باستخدام خدمة Instance ID Cloud في تحديد التطبيقات المعروفة. للحدّ من التكلفة والاتصالات المتكرّرة ذهابًا وإيابًا، اضبط خادمك لتخزين هذه الرموز المميزة حتى لا تحتاج إلى إجراء عملية التحقّق إلا مرة واحدة.
في حال وجود مشكلة متعلّقة بالأمان، يمكن لتطبيقك حذف الرموز المميزة أو رقم تعريف المثيل نفسه وإنشاء رموز جديدة. بالإضافة إلى ذلك، يبدأ خادم رقم تعريف المثيل عملية إعادة تحميل الرمز المميّز أو رقم تعريف المثيل إذا رصد أخطاء أو مشاكل أمنية.
التأكّد من أنّ جهاز التطبيق نشط
يمكن لخادم Instance ID إخبارك بآخر مرة تم فيها استخدام الجهاز الذي تم تثبيت تطبيقك عليه. استخدِم هذه الميزة لتحديد ما إذا كنت تريد الاحتفاظ بالبيانات من تطبيقك أو إرسال رسالة فورية لإعادة التفاعل مع المستخدمين.
تحديد التطبيقات وتتبُّعها
معرّف المثيل فريد على مستوى جميع مثيلات التطبيق في جميع أنحاء العالم، لذا يمكن لقاعدة البيانات استخدام هذا المعرّف لتحديد مثيلات التطبيق وتتبُّعها بشكل فريد. يمكن لرمزك من جهة الخادم التحقّق من خلال خدمة Instance ID السحابية من أنّ معرّف المثيل أصلي وهو المعرّف نفسه الذي سجّله التطبيق الأصلي لدى خادمك. للحفاظ على الخصوصية، يمكن لتطبيقك حذف رقم تعريف مثيل حتى لا يرتبط بأي سجلّ في قاعدة البيانات. في المرة التالية التي يستدعي فيها تطبيقك Instance ID، سيحصل على Instance ID جديد تمامًا بدون أي صلة بالمعرّف السابق.
مراحل نشاط رقم تعريف المثيل
تُصدر خدمة Instance ID InstanceID عندما يتصل تطبيقك بالإنترنت.
يتم الاحتفاظ InstanceID باستخدام زوج مفتاح عام/خاص، ويتم تخزين المفتاح الخاص على الجهاز المحلي وتسجيل المفتاح العام في خدمة Instance ID.
يمكن لتطبيقك طلب InstanceID جديد عند الحاجة باستخدام طريقة getID(). يمكن لتطبيقك تخزينها على خادمك إذا كان لديك خادم متوافق مع تطبيقك.
يمكن لتطبيقك طلب رموز مميّزة من خدمة Instance ID حسب الحاجة
باستخدام طريقة getToken()، ويمكن لتطبيقك أيضًا، مثل InstanceID، تخزين
الرموز المميزة على الخادم الخاص بك. جميع الرموز المميزة الصادرة لتطبيقك تنتمي إلى InstanceID التطبيق.
تكون الرموز المميّزة فريدة وآمنة، ولكن قد يحتاج تطبيقك أو خدمة Instance ID إلى إعادة إنشاء الرموز المميّزة في حال حدوث مشكلة أمان أو عندما يلغي المستخدم تثبيت تطبيقك ثم يعيد تثبيته أثناء استعادة الجهاز. يجب أن ينفّذ تطبيقك أداة معالجة للردّ على طلبات إعادة تحميل الرموز المميزة من خدمة Instance ID.
تنفيذ العميل
يعمل رقم تعريف المثيل على كلّ من Android وiOS. ويتطلّب كل منهما تضمين المكتبة المناسبة في تطبيق العميل. ويتطلّب نظام التشغيل Android توفُّر خدمات Google Play. ستحتاج إلى رقم تعريف مشروع تم إنشاؤه
من خلال Google Developers Console إذا كنت تنوي
إنشاء رموز مميزة.
للحصول على تعليمات مفصّلة، يُرجى الاطّلاع على دليلَي التنفيذ Android وiOS.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003cstrong\u003eWarning:\u003c/strong\u003e The Instance ID API is deprecated; for unique app installation identifiers, use the Firebase installations API instead.\u003c/p\u003e\n"],["\u003cp\u003eInstance ID offers key features like generating security tokens, verifying app authenticity, confirming app device activity, and identifying/tracking apps.\u003c/p\u003e\n"],["\u003cp\u003eInstance ID has a lifecycle involving issuing an ID, requesting fresh IDs and tokens, storing them on the server (optional), and handling token refreshes.\u003c/p\u003e\n"],["\u003cp\u003eClient implementation requires including the appropriate library and potentially a Project ID for token generation.\u003c/p\u003e\n"],["\u003cp\u003eFor detailed instructions, refer to the Android and iOS implementation guides.\u003c/p\u003e\n"]]],[],null,["# What is Instance ID?\n\n| **Warning:** The Instance ID API is deprecated. If you need to access unique app installation identifiers, use the [Firebase installations](//firebase.google.com/docs/projects/manage-installations) API. See also [Firebase installations and Instance ID](//firebase.google.com/docs/projects/manage-installations#fid-iid). The [server-side topic management API](https://developers.google.com/instance-id/reference/server#create_relationship_maps_for_app_instances) is still available.\n\nKey features\n------------\n\nIn addition to providing unique IDs for authentication, Instance ID\ncan generate security tokens for use with other services. Other features\ninclude:\n\n### Generate Security Tokens\n\n: Instance ID provides a simple API to generate security tokens that\n authorize third parties to access your app's server side managed resources.\n\n### Verify app authenticity\n\n: Pass Instance ID tokens to your server and use the Instance ID\n service to verify the app package name and check if it has a valid signature.\n Verifying tokens with the Instance ID Cloud Service helps identify known\n apps. To reduce cost and redundant round trip communications, configure your\n server to store these tokens so the check is needed only once.\n In the event of a security concern, your app can delete tokens, or\n Instance ID itself, and generate new ones. In addition, the\n Instance ID server initiates token or Instance ID refresh if it\n detects bugs or security issues.\n\n### Confirm app device is active\n\n: The Instance ID server can tell you when the device on which your app\n is installed was last used. Use this to decide whether to keep data from your\n app or send a push message to reengage with your users.\n\n### Identify and track apps\n\n: Instance ID is unique across all app instances across the world, so\n your database can use it to uniquely identify and track app instances. Your\n server-side code can verify, via the Instance ID cloud service, that an\n Instance ID is genuine and is the same ID as the original app that\n registered with your server. For privacy, your app can delete an Instance ID so\n it is no longer associated with any history in the database. The next time your\n app calls Instance ID it will get an entirely new Instance ID with no\n relationship to its previous one.\n\nInstance ID lifecycle\n---------------------\n\n1. The Instance ID service issues an `InstanceID` when your app comes online. The `InstanceID` is backed by a public/private key pair with the private key stored on the local device and the public key registered with the Instance ID service.\n2. Your app can request a fresh `InstanceID` whenever needed using the `getID()` method. Your app can store it on your server if you have one that supports your app.\n3. Your app can request tokens from the Instance ID service as needed using the `getToken()` method, and like `InstanceID`, your app can also store tokens on your own server. All tokens issued to your app belong to the app's `InstanceID`.\n4. Tokens are unique and secure, but your app or the Instance ID service may need to refresh tokens in the event of a security issue or when a user uninstalls and reinstalls your app during device restoration. Your app must implement a listener to respond to token refresh requests from the Instance ID service.\n\nClient implementation\n---------------------\n\nInstance ID runs on both Android and iOS. Each requires you to include\nthe appropriate library in your client app. Android requires\n[Google Play Services](https://developer.android.com/google/play-services/index.html). You will need a Project ID generated\nby the [](/console/help/new)[Google Developers Console](https://console.developers.google.com/project) if you intend\nto generate tokens.\n\nFor detailed instructions, see the [Android](/instance-id/guides/android-implementation)\nand [iOS](/instance-id/guides/ios-implementation) implementation guides."]]
