IBM MQ-Trigger

Der IBM MQ-Trigger ist ein Connector-Ereignis-Trigger, mit dem Sie eine Integration basierend auf den IBM MQ-Ereignissen aufrufen können, die Sie in Ihrer IBM MQ-Verbindung abonniert haben.

Hinweise

Wenn Sie eine neue Verbindung für den IBM MQ-Trigger erstellen oder konfigurieren möchten, benötigen Sie die folgende IAM-Rolle für das Projekt:

Connectors-Administrator (roles/connectors.admin)

Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Weisen Sie dem Dienstkonto, das Sie für den IBM MQ-Trigger verwenden möchten, die folgenden IAM-Rollen zu:

Aufrufer von Application Integration (roles/integrations.integrationInvoker)

Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

IBM MQ-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen IBM MQ-Trigger hinzuzufügen:

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu Application Integration
Klicken Sie im Navigationsmenü auf Integrations (Integrationen).
Auf der Seite Integrationsliste werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Verknüpfung erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen:
1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
2. Wählen Sie eine Region für die Integration aus.
  Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Verknüpfung im Bereich Zusammenfassung ändern oder aktualisieren.
  Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
4. Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
Klicken Sie auf das IBM MQ-Triggerelement und platzieren Sie es im Integrationseditor.

Zum Konfigurieren des IBM MQ-Triggers können Sie entweder eine vorhandene IBM MQ-Verbindung verwenden, die in Integration Connectors verfügbar ist, oder mithilfe der Option zum Erstellen einer Inline-Verbindung eine neue IBM MQ-Verbindung erstellen.

IBM MQ-Trigger mithilfe einer vorhandenen Verbindung konfigurieren

Sie können den IBM MQ-Trigger mithilfe einer vorhandenen IBM MQ-Verbindung in Integration Connectors konfigurieren. Der IBM MQ-Trigger ist ein Connector-Ereignistrigger. Daher können Sie zum Konfigurieren des Triggers nur eine IBM MQ-Verbindung mit aktiviertem Ereignisabo verwenden.

Informationen zum Konfigurieren eines IBM MQ-Triggers mithilfe einer neuen IBM MQ-Verbindung finden Sie unter IBM MQ-Trigger mit einer neuen Verbindung konfigurieren.

Führen Sie die folgenden Schritte aus, um einen IBM MQ-Trigger mithilfe einer vorhandenen IBM MQ-Verbindung zu konfigurieren:

Klicken Sie im Integrationseditor auf das Element IBM MQ-Trigger, um den Bereich mit der Triggerkonfiguration zu öffnen.
Klicken Sie auf Trigger konfigurieren.
Geben Sie auf der Seite Editor für Connector-Ereignistrigger die folgenden Konfigurationsdetails an:
1. Region:Wählen Sie die Region Ihrer IBM MQ-Verbindung aus.
2. Connection (Verbindung): Wählen Sie die IBM MQ-Verbindung aus, die Sie verwenden möchten.
  Application Integration zeigt nur die IBM MQ-Verbindungen an, die aktiv sind und für die ein Ereignisabo aktiviert ist.
3. Wählen Sie Queue oder
  Thema als JMS Source Type aus.
  - Wenn Sie Queue auswählen, geben Sie den Namen der IBM MQ-Warteschlange in der Spalte „JMS-Quellname“ an.
  - Wenn Sie Topic auswählen, geben Sie den Namen des IBM MQ-Themas in der Spalte „JMS-Quellname“ an.
4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den IBM MQ-Trigger aus.
Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

IBM MQ-Trigger mit einer neuen Verbindung konfigurieren

Führen Sie die folgenden Schritte aus, um den IBM MQ-Trigger über eine neue IBM MQ-Verbindung zu konfigurieren:

Klicken Sie im Integrationseditor auf das Element IBM MQ-Trigger, um den Bereich mit der Triggerkonfiguration zu öffnen.
Klicken Sie auf Trigger konfigurieren.
Überspringen Sie das Feld Region.
Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
Führen Sie im Bereich Create Connection (Verbindung erstellen) die folgenden Schritte aus:
1. Wählen Sie im Schritt Speicherort den Speicherort für die neue IBM MQ-Verbindung aus:
  1. Region:Wählen Sie eine Region aus der Drop-down-Liste aus.
  2. Klicken Sie auf Weiter.
2. Geben Sie im Schritt Verbindungsdetails Details zur neuen IBM MQ-Verbindung an:
  1. Connector-Version:Wählen Sie eine verfügbare Version des IBM MQ-Connectors aus der Drop-down-Liste aus.
  2. Connection Name (Verbindungsname): Geben Sie einen Namen für die IBM MQ-Verbindung ein.
    Hinweis: Verbindungsnamen müssen die folgenden Kriterien erfüllen:
    - Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
    - Buchstaben müssen Kleinbuchstaben sein.
    - Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
    - Verbindungsnamen dürfen maximal 63 Zeichen haben.
  3. Optional: Beschreibung : Geben Sie eine Beschreibung für die Verbindung ein.
  4. (Optional) Cloud Logging aktivieren: Klicken Sie dieses Kästchen an, um alle Logdaten der Verbindung zu speichern.
  5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die IBM MQ-Verbindung aus.
  6. Ereignisabo aktivieren:Wählen Sie diese Option aus, um das Ereignisabo für die IBM MQ-Verbindung zu aktivieren.
    Hinweis : Die Option Enable only event subscription wird von diesem Connector nicht unterstützt.
  7. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für den Verbindungsknoten zu konfigurieren.
    Weitere Informationen zu den Einstellungen für Verbindungsknoten für IBM MQ finden Sie in der Dokumentation zu IBM MQ-Verbindung.
  8. Optional: Klicken Sie auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
  9. Klicken Sie auf Weiter.
3. Wenn Sie SSL verwenden möchten, wählen Sie optional SSL aktivieren aus. Die SSL-Konfigurationsdetails werden angezeigt.
  1. Wählen Sie einen Trust Store-Typ aus. Es kann entweder Öffentlich, Privat oder Unsichere Verbindung sein.
  2. Wählen Sie die Zertifikate aus, die basierend auf Ihrer Auswahl im Trust Store angezeigt werden sollen.
  3. Wenn Sie mTLS verwenden, wählen Sie die Schlüsselspeicherzertifikate im Abschnitt Schlüsselspeicher aus.
  4. Wählen Sie optional die TLS-Version aus.
  5. Geben Sie die unterstützte Cipher Suite ein. Geben Sie mehrere Chiffresammlungen als kommagetrennte Werte ein. Weitere Informationen finden Sie unter Unterstützte Chiffresammlungen.
  Hinweis:
  - Alle Zertifikate müssen X.509-Zertifikate sein und das Format PEM (Privacy Enhanced Mail) haben.
  - Sie können bei der Konfiguration von SSL nicht direkt ein Zertifikat auswählen. Sie müssen alle Ihre Zertifikate und privaten Schlüssel als Secret Manager-Secret speichern und dann das erforderliche Secret bei der SSL-Konfiguration auswählen.
4. Geben Sie im Schritt Ziele die Details zur IBM MQ-Instanz an:
  1. Zieltyp:Wählen Sie Hostadresse aus.
  2. Host:Geben Sie den Hostnamen oder die IP-Adresse Ihrer IBM MQ-Instanz ein.
  3. Klicken Sie auf Weiter.
5. Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für die IBM MQ-Instanz an:
  1. Wählen Sie den gewünschten Authentifizierungstyp aus und geben Sie die relevanten Details ein, um auf die bereitgestellte IBM MQ-Host-URL zuzugreifen.
    Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.
  2. Klicken Sie auf Weiter.
6. Prüfen: Überprüfen Sie die angegebenen IBM MQ-Verbindungsdetails.
7. Klicken Sie auf Erstellen, um die Erstellung einer neuen IBM MQ-Verbindung abzuschließen.
Klicken Sie auf Fertig und schließen Sie die Seite.

Unterstützte Cipher Suites

TLS-Version	Unterstützte Cipher Suites
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

TLS-Version

Unterstützte Cipher Suites

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

Trigger-Ausgabe

Der IBM MQ-Trigger benötigt einige Minuten, um die Konfiguration des Ereignisabos abzuschließen. Sie können den Status Ihres Ereignisabos im Triggerkonfigurationsbereich unter Ereignisabodetails ansehen.

Der IBM MQ-Trigger gibt den Status eines Ereignisabos mithilfe der folgenden Status an:

Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
Active: Gibt an, dass der Trigger ein Ereignisabo abonniert hat.
Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Zusätzlich zum Ereignisabostatus werden im Bereich Ereignisabodetails auch andere Details wie Verbindungsregion, Verbindungsname und Ereignisaboname angezeigt.

Die folgende Abbildung zeigt ein Beispiellayout des Bereichs für die IBM MQ-Triggerkonfiguration:

Abbildung des Konfigurationsbereichs von IBM MQ-Triggern

Triggerausgabevariable

Für jedes Ereignis generiert der IBM MQ-Trigger eine ConnectorEventPayload-Ausgabevariable (im JSON-Format), die Sie in Ihren nachgelagerten Aufgaben verwenden können. Die Ausgabevariable enthält die Nutzlast aus Ihrem IBM MQ-Ereignis. Beispiel:

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

Ereignisabos ansehen

So rufen Sie alle Ereignisabos auf, die mit einer Verbindung in Integration Connectors verknüpft sind:

Rufen Sie die Seite Integration Connectors > Verbindungen auf.
Zur Seite „Verbindungen“
Klicken Sie auf die Verbindung, deren Abos Sie aufrufen möchten.
Klicken Sie auf den Tab Ereignisabos.
Dadurch werden alle Ereignisabos für die Verbindung angezeigt.

IBM MQ-Trigger bearbeiten

Sie können einen IBM MQ-Trigger bearbeiten, um die Verbindungskonfiguration und die Details des Ereignisabos zu ändern oder zu aktualisieren.

Führen Sie die folgenden Schritte aus, um einen IBM MQ-Trigger zu bearbeiten:

Klicken Sie im Integrationseditor auf das Element IBM MQ-Trigger, um den Bereich mit der Triggerkonfiguration zu öffnen.
Klicken Sie auf IBM MQ-Trigger konfigurieren.
Führen Sie auf der Seite Editor für Connector-Ereignistrigger die folgenden Schritte aus:
1. Wenn Sie das zuvor konfigurierte Ereignisabo beibehalten möchten, klicken Sie auf Beibehalten oder auf Löschen.
  Warnung:Das Löschen eines Ereignisabos wirkt sich auf alle veröffentlichten Integrationen aus, die das Ereignisabo verwenden. Diese Aufgabe kann nicht rückgängig gemacht werden.
2. Aktualisieren Sie die Verbindungskonfiguration und die Details des Ereignisabos nach Bedarf.
3. Klicken Sie auf Fertig.

Die aktualisierten Verbindungs- und Ereignisabodetails finden Sie im Triggerkonfigurationsbereich unter Ereignisabodetails.