Instalowanie Edge SSO dla wysokiej dostępności

Edge dla chmury prywatnej w wersji 4.17.09

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.
  • Przed 2 instancjami Edge SSO musisz mieć system 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

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

      W przypadku 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.

Korzystanie z dostępu 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żywanie trybu HTTP do łączenia się z logowaniem jednokrotnym Edge
  • Nasłuchiwanie na tym samym porcie co Edge SSO

    Domyślnie 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 do zmiany domyślnego portu logowania jednokrotnego Edge użyto SSO_TOMCAT_PORT, 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

Korzystanie z dostępu HTTPS do logowania jednokrotnego w 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

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

  • Do łączenia się z Edge SSO używaj 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

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 te elementy 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:

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