AS2-berichten uitwisselen met behulp van werkstromen in Azure Logic Apps
Van toepassing op: Azure Logic Apps (Verbruik + Standard)
Als u AS2-berichten wilt verzenden en ontvangen in werkstromen die u maakt met behulp van Azure Logic Apps, kunt u de AS2-connector (v2) gebruiken, die acties biedt die AS2-communicatie ondersteunen en beheren. Als u traceringsmogelijkheden nodig hebt, is de oorspronkelijke AS2-connector nog steeds beschikbaar, maar wordt deze afgeschaft.
Met uitzondering van traceringsmogelijkheden biedt de AS2-connector (v2) dezelfde mogelijkheden als de oorspronkelijke AS2-connector , wordt systeemeigen uitgevoerd met de Azure Logic Apps-runtime en biedt aanzienlijke prestatieverbeteringen in de berichtgrootte, doorvoer en latentie. In tegenstelling tot de oorspronkelijke AS2-connector hoeft u voor de AS2-connector (v2) geen verbinding te maken met uw integratieaccount. Zorg er in plaats daarvan, zoals beschreven in de vereisten, voor dat u uw integratieaccount koppelt aan de resource van de logische app waar u de connector wilt gebruiken.
Deze handleiding laat zien hoe u de AS2-coderings- en decoderingsacties toevoegt aan een bestaande werkstroom voor logische apps. De AS2-connector (v2) bevat geen triggers, dus u kunt elke trigger gebruiken om uw werkstroom te starten. In de voorbeelden in deze handleiding wordt de aanvraagtrigger gebruikt.
Technische naslaginformatie over connectoren
De AS2-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.
| Logische apps | Omgeving | Connectorversie |
|---|---|---|
| Verbruik | Multitenant Azure Logic Apps | MET AS2 (v2) en AS2 beheerde connectors (Standard-klasse). De AS2-connector (v2) biedt alleen acties, maar u kunt elke trigger gebruiken die geschikt is voor uw scenario. Raadpleeg de volgende documentatie voor meer informatie: - Naslaginformatie over beheerde AS2-connectors - Door AS2 (v2) beheerde connectorbewerkingen - AS2-berichtlimieten |
| Standaard | Azure Logic Apps en App Service Environment v3 met één tenant (alleen Windows-abonnementen) | Ingebouwde AS2-connector (v2) en door AS2 beheerde connector. De ingebouwde versie verschilt op de volgende manieren: - De ingebouwde versie biedt alleen acties, maar u kunt elke trigger gebruiken die geschikt is voor uw scenario. - De ingebouwde versie heeft rechtstreeks toegang tot virtuele Azure-netwerken. U hebt geen on-premises gegevensgateway nodig. Raadpleeg de volgende documentatie voor meer informatie: - Naslaginformatie over beheerde AS2-connectors - Ingebouwde AS2-connectorbewerkingen (v2) - AS2-berichtlimieten |
AS2-bewerkingen (v2)
De AS2-connector (v2) heeft geen triggers. In de volgende tabel worden de acties beschreven die de AS2-connector (v2) biedt voor het tot stand brengen van beveiliging en betrouwbaarheid bij het verzenden van berichten:
| Actie | Beschrijving |
|---|---|
| AS2 Codeeractie | Biedt versleuteling, digitale ondertekening en bevestigingen via MDN (Message Disposition Notifications), die ondersteuning bieden voor niet-naleving. Deze actie past bijvoorbeeld AS2/HTTP-headers toe en voert de volgende taken uit wanneer deze zijn geconfigureerd: - Uitgaande berichten ondertekenen. - Uitgaande berichten versleutelen. - Het bericht comprimeren. - Verzend de bestandsnaam in de MIME-header. |
| AS2-decodeeractie | Ontsleuteling, digitale ondertekening en bevestigingen bieden via MDN (Message Disposition Notifications). Met deze actie worden bijvoorbeeld de volgende taken uitgevoerd wanneer deze zijn geconfigureerd: - AS2/HTTP-headers verwerken. - Ontvangen MDN's afstemmen met de oorspronkelijke uitgaande berichten. - Records bijwerken en correleren in de database die niet wordt gebruikt. - Records schrijven voor AS2-statusrapportage. - Inhoud van nettolading uitvoeren als base64-gecodeerd. - Bepaal of MDN's vereist zijn. Bepaal op basis van de AS2-overeenkomst of MDN's synchroon of asynchroon moeten zijn. - Synchrone of asynchrone MDN's genereren op basis van de AS2-overeenkomst. - Stel de correlatietokens en -eigenschappen in op MDN's. - Controleer de handtekening. - Ontsleutel de berichten. - Het bericht decomprimeren. - Dubbele bericht-id's controleren en weigeren. |
Vereisten
Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis Azure-account.
De resource en werkstroom van de logische app waar u de AS2-bewerkingen wilt gebruiken.
Een integratieaccountresource voor het definiëren en opslaan van artefacten voor gebruik in bedrijfsintegratie en B2B-werkstromen.
Zowel uw integratieaccount als de resource van de logische app moeten zich in hetzelfde Azure-abonnement en dezelfde Azure-regio bevinden.
Definieert ten minste twee handelspartners die deelnemen aan de AS2-bewerking die in uw werkstroom wordt gebruikt. De definities voor beide partners moeten dezelfde kwalificatie voor bedrijfsidentiteit gebruiken, namelijk AS2Identity voor dit scenario.
Definieert een AS2-overeenkomst tussen de handelspartners die deelnemen aan uw werkstroom. Voor elke overeenkomst zijn een hostpartner en een gastpartner vereist. De inhoud in de berichten tussen u en de andere partner moet overeenkomen met het overeenkomsttype. Zie AS2-berichtinstellingen voor informatie over overeenkomstinstellingen die u kunt gebruiken bij het ontvangen en verzenden van berichten.
Op basis van of u aan een werkstroom voor een logische of standaard logische app werkt, is voor uw logische app-resource mogelijk een koppeling naar uw integratieaccount vereist:
Werkstroom voor logische apps Koppeling vereist? Verbruik - AS2-connector (v2): Verbinding vereist, maar geen koppeling vereist
- AS2-connector: koppeling vereist, maar geen verbinding vereistStandaard - AS2-connector (v2): koppeling vereist, maar geen verbinding vereist
- AS2-connector : verbinding vereist, maar geen koppeling vereistAls u Azure Key Vault gebruikt voor certificaatbeheer, controleert u of uw kluissleutels de bewerkingen Versleutelen en ontsleutelen toestaan. Anders mislukken de coderings- en decoderingsacties.
Open uw sleutelkluis in Azure Portal. Selecteer Sleutels in het menu van de sleutelkluis onder Instellingen.
Selecteer uw sleutel in het deelvenster Sleutels . Selecteer in het deelvenster Versies de sleutelversie die u gebruikt.
Controleer in het deelvenster Sleutelversie onder Toegestane bewerkingen of de bewerkingen Versleutelen en ontsleutelen zijn geselecteerd, bijvoorbeeld:
AS2-berichten coderen
Selecteer het tabblad voor werkstromen van de logische app Verbruik of Standard:
AS2 v2-connector
Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.
Volg deze algemene stappen in de ontwerpfunctie om de AS2-actie (v2) met de naam AS2-codering toe te voegen aan uw werkstroom.
Geef in het actie-informatievak de volgende informatie op:
Eigenschappen Vereist Beschrijving Bericht om te coderen Ja De nettolading van het bericht, bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger.
1. Plaats de cursor in het vak Bericht om te coderen , zodat de lijst met dynamische inhoud wordt geopend.
2. Selecteer meer informatie naast de sectienaam wanneer een HTTP-aanvraag wordt ontvangen.
3. Selecteer Hoofdtekst in de lijst met uitvoerwaarden.AS2 van Ja De zakelijke id voor de afzender van het bericht, zoals opgegeven door uw AS2-overeenkomst, bijvoorbeeld Fabrikam. AS2 naar Ja De zakelijke id voor de ontvanger van het bericht, zoals opgegeven door uw AS2-overeenkomst, bijvoorbeeld Contoso. 
AS2-connector
Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.
Volg deze algemene stappen in de ontwerpfunctie om de AS2-actie Coderen toe te voegen aan het AS2-bericht aan uw werkstroom.
Geef de volgende informatie op wanneer u wordt gevraagd om een verbinding met uw integratieaccount te maken:
Eigenschappen Vereist Beschrijving Verbindingsnaam Ja Een naam voor de verbinding Integratieaccount Ja Selecteer in de lijst met beschikbare integratieaccounts het account dat u wilt gebruiken. Voorbeeld:
Selecteer Maken als u klaar bent.
Geef in het actie-informatievak de volgende informatie op.
Eigenschappen Vereist Beschrijving AS2-Van Ja De zakelijke id voor de afzender van het bericht, zoals opgegeven door uw AS2-overeenkomst, bijvoorbeeld Fabrikam. AS2-Naar Ja De zakelijke id voor de ontvanger van het bericht, zoals opgegeven door uw AS2-overeenkomst, bijvoorbeeld Contoso. hoofdtekst Ja De nettolading van het bericht om bijvoorbeeld de hoofdtekst van de aanvraagtrigger te coderen.
1. Plaats de cursor in het hoofdtekstvak zodat de lijst met dynamische inhoud wordt geopend.
2. Selecteer meer informatie naast de sectienaam wanneer een HTTP-aanvraag wordt ontvangen.
3. Selecteer Hoofdtekst in de lijst met uitvoerwaarden.
AS2-berichten decoderen
Selecteer het tabblad voor werkstromen van de logische app Verbruik of Standard:
AS2 v2-connector
Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.
Volg deze algemene stappen in de ontwerpfunctie om de AS2-actie (v2) met de naam AS2 Decode toe te voegen aan uw werkstroom.
Geef in het actie-informatievak de volgende informatie op:
Eigenschappen Vereist Beschrijving hoofdtekst Ja De hoofdtekst van het bericht voor het decoderen van bijvoorbeeld de hoofdtekst van de aanvraagtrigger.
1. Plaats de cursor in het hoofdtekstvak zodat de lijst met dynamische inhoud wordt geopend.
2. Selecteer meer informatie naast de sectienaam wanneer een HTTP-aanvraag wordt ontvangen.
3. Selecteer Hoofdtekst in de lijst met uitvoerwaarden.Kopteksten Ja De headers voor het bericht om bijvoorbeeld de headers van de aanvraagtrigger te decoderen .
1. Plaats de cursor in het vak Kopteksten , zodat de lijst met dynamische inhoud wordt geopend.
2. Selecteer meer informatie naast de sectienaam wanneer een HTTP-aanvraag wordt ontvangen.
3. Selecteer Kopteksten in de lijst met uitvoerwaarden.Voorbeeld:
AS2-connector
Open in Azure Portal de resource en werkstroom van uw logische app in de ontwerpfunctie.
Volg deze algemene stappen in de ontwerpfunctie om de AS2-actie met de naam AS2-bericht aan uw werkstroom toe te voegen.
Geef de volgende informatie op wanneer u wordt gevraagd om een verbinding met uw integratieaccount te maken:
Eigenschappen Vereist Beschrijving Verbindingsnaam Ja Een naam voor de verbinding Integratieaccount Ja Selecteer in de lijst met beschikbare integratieaccounts het account dat u wilt gebruiken. Voorbeeld:
Selecteer Maken als u klaar bent.
Geef in het actie-informatievak de volgende informatie op.
Eigenschappen Vereist Beschrijving hoofdtekst Ja De nettolading van het bericht, bijvoorbeeld de uitvoer van de hoofdtekst van de aanvraagtrigger.
1. Plaats de cursor in het hoofdtekstvak zodat de lijst met dynamische inhoud wordt geopend.
2. Selecteer meer informatie naast de sectienaam wanneer een HTTP-aanvraag wordt ontvangen.
3. Selecteer Hoofdtekst in de lijst met uitvoerwaarden.Kopteksten Ja De headers voor het bericht om bijvoorbeeld de headers van de aanvraagtrigger te decoderen .
1. Plaats de cursor in het vak Kopteksten , zodat de lijst met dynamische inhoud wordt geopend.
2. Selecteer meer informatie naast de sectienaam wanneer een HTTP-aanvraag wordt ontvangen.
3. Selecteer Kopteksten in de lijst met uitvoerwaarden.
Voorbeeld
Als u een volledig operationele logische app en een as2-voorbeeldscenario (v2) wilt implementeren, bekijkt u de sjabloon en het scenario van de logische as2-app (v2).
Problemen oplossen
Problemen bij het verzenden van ondertekende of versleutelde berichten
Overweeg verschillende SHA256-algoritmeindelingen te proberen. De AS2-specificatie biedt geen informatie over SHA256-indelingen, dus elke provider gebruikt zijn eigen implementatie of indeling.