Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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, użyj łącznika AS2 (wersja 2). Ten łącznik 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 funkcji śledzenia łącznik AS2 (wersja 2) zapewnia takie same możliwości jak oryginalny łącznik AS2. Łącznik AS2 (wersja 2) 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 opisanymi wymaganiami wstępnymi, połącz konto integracji z zasobem aplikacji logicznej, w którym planujesz używać łącznika.
W tym przewodniku pokazano, jak dodać akcje kodowania i dekodowania dla AS2 (wersja 2) i AS2 do istniejącego przepływu pracy aplikacji logicznej. Łącznik AS2 (wersja 2) nie udostępnia żadnych wyzwalaczy, więc możesz użyć dowolnego wyzwalacza, aby uruchomić przepływ 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 (v2) i standardowe łączniki AS2, które są wyświetlane w galerii łączników w obszarze Udostępnione. Łącznik AS2 ma jeden wyzwalacz i wiele akcji. Łącznik AS2 (wersja 2) udostępnia tylko akcje. Możesz użyć dowolnego wyzwalacza, który działa w danym scenariuszu. Aby uzyskać więcej informacji, zobacz: - Dokumentacja łącznika zarządzanego AS2 - Operacje łącznika zarządzanego as2 (wersja 2) - Limity komunikatów AS2 |
| Standardowa | Usługa Azure Logic Apps z jedną dzierżawą, środowisko App Service Environment w wersji 3 (tylko plany systemu Windows) i wdrożenie hybrydowe | Wbudowany łącznik AS2 (wersja 2), który jest wyświetlany w galerii łączników w obszarze Wbudowane i łącznik zarządzany AS2, który jest wyświetlany w galerii łączników w obszarze Udostępnione. Łącznik AS2 ma jeden wyzwalacz i wiele akcji. Łącznik AS2 (wersja 2) udostępnia tylko akcje. Możesz użyć dowolnego wyzwalacza, który działa w danym scenariuszu. Wbudowana wersja różni się w następujący sposób: — Wbudowana wersja może uzyskiwać bezpośredni dostęp do sieci wirtualnych platformy Azure. Nie potrzebujesz lokalnej bramy danych. Aby uzyskać więcej informacji, zobacz: - 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 | Zapewnia odszyfrowywanie, podpisywanie cyfrowe i potwierdzenia odbioru za pośrednictwem powiadomień o stanie wiadomości (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.
Przed rozpoczęciem pracy z AS2 (wersja 2) lub operacjami AS2, musisz połączyć aplikację logiczną Consumption lub połączyć aplikację logiczną Standard z kontem integracyjnym. Podczas dodawania operacji AS2 (wersja 2) lub AS2 może być również konieczne utworzenie połączenia z kontem integracji:
Przepływ pracy aplikacji logiki Link jest wymagany? Zużycie - Łącznik AS2 (wersja 2): Nie jest wymagane połączenie
- Łącznik AS2: Wymagane połączenieStandard - Łącznik AS2 (wersja 2): Nie jest wymagane połączenie
- Łącznik AS2: Wymagane połączenieJeś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 zasób magazynu kluczy. Na pasku bocznym zasobu w obszarze Obiekty wybierz pozycję Klucze.
Na stronie Klucze wybierz klucz. Na stronie Wersje wybierz używaną wersję klucza.
Na stronie Wersja klucza w obszarze Dozwolone operacje upewnij się, że wybrano opcję Szyfruj i Odszyfruj .
Kodowanie komunikatów AS2
Aby zakodować komunikaty za pomocą łącznika AS2 (wersja 2) lub łącznika AS2, wykonaj odpowiednie kroki.
Łącznik AS2 w wersji 2
Aby zakodować komunikaty za pomocą łącznika AS2 (wersja 2), wykonaj następujące kroki:
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ć do przepływu pracy akcję AS2 (wersja 2) o nazwie AS2 Koduj.
W okienku informacji o akcji podaj następujące informacje:
Parameter Wymagania opis Komunikat do kodowania Tak Ładunek komunikatu do kodowania, na przykład dane wyjściowe Treść z wyzwalacza Żądanie.
1. Wybierz w polu Komunikat, aby zakodować, a następnie wybierz ikonę pioruna, aby otworzyć listę dynamicznej zawartości.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy 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. Na przykład ładunek komunikatu to dane wyjściowe zawartości Treść z wyzwalacza Żądanie:
Łącznik AS2
Aby zakodować komunikaty za pomocą łącznika AS2, wykonaj następujące kroki:
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:
Parameter Wymagania opis Nazwa połączenia Tak Nazwa połączenia. Identyfikator konta integracji Tak Nazwa konta integracji. Adres URL sygnatury dostępu współdzielonego konta integracji Tak Adres URL wywołania zwrotnego dla konta integracji. Na przykład:
Po zakończeniu wybierz pozycję Utwórz nową.
W okienku informacji o akcji podaj następujące informacje.
Parameter 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. Wybierz wewnątrz pola treści , a następnie wybierz ikonę błyskawicy, aby otworzyć listę zawartości dynamicznej.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy wybierz pozycję Treść.
Dekodowanie komunikatów AS2
Aby zdekodować komunikaty za pomocą łącznika AS2 (wersja 2) lub łącznika AS2, wykonaj odpowiednie kroki.
Łącznik AS2 w wersji 2
Aby zdekodować komunikaty za pomocą łącznika AS2 (wersja 2), wykonaj następujące kroki:
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ć do przepływu pracy akcję AS2 (v2) nazwaną AS2 Decode.
W okienku informacji o akcji podaj następujące informacje:
Parameter Wymagania opis Komunikat do dekodowania Tak Ładunek komunikatu do dekodowania, na przykład dane wyjściowe Treść z wyzwalacza Żądanie.
1. Wybierz wewnątrz pola Komunikat do dekodowania, a następnie wybierz ikonę pioruna, aby otworzyć listę zawartości dynamicznej.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy wybierz pozycję Treść.Nagłówki komunikatów Tak Nagłówki komunikatu do dekodowania, na przykład dane wyjściowe Nagłówki z wyzwalacza Żądanie.
1. Wybierz wewnątrz pola Nagłówki wiadomości , a następnie wybierz ikonę funkcji, aby otworzyć edytor wyrażeń.
2. W polu edytora wprowadź następujące wyrażenie:triggerOutputs()?['headers']
3. Po zakończeniu wybierz pozycję Dodaj.Na przykład:
Łącznik AS2
Aby zdekodować komunikaty za pomocą łącznika AS2, wykonaj następujące kroki:
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ć do przepływu pracy akcję AS2 o nazwie Dekoduj komunikat AS2.
Po wyświetleniu monitu o utworzenie połączenia z kontem integracji podaj następujące informacje:
Parameter Wymagania opis Nazwa połączenia Tak Nazwa połączenia. Identyfikator konta integracji Tak Identyfikator zasobu dla konta integracji, który ma następujący format: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name>
Przykład:/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount
Aby znaleźć ten identyfikator zasobu, wykonaj następujące kroki:
1. W witrynie Azure Portal otwórz konto integracji.
2. Na pasku bocznym konta integracji wybierz pozycję Przegląd.
3. Na stronie Przegląd wybierz pozycję Widok JSON.
4. Z właściwości Identyfikator zasobu skopiuj wartość.Adres URL sygnatury dostępu współdzielonego konta integracji Tak Adres URL punktu końcowego żądania używający uwierzytelniania sygnatury dostępu współdzielonego (SAS) w celu zapewnienia dostępu do konta integracji. Ten adres URL wywołania zwrotnego ma następujący format: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature>
Przykład: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
Aby znaleźć ten adres URL, wykonaj następujące kroki:
1. W witrynie Azure Portal otwórz konto integracji.
2. Na pasku bocznym konta integracji w obszarze Ustawienia wybierz pozycję Adres URL wywołania zwrotnego.
3. Z właściwości Generated Callback URL (Wygenerowany adres URL wywołania zwrotnego) skopiuj wartość .Na przykład:
Po zakończeniu wybierz pozycję Utwórz nową.
W okienku informacji o akcji podaj następujące wartości:
Parameter Wymagania opis treść Tak Ładunek komunikatu , na przykład dane wyjściowe Treść z wyzwalacza Żądanie.
1. Wybierz wewnątrz pola ciało, a następnie wybierz ikonę błyskawicy, aby otworzyć listę zawartości dynamicznej.
2. Obok nazwy sekcji Po odebraniu żądania HTTP wybierz pozycję Zobacz więcej.
3. Z listy wybierz pozycję Treść.Nagłówki Tak Nagłówki komunikatu do dekodowania, na przykład dane wyjściowe Nagłówki z wyzwalacza Żądanie.
1. Zaznacz w polu Nagłówki, a następnie wybierz ikonę funkcji, aby otworzyć edytor wyrażeń.
2. W polu edytora wprowadź następujące wyrażenie:triggerOutputs()?['headers']
3. Po zakończeniu wybierz pozycję Dodaj.Na przykład:
Przykład
Aby wdrożyć w pełni funkcjonalny przepływ pracy aplikacji logiki i przykładowy scenariusz AS2 (wersja 2), zobacz szablon i scenariusz 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.