Partilhar via

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

APLICA-SE A: Developer | 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 de host) para um gateway auto-hospedado.

Pré-requisitos

  • Uma assinatura ativa do Azure.

    Se 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 de Gerenciamento de API do Azure.

  • Um gateway auto-hospedado. Para obter mais informações, consulte Como provisionar gateway próprio.

  • Um nome de domínio personalizado que pertence a si ou à sua organização. Este artigo não fornece instruções sobre como obter 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 o nome alternativo do assunto (SAN) precisa corresponder ao nome de domínio. Isso permite que a instância de Gerenciamento de API exponha URLs com segurança por TLS.

Vá para a sua instância de Gestão de API

  1. No Portal do Azure , procure e selecione Serviços de Gestão de API:

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

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

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

Adicionar um certificado de domínio personalizado

Adicione um certificado de domínio personalizado (. PFX) para sua instância de Gerenciamento de API ou faça referência a um certificado armazenado no Cofre de Chaves do Azure. Siga as etapas em Serviços de back-end seguros usando a autenticação de certificado de cliente no Gerenciamento de API do Azure.

Observação

Recomendamos o uso de um certificado de cofre de chaves para o domínio de gateway auto-hospedado.

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, em seguida, 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 na lista suspensa de Certificado .
  8. Marque a caixa de seleção Negociar certificado de cliente se alguma das APIs expostas por meio deste gateway usar autenticação de certificado de cliente.

    Advertência

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

  9. Selecione e 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 receber todos os certificados intermediários na cadeia, você deve carregar certificados de CA individuais para o Serviço de Gerenciamento de API e associá-los ao gateway auto-hospedado. Para obter instruções sobre como conseguir isso, consulte Criar CA personalizada para gateway auto-hospedado.

Conteúdo relacionado

  • Last updated on