Conexão do Microsoft Azure Service Bus

Introdução

Uma conexão do Microsoft Azure Service Bus, criada usando o conector do Microsoft Azure Service Bus, estabelece acesso ao Microsoft Azure Service Bus. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Microsoft Azure Service Bus associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Criar ou editar uma conexão do Microsoft Azure Service Bus

Uma nova conexão do Microsoft Azure Service Bus é criada usando o conector do Microsoft Azure Service Bus a partir de uma destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).

Uma conexão existente do Microsoft Azure Service Bus pode ser editada a partir destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).
• A página Endpoints Globais (veja Editar um endpoint global em Endpoints Globais).

Configurar uma conexão do Microsoft Azure Service Bus

Cada elemento da interface do usuário da tela de configuração da conexão do Microsoft Azure Service Bus é descrito abaixo.

A interface utilizada durante a configuração da conexão depende do Tipo de Autenticação selecionado:

• Microsoft Entra ID: Autoriza solicitações para entidades do Service Bus usando um aplicativo Microsoft Entra ID. Para mais informações sobre esta opção, consulte a documentação da Microsoft Autenticar a partir de um aplicativo.

  Nota

  O aplicativo Microsoft Entra ID deve ter atribuído o papel de Proprietário de Dados do Azure Service Bus, conforme descrito em Pré-requisitos.

• Assinaturas de acesso compartilhado: Autoriza solicitações para entidades do Service Bus usando uma chave primária atribuída a uma regra de política de autorização.

Microsoft Entra ID

Se Microsoft Entra ID for selecionado como Tipo de Autenticação, a interface descrita abaixo será apresentada.

• Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão do Microsoft Azure Service Bus e não deve conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint do Microsoft Azure Service Bus, que se refere tanto a uma conexão específica quanto às suas atividades.

• Tipo de autenticação: Use o menu para selecionar Microsoft Entra ID para autorizar solicitações a entidades do Service Bus usando a aplicação do Microsoft Entra ID. Para mais informações sobre esta opção, consulte a documentação da Microsoft Autenticar a partir de uma aplicação.

  Nota

  A aplicação do Microsoft Entra ID deve ter atribuído o papel de Proprietário de Dados do Azure Service Bus para o Namespace do Service Bus, conforme descrito em Pré-requisitos.

• Namespace / Nome do host: Insira o namespace ou o endereço do namespace do Service Bus usando o nome do namespace como um nome de host. Por exemplo, tanto spsbusns1028 quanto spsbusns1028.servicebus.windows.net são válidos e apontam para o mesmo namespace do Service Bus.

• ID do locatário: Insira o ID do Diretório (locatário) para o registro do aplicativo.

• ID do cliente: Insira o ID da Aplicação (cliente) para o registro do aplicativo.

• Segredo do cliente: Insira o Valor do segredo do cliente para o registro do aplicativo.

• Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a política organizacional Desativar Atualização Automática do Conector.

• Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Assinaturas de Acesso Compartilhado

Se Assinaturas de Acesso Compartilhado for selecionado para Tipo de Autenticação, a interface descrita abaixo será apresentada.

• Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser único para cada conexão do Microsoft Azure Service Bus e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint do Microsoft Azure Service Bus, que se refere tanto a uma conexão específica quanto às suas atividades.

• Tipo de Autenticação: Use o menu para selecionar Assinaturas de Acesso Compartilhado para autorizar solicitações a entidades do Service Bus usando uma chave primária atribuída a uma regra de política de autorização.

• Namespace / Hostname: Insira o namespace ou o endereço do namespace do Service Bus usando o nome do namespace como um hostname. Por exemplo, tanto spsbusns1028 quanto spsbusns1028.servicebus.windows.net são válidos e apontam para o mesmo namespace do Service Bus.

• Nome da política: Insira o nome da regra de política de autorização de acesso compartilhado do namespace. Por padrão, os namespaces do Service Bus têm uma política de administrador chamada RootManageSharedAccessKey. Recomenda-se criar outra política para uso em integração.

  Importante

  • Para usar a atividade Enviar Mensagem, a regra de política de autorização deve incluir direitos de envio.
  • Para usar as atividades Consumir Fila e Consumir Tópico, a regra de política de autorização deve incluir direitos de escuta.

• Chave primária: Insira a Chave Primária que corresponde ao Nome da Política. Cada regra de política de autorização recebe sua própria Chave Primária.

• Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

• Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para confirmar que você deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão do Microsoft Azure Service Bus, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Noções básicas sobre conectores.

Estes tipos de atividade estão disponíveis:

• Obter Mensagem da Fila: Recupera todas as mensagens em uma fila do Microsoft Azure Service Bus e é destinado a ser usado como uma fonte em uma operação.

• Desbloquear Mensagem do Tópico: Desbloqueia mensagens em um tópico do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

• Excluir Mensagem da Fila: Exclui mensagens de uma fila do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

• Consumir Tópico: Consome mensagens de um tópico do Microsoft Azure Service Bus e é destinado a ser usado como uma fonte em uma operação.

• Renovar Bloqueio de Mensagem do Tópico: Renova bloqueios de mensagens em um tópico do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

• Excluir Mensagem do Tópico: Exclui mensagens de um tópico do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

• Enviar Mensagem: Envia mensagens para uma fila ou tópico do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

• Consumir Fila: Consome mensagens de uma fila do Microsoft Azure Service Bus e é destinado a ser usado como uma fonte em uma operação.

• Renovar Bloqueio de Mensagem da Fila: Renova bloqueios de mensagens em uma fila do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.

• Obter Mensagem do Tópico: Recupera mensagens de um tópico do Microsoft Azure Service Bus e é destinado a ser usado como uma fonte em uma operação.

• Desbloquear Mensagem da Fila: Desbloqueia mensagens de uma fila do Microsoft Azure Service Bus e é destinado a ser usado como um alvo em uma operação.