Consulte os conectores compatíveis com a Application Integration.

Gatilho do IBM MQ

O gatilho do IBM MQ é um acionador de evento do conector que permite invocar uma integração com base nos eventos do IBM MQ que você se inscreveu na conexão do IBM MQ.

Importante:o Integration Connectors é um componente faturável do Google Cloud. Saiba mais sobre os custos e as cobranças do uso do Integration Connectors em Preços do Integration Connectors.

Antes de começar

Se você planeja criar ou configurar uma nova conexão para o gatilho do IBM MQ, verifique se você tem o seguinte papel do IAM no projeto:

• Administrador de conectores (roles/connectors.admin)

Para informações sobre como conceder papéis, consulte Gerenciar acesso.

Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o acionador do IBM MQ:

• Invocador do Application Integration (roles/integrations.integrationInvoker)

Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.

Adicionar o gatilho do IBM MQ

Para adicionar um gatilho do IBM MQ à sua integração, execute as seguintes etapas:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

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

   A página Lista de integrações aparece listando 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 você estiver criando uma integração:

   1. Digite um nome e uma descrição no painel Create Integration.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas.
      Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração na região selecionada.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

4. Na barra de navegação do editor de integração, clique em Gatilhos para conferir a lista de gatilhos disponíveis.
5. Clique e coloque o elemento de gatilho do IBM MQ no editor de integração.

Para configurar o acionador do IBM MQ, use uma conexão existente do IBM MQ disponível nos Integration Connectors ou uma nova conexão do IBM MQ usando a opção de criação de conexão inline.

Configurar o gatilho do IBM MQ usando uma conexão atual

É possível configurar o acionador do IBM MQ usando uma conexão existente do IBM MQ nos Integration Connectors. O gatilho do IBM MQ é um acionador de evento do conector. Portanto, só é possível usar uma conexão do IBM MQ com a assinatura de evento ativada para configurar o gatilho.

Para informações sobre como configurar um acionador do IBM MQ usando uma nova conexão do IBM MQ, consulte Configurar o gatilho do IBM MQ usando uma nova conexão.

Para configurar um acionador do IBM MQ usando uma conexão existente do IBM MQ, execute as seguintes etapas:

1. Clique no elemento Trigger do IBM MQ no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar gatilho.
3. Forneça os seguintes detalhes de configuração na página Editor do gatilho de evento do conector:
   1. Região: selecione a região da sua conexão do IBM MQ.
   2. Conexão: selecione a conexão do IBM MQ que você quer usar.

      A Application Integration exibe apenas as conexões do IBM MQ que estão ativas e com uma assinatura de eventos ativada.

   3. Selecione Queue ou Tópico como JMS Source Type.
      • Se você selecionar Queue, forneça o nome da fila do IBM MQ na coluna "Nome da origem do JMS".
      • Se você selecionar Topic, forneça o nome do tópico do IBM MQ na coluna Nome da origem do JMS.
   4. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o gatilho do IBM MQ.
4. Clique em Concluído para finalizar a configuração do acionador e fechar a página.

Configurar o gatilho do IBM MQ usando uma nova conexão

Para configurar o acionador do IBM MQ usando uma nova conexão do IBM MQ, execute as seguintes etapas:

1. Clique no elemento Trigger do IBM MQ no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar gatilho.
3. Ignore o campo Região.
4. Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
5. Siga estas etapas no painel Criar conexão:
   1. Na etapa Local, escolha o local da nova conexão do IBM MQ:
      1. Região:selecione uma região na lista suspensa.
      2. Clique em Próxima.
   2. Na etapa Detalhes da conexão, informe detalhes sobre a nova conexão do IBM MQ:
      1. Versão do conector: escolha uma versão disponível do conector do IBM MQ na lista suspensa.
      2. Nome da conexão: insira um nome para a conexão do IBM MQ.
         Observação:os nomes das conexões precisam atender aos seguintes critérios:

         • Os nomes de conexões podem usar letras, números ou hifens.
         • As letras precisam ser minúsculas.
         • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
         • Os nomes das conexões não podem exceder 63 caracteres.
      3. (Opcional) Descrição : insira uma descrição para a conexão.
      4. (Opcional) Ativar o Cloud Logging:marque essa caixa de seleção para armazenar todos os dados de registro da conexão.
      5. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para a conexão do IBM MQ.
      6. Ativar assinatura de eventos: selecione essa opção para ativar a assinatura de eventos para a conexão do IBM MQ.
         Observação : este conector não é compatível com a opção Enable only event subscription.
      7. (Opcional) Expanda Configurações avançadas para definir as configurações do nó de conexão.

         Para mais informações sobre as configurações do nó de conexão do IBM MQ, consulte a documentação de conexão do IBM MQ.

      8. (Opcional) Clique em + Adicionar rótulo para incluir um rótulo à conexão na forma de um par de chave-valor.
      9. Clique em Próxima.
   3. Como opção, se quiser usar SSL, selecione Ativar SSL. Os detalhes da configuração do SSL serão exibidos.
      1. Selecione um tipo de loja de confiança. Pode ser Pública, Particular ou Conexão não segura.
      2. Selecione os certificados com base na sua seleção de loja de confiança.
      3. Se você estiver usando mTLS, selecione os certificados de armazenamento de chaves na seção Armazenamento de chaves.
      4. Opcionalmente, selecione a versão TLS.
      5. Informe o pacote de criptografia compatível. Insira vários conjuntos de criptografia como valores separados por vírgulas. Para mais informações, consulte Conjuntos de criptografia compatíveis.
      Observação:

      • Todos os certificados precisam estar no formato X.509 e precisam estar no formato PEM (Privacy Enhanced Mail).
      • Não é possível selecionar um certificado diretamente ao configurar o SSL. Armazene todos os certificados e chaves privadas como um secret do Secret Manager e selecione o secret necessário durante a configuração do SSL.
   4. Na etapa Destinos, forneça os detalhes da instância do IBM MQ:
      1. Destination Type:selecione Host address.
      2. Host: insira o nome do host ou o endereço IP da instância do IBM MQ.
      3. Clique em Próxima.
   5. Na etapa Autenticação, forneça os detalhes de autenticação para a instância do IBM MQ:
      1. Selecione o tipo de autenticação desejado e insira os detalhes relevantes para acessar o URL do host do IBM MQ fornecido.

         Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

      2. Clique em Próxima.
   6. Revisão: revise os detalhes da conexão do IBM MQ fornecidos.
   7. Clique em Criar para concluir a criação de uma nova conexão do IBM MQ.
6. Clique em Concluído e feche a página.

Conjuntos de criptografia com suporte

Versão TLS	Conjuntos de criptografia com suporte
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 gatilho

O gatilho do IBM MQ leva alguns minutos para concluir a configuração da assinatura do evento. É possível ver o status da assinatura do evento no painel de configuração do acionador, em Detalhes da assinatura do evento.

O acionador do IBM MQ indica o status de uma assinatura de evento usando os seguintes estados:

• Creating: indica que o acionador está assinando a assinatura do evento.
• Active: indica que o acionador foi inscrito em uma assinatura de evento.
• Error: indica que há um problema com a inscrição de eventos configurada.

Além do status da inscrição do evento, a seção Detalhes da assinatura de evento também exibe outros detalhes, como região da conexão, nome da conexão e nome da inscrição do evento.

A imagem a seguir mostra um exemplo de layout do painel de configuração do gatilho do IBM MQ:

Variável de saída do acionador

Para cada evento, o gatilho do IBM MQ gera uma variável de saída ConnectorEventPayload (no formato JSON) que pode ser usada nas tarefas downstream. A variável de saída terá o payload do seu evento do IBM MQ. Exemplo:

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

Ver inscrições em eventos

Para conferir e gerenciar todas as assinaturas de eventos associadas a uma conexão no Integration Connectors, faça o seguinte:

1. Acesse a página Conectores de integração > Conexões.

   Acessar a página "Conexões"

2. Clique na conexão em que você quer exibir as assinaturas.
3. Clique na guia Inscrições em eventos.

   Todas as inscrições de eventos da conexão são exibidas.

Editar gatilho do IBM MQ

É possível editar um gatilho do IBM MQ para alterar ou atualizar a configuração de conexão e os detalhes de inscrição de eventos.

Importante: ao editar ou modificar um gatilho do IBM MQ, é possível manter ou excluir a assinatura de eventos configurada anteriormente que está anexada ao gatilho. A exclusão de uma assinatura de evento afeta todas as integrações publicadas que usam essa assinatura.

Para editar um gatilho do IBM MQ, execute as seguintes etapas:

1. Clique no elemento Trigger do IBM MQ no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar gatilho do IBM MQ.
3. Faça o seguinte na página Editor do gatilho de evento do conector:
   1. Para manter a assinatura de eventos configurada anteriormente, clique em Reter. Caso contrário, clique em Excluir.
      Aviso:a exclusão de uma assinatura de evento afeta todas as integrações publicadas que usam essa assinatura. Esta tarefa não pode ser desfeita.
   2. Atualize a configuração da conexão e os detalhes da inscrição no evento conforme desejado.
   3. Clique em Concluído.

Você pode ver os detalhes atualizados da conexão e das inscrições de eventos no painel de configuração do acionador, em Detalhes da inscrição de eventos.