Installazione di Edge SSO per un'alta disponibilità

Edge for Private Cloud v. 4.17.09

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 disponibilità, 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 di non utilizzare lo stesso server Postgres che hai installato con Edge.
  • È 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.

Utilizzo dell'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 all'SSO di Edge
  • Ascolta sulla stessa porta di Edge SSO

    Per impostazione predefinita, Edge SSO ascolta le 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 di 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

Utilizzo dell'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

Se utilizzi l'accesso HTTPS a Edge SSO, 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

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

  • Converti il server Postgres in standby nel data center 2 in master come descritto in Gestione di un failover del database PostgreSQL.
  • Aggiorna il record DNS in modo che my-sso.domain.com punti all'istanza SSO di Edge nel data center 2:
    my-sso.domain.com => apigee-sso-dc2-ip-or-lb
  • 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
  • Riavvia Edge SSO nel data center 2 per aggiornare la configurazione:
    /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart