Header Ads

Como configurar um domínio personalizado para o gateway da API da AWS

O API Gateway da AWS é excelente como um front-end para funções Lambda e outros serviços da AWS. No entanto, o ponto de extremidade padrão é um subdomínio de amazonaws. com, que não é amigável ao usuário. Mostraremos como corrigir e configurar um domínio personalizado.

Solicitando um certificado do ACM e do link API Gateway

Você precisará da propriedade do nome de domínio que deseja usar para a API. Você provavelmente colocará isso em um subdomínio como api. example. com. Para fazer isso, você precisará fazer duas coisas: solicitar um certificado SSL do AWS Certificate Manager (ACM) para proteger as solicitações feitas à API e atualizar sua configuração de DNS para apontar para o API Gateway.

Entre e vá para o console do ACM. A partir daqui, selecione "Solicitar um certificado", ” e especifique "Público" ” como o tipo.

Em seguida, digite os nomes de domínio que você gostaria de usar para este certificado. Você pode adicionar vários domínios aqui, mas um provavelmente é suficiente, pois os estágios da API são divididos por sub-URLs de qualquer maneira.

Você tem duas opções para validação. O primeiro exigirá que você atualize sua configuração de DNS com um registro CNAME. O segundo enviará um e-mail de verificação ao e-mail que você possui no contato para o domínio. Isso não funcionará se o seu e-mail não for visível de who. is, o que acontecerá se você tiver proteção WhoisGuard.

A configuração do DNS é bastante fácil, então vamos com isso. A próxima tela mostrará o nome e o valor do registro que você precisará escrever. Se você estiver usando o Route 53, o serviço de registro de domínios e DNS da Amazon, este processo é automático e você pode simplesmente pressionar 'Criar registro na rota 53'; para fazer isso por você.

Pode levar alguns minutos para que as alterações sejam propagadas se você estiver usando um registrador de terceiros. Uma vez validado, seu certificado deve alterar o status para "Emitido", ” e estará pronto para vincular ao API Gateway.

Alterne para o console do API Gateway e clique em "Nomes de domínio personalizados" ” na barra lateral. Crie um novo, digite seu nome de domínio e selecione o certificado que você acabou de criar. Você também precisará garantir que o tipo de API correto esteja selecionado.

Clique em criar e um novo domínio deve aparecer na lista. Clique em “ Edit ” para adicionar um mapeamento de caminho. Isso vinculará um subdomínio específico (por exemplo, api. example. com/v1/) à API e o estágio que você escolher.

Provavelmente, seria uma boa ideia criar caminhos diferentes para diferentes estágios da API, como um caminho de desenvolvimento para o estágio $ default e um caminho de produção para o estágio voltado para o usuário.

Depois de criado, copie o “ Nome de Domínio de Destino ” valor. É isso que você precisará atualizar a configuração do DNS (não o ponto de extremidade da API).

Vinculando seu DNS ao API Gateway

Você notará nesta fase que, se você visitar o URL no seu navegador, nada acontecerá. O API Gateway está configurado para usar seu domínio com segurança, mas não está recebendo tráfego porque o DNS não está apontando ninguém em nenhum lugar.

Para DNS de terceiros, você precisará usar um registro CNAME. Isso mapeia um nome de domínio para outro nome de domínio, mas requer uma pesquisa de DNS extra. Cole o “ nome de domínio de destino ” valor para o domínio personalizado que você configurou no API Gateway.

 api. example. com CNAME api-id. execute-api. region. amazonaws. com/stage

Se você estiver usando o Route 53, a configuração é mais simples. Você pode obter o mesmo efeito em uma pesquisa usando um registro A definido como "Alias" ” modo, um tipo de registro especial que permite mapear o registro diretamente para um nome de recurso da AWS. Basta selecionar a API na lista suspensa e clicar em criar.

As alterações levarão um pouco para serem propagadas, mas sua API agora deve estar disponível no seu nome de domínio. Se não estiver funcionando, verifique novamente se você está se conectando através de HTTPS, pois ele não aceita conexões não seguras.

Via: How to Geek

Nenhum comentário