Składnia listy wyciągu

Lista instrukcji to plik lub fragment kodu zakodowany w formacie JSON w dobrze znanej lokalizacji.

Lokalizacja listy wyciągów

Informacje o tym, gdzie ta lista ma być przechowywana, znajdziesz w artykule Tworzenie listy wyciągów

Składnia

Lista lub fragment instrukcji obejmuje tablicę JSON zawierającą co najmniej 1 informację o witrynie lub aplikacji jako obiekty JSON. Wyrażenia mogą być wyświetlane w dowolnej kolejności. Oto ogólna składnia:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]
relacja
Tablica z co najmniej 1 ciągiem, który opisuje zadeklarowaną relację dotyczącą elementu docelowego. Zobacz listę zdefiniowanych ciągów relacji. Przykład: delegate_permission/common.handle_all_urls
target
Zasób docelowy, do którego odnosi się to stwierdzenie. Dostępne typy kierowania:

Przykładowa lista wyciągów

Oto przykładowa lista wyciągów z witryn zawierająca oświadczenia dotyczące witryn i aplikacji: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Skalowanie do kilkudziesięciu instrukcji

W niektórych przypadkach podmiot zabezpieczeń może chcieć utworzyć różne wyciągi dotyczące różnych celów lub może być konieczne przesłanie instrukcji od różnych podmiotów zabezpieczeń do tego samego zestawu celów. Na przykład dana witryna może być dostępna w wielu różnych domenach najwyższego poziomu w poszczególnych krajach, a każda z nich będzie chciała wyrazić na jej temat swoje zdanie.

W takich sytuacjach przydatne może okazać się stwierdzenie. Za pomocą tego mechanizmu możesz skonfigurować wskaźniki z wielu różnych podmiotów zabezpieczeń do jednej lokalizacji centralnej, która definiuje instrukcje dla wszystkich podmiotów zabezpieczeń.

Możesz na przykład określić, że centralna lokalizacja powinna mieć postać „https://example.com/includedstatements.json”. Taki plik można skonfigurować tak, aby zawierał tę samą treść co w powyższych przykładach.

Aby skonfigurować wskaźnik z witryny do pliku Include, zmień `https://example.com/.well-known/assetlinks.json` na:

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

Aby skonfigurować wskaźnik z aplikacji na Androida do pliku Include, zmień `res/values/strings.xml` na:

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

Więcej informacji

Bardziej szczegółowe informacje o formacie listy wyciągów i podstawowych zagadnieniach znajdziesz w dokumentacji.