Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Temel özellikler
Instance ID, kimlik doğrulama için benzersiz kimlikler sağlamanın yanı sıra diğer hizmetlerle kullanılmak üzere güvenlik jetonları da oluşturabilir. Diğer özellikler:
Güvenlik jetonları oluşturma
Instance ID, üçüncü tarafların uygulamanızın sunucu tarafında yönetilen kaynaklarına erişmesine yetki veren güvenlik jetonları oluşturmak için basit bir API sağlar.
Uygulamanın gerçekliğini doğrulama
Sunucunuza örnek kimliği jetonları iletin ve uygulama paket adını doğrulamak, geçerli bir imzaya sahip olup olmadığını kontrol etmek için örnek kimliği hizmetini kullanın.
Jetonları örnek kimliği Cloud Hizmeti ile doğrulama, bilinen uygulamaların tanımlanmasına yardımcı olur. Maliyeti ve gereksiz gidiş dönüş iletişimlerini azaltmak için sunucunuzu bu jetonları saklayacak şekilde yapılandırın. Böylece kontrol yalnızca bir kez yapılır.
Güvenlikle ilgili bir sorun olması durumunda uygulamanız jetonları veya örnek kimliğin kendisini silebilir ve yenilerini oluşturabilir. Ayrıca,
örnek kimliği sunucusu, hataları veya güvenlik sorunlarını tespit ederse jeton ya da örnek kimliği yenileme işlemini başlatır.
Uygulama cihazının etkin olduğunu onaylayın
Instance ID sunucusu, uygulamanızın yüklü olduğu cihazın en son ne zaman kullanıldığını size söyleyebilir. Uygulamanızdaki verileri saklayıp saklamayacağınıza veya kullanıcılarınızla yeniden etkileşim kurmak için push mesajı gönderip göndermeyeceğinize karar vermek için bu bilgileri kullanın.
Uygulamaları tanımlama ve izleme
Örnek kimliği, dünya genelindeki tüm uygulama örnekleri için benzersizdir. Bu nedenle, veritabanınız uygulama örneklerini benzersiz şekilde tanımlamak ve izlemek için bu kimliği kullanabilir. Sunucu tarafı kodunuz, Instance ID bulut hizmeti aracılığıyla bir Instance ID'nin orijinal olduğunu ve sunucunuza kaydedilen orijinal uygulamayla aynı kimlik olduğunu doğrulayabilir. Uygulamanız, gizlilik nedeniyle bir örnek kimliğini silebilir. Böylece örnek kimliği, veritabanındaki herhangi bir geçmişle ilişkilendirilmez. Uygulamanız bir sonraki seferde örnek kimliğini çağırdığında, öncekiyle ilişkisi olmayan tamamen yeni bir örnek kimliği alır.
Örnek kimliği yaşam döngüsü
Örnek Kimliği hizmeti, uygulamanız internete bağlandığında InstanceID yayınlar.
InstanceID, özel anahtarın yerel cihazda saklandığı ve ortak anahtarın örnek kimliği hizmetine kaydedildiği bir herkese açık/özel anahtar çiftiyle desteklenir.
Uygulamanız, getID() yöntemini kullanarak gerektiğinde yeni bir InstanceID isteyebilir. Uygulamanız, destekleyen bir sunucunuz varsa bu bilgiyi sunucunuzda saklayabilir.
Uygulamanız, getToken() yöntemini kullanarak gerektiğinde Instance ID hizmetinden jeton isteyebilir ve InstanceID gibi, jetonları kendi sunucunuzda da depolayabilir. Uygulamanıza verilen tüm jetonlar, uygulamanın InstanceID'ına aittir.
Jetonlar benzersiz ve güvenlidir ancak güvenlik sorunu olması durumunda veya kullanıcı, cihazı geri yüklerken uygulamanızı kaldırıp yeniden yüklediğinde uygulamanızın ya da Instance ID hizmetinin jetonları yenilemesi gerekebilir. Uygulamanız, Instance ID hizmetinden gelen jeton yenileme isteklerine yanıt vermek için bir dinleyici uygulamalıdır.
İstemci uygulaması
Örnek kimliği hem Android hem de iOS'te çalışır. Her biri, istemci uygulamanıza uygun kitaplığı eklemenizi gerektirir. Android için Google Play Hizmetleri gerekir. Jeton oluşturmayı planlıyorsanız Google Developers Console tarafından oluşturulan bir proje kimliğine ihtiyacınız olacaktır.
Ayrıntılı talimatlar için Android ve iOS uygulama kılavuzlarına bakın.
[null,null,["Son güncelleme tarihi: 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."]]
