Menginstal SSO Edge untuk ketersediaan tinggi

Edge for Private Cloud v. 4.17.09

Anda menginstal beberapa instance Edge SSO untuk ketersediaan tinggi dalam dua skenario:

• Dalam lingkungan pusat data tunggal, instal dua instance Edge SSO untuk membuat lingkungan ketersediaan tinggi, yang berarti sistem akan terus beroperasi jika salah satu modul Edge SSO tidak berfungsi.
• Dalam lingkungan dengan dua pusat data, instal Edge SSO di kedua pusat data tersebut agar sistem terus beroperasi jika salah satu modul Edge SSO mengalami gangguan.

Menginstal dua modul SSO Edge di pusat data yang sama

Anda men-deploy dua instance Edge SSO, di node yang berbeda, dalam satu pusat data untuk mendukung ketersediaan tinggi. Dalam skenario ini:

• Kedua instance Edge SSO harus terhubung ke server Postgres yang sama. Apigee merekomendasikan penggunaan server Postgres khusus untuk Edge SSO dan tidak menggunakan server Postgres yang sama dengan yang Anda instal dengan Edge.

• Anda memerlukan load balancer di depan dua instance Edge SSO:
  • Load balancer harus mendukung persistensi cookie yang dihasilkan aplikasi, dan cookie sesi harus diberi nama JSESSIONID.
  • Konfigurasikan load balancer untuk melakukan health check TCP atau HTTP di Edge SSO. Untuk TCP, gunakan URL Edge SSO:
    
    http_or_https://edge_sso_IP_DNS:9099
    
    Tentukan port seperti yang ditetapkan oleh Edge SSO. Port 9099 adalah defaultnya.
    
    Untuk HTTP, sertakan /healthz:
    
    http_or_https://edge_sso_IP_DNS:9099/healthz
  • Beberapa setelan load balancer bergantung pada apakah Anda mengaktifkan HTTPS di Edge SSO. Lihat bagian berikut untuk mengetahui informasi selengkapnya.

Menggunakan akses HTTP ke SSO Edge

Jika Anda menggunakan akses HTTP ke SSO Edge, konfigurasikan load balancer untuk:

• Menggunakan mode HTTP untuk terhubung ke SSO Edge
• Memproses di port yang sama dengan Edge SSO
  
  Secara default, Edge SSO memproses permintaan HTTP di port 9099. Atau, Anda dapat menggunakan SSO_TOMCAT_PORT untuk menetapkan port SSO Edge. Jika Anda menggunakan SSO_TOMCAT_PORT untuk mengubah port SSO Edge dari default, pastikan load balancer memproses port tersebut.

Misalnya, di setiap instance Edge SSO, Anda menetapkan port ke 9033 dengan menambahkan kode berikut ke file konfigurasi:

SSO_TOMCAT_PORT=9033

Kemudian, Anda mengonfigurasi load balancer untuk memproses port 9033 dan meneruskan permintaan ke instance Edge SSO di port 9033. URL publik Edge SSO dalam skenario ini adalah:

http://LB_DNS_NAME:9033

Menggunakan akses HTTPS ke SSO Edge

Anda dapat mengonfigurasi instance Edge SSO untuk menggunakan HTTPS. Dalam skenario ini, ikuti langkah-langkah di Mengonfigurasi apigee-sso untuk akses HTTPS. Sebagai bagian dari proses pengaktifan HTTPS, Anda menetapkan SSO_TOMCAT_PROFILE di file konfigurasi Edge SSO seperti yang ditunjukkan di bawah:

SSO_TOMCAT_PROFILE=SSL_TERMINATION 

Anda juga dapat menetapkan port yang digunakan oleh SSO Edge untuk akses HTTPS:

SSO_TOMCAT_PORT=9443

Jika Anda menggunakan akses HTTPS ke SSO Edge, konfigurasikan load balancer untuk:

• Menggunakan mode TCP, bukan mode HTTP, untuk terhubung ke SSO Edge
• Memproses di port yang sama dengan Edge SSO seperti yang ditentukan oleh SSO_TOMCAT_PORT

Kemudian, Anda mengonfigurasi load balancer untuk meneruskan permintaan ke instance Edge SSO di port 9433. URL publik Edge SSO dalam skenario ini adalah:

https://LB_DNS_NAME:9443

Menginstal Edge SSO di beberapa pusat data

Dalam lingkungan beberapa pusat data, Anda menginstal instance Edge SSO di setiap pusat data. Satu instance Edge SSO kemudian menangani semua traffic. Jika instance SSO Edge tersebut tidak aktif, Anda dapat beralih ke instance SSO Edge kedua.

Sebelum menginstal Edge SSO di dua pusat data, Anda memerlukan hal berikut:

• Alamat IP atau nama domain server Master Postgres.
  
  Dalam lingkungan beberapa pusat data, Anda biasanya menginstal satu server Postgres di setiap pusat data dan mengonfigurasinya dalam mode replikasi Master-Standby. Untuk contoh ini, pusat data 1 berisi server Postgres Master dan pusat data 2 berisi Standby. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Replikasi Master-Standby untuk Postgres.
• Satu entri DNS yang mengarah ke satu instance SSO Edge. Misalnya, Anda membuat entri DNS dalam formulir di bawah yang mengarah ke instance SSO Edge di pusat data 1:
  
  my-sso.domain.com => apigee-sso-dc1-ip-or-lb

Saat menginstal Edge SSO di setiap pusat data, Anda mengonfigurasi keduanya untuk menggunakan Master Postgres di pusat data 1:

## Postgres configuration.
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
 PG_PORT=5432

Anda juga mengonfigurasi keduanya untuk menggunakan entri DNS sebagai URL yang dapat diakses secara publik:

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

Jika Edge SSO di pusat data 1 tidak aktif, Anda dapat beralih ke instance Edge SSO di pusat data 2:

• Konversikan server Postgres Standby di pusat data 2 ke Master seperti yang dijelaskan dalam Menangani Failover Database PostgreSQL.
• Perbarui data DNS untuk mengarahkan my-sso.domain.com ke instance SSO Edge di pusat data 2:
  my-sso.domain.com => apigee-sso-dc2-ip-or-lb
• Perbarui file konfigurasi untuk Edge SSO di pusat data 2 agar mengarah ke server Master Postgres baru di pusat data 2:
  ## Postgres configuration.
PG_HOST=IP_or_DNS_of_PG_Master_in_DC2
• Mulai ulang Edge SSO di pusat data 2 untuk memperbarui konfigurasinya:
  /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart