Erstellen und Verwalten von Integrationskonten für B2B-Workflows in Azure Logic Apps mit dem Enterprise Integration Paket
Gilt für: Azure Logic Apps (Verbrauch + Standard)
Bevor Sie B2B (Business-to-Business)- und Unternehmensintegrations-Workflows mithilfe von Azure Logic Apps erstellen können, müssen Sie eine Integrationskontoressource erstellen. Dieses Konto ist ein skalierbarer, cloudbasierter Container in Azure, der das Speichern und Verwalten von B2B-Artefakten vereinfacht, die Sie in Ihren Workflows für B2B-Szenarien definieren und verwenden, z. B.:
Sie benötigen außerdem ein Integrationskonto, um B2B-Nachrichten auf elektronischem Wege mit anderen Organisationen austauschen zu können. Wenn andere Organisationen Protokolle und Nachrichtenformate verwenden, die von denen Ihrer Organisation abweichen, müssen Sie diese Formate konvertieren, damit das System Ihrer Organisation diese Nachrichten verarbeiten kann. Mit Azure Logic Apps können Sie Workflows erstellen, die die folgenden Branchenstandardprotokolle unterstützen:
In diesem Leitfaden wird gezeigt, wie Sie die folgenden Aufgaben ausführen:
- Erstellen eines Integrationskontos.
- Den Speicherzugriff für ein Premium-Integrationskonto einrichten.
- Verknüpfen Ihres Integrationskontos mit einer Logik-App-Ressource.
- Ändern des Tarifs für Ihr Integrationskonto
- Aufheben der Verknüpfung Ihres Integrationskontos mit einer Logik-App-Ressource.
- Verschieben eines Integrationskontos in eine andere Azure-Ressourcengruppe bzw. ein anderes Azure-Abonnement.
- Löschen eines Integrationskontos.
Wenn Sie mit der Erstellung von B2B-Unternehmensintegrations-Workflows in Azure Logic Apps noch nicht vertraut sind, lesen Sie B2B-Unternehmensintegrations-Workflows mit Azure Logic Apps und Enterprise Integration Pack.
Voraussetzungen
Ein Azure-Konto und ein Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren. Stellen Sie sicher, dass Sie dasselbe Azure-Abonnement sowohl für Ihr Integrationskonto als auch für Ihre Logik-App-Ressource verwenden.
Unabhängig davon, ob Sie an einem Verbrauchs- oder Standard-Logik-App-Workflow arbeiten, muss Ihre Logik-App-Ressource bereits vorhanden sein, bevor Sie Ihr Integrationskonto verknüpfen können.
Für Verwendungs-Logik-App-Ressourcen ist dieser Link erforderlich, bevor Sie die Artefakte aus Ihrem Integrationskonto mit Ihrem Workflow verwenden können. Obgleich Sie Ihre Artefakte ohne diesen Link erstellen können, ist der Link erforderlich, wenn Sie bereit sind, diese Artefakte zu verwenden.
Für Standard-Logik-App-Ressourcen ist dieser Link optional, basierend auf Ihrem Szenario:
Wenn Sie über ein Integrationskonto mit den Artefakten verfügen, die Sie benötigen oder verwenden möchten, können Sie das Integrationskonto mit jeder Standard-Logik-App-Ressource verknüpfen, in der Sie die Artefakte verwenden möchten.
Einige von Azure gehostete Integrationskontoconnectors (z. B AS2, EDIFACT und X12) ermöglichen es Ihnen, eine Verbindung mit Ihrem Integrationskonto herzustellen. Wenn Sie nur diese Connectors verwenden, ist keine Verknüpfung erforderlich.
Mit den integrierten Connectors namens Liquid und Flatfile können Sie Karten und Schemas auswählen, die Sie zuvor in Ihre Logik-App-Ressource oder in ein verknüpftes Integrationskonto hochgeladen haben.
Wenn Sie kein Integrationskonto haben oder benötigen, können Sie die Uploadoption verwenden. Andernfalls können Sie die Verknüpfungsoption verwenden, was auch bedeutet, dass Sie keine Zuordnungen und Schemas in jede Logik-App-Ressource hochladen müssen. In beiden Fällen können Sie diese Artefakte in allen untergeordneten Workflows innerhalb derselben Logik-App-Ressource verwenden.
Grundlegende Kenntnisse zum Erstellen von Logik-App-Workflows. Weitere Informationen finden Sie in der folgenden Dokumentation:
Integrationskonto erstellen
Integrationskonten sind in verschiedenen Tarifen verfügbar, die sich preislich unterscheiden. Auf Grundlage des von Ihnen gewählten Tarifs können beim Erstellen eines Integrationskontos Kosten entstehen. Weitere Informationen finden Sie im Preis- und Abrechnungsmodell für Azure Logic Apps und unter Azure Logic Apps – Preise.
Bestimmen Sie auf Grundlage Ihrer Anforderungen und Szenarien den geeigneten Integrationskontotarif, der erstellt werden soll. In der folgenden Tabelle werden die verfügbaren Tarife beschrieben:
Ihr Integrationskonto verwendet eine automatisch erstellte und aktivierte, vom System zugewiesene verwaltete Identität, um den Zugriff zu authentifizieren.
| Tarif | Beschreibung |
|---|---|
| Premium (Vorschau) | Hinweis: Diese Funktion befindet sich in der Vorschauphase und unterliegt den Zusätzlichen Nutzungsbedingungen für Microsoft Azure-Vorschauversionen. Für Szenarien mit den folgenden Kriterien: – Speichern und Verwenden von unbegrenzten Artefakten, z. B. Partner, Vereinbarungen, Schemas, Karten, Zertifikate usw. – Verwenden Ihres eigenen Speichers, der die relevanten Laufzeitzustände für bestimmte B2B-Aktionen und EDI-Standards enthält. Zu diesen Zuständen gehören beispielsweise die MIC-Nummer für AS2-Aktionen und die Steuernummern für X12-Aktionen, sofern sie für Ihre Vereinbarungen konfiguriert sind. Für den Zugriff auf diesen Speicher verwendet Ihr Integrationskonto die systemseitig zugewiesene verwaltete Identität, die automatisch für Ihr Integrationskonto erstellt und aktiviert wird. Sie können auch mehr Governance und Richtlinien auf Daten anwenden, z. B. kundenseitig verwaltete Schlüssel („Bring Your Own“) für die Datenverschlüsselung. Zum Speichern dieser Schlüssel benötigen Sie einen Schlüsseltresor. – Einrichten und Verwenden eines Schlüsseltresors zum Speichern privater Zertifikate oder kundenseitig verwalteter Schlüssel. Für den Zugriff auf diese Schlüssel verwendet Ihr Premium-Integrationskonto die systemseitig zugewiesene verwaltete Identität, nicht einen freigegebenen Azure Logic Apps-Dienstprinzipal. Die Preise entsprechen dem Preis des integrationskontos im Tarif „Standard“. Hinweis: Während der Vorschau verwendet Ihre Azure-Rechnung denselben Zählernamen und dieselbe ID wie ein Integrationskonto im Tarif „Standard“, das ändert sich jedoch, wenn die Premium-Ebene allgemein verfügbar wird. Einschränkungen und bekannte Probleme: – Derzeit werden keine virtuellen Netzwerke unterstützt. – Wenn Sie einen Schlüsseltresor zum Speichern privater Zertifikate verwenden, funktioniert die verwaltete Identität Ihres Integrationskontos möglicherweise nicht. Verwenden Sie vorerst stattdessen die verwaltete Identität der verknüpften Logik-App. – Derzeit wird die Azure CLI für Azure Logic Apps nicht unterstützt. |
| Standard | Für Szenarien mit komplexeren B2B-Beziehungen und einer größeren Anzahl zu verwaltender Entitäten. Ist von der SLA für Azure Logic Apps abgedeckt. |
| Grundlegend | Für Szenarien, in denen Sie nur die Verarbeitung von Nachrichten nutzen oder als Partner eines kleines Unternehmens fungieren möchten, das eine Handelspartnerbeziehung mit einem größeren Unternehmen eingegangen ist. Ist von der SLA für Azure Logic Apps abgedeckt. |
| Free | Nur für Erkundungs- und nicht für Produktionsszenarien. Bei diesem Tarif gelten Einschränkungen für Region, Durchsatz und Nutzung. Zum Beispiel ist der Free-Tarif nur für öffentliche Regionen in Azure verfügbar, z. B. USA, Westen oder Asien, Südosten, aber nicht für Microsoft Azure operated by 21Vianet oder Azure Government. Hinweis: Ist von der SLA für Azure Logic Apps nicht abgedeckt. |
Für diese Aufgabe können Sie das Azure-Portal, die Azure CLI oder Azure PowerShell verwenden.
Wichtig
Damit Sie Ihr Integrationskonto erfolgreich mit Ihrer Logik-App verknüpfen und verwenden können, stellen Sie sicher, dass beide Ressourcen im selben Azure-Abonnement und in derselben Azure-Region vorhanden sind.
Geben Sie im Azure-Portal im Suchfeld Integrationskonten ein, und wählen Sie den Eintrag Integrationskonten aus.
Klicken Sie unter Integrationskonten auf Erstellen.
Geben Sie im Bereich Integrationskonto erstellen die folgenden Informationen zu Ihrem Integrationskonto an:
Eigenschaft Erforderlich Wert BESCHREIBUNG Abonnement Ja <Name des Azure-Abonnements> Der Name Ihres Azure-Abonnements Ressourcengruppe Ja <Name der Azure-Ressourcengruppe> Der Name der Azure-Ressourcengruppe, die zum Organisieren verwandter Ressourcen verwendet werden soll. Erstellen Sie für dieses Beispiel eine neue Ressourcengruppe namens FabrikamIntegration-RG. Name des Integrationskontos Ja <integration-account-name> Der Name Ihres Integrationskontos, der nur Buchstaben, Ziffern, Bindestriche ( -), Unterstriche (_), Klammern (()) und Punkte (.) enthalten kann. In diesem Beispiel wird Fabrikam-Integration verwendet.Tarif Ja <Preisstufe> Der Tarif für das Integrationskonto – diesen können Sie später ändern. Wählen Sie für dieses Beispiel die Option Free aus. Weitere Informationen finden Sie in der folgenden Dokumentation:
- Logic Apps – Preismodell
- Logic Apps – Grenzwerte und Konfiguration
- Logic Apps – PreiseSpeicherkonto Nur für das Integrationskonto im Tarif „Premium“ (Vorschauversion) verfügbar None Der Name eines vorhandenen Azure-Speicherkontos an. Für das Beispiel in diesem Leitfaden gilt diese Option nicht. Region Ja <Azure-Region> Die Azure-Region, in der die Metadaten zu Ihrem Integrationskonto gespeichert werden sollen. Wählen Sie entweder den gleichen Standort wie für die Logik-App-Ressource aus, oder erstellen Sie Ihre Logik-Apps am gleichen Standort, an dem sich das Integrationskonto befindet. Verwenden Sie für dieses Beispiel USA, Westen.
Um Ihr Integrationskonto mit einer Integrationsdienstumgebung (ISE) zu verwenden, wählen Sie Einer Integrationsdienstumgebung zuordnen aus und dann Ihre ISE als Standort. Informationen zum Erstellen eines Integrationskontos in einer Integrationsdienstumgebung finden Sie unter Erstellen von Integrationskonten in einer ISE.
Hinweis: Am 31. August 2024 wird die ISE-Ressource aufgrund ihrer Abhängigkeit von Azure Cloud Services (klassisch) ausgemustert, die gleichzeitig eingestellt werden. In der aktuellen Vorschau ist es möglich, ein Integrationskonto im Tarif „Standard“ für eine ISE in ein Integrationskonto im Tarif „Premium“ zu exportieren.Aktivieren von Log Analytics Nein Nicht markiert Wählen Sie diese Option für dieses Beispiel nicht aus. Wählen Sie abschließend Überprüfen + erstellen aus.
Nach Abschluss der Bereitstellung öffnet Azure Ihr Integrationskonto.
Wenn Sie ein Integrationskonto im Tarif „Premium“ erstellt haben, müssen Sie den Zugriff auf das zugehörige Azure-Speicherkonto einrichten.
Einrichten des Speicherzugriffs für das Integrationskonto im Tarif „Premium“
Um Artefakte zu lesen und Zustandsinformationen zu schreiben, benötigt Ihr Premium-Integrationskonto Zugriff auf das ausgewählte und zugeordnete Azure-Speicherkonto. Ihr Integrationskonto verwendet seine automatisch erstellte und aktivierte, vom System zugewiesene verwaltete Identität, um den Zugriff zu authentifizieren.
Öffnen Sie im Azure-Portal Ihr Premium-Integrationskonto.
Wählen Sie im Menü des Integrationskontos unter Einstellungen den Eintrag Identität aus.
Wählen Sie auf der Registerkarte Vom System zugewiesen, auf der die vom System zugewiesene verwaltete Identität aktiviert ist, unter Berechtigungen die Option Azure-Rollenzuweisungen aus.
Wählen Sie auf der Symbolleiste der Azure-Rollenzuweisungendie Option Rollenzuweisung hinzufügen (Vorschau) aus, geben Sie die folgenden Informationen an, wählen Sie Speichern aus, und wiederholen Sie dann für jede erforderliche Rolle:
Parameter Wert Beschreibung Bereich Storage Weitere Informationen finden Sie in der Grundlegendes zum Bereich von Azure RBAC. Abonnement <Azure-Abonnement> Das Azure-Abonnement für die Ressource, auf die zugegriffen werden soll. Ressource <Azure-storage-account-name> Der Name für das Azure-Speicherkonto, auf das zugegriffen werden soll.
Hinweis Wenn Sie die Fehlermeldung erhalten, dass Sie keine Berechtigung zum Hinzufügen von Rollenzuweisungen in diesem Bereich haben, müssen Sie sich diese Berechtigung verschaffen. Weitere Informationen finden Sie unter Integrierte Rollen in Microsoft Entra.Rolle - Speicherkontomitwirkender
- Mitwirkender an Storage-Blobdaten
- Mitwirkender an Storage-TabellendatenDie Rollen, die Ihr Premium-Integrationskonto für den Zugriff auf Ihr Speicherkonto benötigt. Weitere Informationen finden Sie unter Zuweisen einer Azure-Rolle zur systemseitig zugewiesenen verwalteten Identität
Verknüpfen Sie als Nächstes Ihr Integrationskonto mit Ihrer Logik-App-Ressource.
Verknüpfen mit Logik-App
Damit Sie Ihr Integrationskonto erfolgreich mit Ihrer Logik-App-Ressource verknüpfen können, stellen Sie sicher, dass beide Ressourcen dasselbe Azure-Abonnement und dieselbe Azure-Region verwenden.
In diesem Abschnitt wird beschrieben, wie Sie diese Aufgabe mithilfe des Azure-Portals ausführen. Wenn Sie Visual Studio verwenden und sich Ihre Logik-App in einem Azure Resource Group-Projekt befindet, können Sie Ihre Logik-App mithilfe von Visual Studio mit einem Integrationskonto verknüpfen.
Öffnen Sie Ihre Logik-App-Ressource im Azure-Portal.
Wählen Sie im Navigationsmenü Ihrer Logik-App unter Einstellungen die Option Workfloweinstellungen aus. Öffnen Sie unter Integrationskonto die Liste Wählen Sie ein Integrationskonto aus aus, und wählen Sie dann das gewünschte Integrationskonto aus.
Klicken Sie zum Fertigstellen der Verknüpfung auf Speichern.
Nachdem Ihr Integrationskonto erfolgreich verknüpft wurde, wird in Azure eine Bestätigungsmeldung angezeigt.
Ihr Logik-App-Workflow kann jetzt die Artefakte in Ihrem Integrationskonto sowie die B2B-Connectors (z. B. XML-Überprüfung und Flatfilecodierung- bzw. decodierung) verwenden.
Ändern des Tarifs
Um die Grenzwerte eines Integrationskontos zu erhöhen, können Sie ein Upgrade auf einen höheren Tarif durchführen, sofern verfügbar. Sie können beispielsweise ein Upgrade vom Free-Tarif auf den Tarif „Basic“, „Standard“ oder „Premium“ durchführen. Sie können auch ein Downgrade auf einen niedrigeren Tarif durchführen, sofern verfügbar. Weitere Informationen zu Preisen finden Sie in der folgenden Dokumentation:
Tarifupgrade
Sie können für diese Änderung das Azure-Portal oder die Azure-Befehlszeilenschnittstelle verwenden.
Geben Sie im Azure-Portal im Suchfeld Integrationskonten ein, und wählen Sie den Eintrag Integrationskonten aus.
Azure zeigt alle Integrationskonten in Ihren Azure-Abonnements an.
Wählen Sie unter Integrationskonten das zu verschiebende Integrationskonto aus. Wählen Sie im Ressourcenmenü Ihres Integrationskontos die Option Übersicht aus.
Wählen Sie im Bereich Übersicht die Option Tarif aktualisieren aus – daraufhin werden alle verfügbaren höheren Tarife aufgelistet. Wenn Sie einen Tarif auswählen, tritt die Änderung sofort in Kraft.
Tarifdowngrade
Verwenden Sie für diese Änderung die Azure CLI.
Installieren Sie die Azure CLI, wenn Sie dies noch nicht getan haben.
Öffnen Sie die Azure Cloud Shell-Umgebung im Azure-Portal.
Geben Sie an der Eingabeaufforderung den Befehl az resource ein, und legen Sie
skuNameauf den gewünschten niedrigeren Tarif fest.az resource update --resource-group <resourceGroupName> --resource-type Microsoft.Logic/integrationAccounts --name <integrationAccountName> --subscription <AzureSubscriptionID> --set sku.name=<skuName>Wenn Sie z.B. derzeit den Standard-Tarif nutzen, können Sie
skuNameaufBasicfestlegen:az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Basic
Aufheben der Verknüpfung mit der Logik-App
Wenn Sie Ihre Logik-App mit einem anderen Integrationskonto verknüpfen oder kein Integrationskonto mehr mit Ihrer Logik-App verwenden möchten, löschen Sie die Verknüpfung über den Azure-Ressourcen-Explorer.
Öffnen Sie ein Browserfenster, und wechseln Sie zu Azure-Ressourcen-Explorer (https://resources.azure.com). Melden Sie sich mit denselben Azure-Kontoanmeldeinformationen an.
Geben Sie im Suchfeld den Namen Ihrer Logik-App ein, um sie zu suchen und auszuwählen.
Wählen Sie in der Titelleiste des Explorers Lesen/Schreiben aus.
Wählen Sie auf der Registerkarte Daten die Option Bearbeiten aus.
Suchen Sie im Editor nach dem integrationAccount-Objekt, das das folgende Format aufweist, und löschen Sie das Objekt:
{ // <other-attributes> "integrationAccount": { "name": "<integration-account-name>", "id": "<integration-account-resource-ID>", "type": "Microsoft.Logic/integrationAccounts" }, }Beispiel:
Klicken Sie auf der Registerkarte Daten auf PUT, um die Änderungen zu speichern.
Öffnen Sie Ihre Logik-App im Azure-Portal. Überprüfen Sie in Ihrem Logik-App-Menü unter Workflow-Einstellungen, ob die Eigenschaft Integrationskonto nun leer ist.
Verschieben eines Integrationskontos
Sie können Ihr Integrationskonto in eine andere Azure-Ressourcengruppe bzw. ein anderes Azure-Abonnement verschieben. Wenn Sie Ressourcen verschieben, erstellt Azure neue Ressourcen-IDs. Stellen Sie daher sicher, dass Sie die neuen IDs verwenden, und aktualisieren Sie alle Skripts und Tools, die den verschobenen Ressourcen zugeordnet sind. Wenn Sie das Abonnement ändern möchten, müssen Sie auch eine vorhandene oder neue Ressourcengruppe angeben.
Für diese Aufgabe können Sie das Azure-Portal verwenden, indem Sie die Schritte in diesem Abschnitt ausführen. Alternativ dazu können Sie auch die Azure CLI verwenden.
Geben Sie im Azure-Portal im Suchfeld Integrationskonten ein, und wählen Sie den Eintrag Integrationskonten aus.
Azure zeigt alle Integrationskonten in Ihren Azure-Abonnements an.
Wählen Sie unter Integrationskonten das zu verschiebende Integrationskonto aus. Wählen Sie im Menü Ihres Integrationskontos die Option Übersicht aus.
Wählen Sie auf der Seite Übersicht neben Ressourcengruppe oder neben Abonnementname die Option Ändern aus.
Wählen Sie alle zugehörigen Ressourcen aus, die Sie ebenfalls verschieben möchten.
Je nach Auswahl führen Sie die folgenden Schritte aus, um die Ressourcengruppe oder das Abonnement zu ändern:
Ressourcengruppe: Wählen Sie aus der Liste Ressourcengruppe die Zielressourcengruppe aus. Oder wählen Sie Neue Ressourcengruppe erstellen aus, um eine andere Ressourcengruppe zu erstellen.
Abonnement: Wählen Sie aus der Liste Abonnement das Zielabonnement aus. Wählen Sie aus der Liste Ressourcengruppe die Zielressourcengruppe aus. Oder wählen Sie Neue Ressourcengruppe erstellen aus, um eine andere Ressourcengruppe zu erstellen.
Um zu bestätigen, dass Ihnen bekannt ist, dass alle Skripts oder Tools, die den verschobenen Ressourcen zugeordnet sind, erst dann wieder funktionieren, wenn Sie sie mit den neuen Ressourcen-IDs aktualisieren, aktivieren Sie das Kontrollkästchen für die Bestätigung, und klicken Sie dann auf OK.
Stellen Sie im Anschluss sicher, dass Sie alle Skripts mit den neuen Ressourcen-IDs für Ihre verschobenen Ressourcen aktualisieren.
Löschen eines Integrationskontos
Für diese Aufgabe können Sie das Azure-Portal verwenden, indem Sie die Schritte in diesem Abschnitt ausführen. Alternativ dazu können Sie auch die Azure CLI oder Azure PowerShell verwenden.
Geben Sie im Azure-Portal im Suchfeld Integrationskonten ein, und wählen Sie den Eintrag Integrationskonten aus.
Azure zeigt alle Integrationskonten in Ihren Azure-Abonnements an.
Wählen Sie unter Integrationskonten das zu löschende Integrationskonto aus. Wählen Sie im Menü Ihres Integrationskontos die Option Übersicht aus.
Wählen Sie auf der Seite Übersicht die Option Löschen aus.
Um zu bestätigen, dass Sie Ihr Integrationskonto löschen möchten, klicken Sie auf Ja.
