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

Операторы размещаются в списке операторов в формате JSON в известном месте на субъекте, как определено Спецификацией связей активов . Список операторов содержит один или несколько операторов, и принципал может иметь только один список операторов.

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

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

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

Список заявлений размещается в хорошо известном месте, которое зависит от типа принципала (веб-сайт или приложение, создающее заявления).

Списки заявлений на веб-сайте

На веб-сайте список выписок представляет собой текстовый файл, расположенный по следующему адресу:

scheme : domain

Обратите внимание на точку в имени папки .well-known.

Любой ответ от сервера, кроме HTTP 200 рассматривается как ошибка и приводит к пустому списку операторов. Для HTTPS любое соединение без цепочки сертификатов, которое можно проверить с помощью доверенного корневого списка, также приведет к пустому списку операторов.

Пример

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

Списки операторов приложений Android

В приложении Android список операторов представляет собой фрагмент JSON с тем же синтаксисом, что и файл операторов веб-сайта, но он встроен в файл strings.xml и упоминается в манифесте, как показано ниже.

В AndroidManifest.xml:

<manifest>
  <application>
    ...
    <meta-data android:name="asset_statements" android:resource="@string/asset_statements" />
    ...
  </application>
</manifest>

В res/values/strings.xml:

<resources>
  ...
  <string name="asset_statements">
    ... statement list ...
  </string>
</resources>

Пример

Ниже приведен пример фрагмента файла res/values/strings.xml для приложения Android, которое поддерживает совместное использование местоположения с приложением (функция Android в настоящее время не поддерживается):

<resources>
    ...
    <string name="asset_statements">
      [{
        \"relation\": [\"delegate_permission/common.share_location\"],
        \"target\": {
          \"namespace\": \"web\",
          \"site\": \"https://example.com\"
        }
      }]
    </string>
</resources>

Соответствие цели

Каждое утверждение касается цели . Когда вы используете оператор, вы должны сопоставить цель в операторе с некоторой сущностью в реальности. Если цель оператора соответствует сущности, оператор применяется. Вот правила определения соответствия цели данному объекту:

Цели веб-сайта

Для веб-сайта схема сайта, хост и порт должны точно совпадать. Порты по умолчанию для HTTP и HTTPS (80 и 443 соответственно) предполагаются неявно; если цель запроса описывает http://www.example.com:80, то веб-сайт http://www.example.com считается соответствующим.

Пример

Учитывая следующую цель утверждения

"target": {
  "namespace": "web",
  "site": "https://www.google.com"
}

Следующие URI БУДУТ соответствовать:

  • https://www.google.com/
  • https://www.google.com:443/
  • https://www.google.com/foo
  • https://www.google.com/foo?bar
  • https://www.google.com/foo#bar
  • https://user@пароль:www.google.com/

Следующие URL-адреса НЕ будут совпадать:

  • http://www.google.com/ ( неправильная схема )
  • https://google.com/ ( имя хоста не совпадает )
  • https://www.google.com:444/ ( порт не соответствует )

Цели приложения

Для приложения хеш сертификата и имя целевого пакета должны точно соответствовать приложению.