Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Fitur utama
Selain menyediakan ID unik untuk autentikasi, ID Instance
dapat membuat token keamanan untuk digunakan dengan layanan lain. Fitur lainnya
mencakup:
Membuat Token Keamanan
ID Instance menyediakan API sederhana untuk membuat token keamanan yang
mengizinkan pihak ketiga mengakses resource yang dikelola sisi server aplikasi Anda.
Memverifikasi keaslian aplikasi
Teruskan token Instance ID ke server Anda dan gunakan layanan Instance ID untuk memverifikasi nama paket aplikasi dan memeriksa apakah aplikasi memiliki tanda tangan yang valid.
Memverifikasi token dengan Instance ID Cloud Service membantu mengidentifikasi aplikasi yang dikenal. Untuk mengurangi biaya dan komunikasi pulang pergi yang berlebihan, konfigurasi server Anda untuk menyimpan token ini sehingga pemeriksaan hanya diperlukan satu kali.
Jika ada masalah keamanan, aplikasi Anda dapat menghapus token, atau
ID Instance itu sendiri, dan membuat yang baru. Selain itu, server ID Instance memulai refresh token atau ID Instance jika mendeteksi bug atau masalah keamanan.
Mengonfirmasi bahwa perangkat aplikasi aktif
Server ID Instance dapat memberi tahu Anda kapan terakhir kali perangkat yang menginstal aplikasi Anda digunakan. Gunakan ini untuk memutuskan apakah akan menyimpan data dari aplikasi Anda atau mengirim pesan push untuk berinteraksi kembali dengan pengguna Anda.
Mengidentifikasi dan melacak aplikasi
ID Instance bersifat unik di semua instance aplikasi di seluruh dunia, sehingga database Anda dapat menggunakannya untuk mengidentifikasi dan melacak instance aplikasi secara unik. Kode
sisi server Anda dapat memverifikasi, melalui layanan cloud ID Instance, bahwa ID
Instance asli dan merupakan ID yang sama dengan aplikasi asli yang
terdaftar di server Anda. Untuk privasi, aplikasi Anda dapat menghapus ID Instance sehingga ID tersebut tidak lagi dikaitkan dengan histori apa pun di database. Lain kali aplikasi Anda memanggil ID Instance, aplikasi akan mendapatkan ID Instance yang benar-benar baru tanpa hubungan dengan ID sebelumnya.
Siklus proses ID instance
Layanan ID Instance mengeluarkan InstanceID saat aplikasi Anda online.
InstanceID didukung oleh pasangan kunci publik/pribadi dengan kunci pribadi yang disimpan
di perangkat lokal dan kunci publik yang terdaftar di layanan ID Instance.
Aplikasi Anda dapat meminta InstanceID baru kapan pun diperlukan menggunakan metode getID(). Aplikasi Anda dapat menyimpannya di server Anda jika Anda memiliki server yang mendukung aplikasi Anda.
Aplikasi Anda dapat meminta token dari layanan ID Instance sesuai kebutuhan
menggunakan metode getToken(), dan seperti InstanceID, aplikasi Anda juga dapat menyimpan
token di server Anda sendiri. Semua token yang dikeluarkan untuk aplikasi Anda adalah milik
InstanceID aplikasi.
Token bersifat unik dan aman, tetapi aplikasi Anda atau layanan ID Instance mungkin perlu memperbarui token jika terjadi masalah keamanan atau saat pengguna meng-uninstal dan menginstal ulang aplikasi Anda selama pemulihan perangkat. Aplikasi Anda harus menerapkan pemroses untuk merespons permintaan refresh token dari layanan ID Instance.
Implementasi klien
ID Instance berjalan di Android dan iOS. Setiap metode mengharuskan Anda menyertakan
library yang sesuai di aplikasi klien Anda. Android memerlukan
Layanan Google Play. Anda memerlukan ID Project yang dibuat
oleh Google Developers Console jika Anda ingin
membuat token.
Untuk petunjuk mendetail, lihat panduan penerapan Android dan iOS.
[null,null,["Terakhir diperbarui pada 2025-09-05 UTC."],[[["\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."]]
