Gatilho do TIBCO EMS

O gatilho do TIBCO EMS é um gatilho de evento do conector que permite invocar uma integração com base nos eventos do TIBCO EMS a que você se inscreveu na sua conexão do TIBCO EMS.

Importante:Integration Connectors são um componente faturável do Google Cloud. Para informações sobre os custos e as cobranças de uso Integration Connectors, consulte os preços dos conectores de integração.

Antes de começar

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

• Administrador do conector (roles/connectors.admin)

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

Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho do TIBCO EMS:

• 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 TIBCO EMS

Para adicionar um gatilho do TIBCO EMS à sua integração, siga estas 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 com todas as integrações disponíveis no projeto do Google Cloud.

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

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Digite um nome e uma descrição no painel Criar integração.
   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. É possível 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 de integração.
      Observação:a opção de selecionar uma conta de serviço só aparece se você tiver ativado a governança de 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 conferir a lista de acionadores disponíveis.
5. Clique e coloque o elemento Gatilho do TIBCO EMS no editor de integração.

Para configurar o gatilho do TIBCO EMS, use uma conexão do TIBCO EMS disponível no Integration Connectors ou crie uma usando a opção de criação de conexão inline.

Configurar o gatilho do TIBCO EMS usando uma conexão atual

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

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

Para configurar um gatilho do TIBCO EMS usando uma conexão do TIBCO EMS, siga estas etapas:

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

      Application Integration mostra apenas as conexões do TIBCO EMS que estão ativas e têm uma assinatura de evento ativada.

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

Configurar o gatilho do TIBCO EMS usando uma nova conexão

Para configurar o gatilho do TIBCO EMS usando uma nova conexão do TIBCO EMS, siga estas etapas:

1. Clique no elemento gatilho do TIBCO EMS no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar acionador.
3. Ignore o campo Região.
4. Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
5. Conclua as etapas a seguir no painel Criar conexão:
   1. Na etapa Local, escolha o local da nova conexão do TIBCO EMS:
      1. Região:selecione uma região na lista suspensa.
      2. Clique em Próxima.
   2. Na etapa Detalhes da conexão, forneça detalhes sobre a nova conexão do TIBCO EMS:
      1. Versão do conector:escolha uma versão disponível do conector TIBCO EMS na lista suspensa.
      2. Nome da conexão:insira um nome para a conexão do TIBCO EMS.
         Observação:os nomes de conexão 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 TIBCO EMS.
      6. Ativar inscrição de eventos:selecione essa opção para ativar a inscrição de eventos na conexão do TIBCO EMS.
         Observação : esse 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ó da conexão.

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

      8. (Opcional) Clique em + Adicionar rótulo para adicionar 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. Selecione também o certificado raiz do cliente na seção Configuração adicional.
      4. Opcionalmente, selecione a versão TLS.
      5. Insira o pacote de criptografia compatível. Insira vários pacotes de ícones como valores separados por vírgulas. Para mais informações, consulte Pacotes de criptografia compatíveis.
      Observação:

      • Todos os certificados precisam estar no formato X.509 e precisam estar no formato PEM (Privacy Enhanced Mail).
      • Sua chave privada do cliente precisa estar no formato PKCS#8.
      • Não é possível selecionar um certificado diretamente ao configurar o SSL. É preciso armazenar todos os seus certificados e chaves privadas como um secret do Secret Manager e, em seguida, selecionar o secret exigido durante a configuração do SSL.
   4. Na etapa Destinos, forneça os detalhes da instância do TIBCO EMS:
      1. Tipo de destino:selecione Endereço do host.
      2. Host:insira o nome do host ou o endereço IP da sua instância do TIBCO EMS.
      3. Clique em Próxima.
   5. Na etapa Autenticação, forneça os detalhes de autenticação da instância do TIBCO EMS:
      1. Selecione o tipo de autenticação desejado e insira os detalhes relevantes para acessar o URL do host do TIBCO EMS 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 de conexão do TIBCO EMS fornecidos.
   7. Clique em Criar para concluir a criação de uma conexão do TIBCO EMS.
6. Clique em Concluído e feche a página.

Pacotes de criptografia compatíveis

Versão TLS	Pacotes de criptografia compatíveis
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 TIBCO EMS leva alguns minutos para concluir a configuração de inscrição no evento. É possível conferir o status da sua assinatura de evento no painel de configuração do gatilho em Detalhes da assinatura de evento.

O gatilho do TIBCO EMS indica o status de uma assinatura de evento usando os seguintes estados:

• Creating: indica que o gatilho está se inscrevendo na assinatura de evento.
• Active: indica que o gatilho foi inscrito em uma assinatura de evento.
• Error: indica que há um problema com a assinatura de evento configurada.

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

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

Variável de saída do gatilho

Para cada evento, o acionador do TIBCO EMS 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 TIBCO EMS. Exemplo:

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

Ver inscrições em eventos

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

1. Acesse a página Integration Connectors > Conexões.

   Acessar a página "Conexões"

2. Clique na conexão para ver as assinaturas.
3. Clique na guia Assinaturas de eventos.

   Isso mostra todas as inscrições de eventos da conexão.

Editar gatilho do TIBCO EMS

É possível editar um gatilho do TIBCO EMS para mudar ou atualizar a configuração de conexão e os detalhes da inscrição no evento.

Importante:ao editar ou modificar um gatilho do TIBCO EMS, você pode manter ou excluir a assinatura de evento 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 TIBCO EMS, siga estas etapas:

1. Clique no elemento gatilho do TIBCO EMS no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar gatilho do TIBCO EMS.
3. Faça o seguinte na página Editor de gatilho de evento do conector:
   1. Para manter a assinatura de evento configurada anteriormente, clique em Manter. Caso contrário, clique em Excluir.
      Aviso:excluir uma assinatura de evento vai afetar 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 necessário.
   3. Clique em Concluído.

Você pode conferir os detalhes atualizados da conexão e da assinatura de evento no painel de configuração do gatilho em Detalhes da assinatura de evento.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais sobre o tratamento de erros.
• Saiba mais sobre os registros de execução de integração.