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 müssen bestimmte Rollen zugewiesen werden, um Zugriff auf einen Service Bus-Namespace zu gewähren. Informationen zu den in Azure integrierten Rollen zum Autorisieren des Zugriffs auf einen Service Bus-Namespace finden Sie unter In Azure integrierte Rollen für Azure Service Bus in der Microsoft-Dokumentation Authentifizierung von einer Anwendung aus.
-
Gemeinsame Zugriffssignaturen: Autorisieren Sie Anforderungen an Service Bus-Entitäten mithilfe eines Primärschlüssels, der einer Autorisierungsrichtlinienregel zugewiesen ist.
Microsoft Entra ID
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 müssen bestimmte Rollen zugewiesen werden, um Zugriff auf einen Service Bus-Namespace zu gewähren. Informationen zu den in Azure integrierten Rollen zum Autorisieren des Zugriffs auf einen Service Bus-Namespace finden Sie unter In Azure integrierte Rollen für Azure Service Bus in der Microsoft-Dokumentation Authentifizierung von einer Anwendung aus.
-
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.Wichtig
Der Service Bus-Namespace muss zugewiesen der Azure Service Bus-Datenbesitzer Rolle.
-
Mandanten-ID: Geben Sie die Verzeichnis-(Mandanten-)ID ein für die App-Registrierung.
-
Client-ID: Geben Sie die Anwendungs-(Client-)ID ein für die App-Registrierung.
-
Client Secret: Geben Sie das Client Secret ein für die App-Registrierung.
-
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
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.Wichtig
Der Service Bus-Namespace muss zugewiesen der Azure Service Bus-Datenbesitzer Rolle.
-
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 ist zur Verwendung als Quelle in einer Operation vorgesehen.
-
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.