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.