Синтаксис списка операторов

Список операторов – это файл или фрагмент кода в формате JSON , который находится в известном месте.

Расположение списка заявлений

См. Создание списка операторов , чтобы узнать, где этот список должен храниться.

Синтаксис

Список инструкций или фрагмент состоит из массива JSON одного или нескольких операторов веб-сайта или приложения в виде объектов JSON. Эти утверждения могут быть в любом порядке. Вот общий синтаксис:

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

связь

Массив из одной или нескольких строк, описывающих объявленное отношение к цели. См. список определенных строк отношений . Пример: delegate_permission/common.handle_all_urls

цель

Целевой актив, к которому относится это утверждение. Доступные типы целей:

• Целевой веб-сайт

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

  пространство имен

  Должен быть web для веб-сайтов.

  сайт

  URI сайта, который является целью оператора, в формате http[s]://< hostname >[:< port >] , где <hostname> является полным, а <port> должен быть опущен при использовании порт 80 для HTTP или порт 443 для HTTPS. Целевым веб-сайтом может быть только корневой домен; вы не можете ограничиться определенным подкаталогом; все каталоги в этом корне будут совпадать. Субдомены не должны рассматриваться как совпадающие: то есть, если файл выписки размещен на www.example.com, то www.puppies.example.com не следует считать совпадающим. Правила и примеры сопоставления целей веб-сайтов см. в документации по целям . Пример: http://www.example.com

• Цель приложения Android

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

  пространство имен

  Должно быть android_app для приложений Android.

  имя пакета

  Полное имя пакета приложения, к которому применяется это утверждение. Пример: com.google.android.apps.maps

  sha256_cert_fingerprints

  Отпечаток SHA265 в верхнем регистре сертификата для приложения, к которому применяется это утверждение. Вы можете вычислить это с помощью openssl или Java keytool , как показано здесь:

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

  Пример: ["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"] .

  Если вы используете Play App Signing для своего приложения, то отпечаток сертификата, созданный при локальном запуске keytool или openssl , обычно не совпадает с отпечатком на устройствах пользователей. Вы можете проверить, используете ли вы подписывание приложений Play для своего приложения, в своей учетной записи разработчика Play Console в разделе Release > Setup > App Integrity ; если вы это сделаете, то вы также найдете правильный фрагмент JSON цифровых активов для вашего приложения на той же странице.

Примерный список операторов

Вот пример списка утверждений веб-сайта, который содержит утверждения как о веб-сайтах, так и о приложениях: http://example.digitalassetlinks.org/.well-known/assetlinks.json .

Масштабирование до десятков утверждений и более

В некоторых случаях принципалу может понадобиться сделать много разных заявлений о разных целях или может возникнуть необходимость выдать заявления от разных участников одному и тому же набору целей. Например, веб-сайт может быть доступен во многих разных доменах верхнего уровня для каждой страны, и все они могут захотеть сделать заявление об одном и том же мобильном приложении.

В этих ситуациях могут быть полезны операторы включения . Используя этот механизм, вы можете установить указатели от множества разных принципалов к одному центральному местоположению, которое определяет операторы для всех участников.

Примечание. В полном дереве списка операторов допускается не более 10 операторов включения. Это означает, что максимальное количество файлов в дереве: (10 включенных файлов операторов) + (корневой файл операторов) = всего 11.

Например, вы можете решить, что центральное расположение должно быть https://example.com/includedstatements.json. Этот файл можно настроить таким образом, чтобы он содержал то же содержимое, что и в приведенных выше примерах.

Чтобы настроить указатель с веб-сайта на включаемый файл, измените `https://example.com/.well-known/assetlinks.json` на:

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

Чтобы настроить указатель из приложения Android на включаемый файл, измените `res/values/strings.xml` на:

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

Больше информации

Более подробное объяснение формата списка операторов и лежащих в его основе концепций содержится в нашем документе спецификации .