Sintaksis Daftar Pernyataan

Daftar pernyataan adalah file atau cuplikan berenkode JSON di lokasi yang dikenal.

Lokasi daftar pernyataan

Lihat Membuat daftar pernyataan untuk mempelajari tempat daftar ini harus disimpan.

Sintaksis

Daftar atau cuplikan pernyataan terdiri dari array JSON dari satu atau beberapa pernyataan situs atau aplikasi sebagai objek JSON. Pernyataan ini dapat dalam urutan apa pun. Berikut ini adalah sintaks yang umum:

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

relation

Array yang berisi satu atau beberapa string yang menjelaskan hubungan yang dideklarasikan tentang target. Lihat daftar string relasi yang ditentukan. Contoh: delegate_permission/common.handle_all_urls

target

Aset target yang menjadi tujuan pernyataan ini. Jenis target yang tersedia:

• Target situs

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

  namespace

  Harus berupa web untuk situs.

  situs

  URI situs yang menjadi target pernyataan, dalam format http[s]://<hostname>[:<port>], dengan <hostname> memenuhi syarat sepenuhnya, dan <port> harus dihilangkan saat menggunakan port 80 untuk HTTP, atau port 443 untuk HTTPS. Target situs hanya dapat berupa domain root; Anda tidak dapat membatasi ke subdirektori tertentu; semua direktori di bawah root ini akan cocok. Subdomain tidak boleh dianggap cocok: yaitu, jika file pernyataan dihosting di www.example.com, maka www.puppies.example.com tidak boleh dianggap cocok. Untuk aturan dan contoh tentang pencocokan target situs, lihat dokumentasi target. Contoh: http://www.example.com

• Target aplikasi Android

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

  namespace

  Harus android_app untuk aplikasi Android.

  package_name

  Nama paket yang sepenuhnya memenuhi syarat dari aplikasi yang menerapkan pernyataan ini. Contoh: com.google.android.apps.maps

  sha256_cert_fingerprints

  Sidik jari SHA256 huruf besar dari sertifikat untuk aplikasi yang pernyataannya berlaku. Anda dapat menghitungnya menggunakan openssl atau Java keytool seperti yang ditunjukkan di sini:

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

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

  Jika Anda menggunakan Penandatanganan Aplikasi Play untuk aplikasi Anda, sidik jari sertifikat yang dihasilkan dengan menjalankan keytool atau openssl secara lokal biasanya tidak cocok dengan sidik jari yang ada di perangkat pengguna. Anda dapat memverifikasi apakah Anda menggunakan Penandatanganan Aplikasi Play untuk aplikasi Anda di akun developer Konsol Play di bagian Release > Setup > App Integrity; jika ya, Anda juga akan menemukan cuplikan JSON Digital Asset Links yang tepat untuk aplikasi Anda di halaman yang sama.

relation_extensions (opsional)

Anda dapat menambahkan kolom relation_extensions opsional ke pernyataan untuk memberikan informasi lebih lanjut tentang izin dan asosiasi yang ingin Anda berikan. Kolom ini harus berupa objek dengan setiap kunci adalah string relasi, dan nilainya adalah objek yang berisi ekstensi untuk relasi tersebut. Klien yang meminta pernyataan ini perlu diperbarui untuk mematuhi kolom ini.

Misalnya, relation_extensions untuk relasi delegate_permission/common.handle_all_urls mungkin terlihat seperti:

  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.app",
      "sha256_cert_fingerprints": ["..."]
    },
    "relation_extensions": {
      "delegate_permission/common.handle_all_urls": {...}
    }
  }
  

DAL API mendukung menampilkan relation_extensions dalam panggilan API saat parameter return_relation_extensions=true ditetapkan dalam permintaan.

Contoh daftar pernyataan

Berikut adalah contoh daftar pernyataan situs yang berisi pernyataan tentang situs dan aplikasi: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Menskalakan ke puluhan pernyataan atau lebih

Dalam beberapa kasus, prinsipal mungkin ingin membuat banyak pernyataan berbeda tentang target yang berbeda, atau mungkin ada kebutuhan untuk mengeluarkan pernyataan dari prinsipal yang berbeda ke kumpulan target yang sama. Misalnya, sebuah situs mungkin tersedia di banyak Domain Tingkat Teratas per negara yang berbeda, dan semuanya mungkin ingin membuat pernyataan tentang aplikasi seluler yang sama.

Untuk situasi ini, pernyataan include dapat membantu. Dengan mekanisme ini, Anda dapat menyiapkan pointer dari banyak prinsipal yang berbeda ke satu lokasi pusat, yang menentukan pernyataan untuk semua prinsipal.

Misalnya, Anda dapat memutuskan bahwa lokasi pusat adalah `https://example.com/includedstatements.json`. File ini dapat dikonfigurasi agar berisi konten yang sama seperti dalam contoh di atas.

Untuk menyiapkan penunjuk dari situs web ke file include, ubah `https://example.com/.well-known/assetlinks.json` menjadi:

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

Untuk menyiapkan penunjuk dari aplikasi Android ke file include, ubah `res/values/strings.xml` menjadi:

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

Informasi Selengkapnya

Ada penjelasan yang lebih mendetail tentang format daftar pernyataan dan konsep yang mendasarinya dalam dokumen spesifikasi kami.