Compartilhar via

Configurar um nome de domínio personalizado para um gateway auto-hospedado

APLICA-SE A: Desenvolvedor | Premium

Quando você provisiona um gateway de Gerenciamento de API do Azure auto-hospedado, ele não recebe um nome de host e deve ser referenciado por seu endereço IP. Este artigo mostra como mapear um nome DNS personalizado existente (também conhecido como nome do host) para um gateway auto-hospedado.

Pré-requisitos

  • Uma assinatura ativa do Azure.

    Se você ainda não tiver uma conta do Azure, crie uma conta gratuita antes de começar.

  • Uma instância de Gerenciamento de API. Para obter mais informações, consulte Criar uma instância do Gerenciamento de API do Azure.

  • Gateway auto-hospedado. Para obter mais informações, consulte o guia de provisionamento de um gateway auto-hospedado.

  • Um nome de domínio personalizado que pertence a você ou à sua organização. Este artigo não fornece instruções sobre como adquirir um nome de domínio personalizado.

  • Um registro DNS hospedado em um servidor DNS que mapeia o nome de domínio personalizado para o endereço IP do gateway auto-hospedado. Este artigo não fornece instruções sobre como hospedar um registro DNS.

  • Você deve ter um certificado válido com uma chave pública e privada (. PFX). O Assunto ou Nome Alternativo da Entidade (SAN) precisa corresponder ao nome de domínio. Isso permite que a instância de Gerenciamento de API exponha com segurança URLs por TLS.

Navegar até a instância de Gerenciamento de API

  1. No portal do Azure, pesquise e selecione Serviços de Gerenciamento de API:

    Captura de tela que mostra os serviços de Gerenciamento de API nos resultados da pesquisa.

  2. Na página Serviços do Gerenciamento de API, selecione sua instância do Gerenciamento de API:

    Captura de tela que mostra uma instância de Gerenciamento de API na página de serviços do Gerenciamento de API.

Adicionar um certificado de domínio personalizado

Adicione um arquivo de certificado de domínio personalizado (.PFX) na sua instância de API Management ou referencie um certificado armazenado no Azure Key Vault. Siga as etapas nos serviços de back-end seguros usando a autenticação de certificado do cliente no Gerenciamento de API do Azure.

Observação

Recomenda-se usar um certificado do Azure Key Vault para o domínio de gateway autogerenciado.

Definir um nome de domínio personalizado para seu gateway auto-hospedado

  1. No portal do Azure, selecione Implantação + infraestrutura no menu da barra lateral.
  2. Selecione gateways auto-hospedados e escolha o gateway auto-hospedado para o qual você deseja configurar o nome de domínio.
  3. Em Configurações, selecione Nomes de host.
  4. Selecione + Adicionar.
  5. Insira um nome de recurso para o nome do host no campo Nome .
  6. Insira o nome de domínio no campo Nome do Host .
  7. Selecione um certificado no menu suspenso Certificado.
  8. Marque a caixa de seleção Negociar certificado do cliente se alguma das APIs expostas por meio desse gateway usar a autenticação de certificado do cliente.

    Aviso

    Essa configuração é compartilhada por todos os nomes de domínio configurados para o gateway.

  9. Selecione Adicionar para atribuir o nome de domínio personalizado ao gateway auto-hospedado selecionado.

Observação

Se os clientes que se conectam ao gateway auto-hospedado usando o domínio personalizado esperam ser apresentados com todos os certificados intermediários na cadeia, você deve carregar certificados de AC individuais para o Serviço de Gerenciamento de API e associá-los ao gateway auto-hospedado. Para obter instruções sobre como fazer isso, consulte Criar AC personalizada para gateway auto-hospedado.

Conteúdo relacionado

  • Last updated on