Anda menginstal beberapa instance Apigee SSO untuk ketersediaan tinggi dalam dua skenario:
- Dalam lingkungan pusat data tunggal, instal dua instance Apigee SSO untuk membuat lingkungan ketersediaan tinggi, yang berarti sistem akan terus beroperasi jika salah satu modul Apigee SSO tidak berfungsi.
- Dalam lingkungan dengan dua pusat data, instal Apigee SSO di kedua pusat data agar sistem terus beroperasi jika salah satu modul Apigee SSO mengalami gangguan.
Menginstal dua modul Apigee SSO di pusat data yang sama
Anda men-deploy dua instance Apigee SSO, pada node yang berbeda, di satu pusat data untuk mendukung ketersediaan tinggi. Dalam skenario ini:
- Kedua instance Apigee SSO harus terhubung ke server Postgres yang sama. Apigee merekomendasikan penggunaan server Postgres khusus untuk Apigee SSO, bukan server Postgres yang sama dengan yang Anda instal dengan Edge.
- Kedua instance Apigee SSO harus menggunakan pasangan kunci JWT yang sama seperti yang ditentukan oleh properti
SSO_JWT_SIGNING_KEY_FILEPATHdanSSO_JWT_VERIFICATION_KEY_FILEPATHdalam file konfigurasi. Lihat Menginstal dan mengonfigurasi SSO Apigee untuk mengetahui informasi selengkapnya tentang cara menetapkan properti ini. - Anda memerlukan load balancer di depan dua instance Apigee SSO:
- Load balancer harus mendukung persistensi cookie yang dihasilkan aplikasi, dan cookie sesi harus diberi nama
JSESSIONID. - Konfigurasi load balancer untuk melakukan health check TCP atau HTTP di Apigee SSO. Untuk TCP, gunakan URL SSO Apigee:
http_or_https://edge_sso_IP_DNS:9099
Tentukan port seperti yang ditetapkan oleh Apigee 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 Apigee SSO. Lihat bagian berikut untuk mengetahui informasi selengkapnya.
- Load balancer harus mendukung persistensi cookie yang dihasilkan aplikasi, dan cookie sesi harus diberi nama
Akses HTTP ke Apigee SSO
Jika Anda menggunakan akses HTTP ke Apigee SSO, konfigurasikan load balancer untuk:
- Gunakan mode HTTP untuk terhubung ke Apigee SSO.
Memproses di port yang sama dengan Apigee SSO.
Secara default, Apigee SSO memproses permintaan HTTP di port 9099. Secara opsional, Anda dapat menggunakan
SSO_TOMCAT_PORTuntuk menetapkan port SSO Apigee. Jika Anda menggunakanSSO_TOMCAT_PORTuntuk mengubah port Apigee SSO dari default, pastikan load balancer memproses port tersebut.
Misalnya, di setiap instance Apigee 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 Apigee SSO dalam skenario ini adalah:
http://LB_DNS_NAME:9033
Akses HTTPS ke Apigee SSO
Anda dapat mengonfigurasi instance Apigee SSO untuk menggunakan HTTPS. Dalam skenario ini, ikuti langkah-langkah di
Mengonfigurasi SSO Apigee untuk akses HTTPS. Sebagai
bagian dari proses pengaktifan HTTPS, Anda menetapkan SSO_TOMCAT_PROFILE di file konfigurasi
Apigee SSO seperti yang ditunjukkan di bawah:
SSO_TOMCAT_PROFILE=SSL_TERMINATION
Anda juga dapat menetapkan port yang digunakan oleh Apigee SSO untuk akses HTTPS:
SSO_TOMCAT_PORT=9443
Kemudian, konfigurasi load balancer untuk:
- Gunakan mode TCP, bukan mode HTTP, untuk terhubung ke Apigee SSO.
- Memproses di port yang sama dengan Apigee SSO seperti yang ditentukan oleh
SSO_TOMCAT_PORT.
Kemudian, Anda mengonfigurasi load balancer untuk meneruskan permintaan ke instance Apigee SSO di port 9433. URL publik Apigee SSO dalam skenario ini adalah:
https://LB_DNS_NAME:9443
Menginstal Apigee SSO di beberapa pusat data
Dalam lingkungan beberapa pusat data, Anda menginstal instance Apigee SSO di setiap pusat data. Satu instance Apigee SSO kemudian menangani semua traffic. Jika instance Apigee SSO tersebut tidak aktif, Anda dapat beralih ke instance Apigee SSO kedua.
Sebelum menginstal Apigee 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 Apigee. Misalnya, Anda membuat entri DNS
dalam formulir di bawah yang mengarah ke instance Apigee SSO di pusat data 1:
my-sso.domain.com => apigee-sso-dc1-ip-or-lb
- Kedua instance Apigee SSO harus menggunakan pasangan kunci JWT yang sama seperti yang ditentukan oleh properti
SSO_JWT_SIGNING_KEY_FILEPATHdanSSO_JWT_VERIFICATION_KEY_FILEPATHdalam file konfigurasi. Lihat Menginstal dan mengonfigurasi SSO Apigee untuk mengetahui informasi selengkapnya tentang cara menetapkan properti ini.
Saat menginstal Apigee SSO di setiap pusat data, Anda mengonfigurasi keduanya untuk menggunakan Postgres Master di pusat data 1:
## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432Anda juga mengonfigurasi kedua pusat data untuk menggunakan entri DNS sebagai URL yang dapat diakses secara publik:
# Externally accessible URL of Apigee SSO SSO_PUBLIC_URL_HOSTNAME=my-sso.domain.com # Default port is 9099. SSO_PUBLIC_URL_PORT=9099
Jika Apigee SSO di pusat data 1 tidak aktif, Anda dapat beralih ke instance Apigee 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 agar mengarahkan
my-sso.domain.comke instance Apigee SSO di pusat data 2:my-sso.domain.com => apigee-sso-dc2-ip-or-lb
- Perbarui file konfigurasi untuk Apigee 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 Apigee SSO di pusat data 2 untuk memperbarui konfigurasinya:
/opt/apigee/apigee-service/bin/apigee-service apigee-sso restart