Personalizaciones de inquilinos de distribución - Amazon CloudFront
Funcionamiento de los parámetros con los inquilinos de distribuciónParámetros de ejemplo

Personalizaciones de inquilinos de distribución

Cuando se utiliza una distribución de varios inquilinos, los inquilinos de la distribución heredan la configuración de distribución de varios inquilinos. Sin embargo, puede personalizar algunos ajustes en el nivel de inquilino de distribución.

Puede personalizar lo siguiente:

  • Parámetros: los parámetros son pares clave-valor que se pueden utilizar para el dominio de origen o las rutas de origen. Consulte Funcionamiento de los parámetros con los inquilinos de distribución.

  • ACL web de AWS WAF (V2): puede especificar una ACL web independiente para el inquilino de distribución, que invalidará la ACL web utilizada para la distribución de varios inquilinos. También puede desactivar esta configuración para un inquilino de distribución específico, lo que significa que el inquilino de distribución no heredará las protecciones de ACL web de la distribución de varios inquilinos. Para obtener más información, consulte ACL web de AWS WAF.

  • Restricciones geográficas: las restricciones geográficas que especifique para un inquilino de distribución invalidarán cualquier restricción geográfica para la distribución de varios inquilinos. Por ejemplo, si bloquea Alemania (DE) en la distribución de varios inquilinos, todos los inquilinos de distribución asociados también bloquearán DE. Sin embargo, si permite DE para un inquilino de distribución específico, la configuración de ese inquilino de distribución invalidará la configuración de la distribución de varios inquilinos. Para obtener más información, consulte Restricción de la distribución geográfica de su contenido.

  • Rutas de invalidación: especifique las rutas de archivo del contenido que desea invalidar para el inquilino de distribución. Para obtener más información, consulte Invalidación de archivos.

  • Certificados TLS personalizados: los certificados de AWS Certificate Manager (ACM) que especifique para los inquilinos de distribución son complementarios al certificado proporcionado en la distribución de varios inquilinos. Sin embargo, si el certificado de distribución de varios inquilinos y el certificado de inquilino de distribución cubren el mismo dominio, se utilizará el certificado de inquilino. Para obtener más información, consulte Solicitud de certificados para el inquilino de distribución de CloudFront.

  • Nombres de dominio: debe especificar al menos un nombre de dominio por inquilino de distribución.

Funcionamiento de los parámetros con los inquilinos de distribución

Un parámetro es un par clave-valor que puede utilizar como valores de marcador de posición. Defina los parámetros que desee usar en la distribución de varios inquilinos y especifique si son obligatorios.

Al definir los parámetros en la distribución de varios inquilinos, se decide si es necesario ingresar dichos parámetros en el nivel de inquilino de distribución.

  • Si define los parámetros según sea necesario en la distribución de varios inquilinos, deben ingresarse en el nivel de inquilino de distribución. (No se heredan).

  • Si los parámetros no son necesarios, puede proporcionar un valor predeterminado en la distribución multiusuario que herede el inquilino de distribución.

Puede utilizar parámetros en las siguientes propiedades:

  • Nombre de dominio de origen

  • Ruta de origen

En la distribución de varios inquilinos, puede definir hasta dos parámetros para cada una de las propiedades anteriores.

Parámetros de ejemplo

Consulte los siguientes ejemplos a fin de utilizar parámetros para el nombre de dominio y la ruta de origen.

Parámetros de nombre de dominio

En la configuración de distribución de varios inquilinos, puede definir un parámetro para el nombre de dominio de origen como en los siguientes ejemplos:

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

Orígenes personalizados

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

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

Al crear un inquilino de distribución, especifique el valor que se utilizará para parameter1.

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

Según los ejemplos anteriores especificados en la distribución de varios inquilinos, el nombre de dominio de origen para el inquilino de distribución se resuelve de la siguiente manera:

  • 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

Parámetros de ruta de origen

Del mismo modo, puede definir parámetros para la ruta de origen en la distribución de varios inquilinos como en los siguientes ejemplos:

  • /{{parameter2}}

  • /{{parameter2}}/test

  • /public/{{parameter2}}/test

  • /search?name={{parameter2}}

Al crear un inquilino de distribución, especifique el valor que se utilizará para parameter2.

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

Según los ejemplos anteriores especificados en la distribución de varios inquilinos, la ruta de origen para el inquilino de distribución se resuelve de la siguiente manera:

  • /myBrand

  • /myBrand/test

  • /public/myBrand/test

  • /search?name=myBrand

ejemplo Ejemplo

Desea crear varios sitios web (inquilinos) para los clientes y debe asegurarse de que cada recurso de inquilino de distribución utilice los valores correctos.

  1. Crea una distribución de varios inquilinos e incluye dos parámetros para la configuración del inquilino de distribución.

  2. Para el nombre de dominio de origen, crea un parámetro denominado customer-name y especifica que es obligatorio. Introduce el parámetro antes del bucket de S3, de modo que aparezca como:

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

  3. Para la ruta de origen, crea un segundo parámetro denominado my-theme y especifica que es opcional, con el valor predeterminado de basic. La ruta de origen aparece como /{{my-theme}}

  4. Al crear un inquilino de distribución:

    • En el nombre de dominio, debe especificar un valor para customer-name, ya que está marcado como obligatorio en la distribución de varios inquilinos.

    • Para la ruta de origen, puede especificar opcionalmente un valor para my-theme o utilizar el valor predeterminado.