Содержание

Будут ли подписанные обмены работать в моей среде?
Реализация подписанных обменов
Поставщики услуг подписанного обмена

Выдача контента AMP с использованием подписанных обменов

Important: this documentation is not applicable to your currently selected format email!

AMP может работать быстрее заявленных возможностей за счет таких методов, как кеширование и предварительная загрузка. У этих преимуществ могут быть свои недостатки, например отображение дополнительных URL-адресов при встраивании в средство просмотра AMP. Решить эти проблемы позволяет новая функциональность веб-платформ — Signed Exchanges («подписанные обмены»).

Подписанный обмен состоит из корректно сформированного документа AMP и исходного URL-адреса контента. Эта информация защищена цифровыми подписями, которые надежно связывают документ с его заявленным URL. Это позволяет браузерам безопасно отображать исходный URL в адресной строке вместо имени хоста устройства, выполнившего доставку байтов в браузер.

Подписанный контент AMP доставляется в дополнение к обычному контенту AMP (а не вместо него).

В настоящее время эта функция поддерживается в Chrome, но ее планируется реализовать и для других браузеров.

Будут ли подписанные обмены работать в моей среде?

Для функционирования подписанных обменов требуется соблюдение следующих условий:

Возможность настройки и управления заголовками HTTP, генерируемыми вашим сервером. Большинство решений для хостинга, являющихся исключительно веб-решениями (например, Blogger), не совместимы с подписанными обменами.
Способность генерировать подписанные обмены AMP, например путем запуска amppackager, в виде двоичного файла Go или внутри Docker VM.
Упаковщик должен обновляться каждые шесть недель.
Способность возвращать различное содержимое с одного и того же URL, учитывая значение Vary с заголовками Accept и AMP-Cache-Transform на пограничных HTTP-серверах.
Система, в которой работает amppackager, должна иметь возможность отправлять исходящие сетевые запросы на:
Центр сертификации, выдающий ваш сертификат
Сервер издателя, на котором размещены подписываемые документы AMP
cdn.ampproject.org для получения текущей версии AMP
Постоянное общее хранилище (файловая система), доступное всем экземплярам amppackager, работающим в одном центре обработки данных.

Реализация подписанных обменов

Ниже приведен предлагаемый порядок действий для реализации поддержки подписанных обменов в ваших документах AMP.

Получите поддерживаемый сертификат TLS

Для создания подписанных обменов необходим сертификат TLS с расширением CanSignHttpExchanges. По состоянию на апрель 2019 года единственным поставщиком этого расширения является DigiCert (подробнее).

Для создания сертификата Центру сертификации (CA) потребуется запрос на подпись сертификата (CSR), который можно сгенерировать с помощью openssl. Образец CSR для ampbyexample.com:

# generate private key (if necessary)

$ openssl ecparam -out ampbyexample-packager.key -name prime256v1 -genkey
# generate CSR (the file ampbyexample-packager.csr)

$ openssl req -new -key ampbyexample-packager.key -nodes -out ampbyexample-packager.csr -subj "/C=US/ST=California/L=Mountain View/O=Google LLC/CN=ampbyexample.com"

Определите, какие URL-адреса будут подписываться

Вам потребуется создать шаблон URL, определяющий, какие документы должны быть подписаны. Очень важно не допускать подписывания частного контента, такого как персонализированная информация, чтобы избежать отправки вводящего в заблуждение или неверного контента.

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

Разверните упаковщик на промежуточном сервере

Начальное внедрение подписанных обменов следует осуществлять на промежуточном сервере, чтобы проверить правильность конфигурации до переноса ее в рабочую среду.

Для генерации подписанных обменов рекомендуем использовать amppackager. Однако, если такой подход плохо сочетается с вашей рабочей средой, вы можете использовать клиенты командной строки transform и gen-signedexchange, осуществляя согласование контента и управление сертификатами самостоятельно.

Приведенные ниже инструкции относятся к развертыванию с помощью amppackager.

Конфигурация

В файле конфигурации amppackager (amppkg.toml) необходимо указывать CertFile и KeyFile.

KeyFile — это закрытый ключ (в приведенном выше примере ampbyexample-packager.key), и он должен иметь следующий формат:

Примечание: никому не передавайте свой личный ключ и защищайте его от непреднамеренного разглашения!
CertFile — это открытый сертификат. Если вы используете DigiCert: CertFile можно создать, объединив сертификат источника, полученный от DigiCert, с файлом DigiCertCA.crt.

Установка

Чтобы настроить amppackager на своем сайте, выполните инструкции по этой ссылке.

Изучите файл packager.js (используемый сайтом amp.dev), чтобы увидеть пример изменений, которые вам нужно будет внести на стороне сервера для маршрутизации необходимых запросов к amppkg.

Тестирование

Убедитесь, что ваш промежуточный сайт отвечает на соответствующие HTTP-запросы контентом с MIME-типом application/signed-exchange. Например (замените staging.example.com на свой промежуточный сервер):

$ curl -si -H 'amp-cache-transform: google;v="1..100"' -H 'accept: application/signed-exchange;v=b3;q=0.9,*/*;q=0.8' https://staging.example.com/ | less

Вывод должен включать эту строку:

content-type: application/signed-exchange;v=b3

v="1..100" в запросе является заполнителем. Не пытайтесь проверять соответствие по этому значению; вместо этого, как описано в инструкциях по установке amppackager, проверяйте только наличие заголовка amp-cache-transform и игнорируйте значение.

Строка версии v=b3 в ответе — это версия по состоянию на август 2019 года. Она будет меняться.

Основная часть ответа должна быть вашей AMP-страницей (в виде открытого текста). В нем также присутствует небольшой двоичный заголовок и периодически вставленные двоичные байты (если размер страницы больше 16 КБ).

Инструмент dump-signedexchange можно использовать для просмотра ответа:

$ curl -s --output - -H 'amp-cache-transform: google;v="1..100"' -H 'accept: application/signed-exchange;v=b3;q=0.9,*/*;q=0.8' https://staging.example.com/ > example.sxg
$ dump-signedexchange -i example.sxg
format version: 1b3

Обратите внимание, что переключатель -verify на этом этапе работать не будет, поскольку требуемые сертификаты на сервере https://example.com/ отсутствуют.

Убедитесь, что ответ всегда включает заголовок Vary со значением Accept,AMP-Cache-Transform (независимо от того, какой используется MIME-тип — text/html, application/signed-exchange или какой-либо другой):

$ curl -si https://staging.example.com/ | less

Вывод данной команды должен включать следующую строку:

vary: Accept,AMP-Cache-Transform

Выполните развертывание упаковщика в рабочей среде

Установка

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

Тестирование

С помощью инструментов командной строки

Выполните те же тесты, что выше. Команда dump-signedexchange -verify теперь должна работать.

С помощью Chrome

Тестировать можно в Chrome с помощью расширения ModHeader. Установите его из Интернет-магазина Chrome и добавьте в раздел Request Headers строку amp-cache-transform, установив параметру Value значение google.

По запросу https://example.com/ ваш сервер выдаст подписанный обмен, который, однако, будет неотличим от обычного сайта. Вам потребуется удостовериться в корректном возврате подписанного обмена через консоль DevTools.

На вкладке Network нажмите на имя своего домена и убедитесь, что в разделе Preview отображается Signed HTTP exchange.

С помощью Google AMP Cache

Убедитесь, что подписанные обмены совместимы с Google AMP Cache. От этого зависит возможность их обнаружения в поисковых системах, таких как Поиск Google.

Чтобы протестировать подписанные обмены в Google AMP Cache, откройте вкладку Network в DevTools, активируйте Preserve log, после чего откройте URL-адрес, например https://example-com.cdn.ampproject.org/wp/s/example.com/.

Если запрос был успешен, DevTools покажет значение 200 в строках signed-exchange и from signed-exchange.

В случае неудачи строки signed-exchange будут отсутствовать или будут выделены красным цветом. Также может отображаться заголовок warning с дополнительной информацией.

Подписанные обмены в Поиске Google

Если ваши AMP-страницы успешно загружались в виде подписанных обменов, в результатах поиска напротив них будет по-прежнему отображаться значок молнии AMP, но при нажатии на результаты вместо URL, начинающегося с https://www.google.com/amp/…., в адресной строке будет отображаться https://example.com. Кроме того, не будет отображаться панель viewer.

На вкладке network консоли DevTools в столбце type будет отображено значение signed-exchange.

Поставщики услуг подписанного обмена

Ниже приведен список CDN и хостинг-провайдеров, предлагающих готовую поддержку подписанных обменов. Их услуги — самый простой способ начать работу с подписанными обменами.

AMP Packager Google Cloud Click-to-Deploy Installer AMP Packager - это инструмент для улучшения URL-адресов AMP путем обслуживания AMP с помощью подписанных обменов. Подробнее читайте в блоге AMP .
Cloudflare AMP Real URL. Cloudflare — одна из крупнейших сетей в мире. Cloudflare помогает обеспечить повышенную скорость и защищенность для сайтов предприятий, некоммерческих организаций, блогеров и всех, кто ведет деятельность в Интернете.

Written by @CrystalOnScript