Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Możesz skonfigurować przepływy współdzielone przez zestaw interfejsów API do wstępnego przetwarzania żądań lub ich późniejszego przetwarzania. Za pomocą punktu zaczepienia dołączasz udostępniony przepływ, aby działał w tym samym miejscu we wszystkich serwerach proxy API wdrożonych w konkretnym środowisku. W ten sposób uzyskasz oddzielnie zaimplementowaną i wdrożoną sekwencję logiki, która nie jest częścią kodu implementacji serwera proxy.
Kod podłączony do webhooka przepływu nie znajduje się w kontekście głównej logiki serwera proxy interfejsu API, dlatego niektóre jego działanie różni się od serwerów proxy interfejsu API. O czym musisz pamiętać:
- Musisz mieć uprawnienia, aby dołączyć udostępniony przepływ do punktu zaczepienia procesu. Musisz być administratorem organizacji.
- Do każdego punktu zaczepienia procesu możesz dołączyć tylko 1 udostępniony przepływ.
- Ten sam wspólny przepływ możesz dołączyć do wielu punktów zaczepienia przepływów.
- Jeśli wspólny przepływ podłączony do punktu zaczepienia przepływu spowoduje błąd lub wystąpią błędy podczas wykonywania przepływu współdzielonego, wiadomość zostanie odrzucona, a błąd zostanie wysłany z powrotem do elementu wywołującego.
- Jeśli wiadomość zostanie odrzucona podczas wykonywania webhooka przepływu, szczegóły zostaną zarejestrowane w Analytics w kontekście wywołanego serwera proxy. Przepływ udostępniony może też zwrócić błąd z niestandardowym kodem i komunikatem o błędzie
Poniższy film pokazuje, jak połączyć udostępniony przepływ z punktem zaczepienia przepływu, a następnie śledzić go w klasycznym interfejsie użytkownika Edge.
Poniższy film pokazuje, jak połączyć udostępniony przepływ z punktem zaczepienia przepływu, a następnie śledzić go w interfejsie nowego interfejsu Edge.
Współdzielony przepływ podłączony do serwera proxy przez punkt zaczepienia przepływu jest doskonałym miejscem dla logiki, która wymusza szerokie wymagania dotyczące zasad. Załóżmy na przykład, że masz jeden zespół, który zarządza jednym zestawem wymagań dotyczących zabezpieczeń dla wielu zespołów reprezentujących różne rodzaje działalności. Każdy zespół LOB może tworzyć interfejsy API zgodnie z własnymi wymaganiami bez konieczności brania pod uwagę bardziej ogólnych wymagań dotyczących bezpieczeństwa. Zespół ds. zabezpieczeń może wdrożyć te wymagania dotyczące zabezpieczeń w ramach współdzielonego procesu, a następnie dołączyć przepływ do środowiska Apigee Edge za pomocą webhooka przepływu. Ponieważ udostępniony przepływ nie jest częścią kodu serwera proxy, zespół ds. zabezpieczeń może go zmienić bez zakłócania działania kodu LOB.
Przepływy współdzielone dołączone przez punkty zaczepienia przepływu są wykonywane w tej pozycji w przypadku każdego serwera proxy interfejsu API wdrożonego w środowisku webhooka serwera proxy. Z tego powodu możliwość korzystania z punktów zaczepienia przepływów jest dostępna tylko dla administratorów organizacji Apigee Edge.
Więcej informacji o przepływach współdzielonych znajdziesz w artykule Przepływy współdzielone wielokrotnego użytku.
Przepływ udostępniony jest dołączany do punktu zaczepienia przepływu za pomocą konsoli zarządzania Apigee Edge. Do punktu zaczepienia przepływu możesz dołączyć maksymalnie 1 udostępniony przepływ w każdym z tych miejsc:
-
Pre-proxy przepływu na potrzeby logiki, która musi być egzekwowana PRZED uruchomieniem punktu końcowego serwera proxy.
Możesz na przykład mieć logikę egzekwującą bezpieczeństwo we wszystkich interfejsach API w środowisku.
-
Punkt początkowy przepływu wstępnego na potrzeby logiki, która musi być egzekwowana PRZED wywołaniem celu.
Możesz na przykład wdrożyć logowanie, zanim żądanie dotrze do backendu. Możesz też wymusić zapośredniczenie, usuwając z żądania określone pola.
-
Punkt zaczepienia przepływu pracy na potrzeby logiki, która musi być egzekwowana PO wykonaniu docelowej odpowiedzi.
To ustawienie będzie wymuszane od razu po otrzymaniu odpowiedzi z backendu. Możesz jej użyć do zarejestrowania odpowiedzi backendu lub przeprowadzenia zapośredniczenia, usuwając poufne pola z odpowiedzi backendu.
-
Punkt zaczepienia po serwerze proxy: logika, która musi być egzekwowana PO punkcie końcowym serwera proxy i tuż przed wysłaniem odpowiedzi do klienta.
Może to obejmować logikę wymuszania CORS, logowanie odpowiedzi oraz wykonywanie mashupów lub formatowania.
Dołączanie udostępnionego przepływu do punktu zaczepienia przepływu
Aby dołączyć przepływ udostępniony do punktu zaczepienia przepływu, musisz być administratorem w organizacji zawierającej ten przepływ.
- Otwórz stronę Punkty przepływu w sposób opisany poniżej.
Edge
Aby uzyskać dostęp do strony Punkty zaczepienia przy użyciu interfejsu Edge:
- Zaloguj się na stronie apigee.com/edge.
- Wybierz organizację zawierającą udostępniony przepływ. Zobacz Przechodzenie między organizacjami.
Przepływ wspólny będzie dostępny dla wszystkich serwerów proxy interfejsów API i przepływów wspólnych wdrożonych w środowisku z tej organizacji. Nie będzie dostępny spoza tej organizacji.
- Na pasku nawigacyjnym po lewej stronie kliknij Administracja > Środowiska > Punkty zaczepienia.
Klasyczna wersja Edge (Private Cloud)
Aby uzyskać dostęp do strony punkty zaczepienia w klasycznym interfejsie użytkownika Edge:
- Zaloguj się w
http://ms-ip:9000, gdzie ms-ip to adres IP lub nazwa DNS węzła serwera zarządzania. - Wybierz organizację zawierającą udostępniony przepływ. Zobacz Przechodzenie między organizacjami.
Przepływ wspólny będzie dostępny dla wszystkich serwerów proxy interfejsów API i przepływów współdzielonych wdrożonych w środowisku z tej organizacji. Nie będzie dostępny spoza tej organizacji.
- Na górnym pasku nawigacyjnym wybierz Interfejsy API > Konfiguracja środowiska > Punkty zaczepienia przepływu.
- Na liście punktów zaczepienia przepływów znajdź punkt zaczepienia przepływu, do którego chcesz dołączyć ten przepływ udostępniony w zależności od miejsca, w którym ma być wykonany.
Umiejscowienie haczyka przepływowego Opis Punkt zaczepienia przepływającego przed serwerem proxy PRZED uruchomieniem punktu końcowego serwera proxy Punkt zaczepienia etapu wstępnego PRZED uruchomieniem docelowego punktu końcowego Punkt zaczepienia punktu docelowego PO wykonaniu docelowej odpowiedzi Punkt zaczepienia przepływającego po serwerze proxy PO punkcie końcowym serwera proxy i tuż przed wysłaniem odpowiedzi do klienta - Aby wyświetlić kolumnę działań, ustaw kursor nad zaczepem przepływu na liście.
- Kliknij
. - W oknie Przepływ udostępniony wybierz w menu Przepływ udostępniony przepływ udostępniony, który chcesz dołączyć.
- Kliknij OK.
- W razie potrzeby dołącz przepływy współdzielone do innych punktów zaczepienia przepływu.