Microsoft Azure Service Bus Verbindung
Einführung
Eine Microsoft Azure Service Bus Verbindung, die mit dem Microsoft Azure Service Bus-Connector erstellt wurde, stellt den Zugriff auf Microsoft Azure Service Bus her. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Microsoft Azure Service Bus-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.
Erstellen oder Bearbeiten einer Microsoft Azure Service Bus-Verbindung
Eine neue Microsoft Azure Service Bus-Verbindung wird mithilfe des Microsoft Azure Service Bus Connectors von einem der folgenden Standorte aus erstellt:
- Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
- Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).
Eine vorhandene Microsoft Azure Service Bus-Verbindung kann von diesen Orten aus bearbeitet werden:
- Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
- Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
- Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).
Konfigurieren einer Microsoft Azure Service Bus-Verbindung
Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche des Microsoft Azure Service Bus Verbindungskonfigurationsbildschirms beschrieben.
Die während der Verbindungskonfiguration verwendete Schnittstelle hängt vom ausgewählten Authentifizierungstyp ab:
-
Microsoft Entra ID: Autorisieren Sie Anforderungen an Service Bus-Entitäten mithilfe einer Microsoft Entra ID Anwendung. Weitere Informationen zu dieser Option finden Sie in der Microsoft-Dokumentation Authentifizierung über eine Anwendung.
Notiz
Der Microsoft Entra ID Anwendung muss der Azure Service Bus-Datenbesitzer zugewiesen werden Rolle, wie unter Voraussetzungen beschrieben.
-
Gemeinsame Zugriffssignaturen: Autorisieren Sie Anforderungen an Service Bus-Entitäten mithilfe eines Primärschlüssels, der einer Autorisierungsrichtlinienregel zugewiesen ist.
Microsoft Entra ID
Notiz
Informationen zum Erhalt dieser Anmeldeinformationen finden Sie unter Microsoft Entra ID in Voraussetzungen.
Wenn Microsoft Entra ID als Authentifizierungstyp ausgewählt ist, wird diese Schnittstelle angezeigt:
Tipp
Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [
in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.
-
Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft Azure Service Bus-Verbindung eindeutig sein und darf keine Schrägstriche enthalten
/
oder Doppelpunkte:
Dieser Name wird auch verwendet, um den Microsoft Azure Service Bus Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht. -
Authentifizierungstyp: Wählen Sie im Menü Microsoft Entra ID aus, um Anfragen an Service Bus-Entitäten mithilfe der Microsoft Entra ID Anwendung zu autorisieren. Weitere Informationen zu dieser Option finden Sie in der Microsoft-Dokumentation Authentifizierung über eine Anwendung.
Notiz
Der Microsoft Entra ID Anwendung muss der Azure Service Bus-Datenbesitzer zugewiesen werden Rolle für den Service Bus-Namespace, wie unter Voraussetzungen beschrieben.
-
Namespace / Hostname: Geben Sie den Service Bus Namespace ein oder Namespace-Adresse unter Verwendung des Namespace-Namens als Hostname. Beispielsweise können beide
spsbusns1028
Undspsbusns1028.servicebus.windows.net
sind gültig und verweisen auf denselben Service Bus-Namespace. -
Mandanten-ID: Geben Sie die Verzeichnis-(Mandanten-)ID für die App-Registrierung ein.
-
Client-ID: Geben Sie die Anwendungs-(Client-)ID für die App-Registrierung ein.
-
Client-Geheimnis: Geben Sie den Wert des Client-Geheimnisses für die App-Registrierung ein.
-
Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.
-
Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.
Gemeinsame Zugriffssignaturen
Hinweis
Informationen zum Erhalt dieser Anmeldeinformationen finden Sie unter Shared Access Signature in Voraussetzungen.
Wenn Shared Access Signatures als Authentifizierungstyp ausgewählt ist, wird diese Schnittstelle angezeigt:
Tipp
Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [
in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.
-
Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft Azure Service Bus-Verbindung eindeutig sein und darf keine Schrägstriche enthalten
/
oder Doppelpunkte:
Dieser Name wird auch verwendet, um den Microsoft Azure Service Bus Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht. -
Authentifizierungstyp: Wählen Sie im Menü Shared Access Signatures aus, um Anforderungen an Service Bus-Entitäten mithilfe eines Primärschlüssels zu autorisieren, der einer Autorisierungsrichtlinienregel zugewiesen ist.
-
Namespace / Hostname: Geben Sie den Service Bus Namespace ein oder Namespace-Adresse unter Verwendung des Namespace-Namens als Hostname. Beispielsweise können beide
spsbusns1028
Undspsbusns1028.servicebus.windows.net
sind gültig und verweisen auf denselben Service Bus-Namespace. -
Richtlinienname: Geben Sie den Namen der Richtlinienregel für die gemeinsame Zugriffsautorisierung des Namespace ein. Standardmäßig haben Service Bus-Namespaces eine
RootManageSharedAccessKey
Administratorrichtlinie. Es wird empfohlen, eine andere Richtlinie für die Integrationsnutzung zu erstellen.Wichtig
- Um die Aktivität Nachricht senden zu verwenden, muss die Autorisierungsrichtlinienregel Senderechte enthalten.
- Um die Aktivitäten Warteschlange verwenden und Thema verwenden zu verwenden, muss die Autorisierungsrichtlinienregel Abhörrechte enthalten.
-
Primärschlüssel: Geben Sie den Primärschlüssel ein, der dem Richtliniennamen entspricht. Jeder Autorisierungsrichtlinienregel wird ein eigener Primärschlüssel zugewiesen.
-
Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.
-
Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.
-
Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.
Nächste Schritte
Nachdem eine Microsoft Azure Service Bus Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.
Diese Aktivitätstypen sind verfügbar:
-
Warteschlangennachricht abrufen: Ruft alle Nachrichten in einer Microsoft Azure Service Bus Warteschlange ab und soll als Quelle in einer Operation verwendet werden.
-
Themennachricht entsperren: Entsperren von Nachrichten in einem Microsoft Azure Service Bus Thema und soll als Ziel bei einer Operation verwendet werden.
-
Warteschlangennachricht löschen: Löscht Nachrichten aus einer Microsoft Azure Service Bus Warteschlange und soll als Ziel bei einer Operation verwendet werden.
-
Thema konsumieren: Verbraucht Nachrichten von einem Microsoft Azure Service Bus Thema und soll als Quelle in einer Operation verwendet werden.
-
Themen-Nachrichtensperre erneuern: Erneuert Nachrichtensperren in einem Microsoft Azure Service Bus Thema und soll als Ziel bei einer Operation verwendet werden.
-
Themennachricht löschen: Löscht Nachrichten aus einem Microsoft Azure Service Bus Thema und soll als Ziel bei einer Operation verwendet werden.
-
Nachricht senden: Sendet Nachrichten an eine Microsoft Azure Service Bus Warteschlange oder Thema und soll als Ziel bei einer Operation verwendet werden.
-
Warteschlange verbrauchen: Verbraucht Nachrichten aus einer Microsoft Azure Service Bus Warteschlange und soll als Quelle in einer Operation verwendet werden.
-
Warteschlangen-Nachrichtensperre erneuern: Erneuert Nachrichtensperren in einer Microsoft Azure Service Bus Warteschlange und soll als Ziel bei einer Operation verwendet werden.
-
Themennachricht abrufen: Ruft Nachrichten von einem Microsoft Azure Service Bus Thema ab und soll als Quelle in einer Operation verwendet werden.
-
Nachricht zum Entsperren der Warteschlange: Entsperren Sie Nachrichten aus einer Microsoft Azure Service Bus Warteschlange und soll als Ziel bei einer Operation verwendet werden.