Appy

Диплинки

Что такое отпечаток сертификата подписи приложения?

Коротко

Отпечаток сертификата подписи — это SHA-256-хеш сертификата, которым подписано Android-приложение. Его записывают как 32 пары шестнадцатеричных символов через двоеточие. По нему Android точно определяет, какая сборка вправе действовать от имени домена, поэтому в assetlinks.json он указан рядом с именем пакета.

Краткий пересказ вChatGPTClaudePerplexity

Что он идентифицирует

Любое Android-приложение перед установкой подписывают сертификатом. Отпечаток — короткая сводка этого сертификата фиксированной длины. У двух сборок, подписанных одним ключом, отпечаток одинаковый, а у сборки, подписанной любым другим ключом, он другой.

Для Android App Links это удостоверение личности. Одно только имя пакета может скопировать кто угодно. Имя пакета вместе с отпечатком, опубликованные в assetlinks.json на вашем домене, говорят Android, что открывать ваши ссылки разрешено именно этому подписанному приложению. Поле принимает список, так что один файл может покрывать несколько ключей.

Ловушка Play App Signing

С Play App Signing ключей два. То, что вы загружаете, вы подписываете ключом загрузки. Затем Google Play подписывает приложение, которое попадает на телефоны, ключом подписи приложения — он хранится у Google. Отпечатки у этих двух ключей разные.

Это самая частая причина, по которой App Links работают при тестировании и не работают в продакшене. В документации Android об этом сказано прямо: если вы пользуетесь Play App Signing, отпечаток, который выдаёт keytool на вашем компьютере, обычно не совпадает с тем, что на устройствах пользователей. А отладочная сборка подписана ещё одним, третьим ключом. Если в файле указан только отпечаток с вашей машины, сборка из Play не проходит проверку и ссылки открываются в браузере.

Где взять правильный

Для сборки из Play откройте в Play Console страницу подписи приложения. Там показан сертификат ключа подписи приложения с отпечатком SHA-256 и, по документации Android, готовый фрагмент Digital Asset Links для приложения. Скопируйте все отпечатки, указанные для ключа подписи приложения.

Для ключа, который хранится у вас, выполните keytool -list -v -keystore с файлом хранилища ключей и найдите строку SHA256. Чтобы увидеть, что на самом деле установлено на тестовом телефоне, выполните adb shell pm get-app-links с именем пакета: команда выводит подписи приложения рядом со статусом проверки каждого домена. Сначала внесите в файл отпечаток из Play, а потом добавьте отпечаток ключа загрузки или отладочного ключа, если хотите, чтобы ссылки открывались и в тестовых сборках.

ПримерОтпечаток сертификата SHA-256
14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5

Попробуйте здесь

Создайте файл для своего приложения

Укажите Team ID и bundle ID или имя пакета и отпечаток подписи. Получите готовый файл apple-app-site-association или assetlinks.json, который останется разместить на сервере.

Приложения

Добавьте каждое приложение, которое должно открывать ссылки этого домена. Каждое станет записью в appIDs.

  1. Приложение 1

    10 символов, в аккаунте Apple Developer в разделе Membership details.

    Из таргета приложения в Xcode, например com.example.app.

Пути, которые открывают приложение

Правила проверяются сверху вниз, и срабатывает первое совпадение, поэтому ставьте исключения выше общих правил. * означает любое количество символов, ? ровно один.

  1. Правило 1

    пары имя=значение через &

Другие сервисы

Ваш файл

apple-app-site-association

Пример. Введите свои данные, и он заменится.

{
  "applinks": {
    "details": [
      {
        "appIDs": [
          "ABCDE12345.com.example.app"
        ],
        "components": [
          {
            "/": "/*"
          }
        ]
      }
    ]
  }
}

Создаётся в вашем браузере. Никуда не отправляется.

Где разместить файл

Где будет лежать файл

  1. Загрузите его по адресу https://ваш-домен/.well-known/apple-app-site-association, без расширения .json.
  2. Отдавайте по HTTPS с действующим сертификатом и сразу с кодом 200, без редиректов.
  3. Отправляйте заголовок Content-Type: application/json.
  4. Повторите для каждого хоста в ссылках: example.com и www.example.com — разные хосты, и каждому нужны файл и запись applinks:.
  5. CDN Apple забирает новый файл в течение 24 часов. До этого тестируйте с ?mode=developer.
Проверить домен валидатором

Не хотите размещать файлы сами? Smart-ссылки бесплатны, а на Enterprise Appy отдаёт оба файла на домене ссылок вашего приложения.

Создать бесплатную ссылку
ПодробнееГенератор AASA и assetlinks.jsonВставьте имя пакета и отпечатки SHA-256 и получите файл assetlinks.json, готовый к загрузке.

Частые вопросы

Где найти отпечаток SHA-256 своего приложения?

Для сборки, которую люди скачивают из Google Play, — в Play Console на странице подписи приложения, в блоке сертификата ключа подписи приложения. Для хранилища ключей на своём компьютере выполните keytool -list -v -keystore с файлом хранилища. При включённом Play App Signing эти два значения различаются.

Чем ключ загрузки отличается от ключа подписи приложения?

Ключ загрузки — ваш. Им вы подписываете бандл, который отправляете в Play Console. Ключ подписи приложения хранится у Google Play, и им подписано приложение, которое доставляется на устройства. Android сверяет ссылки с доставленным приложением, поэтому в assetlinks.json нужен отпечаток ключа подписи приложения.

Может ли в assetlinks.json быть несколько отпечатков?

Да. sha256_cert_fingerprints — это массив, и в документации Android сказано, что несколько отпечатков позволяют поддерживать разные версии приложения, например отладочную и продакшен-сборку. Если указать ключ подписи приложения из Play и свой отладочный ключ, ссылки будут открываться в обеих.

  • Файл assetlinks.json

    assetlinks.json — файл Digital Asset Links по адресу https://<домен>/.well-known/assetlinks.json. Он сообщает Android, какому приложению доверено открывать ссылки домена: в нём указаны отношение delegate_permission/common.handle_all_urls, имя пакета (package_name) и SHA-256-отпечатки сертификата подписи. Без этого файла Android App Links не пройдут проверку, и ссылки будут открываться в браузере.

  • Android App Links

    Android App Links — https-ссылки, принадлежность которых вашему приложению проверил Android, поэтому нажатие открывает приложение сразу, без вопроса, чем открыть. Они работают на Android 6 и новее на устройствах с сервисами Google. Нужны intent filter с autoVerify и файл assetlinks.json на вашем домене.

  • Bundle ID

    Bundle ID — уникальная строка, которая обозначает приложение на iOS, например com.example.app. На Android ей соответствует application ID, который обычно называют именем пакета. Обе строки вы выбираете сами, обычно их записывают в виде перевёрнутого домена, и после публикации приложения менять их не стоит. Имя пакета используется в ссылках на Google Play и в assetlinks.json.

Все термины глоссария

Одна ссылка на App Store, Google Play и сайт

На бесплатном тарифе Appy — 4 ссылки с QR-кодами. Каждый телефон попадает в свой магазин: App Store, Google Play, AppGallery, Galaxy Store или GetApps, а компьютер — на сайт. Без рекламы и без банковской карты.