TIBCO EMS-Trigger

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

Wichtig:Integration Connectors ist eine kostenpflichtige Komponente von Google Cloud. Informationen zu den Kosten und Gebühren für die Verwendung von Integrations-Connectors finden Sie unter Preise für Integrations-Connectors.

Hinweise

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

• Connector-Administrator (roles/connectors.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

• Application Integration Invoker (roles/integrations.integrationInvoker)

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

TIBCO EMS-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um der Integration einen TIBCO EMS-Trigger hinzuzufügen:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationsliste wird angezeigt und enthält alle Integrationen, die im Google Cloud-Projekt verfügbar sind.

3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

   1. Geben Sie im Bereich 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 im Bereich Integrationsübersicht in der Symbolleiste der Integration ändern oder aktualisieren.
      Hinweis:Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

   Die neu erstellte Integration wird im Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Element TIBCO EMS-Trigger und platzieren Sie es im Integrationseditor.

Zum Konfigurieren des TIBCO EMS-Triggers können Sie entweder eine vorhandene TIBCO EMS-Verbindung verwenden, die in Integration Connectors verfügbar ist, oder eine neue TIBCO EMS-Verbindung mit der Inline-Option zum Erstellen von Verbindungen erstellen.

TIBCO EMS-Trigger mit einer vorhandenen Verbindung konfigurieren

Sie können den TIBCO EMS-Trigger mit einer vorhandenen TIBCO EMS-Verbindung in Integration Connectors konfigurieren. Der TIBCO EMS-Trigger ist ein Connector-Ereignistrigger. Sie können ihn also nur mit einer TIBCO EMS-Verbindung konfigurieren, bei der das Ereignisabo aktiviert ist.

Informationen zum Konfigurieren eines TIBCO EMS-Triggers mit einer neuen TIBCO EMS-Verbindung finden Sie unter TIBCO EMS-Trigger mit einer neuen Verbindung konfigurieren.

So konfigurieren Sie einen TIBCO EMS-Trigger mit einer vorhandenen TIBCO EMS-Verbindung:

1. Klicken Sie im Integrationseditor auf das Element TIBCO EMS-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Geben Sie auf der Seite Connector Event Trigger Editor die folgenden Konfigurationsdetails an:
   1. Region:Wählen Sie die Region Ihrer TIBCO EMS-Verbindung aus.
   2. Verbindung:Wählen Sie die TIBCO EMS-Verbindung aus, die Sie verwenden möchten.

      In der Anwendungsintegration werden nur die TIBCO EMS-Verbindungen angezeigt, 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 TIBCO EMS-Warteschlange in der Spalte „JMS Source Name“ (JMS-Quellname) an.
      • Wenn Sie Topic auswählen, geben Sie den Namen des TIBCO EMS-Themas in der Spalte „JMS Source Name“ (JMS-Quellname) an.
   4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den TIBCO EMS-Trigger aus.
4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

TIBCO EMS-Trigger mit einer neuen Verbindung konfigurieren

Führen Sie die folgenden Schritte aus, um den TIBCO EMS-Trigger mit einer neuen TIBCO EMS-Verbindung zu konfigurieren:

1. Klicken Sie im Integrationseditor auf das Element TIBCO EMS-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Überspringen Sie das Feld Region.
4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
5. Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
   1. Wählen Sie im Schritt Standort den Standort für die neue TIBCO EMS-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 TIBCO EMS-Verbindung an:
      1. Connector-Version: Wählen Sie eine verfügbare Version des TIBCO EMS-Connectors aus der Drop-down-Liste aus.
      2. Verbindungsname:Geben Sie einen Namen für die TIBCO EMS-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: Aktivieren Sie dieses Kästchen, um alle Logdaten der Verbindung zu speichern.
      5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die TIBCO EMS-Verbindung aus.
      6. Ereignisabo aktivieren:Wählen Sie diese Option aus, um das Ereignisabo für die TIBCO EMS-Verbindung zu aktivieren.
         Hinweis : Dieser Connector unterstützt die Option Enable only event subscription nicht.
      7. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für den Verbindungsknoten zu konfigurieren.

         Weitere Informationen zu den Einstellungen für den Verbindungs-Knoten für TIBCO EMS finden Sie in der Dokumentation TIBCO EMS-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. Dadurch werden die SSL-Konfigurationsdetails angezeigt.
      1. Wählen Sie einen Truststore-Typ aus. Es kann entweder Öffentlich, Privat oder Unsichere Verbindung sein.
      2. Wählen Sie die Zertifikate entsprechend Ihrer Auswahl des Trust Stores aus.
      3. Wenn Sie mTLS verwenden, wählen Sie die Schlüsselspeicherzertifikate im Abschnitt Schlüsselspeicher aus. Wählen Sie im Abschnitt Zusätzliche Konfiguration auch das Client-Root-Zertifikat aus.
      4. Wählen Sie optional die TLS-Version aus.
      5. Geben Sie die unterstützte Cipher-Suite ein. Geben Sie mehrere Cipher-Suites als durch Kommas getrennte Werte ein. Weitere Informationen finden Sie unter Unterstützte Chiffrierverfahren.
      Hinweis:

      • Alle Zertifikate müssen X.509-Zertifikate sein und das Format PEM (Privacy Enhanced Mail) haben.
      • Ihr privater Clientschlüssel muss im PKCS#8-Format vorliegen.
      • Sie können bei der Konfiguration von SSL nicht direkt ein Zertifikat auswählen. Sie müssen alle Zertifikate und privaten Schlüssel als Secret Manager-Secret speichern und dann das erforderliche Secret während der SSL-Konfiguration auswählen.
   4. Geben Sie im Schritt Ziele die Details zur TIBCO EMS-Instanz an:
      1. Zieltyp:Wählen Sie Hostadresse aus.
      2. Host:Geben Sie den Hostnamen oder die IP-Adresse Ihrer TIBCO EMS-Instanz ein.
      3. Klicken Sie auf Weiter.
   5. Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für die TIBCO EMS-Instanz an:
      1. Wählen Sie den gewünschten Authentifizierungstyp aus und geben Sie die entsprechenden Details ein, um auf die bereitgestellte TIBCO EMS-Host-URL zuzugreifen.

         Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

      2. Klicken Sie auf Weiter.
   6. Überprüfen: Prüfen Sie die angegebenen TIBCO EMS-Verbindungsdetails.
   7. Klicken Sie auf Erstellen, um die Erstellung einer neuen TIBCO EMS-Verbindung abzuschließen.
6. 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

Trigger-Ausgabe

Es dauert einige Minuten, bis die Konfiguration des Ereignisabos für den TIBCO EMS-Trigger abgeschlossen ist. Den Status Ihres Ereignisabos können Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo einsehen.

Der TIBCO EMS-Trigger gibt den Status eines Ereignisabos mit den folgenden Status an:

• Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
• Active: Gibt an, dass der Trigger erfolgreich für ein Ereignisabo registriert wurde.
• Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Neben dem Status des Ereignisabos werden im Bereich Details zum Ereignisabo auch andere Details wie Verbindungsregion, Verbindungsname und Name des Ereignisabos angezeigt.

Die folgende Abbildung zeigt ein Beispiellayout für den Konfigurationsbereich für den TIBCO EMS-Trigger:

Variable „Trigger-Ausgabe“

Für jedes Ereignis generiert der TIBCO EMS-Trigger eine ConnectorEventPayload-Ausgabevariable (im JSON-Format), die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable enthält die Nutzlast aus Ihrem TIBCO EMS-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, und verwalten sie:

1. Rufen Sie die Seite Integration Connectors > Verbindungen auf.

   Zur Seite „Verbindungen“

2. Klicken Sie auf die Verbindung, für die Sie die Abos aufrufen möchten.
3. Klicken Sie auf den Tab Event-Abos.

   Hier werden alle Ereignisabos für die Verbindung angezeigt.

TIBCO EMS-Trigger bearbeiten

Sie können einen TIBCO EMS-Trigger bearbeiten, um die Verbindungskonfiguration und die Details zum Ereignis-Abo zu ändern oder zu aktualisieren.

Wichtig:Wenn Sie einen TIBCO EMS-Trigger bearbeiten oder ändern, können Sie entweder das zuvor konfigurierte Ereignis-Abo beibehalten, das an den Trigger angehängt ist, oder es löschen. Das Löschen eines Ereignisabos wirkt sich auf alle veröffentlichten Integrationen aus, die dieses Ereignisabo verwenden.

So bearbeiten Sie einen TIBCO EMS-Trigger:

1. Klicken Sie im Integrationseditor auf das Element TIBCO EMS-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf TIBCO EMS-Trigger konfigurieren.
3. Führen Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Schritte aus:
   1. Wenn Sie das zuvor konfigurierte Ereignis-Abo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie 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 zum Ereignis-Abo nach Bedarf.
   3. Klicken Sie auf Fertig.

Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich für die Triggerkonfiguration unter Details zum Ereignisabo.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte

• Alle Aufgaben und Trigger.
• Hier erfahren Sie, wie Sie eine Integration testen und veröffentlichen.
• Weitere Informationen zur Fehlerbehandlung.
• Weitere Informationen zu Ausführungslogs der Integration.