

# Personalizações de locatários da distribuição
<a name="tenant-customization"></a>

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](#tenant-customize-parameters).
+ **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 [AWS WAFACL da WEb do](DownloadDistValuesGeneral.md#DownloadDistValuesWAFWebACL).
+ **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](georestrictions.md).
+ **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](Invalidation_Requests.md).
+ **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](managed-cloudfront-certificates.md).
+ **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
<a name="tenant-customize-parameters"></a>

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
<a name="examples-parameters"></a>

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}}`



**Example 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.

1. 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`.

1. 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}}}}`

1. 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.