Sintassi dell'elenco di istruzioni

Un elenco di istruzioni è un file o uno snippet codificato in formato JSON in una posizione nota.

Posizione elenco di estratti conto

Vedi Creazione di un elenco di istruzioni per sapere dove deve essere archiviato questo elenco.

Sintassi

L'elenco o lo snippet di istruzione è costituito da un array JSON di una o più istruzioni di siti web o app come oggetti JSON. Tali istruzioni possono essere in qualsiasi ordine. Ecco la sintassi generale:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]

relazione

Una matrice di una o più stringhe che descrivono la relazione dichiarata sul target. Consulta l'elenco delle stringhe di relazione definite. Esempio: delegate_permission/common.handle_all_urls

destinazione

L'asset di destinazione a cui si applica la presente affermazione. Tipi di target disponibili:

• Target del sito web

  "target": {
    "namespace": "web",
    "site": "site_root_url"
  }

  spazio dei nomi

  Deve essere web per i siti web.

  sito

  URI del sito che ha come target l'istruzione, nel formato http[s]://<hostname>[:<port>], dove <hostname> è completo e <port> deve essere omesso quando si utilizza la porta 80 per HTTP o la porta 443 per HTTPS. La destinazione di un sito web può essere solo un dominio principale; non puoi limitare a una specifica sottodirectory; tutte le directory di questa directory principale troveranno una corrispondenza. I sottodomini non devono essere considerati corrispondenti: se il file di istruzione è ospitato su www.example.com, www.puppies.example.com non deve essere considerato una corrispondenza. Per regole ed esempi di corrispondenza dei target dei siti web, consulta la documentazione relativa ai target. Esempio: http://www.example.com

• Target di app per Android

  "target": {
    "namespace": "android_app",
    "package_name": "fully_qualified_package_name",
    "sha256_cert_fingerprints": ["cert_fingerprint"]
  }

  spazio dei nomi

  Deve essere android_app per le app Android.

  package_name

  Il nome completo del pacchetto dell'app a cui si applica questa affermazione. Esempio: com.google.android.apps.maps

  sha256_cert_fingerprints

  L'impronta SHA265 maiuscola del certificato per l'app a cui si applica questa istruzione. Puoi calcolarlo utilizzando openssl o Java keytool come mostrato di seguito:

  • openssl x509 -in $CERTFILE -noout -fingerprint -sha256
  • keytool -printcert -file $CERTFILE | grep SHA256

  Esempio: ["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"].

  Se utilizzi la firma dell'app di Google Play per la tua app, l'impronta del certificato prodotta eseguendo keytool o openssl di solito non corrisponde a quella sui dispositivi degli utenti. Puoi verificare se stai utilizzando la firma dell'app di Google Play per la tua app nel tuo account sviluppatore Play Console nella sezione Release > Setup > App Integrity; in questo caso, nella stessa pagina troverai anche lo snippet JSON Digital Asset Links per l'app.

Esempio di elenco di istruzioni

Di seguito è riportato un esempio di elenco di istruzioni del sito web contenente istruzioni relative a siti web e app: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Scalabilità fino a decine di istruzioni

In alcuni casi, un'entità potrebbe voler effettuare molte affermazioni diverse su target diversi oppure potrebbe essere necessario emettere istruzioni da entità diverse per lo stesso insieme di target. Ad esempio, un sito web potrebbe essere disponibile in domini di primo livello diversi per paese e ciascuno di essi potrebbe voler fare una dichiarazione sulla stessa app per dispositivi mobili.

In questi casi, può essere utile includere le istruzioni. Con questo meccanismo, puoi configurare i puntatori da molte entità diverse in un'unica posizione centrale, che definisce le istruzioni per tutte le entità.

Ad esempio, potresti decidere che la posizione centrale debba essere "https://example.com/includedstatements.json". Questo file può essere configurato per includere gli stessi contenuti degli esempi precedenti.

Per impostare un puntatore da un sito web al file di inclusione, modifica "https://example.com/.well-known/assetlinks.json" in:

[{
  "include": "https://example.com/includedstatements.json"
}]

Per impostare un puntatore da un'app Android nel file di inclusione, modifica "res/values/strings.xml" in:

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

Scopri di più

Puoi trovare una spiegazione più dettagliata sul formato dell'elenco delle dichiarazioni e sui concetti alla base nel nostro documento delle specifiche.