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. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Microsoft Azure Service Bus associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (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 de um destes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).

Uma conexão existente do Microsoft Azure Service Bus pode ser editada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).

Configurar uma conexão do Microsoft Azure Service Bus

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

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

• Active Directory do Azure: Autorizar solicitações para entidades do Service Bus usando um aplicativo do Azure Active Directory. Para obter mais informações sobre essa opção, consulte a documentação da Microsoft Autenticar de um aplicativo.

  Nota

  O aplicativo Azure Active Directory deve receber determinadas funções para conceder acesso a um namespace do Service Bus. Para obter informações sobre as funções internas do Azure para autorizar acesso a um namespace do Service Bus, consulte Funções internas do Azure para o Azure Service Bus na documentação da Microsoft Autenticar de um aplicativo.

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

Active Directory do Azure

Se Azure Active Directory for selecionado para Tipo de autenticação, esta interface será apresentada:

• Nome da conexão: Insira um nome para usar 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 :. Esse nome também é usado para identificar o endpoint do Microsoft Azure Service Bus, que se refere a uma conexão específica e suas atividades.

• Tipo de autenticação: Use o menu para selecionar Azure Active Directory para autorizar solicitações para entidades do Service Bus usando o aplicativo Azure Active Directory. Para obter mais informações sobre essa opção, consulte a documentação da Microsoft Autenticar de um aplicativo.

  Nota

  O aplicativo Azure Active Directory deve receber determinadas funções para conceder acesso a um namespace do Service Bus. Para obter informações sobre as funções internas do Azure para autorizar acesso a um namespace do Service Bus, consulte Funções internas do Azure para o Azure Service Bus na documentação da Microsoft Autenticar de um aplicativo.

• Namespace / Nome do host: Insira o Service Bus namespace ou endereço de namespace usando o nome do namespace como um nome de host. Por exemplo, ambos spsbusns1028 e 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 do aplicativo (cliente) para o registro do aplicativo.

• Segredo do cliente: Insira o 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 pelo(s) 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 Desabilitar atualização automática do conector política da organização.

• Salvar alterações: Clique para salvar e fechar a configuração de 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 você confirmar 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Assinaturas de acesso compartilhado

Se Assinaturas de acesso compartilhado for selecionado para Tipo de autenticação, esta interface será apresentada:

• Nome da conexão: Insira um nome para usar 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 :. Esse nome também é usado para identificar o endpoint do Microsoft Azure Service Bus, que se refere a uma conexão específica e 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 / Nome do host: Insira o Service Bus namespace ou endereço de namespace usando o nome do namespace como um nome de host. Por exemplo, ambos spsbusns1028 e spsbusns1028.servicebus.windows.net são válidos e apontam para o mesmo namespace do Service Bus.

• Nome da Política: Insira o namespace regra da política de autorização nome para a conexão. Por padrão, os namespaces do Service Bus têm um RootManageSharedAccessKey política do administrador. É recomendado que você crie outra política para uso de integração.

  Importante

  • Para usar a atividade Enviar mensagem, a regra da política de autorização deve incluir direitos de envio.
  • Para usar as atividades Consume Queue e Consume Topic, a regra da política de autorização deve incluir direitos de escuta.

• Primary Key: Insira a chave primária que corresponde ao Policy Name. Cada regra de política de autorização recebe sua própria chave primária.

• 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 pelo(s) 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 Desabilitar atualização automática do conector política da organização.

• Salvar alterações: Clique para salvar e fechar a configuração de 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 você confirmar 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos passos

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

As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Esses tipos de atividade estão disponíveis:

• Obter mensagem de fila: Recupera todas as mensagens em uma fila do Microsoft Azure Service Bus e se destina a ser usado como fonte em uma operação.

• Desbloquear mensagem do tópico: Desbloqueia mensagens em um Microsoft Azure Service Bus tópico e se destina a ser usado como alvo em uma operação.

• Excluir mensagem da fila: Exclui mensagens de uma fila do Microsoft Azure Service Bus e se destina a ser usado como alvo em uma operação.

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

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

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

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

• Fila de consumo: Consome mensagens de um Microsoft Azure Service Bus fila e se destina a ser usado como fonte em uma operação.

• Renovar bloqueio de mensagem de fila: Renova bloqueios de mensagens em uma fila do Microsoft Azure Service Bus e se destina a ser usado como alvo em uma operação.

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

• Mensagem de desbloqueio da fila: Desbloqueia mensagens de um Microsoft Azure Service Bus fila e se destina a ser usado como alvo em uma operação.