Consulte os conetores suportados para a solução Application Integration.

Acionador do IBM MQ

O acionador do IBM MQ é um acionador de eventos de conector que lhe permite invocar uma integração com base nos eventos do IBM MQ aos quais subscreveu na sua ligação do IBM MQ.

Importante: os conectores de integração são um componente faturável do Google Cloud. Para informações sobre os custos e as cobranças da utilização dos Conetores de integração, consulte o artigo Preços dos Conetores de integração.

Antes de começar

Se planeia criar ou configurar uma nova associação para o trigger do IBM MQ, certifique-se de que tem a seguinte função de IAM no projeto:

• Administrador do conetor (roles/connectors.admin)

Para informações sobre a concessão de funções, consulte o artigo Faça a gestão do acesso.

Conceda as seguintes funções de IAM à conta de serviço que quer usar para o acionador do IBM MQ:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Para obter informações sobre a atribuição de funções a uma conta de serviço, consulte o artigo Faça a gestão do acesso às contas de serviço.

Nota: o acionador do IBM MQ suporta o protocolo JMS (Java Message Service). Outros protocolos, como MQTT e AMQP, não são suportados.

Adicione o acionador do IBM MQ

Para adicionar um acionador do IBM MQ à sua integração, siga estes passos:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Integrações

   A página Lista de integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

   Se estiver a criar uma nova integração:

   1. Introduza um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
   3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
   4. Clique em Criar.

   A integração recém-criada é aberta no editor de integração.

4. Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
5. Clique e coloque o elemento Acionador do IBM MQ no editor de integração.

Para configurar o trigger do IBM MQ, pode usar uma ligação do IBM MQ existente disponível nos Integration Connectors ou criar uma nova ligação do IBM MQ através da opção de criação de ligações inline.

Configure o acionador do IBM MQ através de uma associação existente

Pode configurar o acionador do IBM MQ através de uma ligação do IBM MQ existente nos Integration Connectors. Tenha em atenção que o acionador do IBM MQ é um acionador de eventos de conetor. Por conseguinte, só pode usar uma ligação do IBM MQ com a subscrição de eventos ativada para configurar o acionador.

Para obter informações sobre como configurar um acionador do IBM MQ através de uma nova ligação do IBM MQ, consulte o artigo Configure o acionador do IBM MQ através de uma nova ligação

Para configurar um trigger do IBM MQ através de uma ligação do IBM MQ existente, siga estes passos:

1. Clique no elemento Acionador do IBM MQ no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador.
3. Forneça os seguintes detalhes de configuração na página Editor do acionador de eventos do conetor:
   1. Região: selecione a região da sua ligação IBM MQ.
   2. Ligação: selecione a ligação IBM MQ que quer usar.

      A integração de aplicações só apresenta as ligações do IBM MQ que estão ativas e têm uma subscrição de eventos ativada.

   3. Selecione Queue ou Tópico como JMS Source Type.
      • Se selecionar Queue, indique o nome da fila do IBM MQ na coluna Nome da origem JMS.
      • Se selecionar Topic, indique o nome do tópico do IBM MQ na coluna Nome da origem JMS.
   4. Conta de serviço: selecione uma conta de serviço com as funções do IAM necessárias para o acionador do IBM MQ.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configure o acionador do IBM MQ através de uma nova ligação

Para configurar o acionador do IBM MQ através de uma nova ligação do IBM MQ, siga estes passos:

1. Clique no elemento Acionador do IBM MQ no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador.
3. Ignore o campo Região.
4. Clique em Associação e selecione a opção Criar associação no menu pendente.
5. Conclua os seguintes passos no painel Criar associação:
   1. No passo Localização, escolha a localização para a nova ligação IBM MQ:
      1. Região: selecione uma região na lista pendente.
      2. Clicar em Seguinte.
   2. No passo Detalhes da ligação, indique os detalhes da nova ligação IBM MQ:
      1. Versão do conector: escolha uma versão disponível do conector do IBM MQ na lista pendente.
      2. Nome da ligação: introduza um nome para a ligação IBM MQ.
         Nota: os nomes das associações têm de cumprir os seguintes critérios:

         • Os nomes das associações podem usar letras, números ou hífenes.
         • As letras têm de ser minúsculas.
         • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
         • Os nomes das associações não podem exceder 63 carateres.
      3. (Opcional) Descrição: introduza uma descrição para a associação.
      4. (Opcional) Ativar registo na nuvem: selecione esta caixa de verificação para armazenar todos os dados de registo da ligação.
      5. Conta de serviço: selecione uma conta de serviço com as funções do IAM necessárias para a ligação do IBM MQ.
      6. Ativar subscrição de eventos: selecione esta opção para ativar a subscrição de eventos para a ligação IBM MQ.
         Nota: este conector não suporta a opção Enable only event subscription.
      7. (Opcional) Expanda Definições avançadas para configurar as definições do nó de ligação.

         Para mais informações sobre as definições do nó de ligação para o IBM MQ, consulte a documentação Ligação IBM MQ.

      8. (Opcional) Clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par de chave-valor.
      9. Clicar em Seguinte.
   3. Opcionalmente, se quiser usar SSL, selecione Ativar SSL. São apresentados os detalhes da configuração SSL.
      1. Selecione um tipo de loja fidedigna. Pode ser Público, Privado ou Ligação não segura.
      2. Selecione os certificados conforme apresentado com base na sua seleção da loja de confiança.
      3. Se estiver a usar o mTLS, selecione os certificados do armazenamento de chaves na secção Armazenamento de chaves.
      4. Opcionalmente, selecione a versão do TLS.
      5. Introduza o conjunto de cifras suportado. Introduza várias suites de cifragem como valores separados por vírgulas. Para mais informações, consulte o artigo Conjuntos de cifras suportados.
      Nota:

      • Todos os seus certificados têm de ser certificados X.509 e têm de estar no formato PEM (Privacy Enhanced Mail).
      • Não pode selecionar diretamente um certificado quando configura o SSL. Tem de armazenar todos os seus certificados e chaves privadas como um segredo do Secret Manager e, em seguida, selecionar o segredo necessário durante a configuração SSL.
   4. No passo Destinos, indique os detalhes da instância do IBM MQ:
      1. Tipo de destino: selecione Endereço do anfitrião.
      2. Anfitrião: introduza o nome de anfitrião ou o endereço IP da sua instância do IBM MQ.
      3. Clicar em Seguinte.
   5. No passo Autenticação, indique os detalhes de autenticação da instância do IBM MQ:
      1. Selecione o tipo de autenticação pretendido e introduza os detalhes relevantes para aceder ao URL do anfitrião do IBM MQ fornecido.

         Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

      2. Clicar em Seguinte.
   6. Rever: reveja os detalhes da ligação do IBM MQ facultados.
   7. Clique em Criar para concluir a criação de uma nova ligação IBM MQ.
6. Clique em Concluído e feche a página.

Conjuntos de cifras suportados

Versão do TLS	Conjuntos de cifras suportados
1.2	TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 TLS_DHE_RSA_WITH_AES_128_CBC_SHA TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
1.3	TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 TLS_AES_128_GCM_SHA256

Saída do acionador

O acionador do IBM MQ demora alguns minutos a concluir a configuração da subscrição de eventos. Pode ver o estado da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

O acionador do IBM MQ indica o estado de uma subscrição de eventos através dos seguintes estados:

• Creating: indica que o acionador está a subscrever a subscrição de eventos.
• Active: indica que o acionador subscreveu com êxito uma subscrição de eventos.
• Error: indica que existe um problema com a subscrição de eventos configurada.

Além do estado da subscrição de eventos, a secção Detalhes da subscrição de eventos também apresenta outros detalhes, como a região de ligação, o nome da ligação e o nome da subscrição de eventos.

A imagem seguinte mostra um esquema de exemplo do painel de configuração do acionador do IBM MQ:

Variável de saída do acionador

Para cada evento, o acionador do IBM MQ gera uma variável de saída ConnectorEventPayload (em formato JSON) que pode usar nas tarefas posteriores. A variável vai ter o payload do seu evento do IBM MQ. Por exemplo:

{
"message": "Hello world",
"messageContentType": "Text"
}

Veja as subscrições de eventos

Para ver e gerir todas as subscrições de eventos associadas a uma ligação nos Integration Connectors, faça o seguinte:

1. Aceda à página Integration Connectors > Ligações.

   Aceda à página Ligações

2. Clique na associação para a qual quer ver as subscrições.
3. Clique no separador Subscrições de eventos.

   Esta apresenta todas as subscrições de eventos da associação.

Edite o acionador do IBM MQ

Pode editar um trigger do IBM MQ para alterar ou atualizar a configuração da ligação e os detalhes da subscrição de eventos.

Importante: quando edita ou modifica um acionador do IBM MQ, pode manter a subscrição de eventos configurada anteriormente que está anexada ao acionador ou eliminá-la. A eliminação de uma subscrição de eventos afeta todas as integrações publicadas que usam essa subscrição de eventos.

Para editar um acionador do IBM MQ, siga estes passos:

1. Clique no elemento Acionador do IBM MQ no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador do IBM MQ.
3. Faça o seguinte na página Editor de acionadores de eventos do conetor:
   1. Para manter a subscrição de eventos configurada anteriormente, clique em Manter. Caso contrário, clique em Eliminar.
      Aviso: a eliminação de uma subscrição de eventos afeta todas as integrações publicadas que usam a subscrição de eventos. Não é possível anular esta tarefa.
   2. Atualize a configuração da associação e os detalhes da subscrição de eventos conforme pretendido.
   3. Clique em Concluído.

Pode ver os detalhes atualizados da associação e da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais acerca do processamento de erros.
• Saiba mais sobre os registos de execução da integração.