Komunikacja między portalem opartym na Drupal a Edge

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

Portal Usług dla deweloperów działa jako klient Apigee Edge. Oznacza to, że portal nie działa jako samodzielny system. Większość informacji używanych przez portal jest przechowywana w Edge. W razie potrzeby portal wysyła żądanie HTTP lub HTTPS, aby pobrać informacje z Edge lub wysłać je do Edge.

Edge nie wysyła żądań do portalu, tylko odpowiada na żądania wysyłane z portalu. Dlatego wszystkie interakcje między portalem a Edge są inicjowane przez portal.

Konfigurowanie połączenia między portalem a Edge

Portal musi przesyłać do Edge 3 rodzaje informacji, jak opisano poniżej.

  • URL punktu końcowego usługi Edge

    Domyślny punkt końcowy w wersji Edge w chmurze to https://api.enterprise.apigee.com/v1.

    W przypadku instalacji Private Cloud adres URL ma postać: http://EdgePrivateCloudIp:8080/v1lub https://EdgePrivateCloudIp:TLSport/v1.

    Gdzie EdgePrivateCloudIp to adres IP serwera Edge Management Server, a TLSport to port TLS/SSL interfejsu Edge Management API. Na przykład 8443.
  • Nazwa organizacji w Apigee

    To jest nazwa Twojej organizacji w Edge. Organizację konfigurujesz podczas tworzenia konta w Edge.
  • Nazwa użytkownika i hasło administratora

    Wywołania z portalu do Edge są uwierzytelniane i wymagają użytkownika z uprawnieniami Administratora dewelopera. Gdy zarezerwujemy dla Ciebie Portal deweloperów, do Twojej organizacji zostanie dodana rola Administrator dewelopera. Ta rola, która obejmuje jednego użytkownika o nazwie devadmin+{org_name}@apigee.com, służy wyłącznie do łączenia Portalu dewelopera z organizacją Edge. Ponieważ portal wyświetla aplikacje dla deweloperów Edge, usługi API itp., musi być zsynchronizowany z organizacją Edge, wykonując wywołania interfejsu API do zarządzania, które wymagają uwierzytelnienia. Użytkownik „devadmin” ma niezbędne uprawnienia.

Aby wyświetlić informacje o połączeniu:

  1. W menu administracyjnym Drupala kliknij Konfiguracja > Portal deweloperski > Ustawienia aplikacji.

Aby zmienić konfigurację:

Sposób zmiany konfiguracji zależy od instalacji i wersji portalu:

  • Instalacja w chmurze portalu w wersji 15.01.06 lub nowszej: aby zmienić informacje o połączeniu, musisz przesłać prośbę do zespołu pomocy Apigee Edge. Na przykład, jeśli chcesz zmienić nazwę organizacji.
  • Instalacja lokalna i portal w chmurze w wersji wcześniejszej niż 15.01.06: zmień informacje o połączeniu w opisany niżej sposób:
  1. W menu administracyjnym Drupala kliknij Konfiguracja > Portal deweloperów Ustawienia.
  2. W polu Organizacja w Management API wpisz nazwę organizacji.
  3. W polu Adres URL punktu końcowego interfejsu Management API wpisz adres URL punktu końcowego Edge.
  4. Wpisz dane logowania administratora organizacji w polu Użytkownik uwierzytelniony przez punkt końcowy i Hasło użytkownika uwierzytelnionego.
  5. Aby sprawdzić, czy połączenie zostało nawiązane, kliknij Testuj połączenie.
  6. Kliknij Zapisz konfigurację.

Zapewnienie dostępu do Edge z poziomu portalu

Wiele informacji używanych przez portal jest przechowywanych w Edge, dlatego musisz się upewnić, że portal ma dostęp do Edge. Portal inicjuje komunikację z Edge, wysyłając żądania REST przez HTTP i HTTPS. Gdy na przykład deweloper rejestruje nową aplikację na portalu, ten wysyła do przeglądarki Edge prośbę o przesłanie informacji o aplikacji.

Edge i portal mogą być wdrażane w chmurze lub lokalnie, a także możesz łączyć różne typy wdrożeń. Możesz na przykład wdrożyć oba rozwiązania w chmurze, oba w lokalizacji lub jedno w chmurze, a drugie w lokalizacji:

  • Jeśli zarówno portal, jak i Edge są wdrażane przez Apigee w chmurze, nie powinno być problemów z wysyłaniem żądań z portalu do Edge.
  • Jeśli wdrożysz portal w środowisku lokalnym, musisz się upewnić, że portal może wysyłać żądania do Edge niezależnie od tego, czy Edge jest wdrożony w chmurze czy w środowisku lokalnym.
  • Jeśli wdrażasz Edge na miejscu, musisz się upewnić, że portal ma dostęp do Edge. Oznacza to, że serwer Edge musi akceptować żądania z portalu niezależnie od tego, czy portal jest wdrożony w chmurze, czy na miejscu.

Film: obejrzyj krótki film, aby dowiedzieć się więcej o tym, jak portal dla deweloperów komunikuje się z Apigee Edge, i sprawdzić, czy połączenie działa.

Zarządzanie aplikacjami i kluczami interfejsu API w portalu

Gdy deweloper zakończy proces rejestracji aplikacji na portalu, portal prześle Edge informacje o aplikacji, w tym jej nazwę i powiązane z nią produkty interfejsu API.

Jeśli Edge zarejestruje aplikację, zwróci do portalu 1 klucz API. Następnie programista używa tego klucza API, aby uzyskać dostęp do usług API powiązanych z aplikacją.

Na portalu nie są przechowywane żadne informacje o aplikacjach i kluczach API. Zamiast tego wszystkie te informacje są przechowywane w Edge. Dlatego za każdym razem, gdy deweloper korzysta z portalu, aby wyświetlić informacje o aplikacji, portal wysyła żądanie do Edge w celu uzyskania dostępu do tych informacji. Za każdym razem, gdy deweloper zmodyfikuje aplikację, portal automatycznie prześle te zmiany do przeglądarki Edge.

Na przykład deweloper loguje się w portalu i przechodzi na stronę Moje aplikacje. Aby wypełnić stronę Moje aplikacje, portal wysyła żądanie do Edge w celu pobrania informacji o aplikacjach i kluczach API dewelopera. Te informacje są później widoczne na stronie Moje aplikacje w portalu:

Jeśli deweloper doda, usunie lub zmodyfikuje aplikację, portal prześle te zmiany do przeglądarki Edge.

Wszystkie informacje o aplikacjach i kluczach interfejsu API są przechowywane w Edge, dlatego administrator Edge może manipulować tymi informacjami za pomocą interfejsu Edge. Na przykład administrator może:

  • Dodawanie, usuwanie i modyfikowanie aplikacji dewelopera
  • Odwoływanie lub zatwierdzanie klucza interfejsu API aplikacji

Poniżej widzisz tę samą aplikację „Moja aplikacja pogodowa” w interfejsie Edge dla administratora:

Zarządzanie deweloperami w portalu

Gdy deweloper rejestruje się jako nowy użytkownik portalu, konto dewelopera jest tworzone w Edge i na portalu. Dlatego w odróżnieniu od aplikacji i kluczy interfejsu API informacje o deweloperach są przechowywane zarówno w Edge, jak i na portalu.

Informacje o deweloperze przechowywane w Edge obejmują:

  • Imię
  • Nazwisko
  • Adres e-mail
  • Opcjonalne dodatkowe informacje wysłane z portalu

Portal przechowuje te same informacje co Edge, ale także dodatkowe dane, w tym:

  • Hasło do portalu
  • Stan konta w portalu: aktywne lub zablokowane
  • Rola w portalu: uwierzytelniony użytkownik, administrator, inna
  • Uprawnienia oparte na roli: określają działania, które deweloper może wykonywać w portalu.

Gdy deweloper loguje się w portalu, to właśnie portal odpowiada za uwierzytelnianie dewelopera i za stosowanie uprawnień opartych na roli.

Portal przechowuje wszystkie informacje o deweloperze, dlatego jest on systemem rejestrowania informacji o deweloperach, a nie Edge. Gdy deweloper zmodyfikuje swoje informacje na portalu, są one przechowywane na portalu i w stosownych przypadkach wysyłane do Edge. Jeśli na przykład deweloper zmieni swoje imię, te informacje zostaną wysłane do przeglądarki Edge. Jeśli jednak deweloper zmieni hasło, te informacje zostaną zapisane tylko lokalnie na portalu.

Więcej informacji znajdziesz w artykule Dodawanie kont użytkowników i zarządzanie nimi.

Synchronizacja deweloperów aplikacji między portalem a Edge

Edge nie inicjuje komunikacji z portalem. Jeśli jako administrator Edge zmienisz informacje o deweloperze w interfejsie Edge, nie ma gwarancji, że te informacje zostaną przesłane do portalu. Dlatego do tworzenia, modyfikowania i usuwania deweloperów, a nie Edge, używaj funkcji administracyjnych w portalu.

Administrator portalu może wymusić synchronizację portalu z Edge, aby pobrać informacje z Edge do portalu. Jeśli jednak modyfikujesz deweloperów tylko na portalu, a nie w Edge, nie musisz nigdy wykonywać tej synchronizacji. Dodatkowo Edge nie pozwala na ustawienie hasła podczas tworzenia programisty, więc hasło do portalu każdego programisty utworzonego w Edge ma ustawioną losową wartość. Dlatego zanim deweloper zaloguje się w portalu, musi przejść proces odzyskiwania hasła.

Aby zsynchronizować portal z deweloperami aplikacji w Edge:

:
  • Zaloguj się w portalu jako użytkownik z uprawnieniami administratora lub tworzenia treści.
  • W menu administracyjnym Drupala kliknij Osoby.
  • Aby zsynchronizować się z deweloperami aplikacji w Edge, u góry strony kliknij przycisk Synchronizacja dla deweloperów na portalu dla deweloperów.