Personalizações de locatários da distribuição - Amazon CloudFront
Como os parâmetros funcionam com locatários da distribuiçãoParâmetros de exemplo

Personalizações de locatários da distribuição

Ao usar uma distribuição multilocatário, os locatários da distribuição herdam a configuração da distribuição multilocatário. No entanto, não é possível personalizar algumas configurações no nível de locatário da distribuição.

Você pode personalizar as seguintes opções:

  • Parâmetros: os parâmetros são pares de chave-valor que podem ser usados para o domínio de origem ou os caminhos de origem. Consulte Como os parâmetros funcionam com locatários da distribuição.

  • ACL da web do AWS WAF (V2): você pode especificar uma ACL da web separada para o locatário da distribuição, que substituirá a ACL da web usada para a distribuição multilocatário. Você também pode desabilitar essa configuração para um locatário específico da distribuição, o que significa que esse locatário não herdará as proteções da ACL da web da distribuição multilocatário. Para obter mais informações, consulte ACL da WEb do AWS WAF.

  • Restrições geográficas: as restrições geográficas especificadas para um locatário da distribuição substituirão quaisquer restrições geográficas da distribuição multilocatário. Por exemplo, se você bloquear a Alemanha (DE) em sua distribuição multilocatário, todos os locatários da distribuição associados também a bloquearão. No entanto, se você permiti-la para um locatário específico da distribuição, as configurações desse locatário substituirão as configurações da distribuição multilocatário. Para obter mais informações, consulte Restringir a distribuição geográfica do conteúdo.

  • Caminhos de invalidação: especifique os caminhos de arquivo referentes ao conteúdo que você deseja invalidar para o locatário da distribuição. Para obter mais informações, consulte Invalidar arquivos.

  • Certificados TLS personalizados: os certificados do AWS Certificate Manager (ACM) que você especifica para locatários da distribuição são complementares ao certificado fornecido na distribuição multilocatário. Contudo, se o mesmo domínio for coberto pelos certificados da distribuição multilocatário e da distribuição do locatário, o certificado do locatário será usado. Para obter mais informações, consulte Solicitar certificados para locatários de distribuição do CloudFront.

  • Nomes de domínio: é necessário especificar pelo menos um nome de domínio por locatário da distribuição.

Como os parâmetros funcionam com locatários da distribuição

Um parâmetro é um par de chave-valor que você pode usar para valores de espaço reservado. Defina os parâmetros que você deseja usar na distribuição multilocatário e especifique se eles são obrigatórios.

Ao definir parâmetros em uma distribuição multilocatário, você escolhe se esses parâmetros devem ser inseridos no nível de locatário da distribuição.

  • Se você definir os parâmetros como obrigatórios na distribuição multilocatário, eles deverão ser inseridos no nível de locatário da distribuição. (Eles não são herdados.)

  • Se os parâmetros não forem obrigatórios, você poderá fornecer um valor padrão na distribuição multilocatário, que será herdado pelo locatário da distribuição.

Você também pode usar parâmetros nas seguintes propriedades:

  • Nome do domínio de origem

  • Caminho de origem

Na distribuição multilocatário, você pode definir até dois parâmetros para cada uma das propriedades anteriores.

Parâmetros de exemplo

Veja os exemplos a seguir para usar parâmetros para o nome do domínio e o caminho de origem.

Parâmetros do nome de domínio

Na configuração de distribuição multilocatária, você pode definir um parâmetro para o nome de domínio de origem, como nos exemplos a seguir:

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

Origens personalizadas

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

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

Ao criar um locatário de distribuição, especifique o valor a ser usado para parameter1.

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

Usando os exemplos anteriores especificados na distribuição multilocatária, o nome de domínio de origem do locatário da distribuição é resolvido para o seguinte:

  • 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 do caminho de origem

Da mesma forma, você pode definir parâmetros para o caminho de origem na distribuição multilocatária, como nos exemplos a seguir:

  • /{{parameter2}}

  • /{{parameter2}}/test

  • /public/{{parameter2}}/test

  • /search?name={{parameter2}}

Ao criar um locatário de distribuição, especifique o valor a ser usado para parameter2.

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

Usando os exemplos anteriores especificados na distribuição multilocatária, o caminho de origem do locatário da distribuição é resolvido para o seguinte:

  • /myBrand

  • /myBrand/test

  • /public/myBrand/test

  • /search?name=myBrand

exemplo Exemplo

É necessário criar vários sites (locatários) para seus clientes e garantir que cada recurso de locatário da distribuição use os valores corretos.

  1. Você cria uma distribuição multilocatário e inclui dois parâmetros para a configuração de locatário da distribuição.

  2. Com relação ao nome de domínio de origem, você cria um parâmetro chamado customer-name e especifica que ele é obrigatório. Você insere o parâmetro antes do bucket do S3, para que ele apareça como:

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

  3. Para o caminho de origem, você cria um segundo parâmetro chamado my-theme e especifica que ele é opcional, com um valor padrão basic. Seu caminho de origem aparece como: /{{my-theme}}

  4. Quando você criar um locatário de distribuição:

    • Para o nome de domínio, você deve especificar um valor para customer-name, porque ele está marcado como obrigatório na distribuição multilocatária.

    • Para o caminho de origem, você pode, opcionalmente, especificar um valor para my-theme ou usar o valor padrão.