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

Acionador TIBCO EMS

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

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 acionador do TIBCO EMS, 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 TIBCO EMS:

• 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.

Adicione o acionador do TIBCO EMS

Para adicionar um acionador do TIBCO EMS à 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 TIBCO EMS no editor de integração.

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

Configure o acionador do TIBCO EMS através de uma associação existente

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

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

Para configurar um acionador do TIBCO EMS através de uma ligação do TIBCO EMS existente, siga estes passos:

1. Clique no elemento Acionador do TIBCO EMS 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 TIBCO EMS.
   2. Ligação: selecione a ligação TIBCO EMS que quer usar.

      A integração de aplicações só apresenta as ligações TIBCO EMS 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 TIBCO EMS na coluna Nome da origem JMS.
      • Se selecionar Topic, indique 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 as funções do IAM necessárias para o acionador do TIBCO EMS.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configure o acionador do TIBCO EMS com uma nova ligação

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

1. Clique no elemento Acionador do TIBCO EMS 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 TIBCO EMS:
      1. Região: selecione uma região na lista pendente.
      2. Clicar em Seguinte.
   2. No passo Detalhes da ligação, faculte detalhes sobre a nova ligação do TIBCO EMS:
      1. Versão do conector: escolha uma versão disponível do conector TIBCO EMS na lista pendente.
      2. Nome da associação: introduza um nome para a associação do TIBCO EMS.
         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 TIBCO EMS.
      6. Ativar subscrição de eventos: selecione esta opção para ativar a subscrição de eventos para a ligação TIBCO EMS.
         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 TIBCO EMS, consulte a documentação Ligação do TIBCO EMS.

      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. Selecione também o certificado de raiz do cliente na secção Configuração adicional.
      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).
      • A chave privada do cliente tem de estar no formato PKCS#8.
      • 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 TIBCO EMS:
      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 TIBCO EMS.
      3. Clicar em Seguinte.
   5. No passo Autenticação, indique os detalhes de autenticação da instância do TIBCO EMS:
      1. Selecione o tipo de autenticação pretendido e introduza os detalhes relevantes para aceder ao URL do anfitrião do TIBCO EMS 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 TIBCO EMS fornecidos.
   7. Clique em Criar para concluir a criação de uma nova ligação TIBCO EMS.
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 TIBCO EMS 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 TIBCO EMS 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 TIBCO EMS:

Variável de saída do acionador

Para cada evento, o acionador do TIBCO EMS gera uma variável de saída (no formato JSON) que pode usar nas tarefas a jusante.ConnectorEventPayload A variável terá a carga útil do seu evento TIBCO EMS. 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 TIBCO EMS

Pode editar um acionador do TIBCO EMS para alterar ou atualizar a configuração da associação e os detalhes da subscrição de eventos.

Importante: quando edita ou modifica um acionador do TIBCO EMS, 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 TIBCO EMS, siga estes passos:

1. Clique no elemento Acionador do TIBCO EMS no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador TIBCO EMS.
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.