

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