Что такое идентификатор экземпляра?

Предупреждение: API Instance ID устарело. Если вам нужен доступ к уникальным идентификаторам установки приложений, используйте API Firebase installations . См. также Firebase installations and Instance ID . API управления темами на стороне сервера по-прежнему доступно.

Основные характеристики

Помимо предоставления уникальных идентификаторов для аутентификации, Instance ID может генерировать токены безопасности для использования с другими службами. Другие функции включают:

Генерация токенов безопасности

Instance ID предоставляет простой API для генерации токенов безопасности, которые разрешают третьим лицам доступ к управляемым ресурсам вашего приложения на стороне сервера.

Проверьте подлинность приложения

Передайте токены Instance ID на свой сервер и используйте службу Instance ID для проверки имени пакета приложения и проверки его действительной подписи. Проверка токенов с помощью облачной службы Instance ID помогает идентифицировать известные приложения. Чтобы сократить расходы и избыточные двусторонние коммуникации, настройте свой сервер для хранения этих токенов, чтобы проверка требовалась только один раз. В случае возникновения проблем с безопасностью ваше приложение может удалить токены или сам Instance ID и сгенерировать новые. Кроме того, сервер Instance ID инициирует обновление токена или Instance ID, если обнаруживает ошибки или проблемы безопасности.

Примечание: проверка подлинности приложения доступна только для приложений, распространяемых через Google Play.

Подтвердите, что приложение-устройство активно

Сервер Instance ID может сообщить вам, когда устройство, на котором установлено ваше приложение, использовалось в последний раз. Используйте это, чтобы решить, сохранять ли данные из вашего приложения или отправлять push-сообщение для повторного взаимодействия с вашими пользователями.

Идентификация и отслеживание приложений

Instance ID уникален для всех экземпляров приложений по всему миру, поэтому ваша база данных может использовать его для уникальной идентификации и отслеживания экземпляров приложений. Ваш серверный код может проверить с помощью облачной службы Instance ID, что Instance ID является подлинным и совпадает с ID исходного приложения, зарегистрированного на вашем сервере. Для обеспечения конфиденциальности ваше приложение может удалить Instance ID, чтобы он больше не был связан с какой-либо историей в базе данных. В следующий раз, когда ваше приложение вызовет Instance ID, оно получит совершенно новый Instance ID, не имеющий никакой связи с предыдущим.

Жизненный цикл идентификатора экземпляра

1. Служба Instance ID выдает InstanceID , когда ваше приложение выходит в сеть. InstanceID поддерживается парой открытого/закрытого ключа, при этом закрытый ключ хранится на локальном устройстве, а открытый ключ зарегистрирован в службе Instance ID.
2. Ваше приложение может запросить свежий InstanceID всякий раз, когда это необходимо, используя метод getID() . Ваше приложение может сохранить его на вашем сервере, если у вас есть сервер, который поддерживает ваше приложение.
3. Ваше приложение может запрашивать токены из службы Instance ID по мере необходимости с помощью метода getToken() , и, как и InstanceID , ваше приложение также может хранить токены на вашем собственном сервере. Все токены, выданные вашему приложению, принадлежат InstanceID приложения.
4. Токены уникальны и безопасны, но вашему приложению или службе Instance ID может потребоваться обновить токены в случае возникновения проблем безопасности или когда пользователь удаляет и переустанавливает ваше приложение во время восстановления устройства. Ваше приложение должно реализовать прослушиватель для ответа на запросы обновления токенов от службы Instance ID.

Реализация клиента

Instance ID работает как на Android, так и на iOS. Для каждого требуется включить соответствующую библиотеку в клиентское приложение. Для Android требуются Google Play Services . Вам понадобится Project ID, сгенерированный Google Developers Console, если вы собираетесь генерировать токены.

Подробные инструкции см. в руководствах по внедрению для Android и iOS .