Installa SSO SSO per un'alta disponibilità

Edge for Private Cloud v4.19.01

Puoi installare più istanze di Edge SSO per l'alta affidabilità in due scenari:

  • In un ambiente con un singolo data center, installa due istanze Edge SSO per creare un ambiente ad alta affidabilità, il che significa che il sistema continua a funzionare se uno dei moduli Edge SSO non è disponibile.
  • In un ambiente con due data center, installa Edge SSO in entrambi i data center in modo che il sistema continui a funzionare se uno dei moduli Edge SSO non è disponibile.

Installa due moduli Edge SSO nello stesso data center

Esegui il deployment di due istanze di Edge SSO, su nodi diversi, in un unico data center per supportare l'alta affidabilità. In questo caso:

  • Entrambe le istanze di Edge SSO devono essere connesse allo stesso server Postgres. Apigee consiglia di utilizzare un server Postgres dedicato per Edge SSO e non lo stesso server Postgres che hai installato con Edge.
  • Entrambe le istanze di Edge SSO devono utilizzare la stessa coppia di chiavi JWT specificata dalle proprietà SSO_JWT_SIGNING_KEY_FILEPATH e SSO_JWT_VERIFICATION_KEY_FILEPATH nel file di configurazione. Per saperne di più sull'impostazione di queste proprietà, consulta Installa e configura Edge SSO.
  • È necessario un bilanciatore del carico davanti alle due istanze di Edge SSO:
    • Il bilanciatore del carico deve supportare la persistenza dei cookie generati dall'applicazione e il cookie di sessione deve essere denominato JSESSIONID.
    • Configura il bilanciatore del carico in modo che esegua un controllo di integrità TCP o HTTP su Edge SSO. Per TCP, utilizza l'URL di Edge SSO:
      http_or_https://edge_sso_IP_DNS:9099

      Specifica la porta impostata da Edge SSO. La porta 9099 è quella predefinita.

      Per HTTP, includi /healthz:

      http_or_https://edge_sso_IP_DNS:9099/healthz
    • Alcune impostazioni del bilanciatore del carico dipendono dall'attivazione o meno di HTTPS su Edge SSO. Per ulteriori informazioni, consulta le sezioni seguenti.

Accesso HTTP a Edge SSO

Se utilizzi l'accesso HTTP a Edge SSO, configura il bilanciatore del carico in modo da:

  • Utilizza la modalità HTTP per connetterti a Edge SSO.
  • Ascolta sulla stessa porta di Edge SSO.

    Per impostazione predefinita, Edge SSO rimane in ascolto delle richieste HTTP sulla porta 9099. Facoltativamente, puoi utilizzare SSO_TOMCAT_PORT per impostare la porta SSO di Edge. Se hai utilizzato SSO_TOMCAT_PORT per modificare la porta SSO Edge rispetto a quella predefinita, assicurati che il bilanciatore del carico sia in ascolto su quella porta.

Ad esempio, su ogni istanza Edge SSO imposta la porta su 9033 aggiungendo quanto segue al file di configurazione:

SSO_TOMCAT_PORT=9033

Quindi, configura il bilanciatore del carico in modo che rimanga in ascolto sulla porta 9033 e inoltri le richieste a un'istanza Edge SSO sulla porta 9033. L'URL pubblico di Edge SSO in questo scenario è:

http://LB_DNS_NAME:9033

Accesso HTTPS a Edge SSO

Puoi configurare le istanze Edge SSO in modo che utilizzino HTTPS. In questo scenario, segui i passaggi descritti in Configura apigee-sso per l'accesso HTTPS. Nell'ambito del processo di attivazione di HTTPS, imposti SSO_TOMCAT_PROFILE nel file di configurazione di Edge SSO come mostrato di seguito:

SSO_TOMCAT_PROFILE=SSL_TERMINATION

Facoltativamente, puoi anche impostare la porta utilizzata da Edge SSO per l'accesso HTTPS:

SSO_TOMCAT_PORT=9443

Poi configura il bilanciatore del carico in modo da:

  • Utilizza la modalità TCP, non la modalità HTTP, per connetterti a Edge SSO.
  • Ascolta sulla stessa porta di Edge SSO definita da SSO_TOMCAT_PORT.

Quindi, configura il bilanciatore del carico in modo che inoltri le richieste a un'istanza Edge SSO sulla porta 9433. L'URL pubblico di Edge SSO in questo scenario è:

https://LB_DNS_NAME:9443

Installa Edge SSO in più data center

In un ambiente con più data center, installi un'istanza Edge SSO in ogni data center. Un'istanza Edge SSO gestisce quindi tutto il traffico. Se l'istanza Edge SSO non è disponibile, puoi passare alla seconda istanza Edge SSO.

Prima di installare Edge SSO in due data center, devi disporre di quanto segue:

  • L'indirizzo IP o il nome di dominio del server Postgres principale.

    In un ambiente con più data center, in genere installi un server Postgres in ogni data center e li configuri in modalità di replica Master-Standby. In questo esempio, il data center 1 contiene il server Postgres principale e il data center 2 contiene il server di standby. Per saperne di più, consulta Configura la replica master-standby per Postgres.

  • Una singola voce DNS che punta a un'istanza Edge SSO. Ad esempio, crei una voce DNS nel modulo seguente che punta all'istanza Edge SSO nel data center 1:
    my-sso.domain.com => apigee-sso-dc1-ip-or-lb
  • Entrambe le istanze di Edge SSO devono utilizzare la stessa coppia di chiavi JWT specificata dalle proprietà SSO_JWT_SIGNING_KEY_FILEPATH e SSO_JWT_VERIFICATION_KEY_FILEPATH nel file di configurazione. Per saperne di più sull'impostazione di queste proprietà, consulta Installa e configura Edge SSO.

Quando installi Edge SSO in ogni data center, configuri entrambi in modo che utilizzino il master Postgres nel data center 1:

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

Inoltre, configuri entrambi i data center in modo che utilizzino la voce DNS come URL accessibile pubblicamente:

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

Se Edge SSO nel data center 1 non funziona, puoi passare all'istanza Edge SSO nel data center 2:

  1. Converti il server Postgres in standby nel data center 2 in Master come descritto in Gestione di un failover del database PostgreSQL.
  2. Aggiorna il record DNS in modo che my-sso.domain.com punti all'istanza Edge SSO nel data center 2:
    my-sso.domain.com => apigee-sso-dc2-ip-or-lb
  3. Aggiorna il file di configurazione per Edge SSO nel data center 2 in modo che punti al nuovo server Postgres Master nel data center 2:
    ## Postgres configuration
    PG_HOST=IP_or_DNS_of_PG_Master_in_DC2
  4. Riavvia Edge SSO nel data center 2 per aggiornare la relativa configurazione:
    /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart