Wymiana komunikatów AS2 przy użyciu przepływów pracy w usłudze Azure Logic Apps
Dotyczy: Azure Logic Apps (Zużycie + Standardowa)
Aby wysyłać i odbierać komunikaty AS2 w przepływach pracy tworzonych przy użyciu usługi Azure Logic Apps, możesz użyć łącznika AS2 (wersja 2), który udostępnia akcje, które obsługują komunikację AS2 i zarządzają nią. Jeśli potrzebujesz możliwości śledzenia, oryginalny łącznik AS2 jest nadal dostępny, ale jest przestarzały.
Z wyjątkiem możliwości śledzenia łącznik AS2 (wersja 2) zapewnia takie same możliwości jak oryginalny łącznik AS2 , działa natywnie ze środowiskiem uruchomieniowym usługi Azure Logic Apps i oferuje znaczne ulepszenia wydajności w zakresie rozmiaru komunikatu, przepływności i opóźnienia. W przeciwieństwie do oryginalnego łącznika AS2 łącznik AS2 (wersja 2) nie wymaga utworzenia połączenia z kontem integracji. Zamiast tego, zgodnie z opisem w wymaganiach wstępnych, upewnij się, że łączysz konto integracji z zasobem aplikacji logiki, w którym planujesz używać łącznika.
W tym przewodniku z instrukcjami pokazano, jak dodać akcje kodowania i dekodowania AS2 do istniejącego przepływu pracy aplikacji logiki. Łącznik AS2 (wersja 2) nie zawiera żadnych wyzwalaczy, dlatego możesz użyć dowolnego wyzwalacza, aby uruchomić przepływ pracy. Przykłady w tym przewodniku używają wyzwalacza żądania.
Dokumentacja techniczna łącznika
Łącznik AS2 ma różne wersje na podstawie typu aplikacji logiki i środowiska hosta.
| Aplikacja logiki | Środowisko | Wersja łącznika |
|---|---|---|
| Zużycie | Usługa Azure Logic Apps z wieloma dzierżawami | Łączniki zarządzane AS2 (wersja 2) i AS2 (klasa Standardowa). Łącznik AS2 (wersja 2) udostępnia tylko akcje, ale można użyć dowolnego wyzwalacza, który działa dla danego scenariusza. Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją: - Dokumentacja łącznika zarządzanego AS2 - Operacje łącznika zarządzanego as2 (wersja 2) - Limity protokołu B2B dla rozmiarów komunikatów - Łączniki zarządzane w usłudze Azure Logic Apps |
| Zużycie | Środowisko usługi integracji (ISE) | Łączniki zarządzane AS2 (wersja 2) i AS2 (klasa Standardowa) i WERSJA ŚRODOWISKA AS2 ISE, które mają inne limity komunikatów niż klasa Standardowa. Łącznik AS2 (wersja 2) udostępnia tylko akcje, ale można użyć dowolnego wyzwalacza, który działa dla danego scenariusza. Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją: - Dokumentacja łącznika zarządzanego AS2 - Operacje łącznika zarządzanego as2 (wersja 2) - Limity komunikatów ISE - Łączniki zarządzane w usłudze Azure Logic Apps |
| Standardowa | Usługa Azure Logic Apps z jedną dzierżawą i App Service Environment w wersji 3 (tylko plany systemu Windows) | Wbudowany łącznik AS2 (wersja 2) i łącznik zarządzany AS2. Wbudowana wersja różni się w następujący sposób: — Wbudowana wersja udostępnia tylko akcje, ale możesz użyć dowolnego wyzwalacza, który działa w danym scenariuszu. — Wbudowana wersja może uzyskiwać bezpośredni dostęp do sieci wirtualnych platformy Azure. Nie potrzebujesz lokalnej bramy danych. Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją: - Dokumentacja łącznika zarządzanego AS2 - Wbudowane operacje łącznika AS2 (wersja 2) - Wbudowane łączniki w usłudze Azure Logic Apps |
Operacje AS2 (wersja 2)
Łącznik AS2 (wersja 2) nie ma wyzwalaczy. W poniższej tabeli opisano akcje, które łącznik AS2 (wersja 2) zapewnia ustanawianie zabezpieczeń i niezawodności podczas przesyłania komunikatów:
| Akcja | Opis |
|---|---|
| Akcja kodowania AS2 | Zapewnia szyfrowanie, podpisywanie cyfrowe i potwierdzenia za pośrednictwem powiadomień o dyspozycji komunikatów (MDN), które pomagają w obsłudze odrzucenia. Na przykład ta akcja stosuje nagłówki AS2/HTTP i wykonuje następujące zadania podczas konfigurowania: - Podpisz komunikaty wychodzące. - Szyfruj komunikaty wychodzące. - Kompresuj komunikat. - Przesyłaj nazwę pliku w nagłówku MIME. |
| Akcja dekodowania AS2 | Zapewnianie odszyfrowywania, podpisywania cyfrowego i potwierdzenia za pomocą powiadomień o dyspozycji komunikatów (MDN). Na przykład ta akcja wykonuje następujące zadania podczas konfigurowania: - Przetwarzanie nagłówków AS2/HTTP. - Uzgadnianie odebranych nazw MDN z oryginalnymi komunikatami wychodzącymi. - Aktualizuj i koreluj rekordy w bazie danych nieoddania. — Zapisuj rekordy dla raportowania stanu AS2. - Zawartość ładunku wyjściowego jako zakodowana w formacie base64. - Określ, czy wymagane są nazwy MDN. Na podstawie umowy AS2 określ, czy sieci MDN powinny być synchroniczne, czy asynchroniczne. — Generuj synchroniczne lub asynchroniczne sieci MDN na podstawie umowy AS2. — Ustawianie tokenów korelacji i właściwości w sieciACH MDN. — Zweryfikuj podpis. — Odszyfrowywanie komunikatów. - Dekompresuj komunikat. — Sprawdź i nie zezwalaj na duplikaty identyfikatora komunikatu. |
Wymagania wstępne
Konto i subskrypcja platformy Azure. Jeśli nie masz jeszcze subskrypcji, utwórz bezpłatne konto platformy Azure.
Zasób i przepływ pracy aplikacji logiki, w którym chcesz używać operacji AS2.
Zasób konta integracji do definiowania i przechowywania artefaktów do użycia w przepływach pracy integracji przedsiębiorstwa i B2B.
Zarówno konto integracji, jak i zasób aplikacji logiki muszą istnieć w tej samej subskrypcji platformy Azure i regionie świadczenia usługi Azure.
Definiuje co najmniej dwóch partnerów handlowych , którzy uczestniczą w operacji AS2 używanej w przepływie pracy. Definicje obu partnerów muszą używać tego samego kwalifikatora tożsamości biznesowej , który jest as2Identity dla tego scenariusza.
Definiuje umowę AS2 między partnerami handlowymi, którzy uczestniczą w przepływie pracy. Każda umowa wymaga partnera hosta i partnera gościa. Zawartość komunikatów między Tobą a innym partnerem musi być zgodna z typem umowy. Aby uzyskać informacje o ustawieniach umowy do użycia podczas odbierania i wysyłania komunikatów, zobacz Ustawienia komunikatów AS2.
W zależności od tego, czy pracujesz nad przepływem pracy aplikacji logiki Zużycie czy Standardowa, zasób aplikacji logiki może wymagać linku do konta integracji:
Przepływ pracy aplikacji logiki Wymagane łącze? Zużycie - Łącznik AS2 (wersja 2): Wymagane połączenie, ale nie jest wymagane żadne łącze
- Łącznik AS2: łącze jest wymagane, ale nie jest wymagane żadne połączenieStandardowa (Standard) - Łącznik AS2 (wersja 2):Wymagany jest link, ale nie jest wymagane żadne połączenie
- Łącznik AS2: Wymagane połączenie, ale nie jest wymagane żadne łączeJeśli używasz usługi Azure Key Vault do zarządzania certyfikatami, sprawdź, czy klucze magazynu zezwalają na operacje Szyfrowanie i odszyfrowywanie. W przeciwnym razie akcje kodowania i dekodowania kończą się niepowodzeniem.
W Azure Portal otwórz magazyn kluczy. W menu magazynu kluczy w obszarze Ustawienia wybierz pozycję Klucze.
W okienku Klucze wybierz swój klucz. W okienku Wersje wybierz używaną wersję klucza.
W okienku Wersja klucza w obszarze Dozwolone operacje upewnij się, że wybrano operacje Szyfrowanie i odszyfrowywanie , na przykład:
Kodowanie komunikatów AS2
Wybierz kartę przepływów pracy aplikacji logiki Zużycie lub Standardowa:
Łącznik AS2 w wersji 2
W Azure Portal otwórz zasób aplikacji logiki i przepływ pracy w projektancie.
W projektancie wykonaj następujące ogólne kroki, aby dodać akcję AS2 (wersja 2) o nazwie AS2 Kodowanie do przepływu pracy.
W polu informacji o akcji podaj następujące informacje:
Właściwość Wymagane Opis Komunikat do kodowania Tak Ładunek komunikatu, na przykład dane wyjściowe Treść wyzwalacza Żądanie.
1. Umieść kursor w polu Komunikat, aby zakodować , aby otworzyć listę zawartości dynamicznej.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy danych wyjściowych wybierz pozycję Treść.AS2 od Tak Identyfikator biznesowy nadawcy komunikatów określony przez umowę AS2, na przykład Fabrikam. AS2 do Tak Identyfikator biznesowy odbiorcy komunikatów określony przez umowę AS2, na przykład Contoso. 
Łącznik AS2
W Azure Portal otwórz zasób aplikacji logiki i przepływ pracy w projektancie.
W projektancie wykonaj następujące ogólne kroki, aby dodać akcję AS2 o nazwie Encode do komunikatu AS2 do przepływu pracy.
Po wyświetleniu monitu o utworzenie połączenia z kontem integracji podaj następujące informacje:
Właściwość Wymagane Opis Nazwa połączenia Tak Nazwa połączenia Konto integracji Tak Z listy dostępnych kont integracji wybierz konto do użycia. Na przykład:
Gdy wszystko będzie gotowe, wybierz przycisk Utwórz.
W polu informacji o akcji podaj następujące informacje.
Właściwość Wymagane Opis AS2-From Tak Identyfikator biznesowy nadawcy komunikatów określony przez umowę AS2, na przykład Fabrikam. AS2-To Tak Identyfikator biznesowy odbiorcy komunikatów określony przez umowę AS2, na przykład Contoso. Ciała Tak Ładunek komunikatu do kodowania, na przykład dane wyjściowe Treść z wyzwalacza Żądania.
1. Umieść kursor w polu treści , aby zostanie otwarta lista zawartości dynamicznej.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy danych wyjściowych wybierz pozycję Treść.
Dekodowanie komunikatów AS2
Wybierz kartę przepływów pracy aplikacji logiki Zużycie lub Standardowa:
Łącznik AS2 w wersji 2
W Azure Portal otwórz zasób aplikacji logiki i przepływ pracy w projektancie.
W projektancie wykonaj następujące ogólne kroki, aby dodać akcję AS2 (wersja 2) o nazwie AS2 Decode do przepływu pracy.
W polu informacji o akcji podaj następujące informacje:
Właściwość Wymagane Opis Ciała Tak Treść komunikatu do dekodowania, na przykład dane wyjściowe Treści z wyzwalacza Żądanie.
1. Umieść kursor w polu treści , aby lista zawartości dynamicznej się otwierała.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy danych wyjściowych wybierz pozycję Treść.Nagłówki Tak Nagłówki komunikatu do dekodowania, na przykład dane wyjściowe Nagłówki z wyzwalacza Żądanie.
1. Umieść kursor w polu Nagłówki , aby lista zawartości dynamicznej się otwierała.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy danych wyjściowych wybierz pozycję Nagłówki.Na przykład:
Łącznik AS2
W Azure Portal otwórz zasób aplikacji logiki i przepływ pracy w projektancie.
W projektancie wykonaj następujące ogólne kroki, aby dodać akcję AS2 o nazwie Dekoduj komunikat AS2 do przepływu pracy.
Po wyświetleniu monitu o utworzenie połączenia z kontem integracji podaj następujące informacje:
Właściwość Wymagane Opis Nazwa połączenia Tak Nazwa połączenia Konto integracji Tak Z listy dostępnych kont integracji wybierz konto do użycia. Na przykład:
Gdy wszystko będzie gotowe, wybierz przycisk Utwórz.
W polu informacji o akcji podaj następujące informacje.
Właściwość Wymagane Opis Ciała Tak Ładunek komunikatu, na przykład dane wyjściowe Treść z wyzwalacza Żądanie.
1. Umieść kursor w polu treści , aby lista zawartości dynamicznej się otwierała.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy danych wyjściowych wybierz pozycję Treść.Nagłówki Tak Nagłówki komunikatu do dekodowania, na przykład dane wyjściowe Nagłówki z wyzwalacza Żądanie.
1. Umieść kursor w polu Nagłówki , aby lista zawartości dynamicznej się otwierała.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy danych wyjściowych wybierz pozycję Nagłówki.
Przykład
Aby spróbować wdrożyć w pełni działającą aplikację logiki i przykładowy scenariusz AS2 (wersja 2), zapoznaj się z szablonem i scenariuszem aplikacji logiki AS2 (wersja 2).
Rozwiązywanie problemów
Problemy podczas wysyłania podpisanych lub zaszyfrowanych wiadomości
Rozważ wypróbowanie różnych formatów algorytmów SHA256. Specyfikacja AS2 nie udostępnia żadnych informacji o formatach SHA256, więc każdy dostawca używa własnej implementacji lub formatu.