Personnalisations du locataire de distribution - Amazon CloudFront
Fonctionnement des paramètres avec les locataires de distributionExemples de paramètres

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Personnalisations du locataire de distribution

Lorsque vous utilisez une distribution multi-locataires, vos locataires de distribution héritent automatiquement de sa configuration. Cependant, vous pouvez personnaliser certains paramètres au niveau du locataire de distribution.

Vous pouvez personnaliser les éléments suivants :

  • Paramètres : les paramètres sont des paires clé-valeur que vous pouvez utiliser pour le domaine d’origine ou les chemins d’origine. Consultez Fonctionnement des paramètres avec les locataires de distribution.

  • AWS WAF ACL Web (V2) — Vous pouvez spécifier une ACL Web distincte pour le locataire de distribution, qui remplacera l'ACL Web utilisée pour la distribution multi-locataires. Vous pouvez également désactiver ce paramètre pour un locataire de distribution spécifique, ce qui signifie que le locataire de distribution n’héritera pas des protections ACL Web de la distribution multi-locataires. Pour de plus amples informations, veuillez consulter AWS WAF ACL Web.

  • Restrictions géographiques : les restrictions géographiques que vous spécifiez pour un locataire de distribution remplaceront toutes les restrictions géographiques définies pour la distribution multi-locataires. Par exemple, si vous bloquez l’Allemagne (DE) dans votre distribution multi-locataires, tous les locataires de distribution associés bloqueront également DE. Toutefois, si vous autorisez DE pour un locataire de distribution spécifique, les paramètres de ce locataire remplaceront ceux de la distribution multi-locataires. Pour de plus amples informations, veuillez consulter Restriction de la distribution géographique de votre contenu.

  • Chemins d’invalidation : spécifiez les chemins de fichier vers le contenu que vous souhaitez invalider pour le locataire de distribution. Pour de plus amples informations, veuillez consulter Invalidation de fichiers.

  • Certificats TLS personnalisés : les certificats AWS Certificate Manager (ACM) que vous spécifiez pour les locataires de distribution complètent le certificat fourni dans la distribution multi-locataires. Cependant, si le même domaine est couvert à la fois par le certificat de la distribution multi-locataires et par celui du locataire de distribution, alors c’est le certificat du locataire qui est utilisé. Pour de plus amples informations, veuillez consulter Demandez des certificats pour votre locataire CloudFront de distribution.

  • Noms de domaine : vous devez spécifier au moins un nom de domaine par locataire de distribution.

Fonctionnement des paramètres avec les locataires de distribution

Un paramètre est une paire clé-valeur que vous pouvez utiliser comme valeur d’espace réservé. Définissez les paramètres que vous souhaitez utiliser dans votre distribution multi-locataires et précisez s’ils sont obligatoires.

Lorsque vous définissez des paramètres dans votre distribution multi-locataires, vous choisissez si ces paramètres doivent être renseignés au niveau du locataire de distribution.

  • Si vous définissez les paramètres comme obligatoires dans la distribution multi-locataires, ils doivent alors être renseignés au niveau du locataire de distribution. (Ils ne sont pas hérités).

  • Si les paramètres ne sont pas obligatoires, vous pouvez définir une valeur par défaut dans la distribution multi-locataires, laquelle sera héritée par le tenant de distribution.

Vous pouvez utiliser des paramètres dans les propriétés suivantes :

  • Nom de domaine d’origine

  • Chemin d’origine

Dans la distribution multi-locataires, vous pouvez définir jusqu’à deux paramètres pour chacune des propriétés précédentes.

Exemples de paramètres

Consultez les exemples suivants pour l’utilisation de paramètres pour le nom de domaine et le chemin d’origine.

Paramètres du nom de domaine

Dans la configuration de distribution multi-locataires, vous pouvez définir un paramètre pour le nom de domaine d’origine, comme dans les exemples suivants :

Amazon S3

  • {{parameter1}}.amzn-s3-demo-logging-bucket.s3.us-east-1.amazonaws.com

  • {{parameter1}}–amzn-s3-demo-logging-bucket.s3.us-east-1.amazonaws.com

Origines personnalisées

  • {{parameter1}}.lambda-url.us-east-1.on.aws

  • {{parameter1}}.mediapackagev2.ap-south-1.amazonaws.com

Lorsque vous créez un locataire de distribution, spécifiez la valeur à utiliser pour parameter1.

"Parameters": [
  {
    "Name": "parameter1",
    "Value": "mycompany-website"
  }
]

En utilisant les exemples précédemment définis dans la distribution multi-locataires, le nom de domaine d’origine du locataire de distribution se résout comme suit :

  • mycompany-website.amzn-s3-demo-bucket3.s3.us-east-1.amazonaws.com

  • mycompany-website–amzn-s3-demo-bucket3.s3.us-east-1.amazonaws.com

  • mycompany-website.lambda-url.us-east-1.on.aws

  • mycompany-website.mediapackagev2.ap-south-1.amazonaws.com

Paramètres du chemin d’origine

De la même manière, vous pouvez définir des paramètres pour le chemin d’origine dans la distribution multi-locataires, comme l’illustrent les exemples ci-dessous :

  • /{{parameter2}}

  • /{{parameter2}}/test

  • /public/{{parameter2}}/test

  • /search?name={{parameter2}}

Lorsque vous créez un locataire de distribution, spécifiez la valeur à utiliser pour parameter2.

"Parameters": [
  {
    "Name": "parameter2",
    "Value": "myBrand"
  }
]

En utilisant les exemples précédemment définis dans la distribution multi-locataires, le chemin d’origine du locataire de distribution se résout comme suit :

  • /myBrand

  • /myBrand/test

  • /public/myBrand/test

  • /search?name=myBrand

Exemple

Vous souhaitez créer plusieurs sites Web (locataires) pour vos clients, et vous devez vous assurer que chaque ressource de locataire de distribution utilise les valeurs appropriées.

  1. Vous créez une distribution multi-locataires et vous incluez deux paramètres pour la configuration du locataire de distribution.

  2. Pour le nom de domaine d'origine, vous créez un paramètre nommé customer-name et spécifiez qu'il est obligatoire. Vous entrez le paramètre avant le compartiment S3, de sorte qu’il apparaisse comme suit :

    {{customer-name}}.amzn-s3-demo-bucket3.s3.us-east-1.amazonaws.com.

  3. Pour le chemin d'origine, vous créez un deuxième paramètre nommé my-theme et spécifiez qu'il est facultatif, avec une valeur par défaut debasic. Votre chemin d’origine apparaît comme suit : /{{my-theme}}

  4. Lorsque vous créez un locataire de distribution :

    • Pour le nom de domaine, vous devez spécifier une valeur pourcustomer-name, car elle est marquée comme obligatoire dans la distribution multi-locataires.

    • Pour le chemin d'origine, vous pouvez éventuellement spécifier une valeur my-theme ou utiliser la valeur par défaut.