Exchange AS2-meddelanden med hjälp av arbetsflöden i Azure Logic Apps
Gäller för: Azure Logic Apps (Förbrukning + Standard)
Om du vill skicka och ta emot AS2-meddelanden i arbetsflöden som du skapar med Hjälp av Azure Logic Apps kan du använda AS2-anslutningsappen (v2), som tillhandahåller åtgärder som stöder och hanterar AS2-kommunikation. Om du behöver spårningsfunktioner är den ursprungliga AS2-anslutningsappen fortfarande tillgänglig, men är inaktuell.
Förutom spårningsfunktioner tillhandahåller AS2-anslutningsappen (v2) samma funktioner som den ursprungliga AS2-anslutningsappen , körs internt med Azure Logic Apps-körningen och erbjuder betydande prestandaförbättringar i meddelandestorlek, dataflöde och svarstid. Till skillnad från den ursprungliga AS2-anslutningsappen kräver as2-anslutningsappen (v2) inte att du skapar en anslutning till ditt integrationskonto. Se i stället till att du länkar integrationskontot till logikappresursen där du planerar att använda anslutningsappen, enligt beskrivningen i förhandskraven.
Den här instruktionsguiden visar hur du lägger till AS2-kodnings- och avkodningsåtgärder i ett befintligt logikapparbetsflöde. AS2-anslutningsappen (v2) innehåller inga utlösare, så du kan använda valfri utlösare för att starta arbetsflödet. Exemplen i den här guiden använder utlösaren Förfrågning.
Teknisk referens för anslutningsprogram
AS2-anslutningsappen har olika versioner, baserat på logikapptyp och värdmiljö.
| Logikapp | Environment | Anslutningsversion |
|---|---|---|
| Förbrukning | Azure Logic Apps med flera klientorganisationer | AS2 (v2) och AS2-hanterade anslutningsappar (standardklass). AS2-anslutningsappen (v2) innehåller endast åtgärder, men du kan använda alla utlösare som fungerar för ditt scenario. Mer information finns i följande dokumentation: - AS2-referens för hanterad anslutningsapp - AS2-hanterade anslutningsprogram (v2) - AS2-meddelandegränser |
| Förbrukning | Integration Service Environment (ISE) | AS2 (v2) och AS2-hanterade anslutningsappar (standardklass) och AS2 ISE-version, som har andra meddelandegränser än standardklassen. AS2-anslutningsappen (v2) innehåller endast åtgärder, men du kan använda alla utlösare som fungerar för ditt scenario. Mer information finns i följande dokumentation: - AS2-referens för hanterad anslutningsapp - AS2-hanterade anslutningsprogram (v2) - AS2-meddelandegränser |
| Standard | Azure Logic Apps för en klientorganisation och App Service Environment v3 (endast Windows-planer) | AS2 (v2) inbyggd anslutningsapp och AS2-hanterad anslutningsapp. Den inbyggda versionen skiljer sig åt på följande sätt: – Den inbyggda versionen innehåller endast åtgärder, men du kan använda alla utlösare som fungerar för ditt scenario. – Den inbyggda versionen kan komma åt virtuella Azure-nätverk direkt. Du behöver ingen lokal datagateway. Mer information finns i följande dokumentation: - AS2-referens för hanterad anslutningsapp - Inbyggda as2-åtgärder (v2) - AS2-meddelandegränser |
AS2-åtgärder (v2)
AS2-anslutningsappen (v2) har inga utlösare. I följande tabell beskrivs de åtgärder som AS2-anslutningsappen (v2) tillhandahåller för att upprätta säkerhet och tillförlitlighet vid överföring av meddelanden:
| Åtgärd | beskrivning |
|---|---|
| AS2-kodningsåtgärd | Tillhandahåller kryptering, digital signering och bekräftelser via meddelanden om meddelandeborttagning (MDN), som hjälper till att stödja icke-avvisning. Den här åtgärden tillämpar till exempel AS2/HTTP-huvuden och utför följande uppgifter när den konfigureras: – Signera utgående meddelanden. – Kryptera utgående meddelanden. - Komprimera meddelandet. – Överför filnamnet i MIME-huvudet. |
| AS2-avkodningsåtgärd | Ange dekryptering, digital signering och bekräftelser via meddelanden om meddelandeborttagning (MDN). Den här åtgärden utför till exempel följande uppgifter när den konfigureras: – Bearbeta AS2/HTTP-huvuden. – Stämma av mottagna MDN:er med de ursprungliga utgående meddelandena. – Uppdatera och korrelera poster i databasen nonrepudiation. – Skriva poster för AS2-statusrapportering. – Mata ut nyttolastinnehåll som base64-kodat. – Avgör om MDN krävs. Baserat på AS2-avtalet avgör du om MDN:er ska vara synkrona eller asynkrona. – Generera synkrona eller asynkrona MDN:er baserat på AS2-avtalet. – Ange korrelationstoken och egenskaper för MDN. – Verifiera signaturen. - Dekryptera meddelandena. - Dekomprimera meddelandet. – Kontrollera och tillåt inte dubbletter av meddelande-ID. |
Förutsättningar
Ett Azure-konto och prenumeration. Om du inte har någon prenumeration än registrerar du dig för ett kostnadsfritt Azure-konto.
Logikappens resurs och arbetsflöde där du vill använda AS2-åtgärderna.
En integrationskontoresurs för att definiera och lagra artefakter för användning i företagsintegrering och B2B-arbetsflöden.
Både integrationskontot och logikappresursen måste finnas i samma Azure-prenumeration och Azure-region.
Definierar minst två handelspartner som deltar i AS2-åtgärden som används i arbetsflödet. Definitionerna för båda partnerna måste använda samma företagsidentitetskvalificerare , vilket är AS2Identity för det här scenariot.
Definierar ett AS2-avtal mellan de handelspartner som deltar i ditt arbetsflöde. Varje avtal kräver en värdpartner och en gästpartner. Innehållet i meddelandena mellan dig och den andra partnern måste matcha avtalstypen. Information om avtalsinställningar som ska användas när du tar emot och skickar meddelanden finns i AS2-meddelandeinställningar.
Beroende på om du arbetar med ett arbetsflöde för förbrukning eller standardlogikapp kan logikappresursen kräva en länk till ditt integrationskonto:
Arbetsflöde för logikapp Krävs länk? Förbrukning - AS2-anslutningsprogram (v2): Anslutning krävs, men ingen länk krävs
- AS2-anslutning : Länk krävs, men ingen anslutning krävsStandard - AS2-anslutningsprogram (v2): Länk krävs, men ingen anslutning krävs
- AS2-anslutning : Anslutning krävs, men ingen länk krävsOm du använder Azure Key Vault för certifikathantering kontrollerar du att dina valvnycklar tillåter krypterings- och dekrypteringsåtgärderna. Annars misslyckas kodnings- och avkodningsåtgärderna.
Öppna ditt nyckelvalv i Azure-portalen. På menyn key vault går du till Inställningar och väljer Nycklar.
Välj din nyckel i fönstret Nycklar . I fönstret Versioner väljer du den nyckelversion som du använder.
I fönstret Nyckelversion under Tillåtna åtgärder kontrollerar du att åtgärderna Kryptera och Dekryptera är markerade, till exempel:
Koda AS2-meddelanden
Välj fliken för arbetsflöden för förbrukning eller standardlogikapp:
AS2 v2-anslutningsprogram
Öppna logikappresursen och arbetsflödet i designern i Azure-portalen.
I designern följer du de här allmänna stegen för att lägga till AS2-åtgärden (v2) med namnet AS2 Encode i arbetsflödet.
Ange följande information i åtgärdsinformationsrutan:
Property Obligatoriskt Beskrivning Meddelande som ska kodas Ja Meddelandets nyttolast, till exempel brödtextutdata från utlösaren Förfrågning.
1. Placera markören i rutan Meddelande för att koda så att listan med dynamiskt innehåll öppnas.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. I listan med utdata väljer du Brödtext.AS2 från Ja Affärsidentifieraren för meddelandesändaren enligt as2-avtalet, till exempel Fabrikam. AS2 till Ja Affärsidentifieraren för meddelandemottagaren enligt as2-avtalet, till exempel Contoso. 
AS2-anslutningsprogram
Öppna logikappresursen och arbetsflödet i designern i Azure-portalen.
I designern följer du de här allmänna stegen för att lägga till AS2-åtgärden med namnet Koda till AS2-meddelande i arbetsflödet.
När du uppmanas att skapa en anslutning till ditt integrationskonto anger du följande information:
Property Obligatoriskt Beskrivning Anslutningens namn Ja Ett namn på anslutningen Integrationskonto Ja I listan över tillgängliga integrationskonton väljer du det konto som ska användas. Till exempel:
Välj Skapa när du är klar.
Ange följande information i åtgärdsinformationsrutan.
Property Obligatoriskt Beskrivning AS2-From Ja Affärsidentifieraren för meddelandesändaren enligt as2-avtalet, till exempel Fabrikam. AS2-to Ja Affärsidentifieraren för meddelandemottagaren enligt as2-avtalet, till exempel Contoso. brödtext Ja Meddelandets nyttolast för att koda, till exempel brödtextutdata från utlösaren Begäran.
1. Placera markören i brödtextrutan så att listan med dynamiskt innehåll öppnas.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. I listan med utdata väljer du Brödtext.
Avkoda AS2-meddelanden
Välj fliken för arbetsflöden för förbrukning eller standardlogikapp:
AS2 v2-anslutningsprogram
Öppna logikappresursen och arbetsflödet i designern i Azure-portalen.
I designern följer du de här allmänna stegen för att lägga till AS2-åtgärden (v2) med namnet AS2 Decode i arbetsflödet.
Ange följande information i åtgärdsinformationsrutan:
Property Obligatoriskt Beskrivning brödtext Ja Brödtexten för meddelandet som ska avkodas, till exempel Brödtextutdata från utlösaren Begäran.
1. Placera markören i brödtextrutan så att listan med dynamiskt innehåll öppnas.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. I listan med utdata väljer du Brödtext.Rubriker Ja Rubrikerna för meddelandet som ska avkodas, till exempel rubrikernas utdata från utlösaren Förfrågning.
1. Placera markören i rutan Rubriker så att listan med dynamiskt innehåll öppnas.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. I listan med utdata väljer du Rubriker.Till exempel:
AS2-anslutningsprogram
Öppna logikappresursen och arbetsflödet i designern i Azure-portalen.
I designern följer du de här allmänna stegen för att lägga till AS2-åtgärden med namnet Avkoda AS2-meddelande i arbetsflödet.
När du uppmanas att skapa en anslutning till ditt integrationskonto anger du följande information:
Property Obligatoriskt Beskrivning Anslutningens namn Ja Ett namn på anslutningen Integrationskonto Ja I listan över tillgängliga integrationskonton väljer du det konto som ska användas. Till exempel:
Välj Skapa när du är klar.
Ange följande information i åtgärdsinformationsrutan.
Property Obligatoriskt Beskrivning brödtext Ja Meddelandets nyttolast, till exempel brödtextutdata från utlösaren Förfrågning.
1. Placera markören i brödtextrutan så att listan med dynamiskt innehåll öppnas.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. I listan med utdata väljer du Brödtext.Rubriker Ja Rubrikerna för meddelandet som ska avkodas, till exempel rubrikernas utdata från utlösaren Förfrågning.
1. Placera markören i rutan Rubriker så att listan med dynamiskt innehåll öppnas.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. I listan med utdata väljer du Rubriker.
Exempel
Om du vill prova att distribuera en fullt fungerande logikapp och as2-exempelscenario (v2) läser du mallen och scenariot för AS2-logikappen (v2).
Felsöka problem
Problem vid sändning av signerade eller krypterade meddelanden
Överväg att prova olika SHA256-algoritmformat. AS2-specifikationen innehåller ingen information om SHA256-format, så varje leverantör använder sin egen implementering eller sitt eget format.