Personnalisations des locataires de distribution - Amazon CloudFront
Comment les paramètres fonctionnent 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 des locataires de distribution

Lorsque vous utilisez une distribution à locataires multiples, vos locataires de distribution héritent de la configuration de distribution à locataires multiples. 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 Comment les paramètres fonctionnent 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 tenant 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 tenant de distribution remplaceront toutes les restrictions géographiques 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 tenant de distribution spécifique, les paramètres du tenant de distribution remplaceront les paramètres de la distribution multi-locataires. Pour de plus amples informations, veuillez consulter Limitez 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 Invalider des 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. Toutefois, si le même domaine est couvert à la fois par les certificats de distribution multi-locataires et de distribution, le certificat de locataire 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 tenant de distribution.

Comment les paramètres fonctionnent avec les locataires de distribution

Un paramètre est une paire clé-valeur que vous pouvez utiliser pour les valeurs 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 saisis au niveau du locataire de distribution.

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

  • Si les paramètres ne sont pas obligatoires, vous pouvez fournir une valeur par défaut dans la distribution multi-locataires 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 utiliser les paramètres du nom de domaine et du 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 tenant de distribution, spécifiez la valeur à utiliser pourparameter1.

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

À l'aide des exemples précédents spécifiés 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 même, vous pouvez définir des paramètres pour le chemin d'origine dans la distribution multi-locataires, comme dans les exemples suivants :

  • /{{parameter2}}

  • /{{parameter2}}/test

  • /public/{{parameter2}}/test

  • /search?name={{parameter2}}

Lorsque vous créez un tenant de distribution, spécifiez la valeur à utiliser pourparameter2.

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

À l'aide des exemples précédents spécifiés 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 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 correctes.

  1. Vous créez une distribution multi-tenant et incluez deux paramètres pour la configuration du tenant 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 tenant 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.