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 obsługujące komunikację AS2 i zarządzać 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 komunikatów, przepływności i opóźnień. 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 połączenie konta 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żna użyć dowolnego wyzwalacza do uruchomienia przepływu pracy. Przykłady w tym przewodniku korzystają z 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 | Wielodostępna usługa Azure Logic Apps | Łą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 w danym scenariuszu. 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 AS2 |
| Standardowa | Usługa Azure Logic Apps i środowisko App Service Environment w wersji 3 z jedną dzierżawą (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żna 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) - Limity komunikatów AS2 |
Operacje AS2 (wersja 2)
Łącznik AS2 (wersja 2) nie ma wyzwalaczy. W poniższej tabeli opisano akcje, które łącznik AS2 (wersja 2) zapewnia do ustanawiania 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 nieuporządkowania. Na przykład ta akcja stosuje nagłówki AS2/HTTP i wykonuje następujące zadania podczas konfigurowania: - Podpisywanie wiadomości wychodzących. - Szyfruj komunikaty wychodzące. - Kompresuj komunikat. - Przesyłaj nazwę pliku w nagłówku MIME. |
| Akcja dekodowania AS2 | Zapewnianie odszyfrowywania, podpisywania cyfrowego i potwierdzania za pośrednictwem 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 bez dokumentacji. - Zapisuj rekordy dla raportowania stanu AS2. - Zawartość ładunku wyjściowego jako zakodowana w formacie base64. - Określ, czy są wymagane sieci 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. — Ustaw tokeny korelacji i właściwości w sieciACH MDN. — Sprawdź podpis. - Odszyfruj komunikaty. - Dekompresuj komunikat. — Sprawdź i nie zezwalaj na duplikaty identyfikatorów komunikatów. |
Wymagania wstępne
Konto i subskrypcja platformy Azure. Jeśli nie masz jeszcze subskrypcji, utwórz bezpłatne konto platformy Azure.
Zasób aplikacji logiki i przepływ pracy, 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 dla obu partnerów muszą używać tego samego kwalifikatora tożsamości biznesowej, który jest as2Identity w tym scenariuszu.
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, które mają być używane 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 Link jest wymagany? Zużycie - Łącznik AS2 (wersja 2): Połączenie jest wymagane, ale nie jest wymagane żadne łącze
- Łącznik AS2 : łącze jest wymagane, ale nie jest wymagane żadne połączenieStandardowa - Łącznik AS2 (wersja 2): Łącze jest wymagane, ale nie jest wymagane żadne połączenie
- Łącznik AS2 : połączenie jest wymagane, 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 witrynie Azure Portal otwórz magazyn kluczy. W menu magazynu kluczy w obszarze Ustawienia wybierz pozycję Klucze.
W okienku Klucze wybierz 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ływy pracy aplikacji logiki Zużycie lub Standardowa:
Łącznik AS2 w wersji 2
W witrynie 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ści Wymagania opis Komunikat do kodowania Tak Ładunek komunikatu , na przykład dane wyjściowe Treść z 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 z Tak Identyfikator biznesowy nadawcy komunikatów określony w umowie AS2, na przykład Fabrikam. AS2 do Tak Identyfikator biznesowy odbiorcy komunikatów określony w umowie AS2, na przykład Contoso. 
Łącznik AS2
W witrynie 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ści Wymagania 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:
Po zakończeniu wybierz Utwórz.
W polu informacji o akcji podaj następujące informacje.
Właściwości Wymagania opis AS2-From Tak Identyfikator biznesowy nadawcy komunikatów określony w umowie AS2, na przykład Fabrikam. AS2-To Tak Identyfikator biznesowy odbiorcy komunikatów określony w umowie AS2, na przykład Contoso. treść Tak Ładunek komunikatu do kodowania, 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ść.
Dekodowanie komunikatów AS2
Wybierz kartę Przepływy pracy aplikacji logiki Zużycie lub Standardowa:
Łącznik AS2 w wersji 2
W witrynie 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ści Wymagania opis treść Tak Treść komunikatu do dekodowania, 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.Na przykład:
Łącznik AS2
W witrynie 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ści Wymagania 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:
Po zakończeniu wybierz Utwórz.
W polu informacji o akcji podaj następujące informacje.
Właściwości Wymagania opis treść 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 operacyjną 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.