Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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 använder du AS2-anslutningsappen (v2). Den här anslutningsappen innehå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 har AS2-anslutningsappen (v2) samma funktioner som den ursprungliga AS2-anslutningsappen. AS2-anslutningsappen (v2) 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. I stället, som beskrivet i förutsättningarna, länkar du ditt integrationskonto till den logikappresurs där du planerar att använda anslutningen.
Den här guiden visar hur du lägger till kodnings- och avkodningsåtgärderna för AS2 (v2) och AS2 i ett befintligt arbetsflöde för logikappar. AS2-anslutningsappen (v2) tillhandahå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 hanterade AS2-kopplingar, som visas i anslutningsgalleriet under Delat. AS2-kontakten har en utlösare och flera åtgärder. AS2-anslutningsappen (v2) innehåller endast åtgärder. Du kan använda valfri utlösare som fungerar för ditt scenario. Mer information finns i: - AS2-referens för hanterad anslutningsapp - AS2-hanterade anslutningsprogram (v2) - AS2-meddelandegränser |
| Standard | Azure Logic Apps för en enda kund, App Service Environment v3 (endast Windows-planer) och hybriddistribution | AS2 (v2) inbyggd anslutning, som visas i anslutningsgalleriet under Inbyggd, och AS2-hanterad anslutning, som visas i anslutningsgalleriet under Delad. AS2-anslutningen har en utlösare och flera åtgärder. AS2-anslutningsappen (v2) innehåller endast åtgärder. Du kan använda valfri utlösare som fungerar för ditt scenario. Den inbyggda versionen skiljer sig åt på följande sätt: – Den inbyggda versionen kan komma åt virtuella Azure-nätverk direkt. Du behöver ingen lokal datagateway. Mer information finns i: - 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 | Tillhandahåller dekryptering, digital signering och bekräftelser via Message Disposition Notifications (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.
Innan du börjar arbeta med AS2 (v2) eller AS2-åtgärder måste du länka din Consumption logic app eller länka din Standard logic app till ett integrationskonto. När du lägger till en AS2-åtgärd (v2) eller AS2-åtgärd kan du också behöva skapa en anslutning till integrationskontot:
Arbetsflöde för logikapp Krävs länk? Förbrukning – AS2-kontakt (v2): Ingen anslutning krävs
– AS2-anslutning: Anslutning krävsStandard – AS2-anslutning (v2): Ingen anslutning krävs
– AS2-anslutning: Anslutning 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 nyckelvalvsresursen i Azure-portalen. Välj Nycklar under Objekt i resurslisten.
På sidan Nycklar väljer du din nyckel. På sidan Versioner väljer du den nyckelversion som du använder.
På sidan Nyckelversion under Tillåtna åtgärder kontrollerar du att Kryptera och Dekryptera är markerade.
Koda AS2-meddelanden
Följ motsvarande steg för att koda meddelanden med AS2-anslutningsappen (v2) eller AS2-anslutningsappen.
AS2 v2-anslutningsprogram
Följ dessa steg för att koda meddelanden med AS2-anslutningsappen (v2):
Öppna logikappresursen och arbetsflödet i designern i Azure Portal.
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ärdsinformationsfönstret:
Parameter Obligatoriskt beskrivning Meddelande som ska kodas Ja Meddelandets nyttolast för att koda, till exempel brödtextutdata från utlösaren Begäran.
1. Välj i rutan Meddelande att koda och välj sedan blixtikonen för att öppna listan med dynamiskt innehåll.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. Välj Body i listan.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. Meddelandets nyttolast är till exempel brödtextinnehållsutdata från utlösaren Förfrågning:
AS2-anslutningsprogram
Följ dessa steg för att koda meddelanden med AS2-anslutningsappen:
Öppna logikappresursen och arbetsflödet i designern i Azure Portal.
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:
Parameter Obligatoriskt beskrivning Anslutningsnamn Ja Ett namn på anslutningen. Integrationskonto-ID Ja Namnet på ditt integrationskonto. SAS-URL för integrationskonto Ja Återanrops-URL:en för ditt integrationskonto. Till exempel:
När du är klar väljer du Skapa ny.
Ange följande information i åtgärdsinformationsfönstret.
Parameter 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. Välj inuti brödtextrutan och välj sedan blixtikonen för att öppna listan med dynamiskt innehåll.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. Välj Body i listan.
Avkoda AS2-meddelanden
Följ motsvarande steg för att avkoda meddelanden med AS2-anslutningsappen (v2) eller AS2-anslutningsappen.
AS2 v2-anslutningsprogram
Följ dessa steg om du vill avkoda meddelanden med AS2-anslutningsappen (v2):
Öppna logikappresursen och arbetsflödet i designern i Azure Portal.
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ärdsinformationsfönstret:
Parameter Obligatoriskt beskrivning Meddelande som ska avkodas Ja Meddelandets nyttolast för att avkoda, till exempel brödtextutdata från utlösaren Begäran.
1. Välj i rutan Meddelande att avkoda och välj sedan blixtikonen för att öppna listan med dynamiskt innehåll.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. Välj Body i listan.Meddelanderubriker Ja Rubrikerna för meddelandet som ska avkodas, till exempel rubrikernas utdata från utlösaren Förfrågning.
1. Välj i rutan Meddelanderubriker och välj sedan funktionsikonen för att öppna uttrycksredigeraren.
2. I redigeringsrutan anger du följande uttryck:triggerOutputs()?['headers']
3. När du är klar väljer du Lägg till.Till exempel:
AS2-anslutningsprogram
Följ dessa steg för att avkoda meddelanden med AS2-anslutningsappen:
Öppna logikappresursen och arbetsflödet i designern i Azure Portal.
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:
Parameter Obligatoriskt beskrivning Anslutningsnamn Ja Ett namn på anslutningen. Integrationskonto-ID Ja Resurs-ID:t för ditt integrationskonto, som har följande format: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name>
Till exempel:/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount
Följ dessa steg för att hitta det här resurs-ID:t:
1. Öppna ditt integrationskonto i Azure Portal.
2. Välj Översikt i sidofältet för integrationskontot.
3. På sidan Översikt väljer du JSON-vy.
4. Kopiera värdet från egenskapen Resurs-ID .SAS-URL för integrationskonto Ja URL:en för begärandeslutpunkt som använder SAS-autentisering (signatur för delad åtkomst) för att ge åtkomst till ditt integrationskonto. Den här motringnings-URL:en har följande format: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature>
Till exempel:https://prod-04.west-us.logic-azure.com:443/integrationAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=aB1cD2eF-3gH4iJ5kL6-mN7oP8qR
Följ dessa steg för att hitta den här URL:en:
1. Öppna ditt integrationskonto i Azure Portal.
2. I sidofältet för integrationskontot går du till Inställningar och väljer Återanrops-URL.
3. Från egenskapen Genererad motringnings-URL, kopiera värdet.Till exempel:
När du är klar väljer du Skapa ny.
Ange följande värden i åtgärdsinformationsfönstret:
Parameter Obligatoriskt beskrivning brödtext Ja Meddelandets nyttolast, till exempel brödtextutdata från utlösaren Förfrågning.
1. Välj inuti brödtextrutan och välj sedan blixtikonen för att öppna listan med dynamiskt innehåll.
2. Bredvid avsnittsnamnet När en HTTP-begäran tas emot väljer du Visa mer.
3. Välj Body i listan.Rubriker Ja Rubrikerna för meddelandet som ska avkodas, till exempel rubrikernas utdata från utlösaren Förfrågning.
1. Välj i rutan Rubriker och välj sedan funktionsikonen för att öppna uttrycksredigeraren.
2. I redigeringsrutan anger du följande uttryck:triggerOutputs()?['headers']
3. När du är klar väljer du Lägg till.Till exempel:
Exempel
Information om hur du distribuerar ett fullt fungerande logikapparbetsflöde och ett AS2-scenarioexempel (v2) finns i AS2-logikappmall och scenario (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.