Omówienie uwierzytelniania zewnętrznego dostawcy tożsamości

Nowy interfejs Edge i interfejs Edge Management API działają, wysyłając żądania do serwera zarządzania Edge, który obsługuje te typy uwierzytelniania:

  • Uwierzytelnianie podstawowe: zaloguj się w nowym interfejsie Edge lub wysyłaj żądania do interfejsu Edge Management API, podając nazwę użytkownika i hasło.
  • OAuth2 / OIDC: wymień dane logowania podstawowego Edge na token dostępu OAuth2 i token odświeżania. Wywołuj interfejs Edge Management API, przekazując token dostępu OAuth2 w nagłówku Bearer wywołania API.

Edge obsługuje uwierzytelnianie za pomocą tych zewnętrznych dostawców tożsamości:

  • Security Assertion Markup Language (SAML) 2.0: generuj tokeny dostępu OAuth na podstawie asercji SAML zwracanych przez dostawcę tożsamości SAML.
  • Lightweight Directory Access Protocol (LDAP): używaj metod uwierzytelniania wyszukiwania i powiązania LDAP do generowania tokenów dostępu OAuth.

Dostawcy tożsamości SAML i LDAP obsługują środowisko logowania jednokrotnego. Używając zewnętrznego dostawcy tożsamości z Edge, możesz obsługiwać logowanie jednokrotne w nowym interfejsie Edge i interfejsie API, a także w innych usługach, które udostępniasz i które też obsługują zewnętrznego dostawcę tożsamości.

Informacje o nowej strukturze SSO w Apigee

Od wersji Edge dla chmury prywatnej 4.54.00 starszy komponent apigee-sso został zastąpiony nowoczesnym, lekkim brokerem tożsamości OpenID Connect (OIDC) o nazwie Dex. Ten adapter logowania jednokrotnego jest zintegrowany bezpośrednio z cyklem życia komponentu apigee-openldap, co eliminuje konieczność instalowania osobnego modułu apigee-sso.

Ponieważ SSO w Apigee (broker Dex) jest dołączone do apigee-openldap, jest ono wdrażane na tych samych węzłach co instancje OpenLDAP. Zarządzanie cyklem życia odbywa się natywnie za pomocą działań OPDK, takich jak apigee-service apigee-openldap start_sso i stop_sso.

Port 9099 musi być otwarty w węźle apigee-openldap, aby obsługiwać dostęp do logowania jednokrotnego Apigee z przeglądarki, zewnętrznego dostawcy tożsamości SAML lub LDAP oraz serwera zarządzania i nowego interfejsu Edge. W ramach konfigurowania logowania jednokrotnego Apigee możesz określić, czy połączenie zewnętrzne ma używać protokołu HTTP, czy szyfrowanego protokołu HTTPS protokołu.

SSO w Apigee to usługa bezstanowa, która używa bazy danych Postgres (apigee_dex) dostępnej na porcie 5432 w węźle Postgres, aby trwale przechowywać stan OAuth2 na wielu węzłach, zapewniając wysoką dostępność. Zwykle możesz używać tego samego serwera Postgres, który został zainstalowany z Edge – samodzielnego serwera Postgres lub 2 serwerów Postgres skonfigurowanych w trybie główny/rezerwowy. Jeśli obciążenie serwera Postgres jest duże, możesz też utworzyć osobny węzeł Postgres tylko na potrzeby bazy danych logowania jednokrotnego.

Obsługa standardowego protokołu OpenID Connect (OIDC)

Implementacja SAML i LDAP w Edge opiera się na standardowych tokenach dostępu OpenID Connect (OIDC) i OAuth2. Zmodernizowane SSO w Apigee wydaje tokeny zgodne z OIDC (wykorzystujące standardowe deklaracje, takie jak email i sub, a także nieprzezroczyste tokeny odświeżania). Więcej informacji znajdziesz w artykule Wprowadzenie do OAuth 2.0.

Informacje o SAML

Uwierzytelnianie SAML ma kilka zalet. Dzięki SAML możesz:

  • Przejąć pełną kontrolę nad zarządzaniem użytkownikami. Gdy użytkownicy opuszczają organizację i są centralnie usuwani, automatycznie odmawia się im dostępu do Edge.
  • Kontrolować sposób uwierzytelniania użytkowników w celu uzyskania dostępu do Edge. Możesz wybrać różne typy uwierzytelniania dla różnych organizacji Edge.
  • Kontrolować zasady uwierzytelniania. Dostawca SAML może obsługiwać zasady uwierzytelniania które są bardziej zgodne ze standardami Twojej firmy.
  • Możesz monitorować logowania, wylogowania, nieudane próby logowania i działania o wysokim ryzyku w wdrożeniu Edge.

Gdy SAML jest włączony, dostęp do nowego interfejsu Edge i interfejsu Edge Management API odbywa się za pomocą tokenów dostępu OAuth2. Te tokeny są generowane przez logowanie jednokrotne Apigee, które akceptuje asercje SAML zwracane przez dostawcę tożsamości.

Informacje o LDAP

Lightweight Directory Access Protocol (LDAP) to otwarty, standardowy protokół aplikacji do uzyskiwania dostępu do rozproszonych usług informacji o katalogach i zarządzania nimi. Usługi katalogowe mogą udostępniać dowolny uporządkowany zbiór rekordów, często o strukturze hierarchicznej, np. firmowy katalog e-maili.

Uwierzytelnianie LDAP w nowym SSO w Apigee korzysta z wbudowanego łącznika LDAP. Łącznik wykonuje wyszukiwania LDAP pod kątem organizationalRole i standardowych atrybutów (takich jak mail i uid), aby natywnie mapować starszych użytkowników Apigee na standardowe deklaracje OIDC.

LDAP z Edge for Private Cloud obsługuje standardowe metody uwierzytelniania wyszukiwania i powiązania na serwerze zgodnym z LDAP.

SSO w Apigee pobiera adres e-mail użytkownika i standardowe deklaracje OIDC (np. email, preferred_username, i groups) oraz aktualizuje wewnętrzny rekord użytkownika tak, aby zawierał aktualny adres e-mail, ponieważ Edge używa tego adresu do celów autoryzacji .

Adresy URL nowego interfejsu Edge i interfejsu API

Adres URL, którego używasz do uzyskiwania dostępu do nowego interfejsu Edge i interfejsu Edge Management API, jest taki sam jak przed włączeniem SAML lub LDAP. W przypadku nowego interfejsu Edge:

http://edge_UI_IP_DNS:3001

gdzie edge_UI_IP_DNS to adres IP lub nazwa DNS maszyny hostującej nowy interfejs Edge. W ramach konfigurowania nowego interfejsu Edge możesz określić, czy połączenie ma używać protokołu HTTP, czy szyfrowanego protokołu HTTPS.

W przypadku interfejsu Edge Management API:

http://ms_IP_DNS:8080/v1

gdzie ms_IP_DNS to adres IP lub nazwa DNS serwera zarządzania. W ramach konfigurowania interfejsu API możesz określić, czy połączenie ma używać protokołu HTTP, czy szyfrowanego protokołu HTTPS.

Konfigurowanie protokołu TLS za pomocą nowego SSO w Apigee

Domyślnie połączenie z SSO w Apigee używa protokołu HTTP na porcie 9099 w węźle hostującym apigee-openldap. Lekki broker tożsamości oparty na Go natywnie obsługuje żądania HTTP i HTTPS.

SSO w Apigee obsługuje 3 tryby połączenia:

  • DEFAULT: konfiguracja domyślna obsługuje żądania HTTP na porcie 9099.
  • SSL_TERMINATION: umożliwia dostęp TLS do SSO w Apigee na wybranym porcie. W tym trybie musisz określić klucz i certyfikat TLS.
  • SSL_PROXY: konfiguruje SSO w Apigee w trybie proxy, co oznacza, że przed komponentem zainstalowano system równoważenia obciążenia i zakończono protokół TLS w systemie równoważenia obciążenia. Możesz określić port używany w SSO w Apigee na potrzeby żądań z systemu równoważenia obciążenia.