Consultez les connecteurs compatibles avec Application Integration.

Déclencheur IBM MQ

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

Avant de commencer

Si vous prévoyez de créer ou de configurer une connexion pour le déclencheur IBM MQ, assurez-vous de disposer du rôle IAM suivant dans le projet :

  • Administrateur du connecteur (roles/connectors.admin)
  • Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

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

  • 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 IBM MQ

Pour ajouter un déclencheur IBM MQ à 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 Créer une intégration.
    2. Sélectionnez une région pour l'intégration.
    3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment dans le volet Récapitulatif de l'intégration de la barre d'outils d'intégration.
    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 IBM MQ et placez-le dans l'éditeur d'intégrations.
  6. Pour configurer le déclencheur IBM MQ, vous pouvez utiliser une connexion IBM MQ existante disponible dans les connecteurs d'intégration ou créer une connexion IBM MQ à l'aide de l'option de création de connexion intégrée.

Configurer le déclencheur IBM MQ à l'aide d'une connexion existante

Vous pouvez configurer le déclencheur IBM MQ à l'aide d'une connexion IBM MQ existante dans les connecteurs d'intégration. Notez que le déclencheur IBM MQ est un déclencheur d'événement de connecteur. Par conséquent, vous ne pouvez utiliser qu'une connexion IBM MQ avec l'abonnement aux événements activé pour configurer le déclencheur.

Pour savoir comment configurer un déclencheur IBM MQ à l'aide d'une nouvelle connexion IBM MQ, consultez Configurer le déclencheur IBM MQ à l'aide d'une nouvelle connexion.

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

  1. Cliquez sur l'élément Déclencheur IBM MQ 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 IBM MQ.
    2. Connexion : sélectionnez la connexion IBM MQ que vous souhaitez utiliser.

      Application Integration n'affiche que les connexions IBM MQ 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 IBM MQ dans la colonne "Nom de la source JMS".
      • Si vous sélectionnez Topic, indiquez le nom du sujet IBM MQ 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 IBM MQ.
  4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

Configurer le déclencheur IBM MQ à l'aide d'une nouvelle connexion

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

  1. Cliquez sur l'élément Déclencheur IBM MQ dans l'éditeur d'intégrations 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 IBM MQ:
      1. Région : sélectionnez une région dans la liste déroulante.
      2. Cliquez sur Suivant.
    2. À l'étape Détails de la connexion, fournissez les détails de la nouvelle connexion IBM MQ:
      1. Version du connecteur : sélectionnez une version disponible du connecteur IBM MQ dans la liste déroulante.
      2. Nom de la connexion : saisissez un nom pour la connexion IBM MQ.
      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 IBM MQ.
      6. Activer l'abonnement aux événements : sélectionnez cette option pour activer l'abonnement aux événements pour la connexion IBM MQ.
      7. (Facultatif) Développez la section Paramètres avancés pour configurer les paramètres du nœud de connexion.

        Pour en savoir plus sur les paramètres de nœud de connexion pour IBM MQ, consultez la documentation relative à la connexion IBM MQ.

      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.
      4. Si vous le souhaitez, sélectionnez la version TLS.
      5. Saisissez la suite de chiffrement compatible. Saisissez plusieurs suites de chiffrement sous forme de valeurs séparées par des virgules. Pour en savoir plus, consultez la section Suites de chiffrement compatibles.
    4. À l'étape Destinations, fournissez les détails de l'instance IBM MQ:
      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 IBM MQ.
      3. Cliquez sur Suivant.
    5. À l'étape Authentification, fournissez les informations d'authentification de l'instance IBM MQ:
      1. Sélectionnez le type d'authentification souhaité, puis saisissez les informations nécessaires pour accéder à l'URL de l'hôte IBM MQ 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 IBM MQ fournies.
    7. Cliquez sur Créer pour terminer la création d'une connexion IBM MQ.
  6. Cliquez sur OK, puis 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 IBM MQ 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 IBM MQ indique l'état d'un abonnement aux événements à l'aide des états suivants :

  • Creating: indique que le déclencheur s'abonne à l'abonnement à l'événement.
  • Active: indique que le déclencheur a bien été abonné à un abonnement à un événement.
  • Error: indique un problème avec l'abonnement à l'événement 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 montre un exemple de mise en page du volet de configuration du déclencheur IBM MQ:

image montrant le volet de configuration du déclencheur IBM MQ image montrant le volet de configuration du déclencheur IBM MQ

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur IBM MQ 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 IBM MQ. 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 à Integration Connectors > 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 aux événements de la connexion s'affichent.

Modifier le déclencheur IBM MQ

Vous pouvez modifier un déclencheur IBM MQ pour modifier ou mettre à jour la configuration de la connexion et les informations d'abonnement aux événements.

Pour modifier un déclencheur IBM MQ, procédez comme suit:

  1. Cliquez sur l'élément Déclencheur IBM MQ dans l'éditeur d'intégration pour ouvrir le volet de configuration du déclencheur.
  2. Cliquez sur Configurer le déclencheur IBM MQ.
  3. Procédez comme suit sur la page Éditeur de déclencheurs d'événements de connecteur:
    1. Pour conserver l'abonnement à l'événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
    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.
  4. Vous pouvez afficher les détails mis à jour de la connexion et de l'abonnement aux événements 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