Partilhar via

Criar e usar conexões híbridas no Serviço de Aplicativo do Azure

As Conexões Híbridas são um serviço no Azure e um recurso no Serviço de Aplicativo do Azure. Como serviço, ele tem usos e recursos além dos que são usados no Serviço de Aplicativo. Para saber mais sobre Conexões Híbridas e seu uso fora do Serviço de Aplicativo, consulte Conexões híbridas de retransmissão do Azure.

No Serviço de Aplicativo, as Conexões Híbridas podem ser usadas para acessar recursos de aplicativos em qualquer rede que possa fazer chamadas de saída para o Azure pela porta 443. As Conexões Híbridas fornecem acesso do seu aplicativo a um ponto de extremidade TCP. Ele não habilita uma nova maneira de acessar seu aplicativo. Conforme usado no Serviço de Aplicativo, cada Conexão Híbrida se correlaciona a uma única combinação de host TCP e porta.

Esse recurso permite que seus aplicativos acessem recursos em qualquer sistema operacional, desde que seja um ponto de extremidade TCP. O recurso Conexões híbridas não sabe nem se importa com o que é o protocolo do aplicativo ou com o que você está acessando. Ele simplesmente fornece acesso à rede.

Como funciona

As Conexões Híbridas exigem que um agente de retransmissão seja implantado onde ele possa alcançar o ponto de extremidade desejado e o Azure. O agente de retransmissão, Hybrid Connection Manager (HCM), chama o Azure Relay pela porta 443. No site do aplicativo Web, a infraestrutura do Serviço de Aplicativo também se conecta ao Azure Relay em nome do seu aplicativo. Por meio das conexões associadas, seu aplicativo pode acessar o ponto de extremidade desejado. A conexão usa TLS 1.2 para chaves de segurança e assinatura de acesso compartilhado (SAS) para autenticação e autorização.

Diagrama de fluxo de alto nível do Hybrid Connection.

Quando seu aplicativo faz uma solicitação DNS que corresponde a um ponto de extremidade de Conexão Híbrida configurado, o tráfego TCP de saída é redirecionado por meio da Conexão Híbrida.

Nota

Este fato significa que você deve tentar sempre usar um nome DNS para sua conexão híbrida. Alguns programas de cliente não fazem uma consulta DNS se o endpoint usar um endereço IP.

Benefícios da Conexão Híbrida do Serviço de Aplicativo

Há muitos benefícios para o recurso de conexões híbridas, incluindo:

  • Os aplicativos podem acessar sistemas e serviços locais com segurança.
  • O recurso não requer um endpoint acessível pela Internet.
  • É rápido e fácil de configurar. Não são necessários gateways.
  • Cada Conexão Híbrida corresponde a uma única combinação host:port, o que é útil para a segurança.
  • Normalmente, não requer furos de firewall. As conexões são todas efetuadas para fora através de portas web padrão.
  • Como o recurso é de nível de rede, é agnóstico à linguagem que a sua aplicação utiliza e à tecnologia que o endpoint utiliza.
  • Ele pode ser usado para fornecer acesso em várias redes a partir de um único aplicativo.
  • Suportado em GA para aplicativos Windows e aplicativos Linux. Não há suporte para Conexões Híbridas para contêineres personalizados do Windows.

Coisas que você não pode fazer com conexões híbridas

As coisas que você não pode fazer com as Conexões Híbridas incluem:

  • Monte uma unidade.
  • Usa o UDP.
  • Acesse serviços baseados em TCP que usam portas dinâmicas, como o Modo Passivo FTP ou o Modo Passivo Estendido.
  • Suporte LDAP, porque pode exigir UDP.
  • Ofereça suporte ao Ative Directory, porque você não pode ingressar no domínio de um trabalhador do Serviço de Aplicativo.

Adicionar e criar conexões híbridas em seu aplicativo

Para criar uma Conexão Híbrida no portal do Azure:

  1. No portal do Azure, selecione seu aplicativo. Selecione Configurações>de rede.

  2. Ao lado de Conexões híbridas, selecione o link Não configurado . Aqui você pode ver as Conexões Híbridas configuradas para seu aplicativo.

    Captura de ecrã da lista Ligação Híbrida onde pode adicionar e gerir ligações.

  3. Para adicionar uma nova conexão híbrida, selecione Adicionar conexão híbrida. Você verá uma lista das Conexões Híbridas que você já criou. Para adicionar um ou mais deles ao seu aplicativo, selecione os desejados e selecione Adicionar conexão híbrida selecionada.

    Captura de ecrã da página Ligação Híbrida onde pode adicionar uma ligação.

Se quiser criar uma nova conexão híbrida, selecione Criar nova conexão híbrida. Especifique os seguintes valores:

  • Nome da conexão híbrida.
  • Nome do host do ponto final.
  • Porta de endpoint.
  • Namespace do Service Bus que você deseja usar.

Captura de ecrã da caixa de diálogo Criar nova ligação híbrida.

Cada Conexão Híbrida está vinculada a um namespace do Service Bus. Cada namespace do Barramento de Serviço está numa região do Azure. Para evitar a latência induzida pela rede, use um namespace do Service Bus na mesma região do seu aplicativo.

Se quiser remover a Ligação Híbrida da sua aplicação, clique com o botão direito do rato na mesma e selecione Desligar.

Quando uma Conexão Híbrida é adicionada ao seu aplicativo, você pode ver detalhes sobre ele simplesmente selecionando-o.

Captura de tela dos detalhes das conexões híbridas.

Criar uma conexão híbrida em ARM/Bicep

Para criar uma conexão híbrida usando um modelo ARM/Bicep, adicione o seguinte recurso ao seu modelo existente. Você deve incluir o userMetadata para ter uma conexão híbrida válida. Se você não incluir o userMetadata, a Conexão Híbrida não funcionará. Se você criar a Conexão Híbrida no portal do Azure, essa propriedade será preenchida automaticamente para você.

A userMetadata propriedade deve ser uma representação de cadeia de caracteres de uma matriz JSON no formato [{/"key/": /"endpoint/", /"value/" : /"<HOST>:<PORT>/"}]. Para obter mais informações, consulte Microsoft.Relay namespaces/hybridConnections.

resource hybridConnection 'Microsoft.Relay/namespaces/hybridConnections@2024-01-01' = {
  parent: relayNamespace
  name: hybridConnectionName
  properties: {
    requiresClientAuthorization: true
    userMetadata: '[{/"key/": /"endpoint/", /"value/" : /"<HOST>:<PORT>/"}]'
  }
}

Criar uma conexão híbrida no portal de retransmissão do Azure

Além da experiência do portal a partir da sua aplicação, pode criar Ligações Híbridas a partir do portal de Retransmissão do Azure. Para que uma Conexão Híbrida seja usada pelo Serviço de Aplicativo, ela deve:

  • Requer autorização do cliente.
  • Tenha um item de metadados e um ponto de extremidade nomeado que contenha uma combinação host: port como valor.

Conexões híbridas e planos do Serviço de Aplicações

As Conexões Híbridas do Serviço de Aplicativo estão disponíveis apenas em SKUs de preços Básico, Padrão, Premium e Isolado. As Conexões Híbridas não estão disponíveis para aplicativos funcionais nos planos de Consumo. Existem limites ligados ao plano de preços.

Plano de preços Número de conexões híbridas utilizáveis no plano
Básico 5 por cada plano
Standard 25 por plano
Premium (v1-v4) 220 por aplicação
IsoladoV2 220 por aplicação

A interface do usuário do plano do Serviço de Aplicativo mostra quantas Conexões Híbridas estão sendo usadas e por quais aplicativos.

Captura de ecrã das propriedades do plano de Serviço de Aplicações.

Para ver detalhes, selecione a Conexão híbrida. Você pode ver todas as informações que viu na visualização do aplicativo. Você também pode ver quantos outros aplicativos no mesmo plano estão usando essa Conexão Híbrida.

Há um limite para o número de pontos de extremidade de Ligação Híbrida que podem ser usados num Plano de Serviço de Aplicações. Cada Conexão Híbrida usada pode ser usada em qualquer número de aplicativos nesse plano. Por exemplo, uma única Conexão Híbrida usada em cinco aplicativos separados em um plano do Serviço de Aplicativo conta como uma Conexão Híbrida.

Preços

Além de haver um requisito de SKU do plano do App Service, há um custo extra para usar Conexões Híbridas. Há uma cobrança para cada ouvinte que uma conexão híbrida usa. O ouvinte é o Hybrid Connection Manager. Se você tivesse cinco Conexões Híbridas suportadas por dois Gerenciadores de Conexões Híbridas, seriam 10 ouvintes. Para obter mais informações, consulte Preços do Service Bus.

Gestor de Ligações Híbridas

O recurso Conexões Híbridas requer um agente de retransmissão na rede que hospeda seu ponto de extremidade de Conexão Híbrida. Esse agente de retransmissão é chamado de HCM (Hybrid Connection Manager). Para descarregar o Hybrid Connection Manager, siga as instruções correspondentes ao seu cliente.

Esta ferramenta é executada em Windows e Linux. O Gestor de Conexões Híbridas é executado como um serviço e estabelece ligação de saída para o Azure Relay na porta 443. No Windows, a versão atual requer o Windows Server 2012 ou posterior, mas suporta apenas a interface CLI no Windows Server 2012 (a GUI requer o Windows Server 2016 ou posterior). Uma versão herdada que suporta a GUI no Windows Server 2012 está disponível, mas não é recomendada - consulte a observação na seção de solução de problemas para obter detalhes.

Nota

A partir de 20 de outubro de 2025, o Barramento de Serviço do Azure não suporta mais TLS 1.0 e TLS 1.1. A versão mínima do TLS agora é 1.2 para todas as implantações do Service Bus. As conexões híbridas usam o Service Bus para conectividade. O Gerenciador de Conexões Híbridas do Serviço de Aplicativo versão 0.7.7 e posterior oferece suporte ao TLS 1.2. Se você estiver em uma versão anterior, deverá atualizar para a nova versão do Hybrid Connection Manager o mais rápido possível para evitar a interrupção do serviço.

Instruções de instalação

Para instalar o Hybrid Connection Manager no Windows, baixe o pacote MSI e siga as instruções de instalação.

Download do Windows

Nota

O Azure Relay depende de Web Sockets para conectividade. Esse recurso só está disponível no Windows Server 2012 ou posterior. Devido a esse requisito, o Gerenciador de Conexões Híbridas não é suportado em sistemas anteriores ao Windows Server 2012.

Para suportar as Ligações Híbridas com que está configurado, o Gestor de Ligações Híbridas requer:

  • Acesso TCP ao Azure pela porta 443.
  • Acesso TCP ao endpoint de Hybrid Connection.
  • Os clientes Windows usam as portas 4999-5001 por defeito. Estas portas podem ser modificadas, se necessário.
  • Os clientes Linux usam a porta 5001 por defeito. Esta porta pode ser modificada se necessário.
  • A capacidade de fazer pesquisas de DNS no host do ponto de extremidade e no namespace do Service Bus. Em outras palavras, o nome do host na conexão de retransmissão do Azure deve ser resolúvel a partir da máquina que hospeda o Gerenciador de Conexões Híbridas.

Introdução à GUI do Hybrid Connection Manager

Depois de instalar o Gerenciador de Conexões Híbridas, no Windows, procure por GUI do Gerenciador de Conexões Híbridas na caixa de pesquisa.

Captura de ecrã do Hybrid Connection Manager.

Quando você inicia a GUI do Gerenciador de Conexões Híbridas, a primeira coisa que você vê é uma tabela que lista todas as Conexões Híbridas configuradas com essa instância do Gerenciador de Conexões Híbridas.

Para adicionar uma ou mais Conexões Híbridas à GUI do Gerenciador de Conexões Híbridas:

  1. Inicie a GUI do Gerenciador de Conexões Híbridas.
  2. Selecione + Novo.
  3. Selecione Selecionar com o Azure.
  4. Inicie sessão com a sua conta do Azure para disponibilizar as suas Ligações Híbridas com as suas subscrições. O Gestor de Ligações Híbridas não continua a utilizar a sua conta do Azure para além deste passo.
  5. Escolha uma subscrição.
  6. Selecione as Conexões Híbridas que você deseja que o Gerenciador de Conexões Híbridas retransmita.
  7. Selecione Criar.

Agora você pode ver as Conexões Híbridas adicionadas.

Captura de ecrã da Ligação Híbrida adicionada ao Gestor de Ligações Híbridas.

Você também pode selecionar a Conexão híbrida configurada para ver os detalhes.

Captura de tela dos detalhes da conexão híbrida.

Introdução à CLI do Hybrid Connection Manager

No Windows, você pode usar a CLI do Gerenciador de Conexões Híbridas procurando e abrindo a CLI do Gerenciador de Conexões Híbridas.

Para usar o modo interativo com a CLI do Gerenciador de Conexões Híbridas, que permite exibir sua assinatura do Azure e detalhes da Conexão Híbrida, você precisa instalar e entrar na CLI do Azure. Para obter instruções de instalação, consulte Como instalar a CLI do Azure e selecione a opção apropriada para seu cliente. Uma vez instalado, execute az login e siga as instruções para concluir o login.

Ao iniciar a CLI do Gerenciador de Conexões Híbridas, você pode executar hcm list para ver as Conexões Híbridas que já foram adicionadas.

Para adicionar conexões híbridas à CLI do Gerenciador de conexões híbridas:

  1. Inicie a CLI do Gerenciador de Conexões Híbridas.

  2. Execute hcm add e aguarde a conclusão da autenticação no Azure. Se você não tiver instalado e conectado à CLI do Azure, precisará concluir esta etapa primeiro para usar o modo interativo. Se você não quiser instalar a CLI do Azure, siga as instruções para adicionar manualmente uma Conexão Híbrida com a CLI.

    Captura de tela da adição de uma conexão híbrida com a CLI.

  3. Escolha uma subscrição. O Hybrid Connection Manager recupera todas as Conexões Híbridas nessa assinatura. Esta etapa pode levar até um minuto para ser concluída.

  4. Selecione a Conexão Híbrida que você deseja que o Gerenciador de Conexões Híbridas retransmita.

Execute hcm list para ver as Conexões Híbridas adicionadas.

Você também pode mostrar os detalhes de uma Conexão Híbrida específica com o hcm show comando.

Captura de ecrã dos detalhes da ligação híbrida na CLI.

Configurar portas personalizadas

Por defeito, o Hybrid Connection Manager utiliza as portas 4999-5001 no Windows e a porta 5001 no Linux. Podes configurar portas personalizadas se as portas padrão não estiverem disponíveis ou se o teu ambiente exigir atribuições de portas diferentes.

Nota

A configuração de portas personalizadas só é suportada no Hybrid Connection Manager versão 1.2.5 ou posterior.

Para configurar portas personalizadas no Windows, navegue até Editar as variáveis do ambiente do sistema com a Pesquisa do Windows e adicione as seguintes variáveis de ambiente. Certifica-te de que estás a editar a secção de Variáveis do Sistema , não as variáveis de utilizador.

  • HCM_GUI_PORT
  • HCM_SERVICE_PORT

Define o valor de cada variável para o número de porta que queres usar. Por exemplo, HCM_GUI_PORT=1234.

Nota

Se definires estas variáveis de ambiente depois de o Hybrid Connection Manager ter sido instalado, tens de reiniciar o HybridConnectionManagerService através de Services no Windows Search. Recomendamos definir estas variáveis antes de instalar o Hybrid Connection Manager para evitar problemas com o serviço a captar esses valores.

Definir configurações do servidor proxy

Se você precisar definir as configurações do servidor proxy para o Gerenciador de Conexões Híbridas, edite a ProxySettingsappsettings.json seção no arquivo localizada em:

  • Windows: C:\ProgramData\HybridConnectionManager\
  • Linux: /usr/share/HybridConnectionManager/

Depois de editar o arquivo de configuração, reinicie o serviço Gerenciador de Conexões Híbridas para aplicar as novas configurações de proxy:

  • Windows: Reinicie o serviço através de Serviços no Menu Iniciar.
  • Linux: Executar systemctl restart hybridconnectionmanager.service.

A configuração de um servidor proxy roteia solicitações do Gerenciador de Conexões Híbridas através do servidor proxy selecionado antes de chegar ao destino. Certifique-se de que o seu servidor proxy suporta tráfego HTTP/HTTPS para que o Gestor de Ligações Híbridas possa comunicar com o Serviço de Retransmissão do Azure.

Nota

Todos os endereços definidos em appsettings.json (ProxyAddress, BypassList) devem estar no formato RegEx, se não forem uma correspondência exata.

Redundância

Cada Hybrid Connection Manager pode suportar várias conexões híbridas. Vários Gerenciadores de Conexões Híbridas podem suportar qualquer Conexão Híbrida. O comportamento padrão é rotear o tráfego através dos Gerenciadores de Conexões Híbridas configurados para qualquer ponto de extremidade. Se você quiser alta disponibilidade em suas conexões híbridas de sua rede, execute vários gerenciadores de conexões híbridas em máquinas separadas. O algoritmo de distribuição de carga usado pelo serviço de retransmissão para distribuir o tráfego para os Gerenciadores de Conexões Híbridas é uma atribuição aleatória.

Adicionar manualmente uma conexão híbrida

Para permitir que alguém fora da sua assinatura hospede uma instância do Gerenciador de Conexões Híbridas para uma determinada Conexão Híbrida, compartilhe a cadeia de conexão do gateway para a Conexão Híbrida com essa pessoa. Você pode ver a cadeia de conexão do gateway nas propriedades de Conexão Híbrida do seu Serviço de Aplicativo no portal do Azure. A cadeia de conexão do gateway está no formato Endpoint=sb://[NAMESPACE].servicebus.windows.net/;SharedAccessKeyName=defaultListener;SharedAccessKey=[KEY];EntityPath=[HYBRID-CONNECTION-NAME].

Captura de ecrã da cadeia de ligação do gateway de Ligação Híbrida no portal do Azure.

Para usar essa cadeia de caracteres na GUI do Gerenciador de Conexões Híbridas, selecione + Novo e Usar Cadeia de Conexão e cole na cadeia de conexão do gateway.

Captura de ecrã da caixa de diálogo onde adiciona manualmente uma Ligação Híbrida.

Para usar essa cadeia de caracteres na CLI do Gerenciador de Conexões Híbridas, execute hcm add com a cadeia de conexão ou com os detalhes do recurso Conexão Híbrida.

Captura de tela da CLI do Gerenciador de Conexões Híbridas mostrando como adicionar manualmente uma Conexão Híbrida.

Melhoria

Há atualizações periódicas para o Hybrid Connection Manager para corrigir problemas ou fornecer melhorias. Quando as atualizações são lançadas, uma caixa de diálogo aparece na GUI do Gerenciador de Conexões Híbridas na inicialização. Para verificar se há atualizações disponíveis com a CLI do Gerenciador de Conexões Híbridas, execute hcm version. As atualizações devem ser feitas usando o instalador MSI e não podem ser feitas usando a CLI. A aplicação da atualização aplica as alterações e reinicia o Hybrid Connection Manager.

Adicionar uma conexão híbrida ao seu aplicativo programaticamente

Há suporte à CLI do Azure para Conexões Híbridas. Os comandos fornecidos operam no nível do aplicativo e do plano do Serviço de Aplicativo. Os comandos no nível do aplicativo são:

az webapp hybrid-connection

Group
    az webapp hybrid-connection : Methods that list, add and remove hybrid-connections from webapps.
        This command group is in preview. It may be changed/removed in a future release.
Commands:
    add    : Add a hybrid-connection to a webapp.
    list   : List the hybrid-connections on a webapp.
    remove : Remove a hybrid-connection from a webapp.

Os comandos do plano do Serviço de Aplicativo permitem que você defina qual chave uma determinada conexão híbrida usa. Há duas chaves definidas em cada conexão híbrida, uma primária e uma secundária. Você pode optar por usar a chave primária ou secundária com os seguintes comandos. Esta opção permite-lhe mudar de teclas para quando quiser regenerar periodicamente as suas chaves.

az appservice hybrid-connection --help

Group
    az appservice hybrid-connection : A method that sets the key a hybrid-connection uses.
        This command group is in preview. It may be changed/removed in a future release.
Commands:
    set-key : Set the key that all apps in an appservice plan use to connect to the hybrid-
                connections in that appservice plan.

Proteja suas conexões híbridas

Qualquer utilizador que tenha permissões suficientes num Azure Service Bus Relay pode adicionar uma Conexão Híbrida existente para essa retransmissão a outras aplicações Web do App Service. Para impedir que outras pessoas reutilizem essa mesma Conexão Híbrida, bloqueie o acesso ao Relay do Azure Service Bus. Essa situação pode acontecer quando o recurso de destino é um serviço que não tem outras medidas de segurança em vigor para impedir o acesso não autorizado.

Qualquer pessoa com Reader acesso à Retransmissão poderá ver a Conexão Híbrida se tentar adicioná-la ao seu Aplicativo Web no portal do Azure. Eles não podem adicioná-lo porque não têm as permissões para recuperar a cadeia de conexão usada para estabelecer a conexão de retransmissão. Para adicionar a conexão híbrida, eles devem ter a listKeys permissão (Microsoft.Relay/namespaces/hybridConnections/authorizationRules/listKeys/action). A Contributor função ou qualquer outra função que inclua essa permissão na Retransmissão permite aos utilizadores usar a Conexão Híbrida e adicioná-la às suas próprias Aplicações Web.

Gerencie suas conexões híbridas

Se você precisar alterar o host ou a porta do ponto de extremidade para uma conexão híbrida, use as seguintes etapas:

  1. No Hybrid Connection Manager, selecione a conexão para ver sua janela de detalhes. Em seguida, selecione Remover.
  2. No portal do Azure, selecione seu aplicativo. Selecione Configurações>de rede.
  3. Ao lado de Conexões híbridas, selecione o link Configurado .
  4. Em Conexões híbridas, clique com o botão direito do mouse na conexão e selecione Desconectar.
  5. Navegue até ao Relay para o ponto de acesso que necessita atualizar. No menu de navegação, em Entidades, selecione Conexões híbridas em Entidades.
  6. Selecione a Conexão híbrida. No menu de navegação, em Configurações, selecione Propriedades.
  7. Faça as alterações e selecione Salvar alterações.
  8. Retorne às configurações de Conexões Híbridas do Serviço de Aplicativo e adicione a Conexão Híbrida novamente. Certifique-se de que o ponto de extremidade está atualizado conforme pretendido. Se você não vir a Conexão Híbrida na lista, atualize em 5 a 10 minutos.
  9. Retorne ao Hybrid Connection Manager na máquina local e adicione a conexão novamente.

Resolução de Problemas

O status de Conectado significa que pelo menos um Gerenciador de Conexões Híbridas está configurado com essa Conexão Híbrida e pode acessar o Azure. Se o status da sua Conexão Híbrida não disser Conectado, sua Conexão Híbrida não estará configurada em nenhum Gerenciador de Conexões Híbridas que tenha acesso ao Azure. Quando o Gestor de Ligações Híbridas mostrar Não Ligado, há alguns aspetos a verificar:

  • Seu host tem acesso de saída ao Azure na porta 443? Você pode testar a partir do host do Gerenciador de Conexões Híbridas usando o comando Test-NetConnection Destination -P PortPowerShell.

  • O seu Hybrid Connection Manager está potencialmente em mau estado? Tente reiniciar o serviço local Azure Hybrid Connection Manager Service.

  • Você tem software conflitante instalado? O Gerenciador de Conexões Híbridas não pode coexistir com o Gerenciador de Conexões Híbridas do Biztalk ou o Service Bus for Windows Server. Ao instalar o Hybrid Connection Manager, você deve remover todas as versões desses pacotes primeiro.

  • Você tem um firewall entre o host do Gerenciador de Conexões Híbridas e o Azure? Em caso afirmativo, você precisa permitir o acesso de saída à URL do ponto de extremidade do Service Bus e aos gateways do Service Bus que servem a sua Conexão Híbrida.

    • Você pode encontrar a URL do ponto de extremidade do Service Bus na GUI do Gerenciador de Conexões Híbridas.

      Captura de ecrã do ponto de extremidade do Hybrid Connection Service Bus.

    • Você também pode encontrar a URL do ponto de extremidade do Service Bus na CLI do Gerenciador de Conexões Híbridas.

      Captura de tela do ponto de extremidade do Barramento de Serviço de Conexão Híbrida na CLI.

    • Os gateways do Service Bus são os recursos que aceitam a solicitação na Conexão Híbrida e a passam pelo Azure Relay. Tens de permitir a lista de todos os gateways. Os gateways estão no formato: G#-prod-[stamp]-sb.servicebus.windows.net e GV#-prod-[stamp]-sb.servicebus.windows.net. O sinal numérico, #, é um número entre 0 e 127 e stamp é o nome da instância no data center do Azure onde o ponto de extremidade do Service Bus existe.

    • Se conseguir usar um coringa, pode permitir a lista *.servicebus.windows.net.

    • Se não conseguires usar um coringa, tens de permitir listar todos os 256 gateways.

      Você pode descobrir o carimbo usando nslookup na URL do ponto de extremidade do Service Bus.

      Captura de ecrã do terminal a mostrar onde encontrar o nome do carimbo para o Service Bus.

      Neste exemplo, o carimbo é sn3-010. Para permitir a listagem dos gateways do Service Bus, precisa das seguintes entradas:

      G0-prod-sn3-010-sb.servicebus.windows.net
      G1-prod-sn3-010-sb.servicebus.windows.net
      G2-prod-sn3-010-sb.servicebus.windows.net
      G3-prod-sn3-010-sb.servicebus.windows.net
      ...
      G126-prod-sn3-010-sb.servicebus.windows.net
      G127-prod-sn3-010-sb.servicebus.windows.net
      GV0-prod-sn3-010-sb.servicebus.windows.net
      GV1-prod-sn3-010-sb.servicebus.windows.net
      GV2-prod-sn3-010-sb.servicebus.windows.net
      GV3-prod-sn3-010-sb.servicebus.windows.net
      ...
      GV126-prod-sn3-010-sb.servicebus.windows.net
      GV127-prod-sn3-010-sb.servicebus.windows.net

Se o seu estado indicar Ligado , mas a sua aplicação não conseguir alcançar o seu ponto final, então:

  • Certifique-se de que está a utilizar um nome DNS na sua Ligação Híbrida. Se você usar um endereço IP, a pesquisa de DNS do cliente necessária pode não acontecer. Se o cliente em execução no seu aplicativo Web não fizer uma pesquisa de DNS, a Conexão Híbrida não funcionará.
  • Verifique se o nome DNS usado na sua Conexão Híbrida pode ser resolvido a partir do host do Gerenciador de Conexões Híbridas. Verifique a resolução usando nslookup EndpointDNSname onde EndpointDNSname é uma correspondência exata com o que é usado na sua definição de Conexão Híbrida.
  • Teste o acesso do host do Gerenciador de Conexões Híbridas ao ponto de extremidade usando o comando Test-NetConnection EndpointDNSname -P PortPowerShell. Se não conseguir aceder ao ponto de extremidade a partir do anfitrião do Gestor de Ligações Híbridas, verifique as firewalls entre os dois anfitriões, incluindo quaisquer firewalls baseadas no host de destino.
  • Se você estiver usando o Serviço de Aplicativo no Linux, certifique-se de que não está usando localhost como host de ponto final. Em vez disso, use o nome da máquina se estiver tentando criar uma conexão com um recurso na máquina local.

No Serviço de Aplicativo, a ferramenta de linha de comando tcpping pode ser invocada a partir do console de Ferramentas Avançadas (Kudu). Essa ferramenta pode dizer se você tem acesso a um ponto de extremidade TCP, mas não informa se você tem acesso a um ponto de extremidade de Conexão Híbrida. Quando utiliza a ferramenta no console num ponto de extremidade de Conexão Híbrida, está apenas a confirmar que utiliza uma combinação de anfitrião e porta.

Se tiver um cliente de linha de comando para o seu ponto de extremidade, pode testar a conectividade no console da aplicação. Por exemplo, podes testar o acesso aos endpoints do servidor web usando curl.

Nota

Disponibilidade do Gestor de Conexões Híbrido Legado: A versão legada do Hybrid Connection Manager está disponível se necessário e pode ser descarregada aqui. Esta versão não está mais sendo atualizada e suporta apenas clientes Windows. É recomendável usar a versão mais recente do Hybrid Connection Manager para todas as novas instalações e atualizações para instalações existentes.

Para perguntas e suporte específico para Conexões Híbridas do Serviço de Aplicativo e Gerenciador de Conexões Híbridas do Serviço de Aplicativo, entre em contato com hcmsupport@service.microsoft.com.

  • Last updated on