Dołączanie udostępnionego przepływu za pomocą punktu zaczepienia przepływu

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Możesz skonfigurować przepływy współdzielone tak, aby wykonywały wstępne przetwarzanie żądań lub przetwarzanie końcowe odpowiedzi w przypadku zestawu interfejsów API. Za pomocą punktu zaczepienia przepływu możesz podłączyć współdzielony przepływ, aby był on wykonywany w tym samym miejscu we wszystkich proxy interfejsów API wdrożonych w określonym środowisku. Dzięki temu uzyskasz oddzielnie zaimplementowaną i wdrożoną sekwencję logiki, która nie jest częścią kodu implementacji proxy.

Ponieważ kod dołączony do punktu zaczepienia przepływu znajduje się poza kontekstem podstawowej logiki proxy interfejsu API, niektóre jego zachowania różnią się od zachowań proxy interfejsów API. O czym musisz pamiętać:

• Musisz mieć uprawnienia do dołączania współdzielonego przepływu do punktu zaczepienia przepływu. Musisz być administratorem organizacji.
• Do każdego punktu zaczepienia przepływu możesz dołączyć tylko 1 przepływ współdzielony.
• Ten sam przepływ współdzielony możesz dołączyć do wielu punktów zaczepienia przepływu.
• Jeśli współdzielony przepływ dołączony do punktu zaczepienia przepływu zgłosi błąd lub wystąpią błędy podczas jego wykonywania, wiadomość zostanie odrzucona, a błąd zostanie odesłany do elementu wywołującego.
• Jeśli wiadomość zostanie odrzucona podczas wykonywania punktu zaczepienia przepływu, szczegóły zostaną zapisane w statystykach w kontekście wywołanego proxy. Współdzielony przepływ może też zgłosić błąd z niestandardowym kodem i komunikatem o błędzie.

Ten film pokazuje, jak połączyć współdzielony przepływ z punktem zaczepienia przepływu, a następnie go śledzić w klasycznym interfejsie Edge.

Ten film pokazuje, jak połączyć współdzielony przepływ z punktem zaczepienia przepływu, a następnie go śledzić, w nowym interfejsie Edge.

Współdzielony przepływ dołączony do proxy za pomocą punktu zaczepienia przepływu to doskonałe miejsce na logikę, która wymusza szerokie wymagania wynikające z zasad. Wyobraź sobie na przykład, że masz zespół, który zarządza jednym zestawem wymagań dotyczących bezpieczeństwa dla kilku zespołów reprezentujących różne linie biznesowe (LOBs). Każdy zespół linii biznesowej może tworzyć interfejsy API zgodnie z własnymi wymaganiami, bez konieczności uwzględniania szerszych wymagań dotyczących bezpieczeństwa. Zespół ds. bezpieczeństwa może zaimplementować te wymagania w przepływie współdzielonym, a następnie dołączyć go do środowiska Apigee Edge za pomocą punktu zaczepienia przepływu . Ponieważ współdzielony przepływ nie jest częścią kodu proxy, zespół ds. bezpieczeństwa może go w razie potrzeby modyfikować bez ingerowania w kod linii biznesowej.

Przepływy współdzielone dołączone za pomocą punktów zaczepienia przepływu są wykonywane w tym miejscu w przypadku każdego proxy interfejsu API wdrożonego w środowisku punktu zaczepienia proxy. Z tego powodu możliwość korzystania z punktów zaczepienia przepływu 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.

Współdzielony przepływ dołączasz do punktu zaczepienia przepływu za pomocą konsoli zarządzania Apigee Edge. Do punktu zaczepienia przepływu możesz dołączyć co najwyżej 1 współdzielony przepływ w każdym z tych miejsc:

• Punkt zaczepienia przepływu przed proxy dla logiki, która musi być wymuszana ZANIM zostanie wykonany punkt końcowy proxy wykonuje.

  Możesz na przykład mieć logikę wymuszającą bezpieczeństwo we wszystkich interfejsach API w środowisku.

• Punkt zaczepienia przepływu przed celem dla logiki, która musi być wymuszana ZANIM zostanie wywołany cel.

  Możesz na przykład zaimplementować logowanie, zanim żądanie dotrze do backendu. Możesz też wymusić mediację, usuwając niektóre pola z żądania.

• Punkt zaczepienia przepływu po celu dla logiki, która musi być wymuszana PO wykonaniu odpowiedzi celu wykonuje.

  Będzie to wymuszane zaraz po otrzymaniu odpowiedzi z backendu. Możesz go użyć do logowania odpowiedzi backendu lub do przeprowadzenia mediacji przez usunięcie poufnych pól z odpowiedzi backendu.

• Punkt zaczepienia przepływu po proxy dla logiki, która musi być wymuszana PO punkcie końcowym proxy i tuż przed wysłaniem odpowiedzi do klienta.

  Może to obejmować logikę wymuszania CORS, logowanie odpowiedzi lub wykonywanie mashupu albo formatowania.

Dołączanie współdzielonego przepływu do punktu zaczepienia przepływu

Aby dołączyć współdzielony przepływ do punktu zaczepienia przepływu, musisz być administratorem w organizacji zawierającej współdzielony przepływ.

1. Otwórz stronę Punkty zaczepienia przepływu, jak opisano poniżej.

   Edge

   Aby otworzyć stronę Punkty zaczepienia przepływu w interfejsie Edge:

   1. Zaloguj się na apigee.com/edge.
   2. Wybierz organizację zawierającą przepływ współdzielony. Zobacz Przełączanie się między organizacjami.

      Współdzielony przepływ będzie dostępny dla wszystkich proxy interfejsów API i współdzielonych przepływów wdrożonych w środowisku z tej organizacji. Nie będzie dostępny spoza tej organizacji.

   3. Na lewym pasku nawigacji kliknij Admin > Środowiska > Punkty zaczepienia przepływu.

   Klasyczny Edge (Private Cloud)

   Aby otworzyć stronę Punkty zaczepienia przepływu w klasycznym interfejsie Edge:

   1. Zaloguj się na http://ms-ip:9000, gdzie ms-ip to adres IP lub nazwa DNS węzła serwera zarządzania.
   2. Wybierz organizację zawierającą przepływ współdzielony. Zobacz Przełączanie się między organizacjami.

      Współdzielony przepływ będzie dostępny dla wszystkich proxy interfejsów API i współdzielonych przepływów wdrożonych w środowisku z tej organizacji. Nie będzie dostępny spoza tej organizacji.

   3. Na górnym pasku nawigacji kliknij Interfejsy API > Konfiguracja środowiska > Punkty zaczepienia przepływu.
2. Na liście punktów zaczepienia przepływu znajdź punkt zaczepienia przepływu, do którego chcesz dołączyć współdzielony przepływ na podstawie miejsca, w którym ma być wykonywany współdzielony przepływ.

   Lokalizacja punktu zaczepienia przepływu	Opis
   Punkt zaczepienia przepływu przed proxy	ZANIM zostanie wykonany punkt końcowy proxy
   Punkt zaczepienia przepływu przed celem	ZANIM zostanie wykonany punkt końcowy celu
   Punkt zaczepienia przepływu po celu	PO wykonaniu odpowiedzi celu
   Punkt zaczepienia przepływu po proxy	PO punkcie końcowym proxy i tuż przed wysłaniem odpowiedzi do klienta

3. Najedź kursorem na punkt zaczepienia przepływu na liście, aby wyświetlić kolumnę działań.
4. Kliknij .
5. W oknie Przepływ współdzielony wybierz współdzielony przepływ, który chcesz dołączyć, w menu Przepływ współdzielony.
6. Kliknij OK.
7. W razie potrzeby dołącz przepływy współdzielone do innych punktów zaczepienia przepływu.