Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Platí pro: Azure Logic Apps (Consumption + Standard)
Pokud chcete odesílat a přijímat zprávy AS2 v pracovních postupech, které vytvoříte pomocí Azure Logic Apps, použijte konektor AS2 (v2). Tento konektor poskytuje akce, které podporují a spravují komunikaci AS2. Pokud potřebujete funkce sledování, je původní konektor AS2 stále dostupný, ale je zastaralý.
Kromě možností sledování poskytuje konektor AS2 (v2) stejné možnosti jako původní konektor AS2. Konektor AS2 (v2) běží nativně s modulem runtime Azure Logic Apps a nabízí významné vylepšení výkonu ve velikosti zpráv, propustnosti a latenci. Na rozdíl od původního konektoru AS2 konektor AS2 (v2) nevyžaduje, abyste vytvořili připojení ke svému účtu integrace. Místo toho, jak je popsáno v požadavcích, propojte svůj účet integrace s prostředkem aplikace logiky, ve kterém plánujete konektor používat.
Tento průvodce ukazuje, jak přidat akce kódování a dekódování pro AS2 (v2) a AS2 do existujícího pracovního postupu aplikace logiky. Konektor AS2 (v2) neposkytuje žádné triggery, takže ke spuštění pracovního postupu můžete použít libovolnou aktivační událost. Příklady v této příručce používají trigger požadavku.
Technické reference ke konektoru
Konektor AS2 má různé verze založené na typu aplikace logiky a hostitelském prostředí.
| Aplikace logiky | Prostředí | Verze konektoru |
|---|---|---|
| Využití | Azure Logic Apps s více tenanty | Spravované konektory AS2 (v2) a AS2, které se zobrazují v galerii konektorů v části Sdílené. Konektor AS2 má jeden trigger a několik akcí. Konektor AS2 (v2 verze) poskytuje pouze akce. Můžete použít libovolný trigger, který funguje pro váš scénář. Další informace najdete tady: - Referenční informace ke spravovanému konektoru AS2 - Operace spravovaného konektoru AS2 (v2) - Omezení zpráv AS2 |
| Standard | Azure Logic Apps s jedním tenantem, App Service Environment v3 (jenom plány Windows) a hybridní nasazení | Integrovaný konektor AS2 (v2), který se zobrazí v galerii konektorů v integrovaném konektoru a spravovaný konektor AS2, který se zobrazí v galerii konektorů v části Sdílené. Konektor AS2 má jeden trigger a několik akcí. Konektor AS2 (v2) poskytuje pouze akce. Můžete použít libovolný trigger, který funguje pro váš scénář. Integrovaná verze se liší následujícími způsoby: – Integrovaná verze má přímý přístup k virtuálním sítím Azure. Nepotřebujete místní bránu dat. Další informace najdete tady: - Referenční informace ke spravovanému konektoru AS2 - Operace integrovaného konektoru AS2 (v2) - Omezení zpráv AS2 |
Operace AS2 (v2)
Konektor AS2 (v2) nemá žádné triggery. Následující tabulka popisuje akce, které konektor AS2 (v2) poskytuje pro zajištění zabezpečení a spolehlivosti při přenosu zpráv:
| Akce | Popis |
|---|---|
| Akce kódování AS2 | Poskytuje šifrování, digitální podepisování a potvrzení prostřednictvím oznámení MDN (Message Disposition Notifications), které pomáhají podporovat nererepudici. Tato akce například použije hlavičky AS2/HTTP a při konfiguraci provede následující úlohy: - Podepište odchozí zprávy. - Zašifrujte odchozí zprávy. - Komprimujte zprávu. - Přeneste název souboru v hlavičce MIME. |
| Akce dekódování AS2 | Poskytuje dešifrování, digitální podepisování a potvrzení prostřednictvím oznámení MDN (Message Disposition Notifications). Tato akce například provádí při konfiguraci následující úlohy: – Zpracování hlaviček AS2/HTTP – Odsouhlasení přijatých sítí MDN s původními odchozími zprávami. – Aktualizujte a korelujte záznamy v databázi, která není opakována. - Zápis záznamů pro hlášení stavu AS2. – Výstupní obsah datové části s kódováním base64. – Určete, jestli jsou vyžadovány sítě MDN. Na základě smlouvy AS2 určete, jestli mají být sítě MDN synchronní nebo asynchronní. – Generování synchronních nebo asynchronních sítí MDN na základě smlouvy AS2. – Nastavte korelační tokeny a vlastnosti v sítích MDN. - Ověřte podpis. - Dešifrujte zprávy. - Dekomprimujte zprávu. - Zkontrolujte a zakážete duplicitní id zprávy. |
Požadavky
Účet a předplatné Azure. Pokud ještě nemáte předplatné, zaregistrujte si bezplatný účet Azure.
Prostředek aplikace logiky a pracovní postup, ve kterém chcete použít operace AS2.
Prostředek účtu integrace pro definování a ukládání artefaktů pro použití v pracovních postupech podnikové integrace a B2B.
Váš účet integrace i prostředek aplikace logiky musí existovat ve stejném předplatném Azure i v oblasti Azure.
Definuje alespoň dva obchodní partnery , kteří se účastní operace AS2 používané ve vašem pracovním postupu. Definice obou partnerů musí používat stejný kvalifikátor obchodní identity , což je AS2Identity pro tento scénář.
Definuje smlouvu AS2 mezi obchodními partnery, kteří se účastní vašeho pracovního postupu. Každá smlouva vyžaduje partnera hostitele a partnera typu host. Obsah zpráv mezi vámi a druhým partnerem musí odpovídat typu smlouvy. Informace o nastavení smlouvy, která se mají použít při přijímání a odesílání zpráv, najdete v tématu Nastavení zprávy AS2.
Než začnete pracovat s AS2 (v2) nebo operacemi AS2, musíte propojit aplikaci Consumption logic app nebo propojit aplikaci Standard logic app k integračnímu účtu. Když přidáte operaci AS2 (v2) nebo AS2, možná budete muset také vytvořit připojení k účtu integrace:
Pracovní postup aplikace logiky Vyžaduje se propojení? Spotřeba – konektor AS2 (v2): Nevyžaduje se žádné připojení
– Konektor AS2: Vyžaduje se připojeníStandard – konektor AS2 (v2): Nevyžaduje se žádné připojení
– Konektor AS2: Vyžaduje se připojeníPokud ke správě certifikátů používáte Azure Key Vault , zkontrolujte, jestli klíče trezoru povolují operace Šifrování a dešifrování . Jinak se akce kódování a dekódování nezdaří.
Na webu Azure Portal otevřete prostředek trezoru klíčů. Na bočním panelu prostředku v části Objekty vyberte Klíče.
Na stránce Klíče vyberte svůj klíč. Na stránce Verze vyberte verzi klíče, kterou používáte.
Na stránce Verze klíče v části Povolené operace potvrďte, že je vybraná možnost Šifrovat a Dešifrovat .
Kódování zpráv AS2
Pokud chcete kódovat zprávy pomocí konektoru AS2 (v2) nebo konektoru AS2, postupujte podle odpovídajících kroků.
Konektor AS2 v2
Pokud chcete kódovat zprávy pomocí konektoru AS2 (v2), postupujte takto:
Na webu Azure Portal otevřete prostředek aplikace logiky a pracovní postup v návrháři.
V návrháři podle těchto obecných kroků přidejte do pracovního postupu akci AS2 (v2) pojmenovanou AS2 Encode.
V podokně informací o akci zadejte následující informace:
Parameter Požadováno Popis Zpráva pro kódování Ano Datová část zprávy, která se má kódovat, například výstup textu z triggeru Požadavku.
1. Vyberte uvnitř pole zprávy k zakódování, poté vyberte ikonu blesku pro otevření seznamu dynamického obsahu.
2. Vedle názvu oddílu Při přijetí požadavku HTTP vyberte Zobrazit více.
3. Ze seznamu vyberte Body.AS2 z Ano Obchodní identifikátor odesílatele zprávy, jak je určeno vaší smlouvou AS2, například Fabrikam. AS2 do Ano Obchodní identifikátor příjemce zprávy určený vaší smlouvou AS2, například Contoso. Datová část zprávy je například výstup základního obsahu z triggeru požadavku:
Konektor AS2
Pokud chcete kódovat zprávy pomocí konektoru AS2, postupujte takto:
Na webu Azure Portal otevřete prostředek aplikace logiky a pracovní postup v návrháři.
V návrháři postupujte podle těchto obecných kroků a přidejte akci AS2 nazvanou Kódování do zprávy AS2 do svého pracovního postupu.
Po zobrazení výzvy k vytvoření připojení k vašemu účtu integrace zadejte následující informace:
Parameter Požadováno Popis Název připojení Ano Název připojení. ID účtu integrace Ano Název vašeho integračního účtu. Adresa URL SAS integračního účtu Ano Adresa URL zpětného volání pro váš integrační účet. Příklad:
Až budete hotovi, vyberte Vytvořit nový.
V podokně informací o akci zadejte následující informace.
Parameter Požadováno Popis AS2-From Ano Obchodní identifikátor odesílatele zprávy, jak je určeno vaší smlouvou AS2, například Fabrikam. AS2-to Ano Obchodní identifikátor příjemce zprávy určený vaší smlouvou AS2, například Contoso. tělo Ano Datová část zprávy, která se má kódovat, například výstup textu z triggeru Požadavku.
1. Vyberte uvnitř textového pole a pak výběrem ikony blesku otevřete seznam dynamického obsahu.
2. Vedle názvu oddílu Při přijetí požadavku HTTP vyberte Zobrazit více.
3. Ze seznamu vyberte Tělo.
Dekódování zpráv AS2
Pokud chcete dekódovat zprávy pomocí konektoru AS2 (v2) nebo konektoru AS2, postupujte podle odpovídajících kroků.
Konektor AS2 v2
Pokud chcete dekódovat zprávy pomocí konektoru AS2 (v2), postupujte takto:
Na webu Azure Portal otevřete prostředek aplikace logiky a pracovní postup v návrháři.
V návrháři podle těchto obecných kroků přidejte akci AS2 (v2) s názvem AS2 Decode do vašeho pracovního postupu.
V podokně informací o akci zadejte následující informace:
Parameter Požadováno Popis Zpráva k dekódování Ano Datová část zprávy pro dekódování, například výstup textu z triggeru Požadavku.
1. Vyberte uvnitř pole Zpráva pro dekódování a pak výběrem ikony blesku otevřete seznam dynamického obsahu.
2. Vedle názvu oddílu Při přijetí požadavku HTTP vyberte Zobrazit více.
3. Ze seznamu vyberte Tělo.Záhlaví zpráv Ano Hlavičky zprávy, které se mají dekódovat, například výstup headers z triggeru Požadavku.
1. Vyberte uvnitř pole Záhlaví zprávy a pak výběrem ikony funkce otevřete editor výrazů.
2. Do pole editoru zadejte následující výraz:triggerOutputs()?['headers']
3. Až budete hotovi, vyberte Přidat.Příklad:
Konektor AS2
Pokud chcete dekódovat zprávy pomocí konektoru AS2, postupujte takto:
Na webu Azure Portal otevřete prostředek aplikace logiky a pracovní postup v návrháři.
V návrháři postupujte podle těchto obecných kroků a přidejte do pracovního postupu akci AS2 s názvem Dekódovat zprávu AS2.
Po zobrazení výzvy k vytvoření připojení k vašemu účtu integrace zadejte následující informace:
Parameter Požadováno Popis Název připojení Ano Název připojení. ID účtu integrace Ano ID prostředku vašeho integračního účtu, který má následující formát: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name>
Například:/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount
Pokud chcete najít toto ID prostředku, postupujte takto:
1. Na webu Azure Portal otevřete svůj účet integrace.
2. Na bočním panelu účtu integrace vyberte Přehled.
3. Na stránce Přehled vyberte zobrazení JSON.
4. Z vlastnosti identifikátor prostředku zkopírujte hodnotu.Adresa URL SAS integračního účtu Ano Adresa URL koncového bodu požadavku, která používá ověřování sdíleného přístupového podpisu (SAS) k poskytnutí přístupu k vašemu účtu integrace. Tato adresa URL zpětného volání má následující formát: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature>
Například: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
Chcete-li najít tuto adresu URL, postupujte takto:
1. Na webu Azure Portal otevřete svůj účet integrace.
2. Na bočním panelu účtu integrace v části Nastavení vyberte adresu URL zpětného volání.
3. Z vygenerované vlastnosti URL zpětného volání zkopírujte hodnotu.Příklad:
Až budete hotovi, vyberte Vytvořit nový.
V podokně informací o akci zadejte následující hodnoty:
Parameter Požadováno Popis tělo Ano Datová část zprávy, například výstup textu z triggeru požadavku.
1. Vyberte uvnitř textového pole a pak výběrem ikony blesku otevřete seznam dynamického obsahu.
2. Vedle názvu oddílu Při přijetí požadavku HTTP vyberte Zobrazit více.
3. Ze seznamu vyberte Body.Záhlaví Ano Hlavičky zprávy, které se mají dekódovat, například výstup headers z triggeru Požadavku.
1. Klikněte do pole Záhlaví a pak kliknutím na ikonu funkce otevřete editor výrazů.
2. Do pole editoru zadejte následující výraz:triggerOutputs()?['headers']
3. Až budete hotovi, vyberte Přidat.Příklad:
Vzorek
Pokud chcete nasadit plně funkční pracovní postup aplikace logiky a ukázkový scénář AS2 (v2), přečtěte si šablonu a scénář aplikace logiky AS2 (v2).
Poradce při potížích
Problémy při odesílání podepsaných nebo šifrovaných zpráv
Zvažte použití různých formátů algoritmů SHA256. Specifikace AS2 neposkytuje žádné informace o formátech SHA256, takže každý poskytovatel používá vlastní implementaci nebo formát.