AMP

Fournir AMP à l'aide d'échanges signés

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

AMP offre des avantages de vitesse au-delà des formats grâce à des techniques telles que la mise en cache et le préchargement. Ces avantages peuvent avoir des inconvénients tels que l'affichage d'URL supplémentaires si elles sont intégrées dans une visionneuse AMP. En diffusant du contenu AMP à l'aide d'échanges signés, vous pouvez utiliser une nouvelle fonctionnalité de plateforme Web pour surmonter tous ces problèmes.

Un échange signé est composé d'un document AMP valide et de l'URL d'origine du contenu. Ces informations sont protégées par des signatures numériques qui lient en toute sécurité le document à son URL déclarée. Cela permet aux navigateurs d'afficher en toute sécurité l'URL d'origine dans la barre d'URL au lieu du nom d'hôte de la machine qui a livré les octets au navigateur.

Le contenu AMP signé est fourni en plus (plutôt qu'à la place) du contenu AMP normal.

Cette fonctionnalité est actuellement prise en charge sur Chrome, mais son implémentation est prévue pour d'autres navigateurs.

Les échanges signés fonctionneront-ils pour moi?

Pour implémenter les échanges signés, vous devez répondre aux exigences suivantes:

  • La possibilité de configurer et de contrôler les en-têtes HTTP générés par votre serveur. (La plupart des solutions d'hébergement purement web telles que Blogger ne sont pas compatibles avec les échanges signés).
  • La possibilité de générer des échanges signés AMP, par exemple en exécutant amppackager, en tant que Go binary ou dans une VM Docker.
  • Le packager doit être mis à jour toutes les six semaines.
  • La possibilité d'appliquer Vary sur les en-têtes Accept et AMP-Cache-Transform des serveurs HTTP de périphérie, en renvoyant des contenus différents pour la même URL.
  • Le système qui exécute amppackager doit être en mesure de faire des requêtes réseau sortantes pour:
  • L'autorité de certification qui émet votre certificat
  • Le serveur de l'éditeur qui héberge les documents AMP à signer
  • cdn.ampproject.org pour obtenir la version actuelle d'AMP
  • Un système de fichiers de stockage partagé persistant entre toutes les instances de amppackager s'exécutant dans le même centre de données.

Implémentation des échanges signés

Vous trouverez ci-dessous l'ordre d'implémentation suggéré pour prendre en charge les échanges signés sur vos documents AMP.

Acquérir un certificat TLS pris en charge

Pour produire des échanges signés, vous avez besoin d'un certificat TLS avec l'extension CanSignHttpExchanges. Depuis avril 2019, DigiCert est le seul fournisseur de cette extension (plus d'infos).

Afin de générer le certificat, l'autorité de certification (CA) exigera une demande de signature de certificat (CSR), qui peut être générée par openssl. Exemple de CSR pour 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"

Déterminer les URL à signer

Vous devrez créer un modèle d'URL qui définit les documents à signer. Il est essentiel que le contenu privé, tel que les informations personnalisées, ne soit pas signé, pour éviter d'envoyer un contenu trompeur ou incorrect.

Pour des raisons de performances, le packager ne doit recevoir que des documents AMP valides en entrée. Certains documents AMP non valides conviennent si nécessaire, mais vous devez éviter d'envoyer tout le trafic via le packager.

Déployer le packager sur un serveur intermédiaire

Vous devez d'abord configurer les échanges signés sur un serveur intermédiaire pour vérifier que votre configuration est correcte avant de migrer vers la production.

Nous vous recommandons d'utiliser amppackager pour générer des échanges signés. Cependant, si cela ne convient pas à votre environnement de production, vous pouvez plutôt utiliser les clients de ligne de commande transform et gen-signedexchange, et gérer vous-même les tâches de négociation de contenu et de gestion des certificats.

Les instructions suivantes s'appliquent aux déploiements utilisant amppackager.

Configuration

Le fichier de configuration de amppackager, (amppkg.toml), appelle un CertFile et un KeyFile.

Le KeyFile est la clé privée (ampbyexample-packager.key dans l'exemple ci-dessus) et doit avoir le format suivant. (Remarque: ne partagez pas votre propre clé privée et protégez-la contre tout partage accidentel!)

-----BEGIN EC PARAMETERS-----
BggqhkjOPQMBBw==
-----END EC PARAMETERS-----
-----BEGIN EC PRIVATE KEY-----
MHcCAQEEINDgf1gprbdD6hM1ttmRC9+tOqJ+lNRtHwZahJIXfLADoAoGCCqGSM49

4j1NY29jVmAMQYrBYb+6heiv6ok+8c/zJQ==
-----END EC PRIVATE KEY-----

Le CertFile est le certificat public. Si DigiCert a fourni le certificat, celui-ci peut être créé en concaténant ensemble le certificat spécifique à l'origine fourni par DigiCert et le fichier DigiCertCA.crt.

-----BEGIN CERTIFICATE-----
MIIE0zCCBFmgAwIBAgIQCkEgeFknZluZtdcJnvdFCjAKBggqhkjOPQQDAjBMMQsw
CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMSYwJAYDVQQDEx1EaWdp
Q2VydCBFQ0MgU2VjdXJlIFNlcnZlciBDQTAeFw0xODEwMzAwMDAwMDBaFw0xOTEx
MDYxMjAwMDBaMGIxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJjYTEWMBQGA1UEBxMN
TW91bnRhaW4gVmlldzETMBEGA1UEChMKR29vZ2xlIExMQzEZMBcGA1UEAxMQYW1w
YnlleGFtcGxlLmNvbTBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABAGu0CjzWa6i

PXLGRK8i0lr7Jv6ZKPY8tfaB/c5yK404QU4HNggmAiEAlnNjIerjJOLHb8CvVaUQ
nhhn0a35nHp1yvE651W14fMwCgYIKoZIzj0EAwIDaAAwZQIwI4/7dpqJQxkQwpP3
DAjVOFdjC6PDcUIRPll3bF0srrTUXSyZ8xkM4q/RhB51A0hVAjEAsUGNYBje9RIO
wf9qyV2iHB+9cBwgKfC0KvEcBugbgHShypM8hPhV9UMC3qTpdKPx
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIDrDCCApSgAwIBAgIQCssoukZe5TkIdnRw883GEjANBgkqhkiG9w0BAQwFADBh
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
QTAeFw0xMzAzMDgxMjAwMDBaFw0yMzAzMDgxMjAwMDBaMEwxCzAJBgNVBAYTAlVT

loB5hWp2Jp2VDCADjT7ueihlZGak2YPqmXTNbk19HOuNssWvFhtOyPNV6og4ETQd
Ea8/B6hPatJ0ES8q/HO3X8IVQwVs1n3aAr0im0/T+Xc=
-----END CERTIFICATE-----

Installation

Suivez ces instructions pour configurer amppackager pour votre site.

Voir packager.js (utilisé par amp.dev) pour un exemple des changements côté serveur que vous devrez faire pour acheminer les requêtes requises vers amppkg.

Test

Vérifiez que votre site intermédiaire répond avec le contenu du type MIME application/signed-exchange lorsque spécifié par la requête HTTP. Par exemple (remplacez staging.example.com par votre serveur intermédiaire):

$ 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

Le résultat doit inclure cette ligne:

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

La valeurs v="1..100" dans la requête est un caractère de remplacement. N'utilisez pas cette valeur exacte; mais, comme il est décrit dans les instructions d'installation de amppackager, vérifiez uniquement l'existence de l'en-tête amp-cache-transform et ignorez cette valeur.

La chaîne de version v=b3 dans la réponse correspond à la version d'août 2019. Celle-ci sera modifiée.

La majeure partie de la réponse doit être votre page AMP (en texte brut). Il y a un petit en-tête binaire et, si la page est > 16 ko, quelques octets binaires sont éparpillés.

L'outil dump-signedexchange peut être utilisé pour analyser la réponse:

$ 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

(Notez que le commutateur -verify ne fonctionnera pas à ce stade car les certificats requis ne sont pas sur le serveur https://example.com/.)

Vérifiez que la réponse inclut toujours l'en-tête Vary avec la valeur Accept,AMP-Cache-Transform (indépendamment du fait que le type MIME soit text/html, application/signed-exchange ou autre chose):

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

Ce résultat doit inclure cette ligne:

vary: Accept,AMP-Cache-Transform

Déployer le packager en production

Installation

Ajustez les étapes de déploiement intermédiaire ci-dessus en fonction de votre environnement de production.

Test

Avec des outils de ligne de commande

Exécutez les mêmes tests que ci-dessus. dump-signedexchange -verify devrait maintenant réussir également.

Avec Chrome

Vous pouvez également tester dans Chrome à l'aide de l'extension ModHeader. Installez-la à partir du Chrome Webstore et configurez les en-têtes de requête sur amp-cache-transform avec google comme value.

Après avoir demandé https://example.com/ votre serveur fournira un échange signé, mais il la même apparence et le même comportement qu'avant. Vous devrez vérifier qu'un échange signé est correctement renvoyé via la console DevTools.

Sous l'onglet Network, cliquez sur votre nom de domaine et vérifiez que Signed HTTP exchange apparaît sous Preview.

Avec Google AMP Cache

Confirmez que les échanges signés sont compatibles avec Google AMP Cache. Cela est lié à leur visibilité sur les moteurs de recherche tels que la recherche Google.

Pour tester les échanges signés dans Google AMP Cache, ouvrez l'onglet réseau dans DevTools, activez Preserve log et visitez une URL telle que https://example-com.cdn.ampproject.org/wp/s/example.com/.

DevTools affichera 200 avec une ligne signed-exchange, et une ligne from signed-exchange, si la demande a réussi.

En cas d'échec, les lignes signed-exchange seront absentes ou seront surlignées en rouge. Un en-tête d' warning peut également être affiché et fournir des informations supplémentaires.

Echanges signés dans la recherche Google

Si vos pages AMP ont été distribuées avec succès en tant qu'échanges signés, leurs résultats de recherche afficheront l'éclair AMP, comme précédemment, mais en appuyant sur les résultats, https://example.com apparaîtra dans la barre d'URL, au lieu d'une URL commençant par https://www.google.com/amp/….. En outre, la barre de viewer n'apparaîtra pas.

Dans la console DevTools, sous l'onglet network, vous pourrez voir signed-exchange sous la colonne type.

Fournisseurs de services d'échange signés

Voici une liste de CDN et de fournisseurs d'hébergement offrant une prise en charge prête à l'emploi pour les échanges signés. Utilisez l'une de ces solutions pour un démarrage facile en matière d'échanges signés: