Zum Inhalt springen

Microsoft Azure Service Bus-Verbindung

Einführung

Eine Microsoft Azure Service Bus-Verbindung, die mit dem Microsoft Azure Service Bus-Connector erstellt wurde, ermöglicht den Zugriff auf Microsoft Azure Service Bus. Sobald eine Verbindung konfiguriert ist, können Instanzen von Microsoft Azure Service Bus-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer Microsoft Azure Service Bus-Verbindung

Eine neue Microsoft Azure Service Bus-Verbindung wird mit dem Microsoft Azure Service Bus-Connector aus einem dieser Standorte erstellt:

Eine vorhandene Microsoft Azure Service Bus-Verbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer Microsoft Azure Service Bus-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Microsoft Azure Service Bus-Verbindung wird im Folgenden beschrieben.

Die Benutzeroberfläche, die während der Verbindungs-Konfiguration verwendet wird, hängt vom ausgewählten Authentifizierungstyp ab:

Microsoft Entra ID

Hinweis

Informationen zum Erhalt dieser Anmeldeinformationen finden Sie unter Microsoft Entra ID in Voraussetzungen.

Wenn Microsoft Entra ID für den Authentifizierungstyp ausgewählt ist, wird die unten beschriebene Benutzeroberfläche angezeigt.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder damit, eine öffnende eckige Klammer [ in das Feld einzugeben, oder klicken Sie auf das Symbol für Variablen, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft Azure Service Bus-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Microsoft Azure Service Bus-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungstyp: Verwenden Sie das Menü, um Microsoft Entra ID auszuwählen, 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 Authentifizieren von einer Anwendung.

    Hinweis

    Die Microsoft Entra ID-Anwendung muss die Rolle Azure Service Bus Data Owner für den Service Bus-Namespace zugewiesen bekommen, wie in Voraussetzungen beschrieben.

  • Namespace / Hostname: Geben Sie den Service Bus Namespace oder die Namespace-Adresse ein, wobei der Namespace-Name als Hostname verwendet wird. Zum Beispiel sind sowohl spsbusns1028 als auch spsbusns1028.servicebus.windows.net 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, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Shared Access Signatures

Hinweis

Für Informationen zum Erhalt dieser Anmeldeinformationen siehe Shared Access Signature in Voraussetzungen.

Wenn Shared Access Signatures für Authentifizierungstyp ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft Azure Service Bus-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Microsoft Azure Service Bus-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungstyp: Verwenden Sie das Menü, um Shared Access Signatures auszuwählen, um Anfragen an Service Bus-Entitäten mit einem Primärschlüssel zu autorisieren, der einer Autorisierungspolitikregel zugewiesen ist.

  • Namespace / Hostname: Geben Sie den Service Bus Namespace oder die Namespace-Adresse ein, wobei der Namespace-Name als Hostname verwendet wird. Zum Beispiel sind sowohl spsbusns1028 als auch spsbusns1028.servicebus.windows.net gültig und verweisen auf denselben Service Bus Namespace.

  • Policy-Name: Geben Sie den Namen der Shared Access Authorization Policy-Regel des Namespaces ein. Standardmäßig haben Service Bus Namespaces eine RootManageSharedAccessKey-Administratorrichtlinie. Es wird empfohlen, eine andere Richtlinie für Integrationszwecke zu erstellen.

    Wichtig

    • Um die Send Message-Aktivität zu verwenden, muss die Autorisierungsrichtlinie Senderechte enthalten.
    • Um die Aktivitäten Consume Queue und Consume Topic zu verwenden, muss die Autorisierungsrichtlinie Hörrechte enthalten.

  • Primärschlüssel: Geben Sie den Primärschlüssel ein, der mit dem Policy-Name übereinstimmt. Jeder Autorisierungsrichtlinie wird ihr eigener Primärschlüssel zugewiesen.

  • Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Disable Auto Connector Update.

  • Änderungen speichern: Klicken Sie, um die Konfigurationsänderungen zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem eine vorhandene Verbindungs-Konfiguration geöffnet wurde, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Nachdem eine Microsoft Azure Service Bus-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar: