Appy

Deep linking

Cos’è l’impronta del certificato di firma di un’app?

In breve

L’impronta di firma di un’app è l’hash SHA-256 del certificato che firma un’app Android, scritto come 32 coppie di caratteri esadecimali separate da due punti. Android la usa per stabilire con esattezza quale build può agire per conto di un dominio: per questo assetlinks.json la elenca accanto al package name.

Cosa identifica

Ogni app Android viene firmata con un certificato prima di poter essere installata. L’impronta è un riassunto breve, a lunghezza fissa, di quel certificato. Due build firmate con la stessa chiave hanno la stessa impronta, una build firmata con qualsiasi altra chiave no.

Per gli Android App Links è la prova di identità. Il solo package name potrebbe copiarlo chiunque. Il package name insieme all’impronta, pubblicati in assetlinks.json sul tuo dominio, dicono ad Android che proprio questa app firmata può aprire i tuoi link. Il campo accetta un elenco, quindi un solo file può coprire più chiavi.

La trappola di Play App Signing

Con Play App Signing le chiavi sono due. Quello che carichi lo firmi con una chiave di caricamento. Google Play firma poi l’app che arriva sui telefoni delle persone con la chiave di firma dell’app, che è in mano a Google. Le due chiavi hanno impronte diverse.

È il motivo più comune per cui gli App Links falliscono in produzione mentre in test funzionano. La documentazione di Android lo dice chiaramente: se usi Play App Signing, l’impronta che ottieni lanciando keytool in locale di solito non corrisponde a quella sui dispositivi degli utenti. Una build di debug è firmata con un’altra chiave ancora. Se il file elenca solo l’impronta della tua macchina, la build di Play non viene mai verificata e i link si aprono nel browser.

Dove trovare quella giusta

Per la build di Play, apri la pagina di firma dell’app nella Play Console. Mostra il certificato della chiave di firma dell’app con la sua impronta SHA-256 e, secondo la documentazione di Android, uno snippet Digital Asset Links già pronto per l’app. Copia tutte le impronte elencate per la chiave di firma dell’app.

Per una chiave che tieni tu, lancia keytool -list -v -keystore seguito dal file del keystore e leggi la riga SHA256. Per vedere cosa è davvero installato su un telefono di test, adb shell pm get-app-links con il package name stampa le firme dell’app accanto allo stato di verifica di ogni dominio. Metti nel file prima l’impronta di Play, poi aggiungi quella di caricamento o di debug se vuoi che i link si aprano anche nelle build di test.

EsempioImpronta SHA-256 del certificato
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

Provalo qui

Genera il file per la tua app

Inserisci Team ID e bundle ID, oppure nome del pacchetto e impronta di firma. Ottieni il file apple-app-site-association o assetlinks.json pronto da caricare sul tuo server.

App

Aggiungi ogni app che deve aprire i link di questo dominio. Ognuna diventa una voce di appIDs.

  1. App 1

    10 caratteri, nel tuo account Apple Developer sotto Membership details.

    Dal target della tua app in Xcode, per esempio com.example.app.

Percorsi che aprono l’app

Le regole vengono lette dall’alto in basso e vince la prima che corrisponde, quindi metti le esclusioni sopra le regole più ampie. * corrisponde a qualsiasi numero di caratteri, ? a uno solo.

  1. Regola 1

    coppie nome=valore unite da &

Altri servizi

Il tuo file

apple-app-site-association

Esempio. Inserisci i tuoi dati per sostituirlo.

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

Generato nel tuo browser. Non viene inviato nulla.

Dove pubblicarlo

Dove va il file

  1. Caricalo su https://tuo-dominio/.well-known/apple-app-site-association, senza estensione .json.
  2. Servilo in HTTPS con un certificato valido e un 200 diretto, senza redirect.
  3. Invia l’intestazione Content-Type: application/json.
  4. Ripeti su ogni host dei tuoi link: example.com e www.example.com richiedono ciascuno il file e una voce applinks:.
  5. La CDN di Apple recupera il nuovo file entro 24 ore. Nel frattempo prova con ?mode=developer.
Controlla un dominio con il validatore

Preferisci non ospitare file da solo? Gli smart link sono gratis e con Enterprise Appy serve entrambi i file sul dominio di link della tua app.

Crea un link gratis
Per approfondireGeneratore di AASA e assetlinks.jsonIncolla il package name e le impronte SHA-256 e ottieni un file assetlinks.json pronto da caricare.

Domande frequenti

Dove trovo l’impronta SHA-256 della mia app?

Per la build che le persone scaricano da Google Play, nella pagina di firma dell’app della Play Console, sotto il certificato della chiave di firma dell’app. Per un keystore sulla tua macchina, lancia keytool -list -v -keystore con il file del keystore. Quando Play App Signing è attivo i due valori sono diversi.

Che differenza c’è tra la chiave di caricamento e la chiave di firma dell’app?

La chiave di caricamento è tua. La usi per firmare il bundle che mandi alla Play Console. La chiave di firma dell’app è in mano a Google Play e firma l’app che viene consegnata ai dispositivi. Android verifica i link sull’app consegnata, quindi in assetlinks.json serve l’impronta della chiave di firma dell’app.

assetlinks.json può contenere più di un’impronta?

Sì. sha256_cert_fingerprints è un array, e la documentazione di Android dice che più impronte possono supportare versioni diverse dell’app, come le build di debug e di produzione. Elencando la chiave di firma dell’app di Play e la tua chiave di debug, i link si aprono in entrambe.

  • assetlinks.json

    assetlinks.json è il file Digital Asset Links che Android consulta per verificare i tuoi App Links. Pubblicato all’indirizzo /.well-known/assetlinks.json del tuo dominio, dichiara che un’app, identificata dal package name e dall’impronta SHA-256 del certificato di firma, può aprire i link di quel dominio.

  • Android App Links

    Gli Android App Links sono link https che Android ha verificato come appartenenti alla tua app: un tocco apre direttamente l’app, senza chiedere quale app usare. Funzionano da Android 6 in poi sui dispositivi con i servizi Google, e richiedono un intent filter con autoVerify e un file assetlinks.json sul tuo dominio.

  • Bundle ID

    Il bundle ID è la stringa univoca che identifica un’app iOS, come com.example.app. L’equivalente su Android è l’application ID, chiamato di solito package name. Li scegli tu entrambi, seguono di norma lo stile a dominio invertito, e nessuno dei due andrebbe cambiato dopo la pubblicazione dell’app. I link Google Play e assetlinks.json usano il package name.

Tutto il glossario

Un solo link per App Store, Google Play e web

Crea uno smart link con il suo QR code: ogni telefono arriva allo store giusto, ogni computer al tuo sito. Gratis fino a 4 link, senza pubblicità.