Appy

Deep linking

Qu’est-ce que l’empreinte du certificat de signature d’une app ?

En bref

L’empreinte de signature d’une app est le hachage SHA-256 du certificat qui signe une app Android, écrit sous la forme de 32 paires de caractères hexadécimaux séparées par des deux-points. Android s’en sert pour identifier exactement quelle version signée peut agir pour un domaine : c’est pourquoi assetlinks.json la liste à côté du nom de package.

Ce qu’elle identifie

Toute app Android est signée avec un certificat avant de pouvoir être installée. L’empreinte est un résumé court, de longueur fixe, de ce certificat. Deux versions signées avec la même clé ont la même empreinte, et une version signée avec une autre clé ne l’a pas.

Pour les Android App Links, c’est la preuve d’identité. Le nom de package seul pourrait être copié par n’importe qui. Le nom de package associé à l’empreinte, publié dans assetlinks.json sur votre domaine, indique à Android que cette app signée précise a le droit d’ouvrir vos liens. Le champ accepte une liste : un même fichier peut donc couvrir plusieurs clés.

Le piège de Play App Signing

Avec Play App Signing, il y a deux clés. Vous signez ce que vous importez avec une clé d’importation. Google Play signe ensuite l’app qui arrive sur les téléphones avec la clé de signature d’application qu’il détient. Les deux clés ont des empreintes différentes.

C’est la raison la plus fréquente pour laquelle les App Links échouent en production alors qu’ils fonctionnent en test. La documentation d’Android le dit clairement : si vous utilisez Play App Signing, l’empreinte obtenue en lançant keytool en local ne correspondra en général pas à celle des appareils des utilisateurs. Une version de débogage est signée avec une autre clé encore. Si le fichier ne liste que l’empreinte de votre propre machine, la version distribuée par Play n’est jamais vérifiée et les liens s’ouvrent dans le navigateur.

Où trouver la bonne

Pour la version distribuée par Play, ouvrez la page de signature d’application de la Play Console. Elle affiche le certificat de la clé de signature d’application avec son empreinte SHA-256 et, d’après la documentation d’Android, un extrait Digital Asset Links prêt à l’emploi pour l’app. Copiez toutes les empreintes listées pour la clé de signature d’application.

Pour une clé que vous détenez vous-même, lancez keytool -list -v -keystore suivi du fichier keystore et lisez la ligne SHA256. Pour voir ce qui est réellement installé sur un téléphone de test, adb shell pm get-app-links suivi du nom de package affiche les signatures de l’app à côté de l’état de vérification de chaque domaine. Mettez d’abord l’empreinte Play dans le fichier, puis ajoutez celle de la clé d’importation ou de débogage si vous voulez aussi que les liens s’ouvrent dans les versions de test.

ExempleEmpreinte SHA-256 du certificat
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

Essayez ici

Générez le fichier de votre app

Saisissez votre Team ID et votre bundle ID, ou le nom du package et l’empreinte de signature. Vous obtenez un fichier apple-app-site-association ou assetlinks.json prêt à déposer sur votre serveur.

Apps

Ajoutez chaque app qui doit ouvrir les liens de ce domaine. Chacune devient une entrée de appIDs.

  1. App 1

    10 caractères, dans votre compte Apple Developer, sous Membership details.

    Dans la cible de votre app sous Xcode, par exemple com.example.app.

Chemins qui ouvrent l’app

Les règles sont lues de haut en bas et la première qui correspond l’emporte : placez donc les exclusions au-dessus des règles plus larges. * correspond à n’importe quel nombre de caractères, ? à un seul.

  1. Règle 1

    paires nom=valeur reliées par &

Autres services

Votre fichier

apple-app-site-association

Exemple. Saisissez vos informations pour le remplacer.

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

Généré dans votre navigateur. Rien n’est envoyé nulle part.

Où l’héberger

Où va le fichier

  1. Déposez-le à l’adresse https://votre-domaine/.well-known/apple-app-site-association, sans extension .json.
  2. Servez-le en HTTPS avec un certificat valide et un 200 direct, sans redirection.
  3. Envoyez l’en-tête Content-Type: application/json.
  4. Répétez l’opération sur chaque host de vos liens : example.com et www.example.com ont chacun besoin du fichier et d’une entrée applinks:.
  5. Le CDN d’Apple récupère un nouveau fichier sous 24 heures. En attendant, testez avec ?mode=developer.
Vérifier un domaine avec le validateur

Vous préférez ne pas héberger ces fichiers ? Les smart links sont gratuits, et avec Enterprise Appy sert les deux fichiers sur le domaine de liens de votre app.

Créer un lien gratuit
Pour aller plus loinGénérateur AASA et assetlinks.jsonCollez votre nom de package et vos empreintes SHA-256 : vous obtenez un fichier assetlinks.json prêt à mettre en ligne.

Questions fréquentes

Où trouver l’empreinte SHA-256 de mon app ?

Pour la version que les gens téléchargent sur Google Play, sur la page de signature d’application de la Play Console, sous le certificat de la clé de signature d’application. Pour un keystore sur votre propre machine, lancez keytool -list -v -keystore avec le fichier keystore. Les deux valeurs diffèrent quand Play App Signing est activé.

Quelle est la différence entre la clé d’importation et la clé de signature d’application ?

La clé d’importation est la vôtre. Vous vous en servez pour signer le bundle que vous envoyez à la Play Console. La clé de signature d’application est détenue par Google Play et signe l’app remise aux appareils. Android vérifie les liens par rapport à l’app remise : assetlinks.json a donc besoin de l’empreinte de la clé de signature d’application.

assetlinks.json peut-il contenir plusieurs empreintes ?

Oui. sha256_cert_fingerprints est un tableau, et la documentation d’Android indique que plusieurs empreintes permettent de prendre en charge différentes versions de l’app, comme les versions de débogage et de production. En listant la clé de signature d’application de Play et votre clé de débogage, les liens s’ouvrent dans les deux.

  • assetlinks.json

    assetlinks.json est le fichier Digital Asset Links qu’Android consulte pour vérifier vos App Links. Publié à l’adresse /.well-known/assetlinks.json de votre domaine, il déclare qu’une app, désignée par son nom de package et par l’empreinte SHA-256 de son certificat de signature, a le droit d’ouvrir les liens de ce domaine.

  • Android App Links

    Les Android App Links sont des liens https dont Android a vérifié qu’ils appartiennent à votre app : un toucher ouvre donc l’app directement, sans demander quelle application utiliser. Ils fonctionnent à partir d’Android 6, sur les appareils dotés des services Google, et demandent un intent filter avec autoVerify ainsi qu’un fichier assetlinks.json sur votre domaine.

  • Bundle ID

    Un bundle ID est la chaîne unique qui identifie une app iOS, par exemple com.example.app. Son équivalent sur Android est l’application ID, qu’on appelle le plus souvent nom de package. Vous choisissez l’un et l’autre, ils suivent en général le style du nom de domaine inversé, et aucun des deux ne devrait changer une fois l’app publiée. Les liens Google Play et le fichier assetlinks.json utilisent le nom de package.

Tout le glossaire

Un seul lien pour l’App Store, Google Play et le web

Créez un smart link et son QR code : chaque téléphone arrive sur le bon store, chaque ordinateur sur votre site. Gratuit jusqu’à 4 liens, sans publicité.