Consultez la liste des connecteurs compatibles avec Application Integration.

Déclencheur Rabbit MQ

Le déclencheur Rabbit MQ est un déclencheur d'événements de connecteur qui vous permet d'appeler une intégration basée sur les événements Rabbit MQ auxquels vous vous êtes abonné dans votre connexion Rabbit MQ.

Important:Integration Connectors est un composant facturable de Google Cloud. Pour en savoir plus sur les coûts et les frais d'utilisation d'Integration Connectors, consultez les tarifs d'Integration Connectors.

Avant de commencer

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

• Administrateur des connecteurs (roles/connectors.admin)

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

Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le déclencheur Rabbit 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 Rabbit MQ

Pour ajouter un déclencheur Rabbit 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 Integrations (Intégrations).

   La page Liste des intégrations s'affiche. Elle répertorie 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.
      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 depuis le volet Résumé de l'intégration de dans la barre d'outils d'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.

   La page de l'éditeur d'intégration s'affiche.

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 Rabbit MQ et placez-le dans l'éditeur d'intégrations.

Pour configurer le déclencheur Rabbit MQ, vous pouvez soit utiliser une connexion Rabbit MQ existante disponible dans Integration Connectors, soit créer une connexion Rabbit MQ à l'aide de l'option de création de connexion intégrée.

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

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

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

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

1. Cliquez sur l'élément du déclencheur Rabbit 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énements de connecteur :
   1. Région:sélectionnez la région de votre connexion Rabbit MQ.
   2. Connexion:sélectionnez la connexion Rabbit MQ que vous souhaitez utiliser.

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

   3. Sélectionnez Queue ou Thème comme JMS Source Type.
      • Si vous sélectionnez Queue, indiquez le nom de la file d'attente Rabbit MQ dans la colonne JMS Source Name.
      • Si vous sélectionnez Topic, indiquez le nom du sujet Rabbit MQ dans la colonne "JMS Source Name" (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 Rabbit MQ.
4. Cliquez sur OK pour terminer la configuration du déclencheur et fermer la page.

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

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

1. Cliquez sur l'élément du déclencheur Rabbit 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 Create Connection (Créer une connexion) :
   1. À l'étape Emplacement, choisissez l'emplacement de la nouvelle connexion Rabbit 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 des informations sur la nouvelle connexion Rabbit MQ :
      1. Version du connecteur:sélectionnez une version disponible du connecteur Rabbit MQ dans la liste déroulante.
      2. Connection Name (Nom de connexion) : saisissez un nom pour la connexion Rabbit MQ.
         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 journaux de la connexion.
      5. Compte de service: sélectionnez un compte de service disposant des rôles IAM requis pour la connexion Rabbit MQ.
      6. Activer l'abonnement aux événements:sélectionnez cette option pour activer l'abonnement aux événements pour la connexion à Rabbit MQ.
         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 Rabbit MQ, consultez la documentation sur la connexion de Rabbit MQ.

      8. (Facultatif) Cliquez sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé-valeur.
      9. Cliquez sur Suivant.
   3. À l'étape Destinations, fournissez les détails de l'instance Rabbit MQ :
      1. Type de destination:sélectionnez Adresse de l'hôte.
      2. Host (Hôte) : saisissez le nom d'hôte ou l'adresse IP de votre instance Rabbit MQ.
      3. Cliquez sur Suivant.
   4. 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. Indiquez la suite de chiffrement compatible. Indiquez plusieurs suites de chiffrement sous forme de valeurs séparées par des virgules. 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).
      • 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 secret Secret Manager, puis sélectionner le secret requis lors de la configuration SSL.
   5. À l'étape Authentification, fournissez les informations d'authentification pour l'instance Rabbit MQ :
      1. Sélectionnez le type d'authentification souhaité et saisissez les informations requises pour accéder à l'URL de l'hôte Rabbit MQ fournie.

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

      2. Cliquez sur Suivant.
   6. Vérification: examinez les informations de connexion de Rabbit MQ fournies.
   7. Cliquez sur Créer pour terminer la création d'une connexion Rabbit MQ.
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

Le déclencheur Rabbit MQ prend quelques minutes pour terminer la configuration de l'abonnement aux événements. Vous pouvez afficher l'état de votre abonnement à un événement dans le volet de configuration du déclencheur sous Détails de l'abonnement à un événement.

Le déclencheur Rabbit MQ indique l'état d'un abonnement à un événement à 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 qu'il y a un problème avec l'abonnement à un événement configuré.

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

L'image suivante montre un exemple de mise en page du volet de configuration du déclencheur Rabbit MQ:

Variable de sortie du déclencheur

Pour chaque événement, le déclencheur Rabbit 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 Rabbit MQ. Exemple :

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

Afficher les abonnements à des événements

Pour afficher et gérer tous les abonnements à des é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 aux événements pour la connexion s'affichent.

Modifier le déclencheur Rabbit MQ

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

Important:Lorsque vous modifiez un déclencheur Rabbit MQ, vous pouvez soit conserver l'abonnement aux événements précédemment configuré qui lui est associé, soit le supprimer. La suppression d'un abonnement à un événement aura une incidence sur toutes les intégrations publiées qui utilisent cet abonnement.

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

1. Cliquez sur l'élément du déclencheur Rabbit MQ dans l'éditeur d'intégrations pour ouvrir le volet de configuration du déclencheur.
2. Cliquez sur Configurer un déclencheur Rabbit MQ.
3. Procédez comme suit sur la page Éditeur de déclencheur d'événements de connecteur :
   1. Pour conserver l'abonnement à un événement configuré précédemment, cliquez sur Conserver, sinon cliquez sur Supprimer.
      Avertissement:La suppression d'un abonnement à un événement aura une incidence sur toutes les intégrations publiées qui l'utilisent. Cette tâche est irréversible.
   2. Mettez à jour la configuration de la connexion et les détails de l'abonnement à l'événement, comme vous le souhaitez.
   3. Cliquez sur OK.

Vous pouvez afficher les détails de la connexion et de l'abonnement aux événements mis à jour dans le volet de configuration du déclencheur, sous Détails de l'abonnement aux événements.