Consultez les connecteurs compatibles avec Application Integration.

Déclencheur TIBCO EMS

Le déclencheur TIBCO EMS est un déclencheur d'événement de connecteur qui vous permet d'appeler une intégration en fonction des événements TIBCO EMS auxquels vous vous êtes abonné dans votre connexion TIBCO EMS.

Important : Les connecteurs d'intégration sont un composant facturable de Google Cloud. Pour en savoir plus sur les coûts et les frais d'utilisation des connecteurs d'intégration, consultez la page Tarifs Integration Connectors.

Avant de commencer

Si vous envisagez de créer ou de configurer une nouvelle connexion pour le déclencheur TIBCO EMS, assurez-vous de disposer du rôle IAM suivant sur le projet:

• Administrateur du connecteur (roles/connectors.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès.

Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur TIBCO EMS:

• Demandeur Application Integration (roles/integrations.integrationInvoker)

Pour en savoir plus sur l'attribution d'un rôle à un compte de service, consultez la page Gérer l'accès aux comptes de service.

Ajouter le déclencheur TIBCO EMS

Pour ajouter un déclencheur TIBCO EMS à votre intégration, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Liste des intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.

3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

   Si vous créez une intégration :

   1. Saisissez un nom et une description dans le volet Create Integration (Créer une intégration).
   2. Sélectionnez une région pour l'intégration.
      Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
   3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les détails du compte de service d'une intégration à tout moment à partir du volet Integration summary (Résumé de l'intégration) dans la barre d'outils de l'intégration.
      Remarque : L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
   4. Cliquez sur Créer.

   Cela entraîne son ouverture dans l'éditeur d'intégrations.

4. Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
5. Cliquez sur l'élément déclencheur TIBCO EMS et placez-le dans l'éditeur d'intégration.

Pour configurer le déclencheur TIBCO EMS, vous pouvez utiliser une connexion TIBCO EMS existante disponible dans les connecteurs d'intégration ou en créer une à l'aide de l'option de création de connexion intégrée.

Configurer le déclencheur TIBCO EMS à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur TIBCO EMS à l'aide d'une connexion TIBCO EMS existante dans Integration Connectors. Notez que le déclencheur TIBCO EMS est un déclencheur d'événement Connector. Vous ne pouvez donc utiliser qu'une connexion TIBCO EMS avec l'abonnement aux événements activé pour configurer le déclencheur.

Pour savoir comment configurer un déclencheur TIBCO EMS à l'aide d'une nouvelle connexion TIBCO EMS, consultez Configurer un déclencheur TIBCO EMS à l'aide d'une nouvelle connexion.

Pour configurer un déclencheur TIBCO EMS à l'aide d'une connexion TIBCO EMS existante, procédez comme suit :

1. Cliquez sur l'élément Déclencheur TIBCO EMS dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Fournissez les informations de configuration suivantes sur la page Éditeur de déclencheur d'événement du connecteur :
   1. Région : sélectionnez la région de votre connexion TIBCO EMS.
   2. Connexion:sélectionnez la connexion TIBCO EMS que vous souhaitez utiliser.

      Application Integration n'affiche que les connexions TIBCO EMS actives et pour lesquelles l'abonnement à un événement est activé.

   3. Sélectionnez Queue ou SujetJMS Source Type comme JMS Source Type.
      • Si vous sélectionnez Queue, indiquez le nom de la file d'attente TIBCO EMS dans la colonne "Nom de la source JMS".
      • Si vous sélectionnez Topic, indiquez le nom du sujet TIBCO EMS dans la colonne "Nom de la source JMS".
   4. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour le déclencheur TIBCO EMS.
4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer le déclencheur TIBCO EMS à l'aide d'une nouvelle connexion

Pour configurer le déclencheur TIBCO EMS à l'aide d'une nouvelle connexion TIBCO EMS, procédez comme suit :

1. Cliquez sur l'élément Déclencheur TIBCO EMS dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur.
3. Ignorez le champ Région.
4. Cliquez sur Connexion, puis sélectionnez l'option Créer une connexion dans le menu déroulant.
5. Procédez comme suit dans le volet Créer une connexion:
   1. À l'étape Emplacement, choisissez l'emplacement de la nouvelle connexion TIBCO EMS :
      1. Région : sélectionnez une région dans la liste déroulante.
      2. Cliquez sur Suivant.
   2. À l'étape Détails de connexion, fournissez les informations suivantes sur la nouvelle connexion TIBCO EMS :
      1. Version du connecteur:sélectionnez une version disponible du connecteur TIBCO EMS dans la liste déroulante.
      2. Nom de la connexion : saisissez un nom pour la connexion TIBCO EMS.
         Remarque : Les noms de connexion doivent répondre aux critères suivants :

         • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
         • Les lettres doivent être en minuscules.
         • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
         • Les noms de connexion ne peuvent pas dépasser 63 caractères.
      3. (Facultatif) Description : saisissez une description de la connexion.
      4. (Facultatif) Activer Cloud Logging : cochez cette case pour stocker toutes les données de journal de la connexion.
      5. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour la connexion TIBCO EMS.
      6. Activer l'abonnement aux événements : sélectionnez cette option pour activer l'abonnement aux événements pour la connexion TIBCO EMS.
         Remarque : Ce connecteur n'est pas compatible avec l'option Enable only event subscription.
      7. (Facultatif) Développez Paramètres avancés pour configurer les paramètres du nœud de connexion.

         Pour en savoir plus sur les paramètres du nœud de connexion pour TIBCO EMS, consultez la documentation sur la connexion TIBCO EMS.

      8. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé-valeur.
      9. Cliquez sur Suivant.
   3. Si vous souhaitez utiliser SSL, sélectionnez Activer SSL. Les détails de la configuration SSL s'affichent.
      1. Sélectionnez un type de truststore. Il peut s'agir de Public, Privé ou Connexion non sécurisée.
      2. Sélectionnez les certificats comme affiché en fonction de votre choix de truststore.
      3. Si vous utilisez mTLS, sélectionnez les certificats du magasin de clés dans la section Magasin de clés. Sélectionnez également le certificat racine du client dans la section Configuration supplémentaire.
      4. Si vous le souhaitez, sélectionnez la version TLS.
      5. Indiquez la suite de chiffrement compatible. Saisir plusieurs suites de chiffrement, comme des valeurs séparées par une virgule. Pour en savoir plus, consultez la page Suites de chiffrement compatibles.
      Remarque :

      • Tous vos certificats doivent être des certificats X.509 au format PEM (Privacy Enhanced Mail).
      • Votre clé privée client doit être au format PKCS#8.
      • Vous ne pouvez pas sélectionner directement un certificat lorsque vous configurez SSL. Vous devez stocker tous vos certificats et clés privées en tant que secrets Secret Manager, puis sélectionner le secret requis lors de la configuration SSL.
   4. À l'étape Destinations, fournissez les détails de l'instance TIBCO EMS:
      1. Type de destination : sélectionnez Adresse hôte.
      2. Host (Hôte) : saisissez le nom d'hôte ou l'adresse IP de votre instance TIBCO EMS.
      3. Cliquez sur Suivant.
   5. À l'étape Authentification, fournissez les informations d'authentification de l'instance TIBCO EMS :
      1. Sélectionnez le type d'authentification souhaité et saisissez les informations pertinentes pour accéder à l'URL de l'hôte TIBCO EMS fournie.

         Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.

      2. Cliquez sur Suivant.
   6. Vérifiez les informations de connexion TIBCO EMS fournies.
   7. Cliquez sur Créer pour terminer de créer une connexion TIBCO EMS.
6. Cliquez sur OK et fermez la page.

Suites de chiffrement compatibles

Version TLS	Suites de chiffrement compatibles
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

Sortie du déclencheur

La configuration de l'abonnement à l'événement par le déclencheur TIBCO EMS prend quelques minutes. Vous pouvez consulter l'état de votre abonnement aux événements dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.

Le déclencheur TIBCO EMS indique l'état d'un abonnement aux événements à l'aide des états suivants :

• Creating : indique que le déclencheur s'abonne à l'abonnement aux événements.
• Active : indique que le déclencheur est correctement abonné à un abonnement d'événement.
• Error : indique qu'un problème est associé à l'abonnement aux événements configuré.

En plus de l'état de l'abonnement aux événements, la section Détails de l'abonnement aux événements affiche également d'autres informations, telles que la région de la connexion, le nom de la connexion et le nom de l'abonnement aux événements.

L'image suivante présente un exemple de mise en page du volet de configuration du déclencheur TIBCO EMS :

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur TIBCO EMS génère une variable de sortie ConnectorEventPayload (au format JSON) que vous pouvez utiliser dans vos tâches en aval. La variable de sortie contiendra la charge utile de votre événement TIBCO EMS. Exemple :

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

Afficher les abonnements à des événements

Pour afficher et gérer tous les abonnements aux événements associés à une connexion dans Integration Connectors, procédez comme suit :

1. Accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions).

   Accéder à la page "Connexions"

2. Cliquez sur la connexion pour laquelle vous souhaitez afficher les abonnements.
3. Cliquez sur l'onglet Abonnements aux événements.

   Tous les abonnements d'événements de la connexion s'affichent.

Modifier le déclencheur TIBCO EMS

Vous pouvez modifier un déclencheur TIBCO EMS pour modifier ou mettre à jour la configuration de la connexion et les détails de l'abonnement à l'événement.

Important : Lorsque vous modifiez un déclencheur TIBCO EMS, vous pouvez conserver l'abonnement aux événements précédemment configuré associé au déclencheur ou le supprimer. La suppression d'un abonnement à des événements affectera toutes les intégrations publiées qui l'utilisent.

Pour modifier un déclencheur TIBCO EMS, procédez comme suit:

1. Cliquez sur l'élément Déclencheur TIBCO EMS dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer le déclencheur TIBCO EMS.
3. Procédez comme suit sur la page Éditeur du déclencheur d'événement du connecteur :
   1. Pour conserver l'abonnement aux événements précédemment configuré, cliquez sur Conserver. Sinon, cliquez sur Supprimer.
      Avertissement : La suppression d'un abonnement à des événements affectera toutes les intégrations publiées qui l'utilisent. Cette tâche est irréversible.
   2. Mettez à jour les détails de la configuration de la connexion et de l'abonnement aux événements selon vos besoins.
   3. Cliquez sur OK.

Vous pouvez consulter les informations de connexion et d'abonnement aux événements mises à jour dans le volet de configuration du déclencheur sous Détails de l'abonnement aux événements.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante

• Découvrez toutes les tâches et tous les déclencheurs.
• Découvrez comment tester et publier une intégration.
• En savoir plus sur la gestion des erreurs
• Découvrez les journaux d'exécution d'intégration.