Zainstaluj logowanie jednokrotne Edge dla wysokiej dostępności

Edge dla chmury prywatnej w wersji 4.19.01

W celu zapewnienia wysokiej dostępności możesz zainstalować wiele instancji Edge SSO w 2 scenariuszach:

  • W środowisku z jednym centrum danych zainstaluj 2 instancje Edge SSO, aby utworzyć środowisko o wysokiej dostępności, co oznacza, że system będzie nadal działać, jeśli jeden z modułów Edge SSO ulegnie awarii.
  • W środowisku z 2 centrami danych zainstaluj Edge SSO w obu centrach danych, aby system działał dalej, jeśli jeden z modułów Edge SSO przestanie działać.

Instalowanie 2 modułów Edge SSO w tym samym centrum danych

Wdrażasz 2 instancje logowania jednokrotnego Edge na różnych węzłach w jednym centrum danych, aby zapewnić wysoką dostępność. W tym scenariuszu:

  • Obie instancje Edge SSO muszą być połączone z tym samym serwerem Postgres. Apigee zaleca używanie dedykowanego serwera Postgres na potrzeby Edge SSO, a nie tego samego serwera Postgres, który został zainstalowany z Edge.
  • Obie instancje logowania jednokrotnego Edge muszą używać tej samej pary kluczy JWT określonej przez właściwości SSO_JWT_SIGNING_KEY_FILEPATH i SSO_JWT_VERIFICATION_KEY_FILEPATH w pliku konfiguracji. Więcej informacji o ustawianiu tych właściwości znajdziesz w artykule Instalowanie i konfigurowanie logowania jednokrotnego Edge.
  • Przed 2 instancjami Edge SSO potrzebujesz systemu równoważenia obciążenia:
    • System równoważenia obciążenia musi obsługiwać trwałość plików cookie generowanych przez aplikację, a plik cookie sesji musi mieć nazwę JSESSIONID.
    • Skonfiguruj system równoważenia obciążenia, aby przeprowadzał kontrolę stanu TCP lub HTTP w Edge SSO. W przypadku TCP użyj adresu URL logowania jednokrotnego Edge:
      http_or_https://edge_sso_IP_DNS:9099

      Podaj port ustawiony przez logowanie jednokrotne Edge. Domyślny port to 9099.

      W przypadku protokołu HTTP dodaj /healthz:

      http_or_https://edge_sso_IP_DNS:9099/healthz
    • Niektóre ustawienia systemu równoważenia obciążenia zależą od tego, czy włączono HTTPS w Edge SSO. Więcej informacji znajdziesz w sekcjach poniżej.

Dostęp HTTP do logowania jednokrotnego Edge

Jeśli używasz dostępu HTTP do logowania jednokrotnego Edge, skonfiguruj system równoważenia obciążenia, aby:

  • Użyj trybu HTTP, aby połączyć się z logowaniem jednokrotnym Edge.
  • Nasłuchuj na tym samym porcie co Edge SSO.

    Domyślnie usługa Edge SSO nasłuchuje żądań HTTP na porcie 9099. Opcjonalnie możesz użyć SSO_TOMCAT_PORT, aby ustawić port logowania jednokrotnego Edge. Jeśli użyto SSO_TOMCAT_PORT do zmiany domyślnego portu logowania jednokrotnego Edge, upewnij się, że system równoważenia obciążenia nasłuchuje na tym porcie.

Na przykład w każdej instancji logowania jednokrotnego Edge ustawiasz port na 9033, dodając do pliku konfiguracji ten wpis:

SSO_TOMCAT_PORT=9033

Następnie skonfiguruj system równoważenia obciążenia, aby nasłuchiwał na porcie 9033 i przekazywał żądania do instancji Edge SSO na porcie 9033. W tym scenariuszu publiczny adres URL logowania jednokrotnego Edge to:

http://LB_DNS_NAME:9033

Dostęp HTTPS do logowania jednokrotnego Edge

Możesz skonfigurować instancje Edge SSO tak, aby używały protokołu HTTPS. W tym scenariuszu wykonaj czynności opisane w artykule Konfigurowanie apigee-sso na potrzeby dostępu przez HTTPS. W ramach procesu włączania HTTPS ustaw SSO_TOMCAT_PROFILE w pliku konfiguracji logowania jednokrotnego Edge, jak pokazano poniżej:

SSO_TOMCAT_PROFILE=SSL_TERMINATION

Możesz też opcjonalnie ustawić port używany przez Edge SSO na potrzeby dostępu HTTPS:

SSO_TOMCAT_PORT=9443

Następnie skonfiguruj system równoważenia obciążenia, aby:

  • Aby połączyć się z Edge SSO, użyj trybu TCP, a nie HTTP.
  • Nasłuchuj na tym samym porcie co logowanie jednokrotne Edge, zgodnie z definicją SSO_TOMCAT_PORT.

Następnie skonfigurujesz system równoważenia obciążenia, aby przekierowywał żądania do instancji Edge SSO na porcie 9433. W tym scenariuszu publiczny adres URL logowania jednokrotnego Edge to:

https://LB_DNS_NAME:9443

Instalowanie logowania jednokrotnego Edge w wielu centrach danych

W środowisku z wieloma centrami danych instalujesz instancję Edge SSO w każdym centrum danych. Jedna instancja Edge SSO obsługuje wtedy cały ruch. Jeśli ta instancja Edge SSO przestanie działać, możesz przełączyć się na drugą instancję Edge SSO.

Zanim zainstalujesz logowanie jednokrotne Edge w 2 centrach danych, musisz mieć:

  • Adres IP lub nazwa domeny głównego serwera Postgres.

    W środowisku z wieloma centrami danych zwykle instaluje się po jednym serwerze Postgres w każdym centrum danych i konfiguruje się je w trybie replikacji Master-Standby. W tym przykładzie centrum danych 1 zawiera główny serwer Postgres, a centrum danych 2 zawiera serwer rezerwowy. Więcej informacji znajdziesz w artykule Konfigurowanie replikacji master-standby w Postgres.

  • Pojedynczy wpis DNS wskazujący jedną instancję logowania jednokrotnego Edge. Możesz na przykład utworzyć wpis DNS w poniższym formacie, który wskazuje instancję logowania jednokrotnego Edge w centrum danych 1:
    my-sso.domain.com => apigee-sso-dc1-ip-or-lb
  • Obie instancje logowania jednokrotnego Edge muszą używać tej samej pary kluczy JWT określonej przez właściwości SSO_JWT_SIGNING_KEY_FILEPATH i SSO_JWT_VERIFICATION_KEY_FILEPATH w pliku konfiguracji. Więcej informacji o ustawianiu tych właściwości znajdziesz w artykule Instalowanie i konfigurowanie logowania jednokrotnego Edge.

Podczas instalowania Edge SSO w każdym centrum danych skonfiguruj oba centra danych tak, aby korzystały z bazy danych Postgres Master w centrum danych 1:

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

Skonfigurujesz też oba centra danych tak, aby używały wpisu DNS jako publicznie dostępnego adresu URL:

# Externally accessible URL of Edge SSO
SSO_PUBLIC_URL_HOSTNAME=my-sso.domain.com
# Default port is 9099.
SSO_PUBLIC_URL_PORT=9099

Jeśli usługa Edge SSO w centrum danych 1 przestanie działać, możesz przełączyć się na instancję Edge SSO w centrum danych 2:

  1. Przekształć serwer Postgres Standby w centrum danych 2 w serwer główny zgodnie z opisem w artykule Obsługa przełączania awaryjnego bazy danych PostgreSQL.
  2. Zaktualizuj rekord DNS, aby wskazywał my-sso.domain.com na instancję Edge SSO w centrum danych 2:
    my-sso.domain.com => apigee-sso-dc2-ip-or-lb
  3. Zaktualizuj plik konfiguracji logowania jednokrotnego Edge w centrum danych 2, aby wskazywał nowy serwer Postgres Master w centrum danych 2:
    ## Postgres configuration
    PG_HOST=IP_or_DNS_of_PG_Master_in_DC2
  4. Uruchom ponownie logowanie jednokrotne Edge w centrum danych 2, aby zaktualizować jego konfigurację:
    /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart