

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalhar com nomes de host personalizados
<a name="requirements-dns"></a>

O *nome de host do servidor* é o nome do host que seus usuários inserem nos seus clientes ao se conectarem ao seu servidor . Você pode usar um domínio personalizado que você registrou para o nome de host do seu servidor ao trabalhar com AWS Transfer Family. Por exemplo, é possível usar um nome de host personalizado, como `mysftpserver.mysubdomain.domain.com`.

Para redirecionar o tráfego do domínio personalizado registrado para o endpoint do servidor, é possível usar o Amazon Route 53 ou qualquer provedor de Sistema de Nomes de Domínio (DNS). O Route 53 é o serviço DNS que AWS Transfer Family oferece suporte nativo.

**Topics**
+ [Usar o Amazon Route 53 como seu provedor de DNS.](#requirements-use-r53)
+ [Uso de outros provedores de DNS](#requirements-use-alt-dns)
+ [Nomes de host personalizados para servidores que não são criados por console](#tag-custom-hostname-cdk)

No console, é possível escolher uma destas opções para a configuração de um nome de host personalizado:
+ **Pseudônimo de DNS do Amazon Route 53** — se o nome do host que você deseja usar estiver registrado no Route 53. Em seguida, você pode inserir o nome do host.
+ **Outro DNS** - se o nome do host que você deseja usar estiver registrado em outro provedor DNS. Em seguida, você pode inserir o nome do host.
+ **Nenhum** - para usar o endpoint do servidor e não um nome de host personalizado.

Você define essa opção ao criar um novo servidor ou editar a configuração de um servidor existente. Para obter mais informações sobre como criar um novo servidor, consulte [Etapa 2: Criar um servidor habilitado para SFTP](getting-started.md#getting-started-server). Para obter mais informações sobre como editar a configuração de um servidor existente, consulte [Editar detalhes do servidor](edit-server-config.md).

Para obter mais detalhes sobre como usar seu próprio domínio para o nome do host do servidor e como AWS Transfer Family usa o Route 53, consulte as seções a seguir.

## Usar o Amazon Route 53 como seu provedor de DNS.
<a name="requirements-use-r53"></a>

Ao criar um servidor, é possível usar o Amazon Route 53 como provedor de DNS. Antes de usar um domínio no Route 53, registre o domínio. Para obter mais informações, consulte [Como funciona o registro de domínio](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/welcome-domain-registration.html) no *Guia do desenvolvedor do Amazon Route 53*.

Quando você usa o Route 53 para fornecer roteamento DNS ao seu servidor, AWS Transfer Family usa o nome de host personalizado que você inseriu para extrair sua zona hospedada. Ao AWS Transfer Family extrair uma zona hospedada, três coisas podem acontecer:

1. Se você é novo no Route 53 e não tem uma zona hospedada, AWS Transfer Family adiciona uma nova zona hospedada e um `CNAME` registro. O valor desse registro `CNAME` é o nome de host do endpoint para o seu servidor. Um *CNAME *é um nome de domínio alternativo.

1. Se você tiver uma zona hospedada no Route 53 sem registros de `CNAME`, o AWS Transfer Family adicionará um registro `CNAME` à zona hospedada.

1. Se o serviço detectar que um registro `CNAME` já existe na zona hospedada, você receberá uma mensagem de erro indicando que um registro `CNAME` já existe. Nesse caso, altere o valor do registro de `CNAME` para o nome de host do seu servidor. 

Para obter mais informações sobre zonas hospedadas no Route 53, consulte [Zona hospedada](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/CreatingHostedZone.html) no *Guia do desenvolvedor do Amazon Route 53*.

## Uso de outros provedores de DNS
<a name="requirements-use-alt-dns"></a>

Ao criar um servidor, você também pode usar provedores de DNS diferentes do Amazon Route 53. Se você usar um provedor de DNS alternativo, precisará se certificar de que o tráfego do seu domínio é direcionado para o endpoint do servidor do .

Para isso, defina seu domínio para o nome de host do endpoint no servidor.
+ Para IPv4 endpoints, o nome do host tem a seguinte aparência no console:

   `serverid.server.transfer.region.amazonaws.com` 
+ Para endpoints de pilha dupla, o nome do host tem a seguinte aparência no console:

   `serverid.transfer-server.region.on.aws` 

**nota**  
Se seu servidor tiver um VPC endpoint, o formato do nome do host será diferente dos descritos acima. Para encontrar seu endpoint da VPC, selecione o VPC na página de detalhes do servidor e, em seguida, selecione o **ID do endpoint da VPC** no painel da VPC. O endpoint é o primeiro nome DNS dos listados.

## Nomes de host personalizados para servidores que não são criados por console
<a name="tag-custom-hostname-cdk"></a>

Ao criar um servidor usando AWS Cloud Development Kit (AWS CDK) CloudFormation, ou por meio da CLI, você deve adicionar uma tag se quiser que o servidor tenha um nome de host personalizado. Ao criar um servidor Transfer Family ao usar o console, a marcação é feita automaticamente.

**nota**  
Você também precisa criar um registro DNS para redirecionar o tráfego do seu domínio para o endpoint do servidor. Para obter detalhes, consulte Como [trabalhar com registros](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/rrsets-working-with.html) no *Guia do desenvolvedor do Amazon Route 53*.

Use as seguintes chaves para seu nome de host personalizado:
+ Adicione `transfer:customHostname` para exibir o nome de host personalizado no console.
+ Se você não está usando o Route 53 como provedor de DNS, adicione `transfer:route53HostedZoneId`. Essa tag vincula o nome do host personalizado ao seu ID de zona hospedada do Route 53.

Para adicionar o nome de host personalizado, emita o seguinte comando da CLI.

```
aws transfer tag-resource --arn arn:aws:transfer:region:Conta da AWS:server/server-ID --tags Key=transfer:customHostname,Value="custom-host-name"
```

Por exemplo:

```
aws transfer tag-resource --arn arn:aws:transfer:us-east-1:111122223333:server/s-1234567890abcdef0 --tags Key=transfer:customHostname,Value="abc.example.com"
```

Se você estiver usando o Route 53, emita o comando a seguir para vincular seu nome de host personalizado ao ID da zona hospedada do Route 53.

```
aws transfer tag-resource --arn server-ARN:server/server-ID --tags Key=transfer:route53HostedZoneId,Value=HOSTED-ZONE-ID
```

Por exemplo:

```
aws transfer tag-resource --arn arn:aws:transfer:us-east-1:111122223333:server/s-1234567890abcdef0 --tags Key=transfer:route53HostedZoneId,Value=ABCDE1111222233334444
```

Assumindo os valores de exemplo do comando anterior, execute o comando a seguir para visualizar suas tags:

```
aws transfer list-tags-for-resource --arn arn:aws:transfer:us-east-1:111122223333:server/s-1234567890abcdef0
```

```
"Tags": [
   {
      "Key": "transfer:route53HostedZoneId",
      "Value": "/hostedzone/ABCDE1111222233334444"
   },
   {
      "Key": "transfer:customHostname",
      "Value": "abc.example.com"
   }
 ]
```

**nota**  
 Suas zonas públicas hospedadas e IDs as delas estão disponíveis no Amazon Route 53.   
Faça login no Console de gerenciamento da AWS e abra o console do Route 53 em [https://console.aws.amazon.com/route53/](https://console.aws.amazon.com/route53/).