Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

4.53.00.02 - Catatan rilis Edge untuk Private Cloud

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Pada 19 Desember 2024, kami merilis versi baru Apigee Edge untuk Private Cloud.

Prosedur update

Bagian ini menjelaskan cara menginstal rilis ini jika Anda mengupdate dari rilis Edge untuk Private Cloud sebelumnya. Jika Anda perlu mengupdate dari rilis sebelumnya, lihat Menerapkan Beberapa Versi Patch.

Mengupdate rilis ini akan mengupdate komponen yang tercantum di bawah:

apigee-nginx-1.26.1-el8.x86_64.rpm
apigee-nginx-1.26.1-el9.x86_64.rpm
apigee-qpidd-8.0.6-0.0.2534.noarch.rpm
apigee-sso-4.53.00-0.0.21506.noarch.rpm
apigee-tomcat-9.0.86-0.0.948.noarch.rpm

Anda dapat memeriksa versi RPM yang saat ini diinstal untuk melihat apakah perlu diupdate dengan memasukkan:

apigee-all version

Untuk mengupdate instalasi, lakukan prosedur berikut di node Edge:

Di semua node Edge:
1. Bersihkan repositori Yum:
```
sudo yum clean all
```
2. Download file Edge 4.53.00 bootstrap_4.53.00.sh terbaru ke /tmp/bootstrap_4.53.00.sh:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
3. Instal utilitas dan dependensi apigee-service Edge 4.53.00:
```
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  dengan uName dan pWord adalah nama pengguna dan kata sandi yang Anda terima dari Apigee. Jika Anda menghapus pWord, Anda akan diminta untuk memasukkannya.
4. Gunakan perintah source untuk menjalankan skrip apigee-service.sh:
```
source /etc/profile.d/apigee-service.sh
```

Di semua node Qpid, jalankan skrip update.sh:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Di node SSO, ikuti prosedur yang dijelaskan di bagian Langkah-langkah untuk mengupdate Apigee SSO dari versi lama:

/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Langkah-langkah untuk mengupdate Apigee SSO dari versi lama

Di Edge untuk Private Cloud 4.53.00, kunci dan sertifikat IDP yang digunakan dalam komponen apigee-sso kini dikonfigurasi melalui keystore. Anda harus mengekspor kunci dan sertifikat yang digunakan sebelumnya ke keystore, mengonfigurasinya, lalu melanjutkan update SSO seperti biasa.

Identifikasi kunci dan sertifikat yang ada yang digunakan untuk mengonfigurasi IDP:
1. Ambil sertifikat dengan mencari nilai SSO_SAML_SERVICE_PROVIDER_CERTIFICATE dalam file konfigurasi penginstalan SSO atau dengan membuat kueri komponen apigee-sso untuk conf_login_service_provider_certificate.
  
  Gunakan perintah berikut di node SSO untuk membuat kueri apigee-sso untuk jalur sertifikat IDP. Di output, cari nilai di baris terakhir.
```
apigee-service apigee-sso configure -search conf_login_service_provider_certificate
```
2. Ambil kunci dengan mencari nilai SSO_SAML_SERVICE_PROVIDER_KEY dalam file konfigurasi penginstalan SSO atau dengan membuat kueri komponen apigee-sso untuk conf_login_service_provider_key.
  
  Gunakan perintah berikut di node SSO untuk membuat kueri apigee-sso untuk jalur kunci IDP. Di output, cari nilai di baris terakhir.
```
apigee-service apigee-sso configure -search conf_login_service_provider_key
```
Ekspor kunci dan sertifikat ke keystore:
1. Ekspor kunci dan sertifikat ke keystore PKCS12:
```
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
```
  Parameter:
  - certificate_path: Jalur ke file sertifikat yang diambil di Langkah 1.a.
  - key_path: Jalur ke file kunci pribadi yang diambil di Langkah 1.b.
  - keystore_path: Jalur ke keystore yang baru dibuat yang berisi sertifikat dan kunci pribadi.
  - alias: Alias yang digunakan untuk pasangan kunci dan sertifikat dalam keystore.
  Lihat dokumentasi OpenSSL untuk mengetahui detail selengkapnya.
2. (Opsional) Ekspor kunci dan sertifikat dari PKCS12 ke keystore JKS:
```
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
```
  Parameter:
  - PKCS12_keystore_path: Jalur ke keystore PKCS12 yang dibuat di Langkah 2.a, yang berisi sertifikat dan kunci.
  - destination_keystore_path: Jalur ke keystore JKS baru tempat sertifikat dan kunci akan diekspor.
  - alias: Alias yang digunakan untuk pasangan kunci dan sertifikat dalam keystore JKS.
Ubah pemilik file keystore output ke pengguna "apigee":
```
sudo chown apigee:apigee <keystore_file>
```

Tambahkan properti berikut di file konfigurasi Apigee SSO dan perbarui dengan jalur file keystore, sandi, jenis keystore, dan alias:

# Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

Update software Apigee SSO di node SSO seperti biasa menggunakan perintah berikut:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
```

Perbaikan bug

Bagian ini mencantumkan bug Private Cloud yang diperbaiki dalam rilis ini.

ID Masalah	Deskripsi
379446933	Memperbaiki masalah yang mencegah `nginx` terikat ke port 443.

Masalah keamanan yang diperbaiki

Berikut adalah daftar masalah keamanan umum yang telah diperbaiki dalam rilis ini. Untuk menghindari masalah ini, instal Edge Private Cloud versi terbaru.

ID Masalah	Deskripsi
344961470	Mem-patch portal pengelolaan QPID untuk kerentanan XSS.

Perubahan pada software yang didukung

Tidak ada dukungan untuk software baru yang disertakan dalam rilis ini.

Penghentian dan pengakhiran

Tidak ada penghentian atau pengakhiran baru dalam rilis ini.

Fitur baru

Bagian ini mencantumkan fitur baru dalam rilis ini.

ID Masalah	Deskripsi
379125083	Mengaktifkan fungsi Single Sign-On (SSO) di lingkungan RHEL-8 yang mendukung FIPS.
379125495	SSO kini menerima kunci dan sertifikat untuk IDP dalam format keystore.

Masalah umum

Lihat Masalah umum dengan Edge untuk Private Cloud untuk mengetahui daftar lengkap masalah umum.

Menerapkan beberapa versi patch

Bagian ini menjelaskan cara menerapkan beberapa versi patch, jika Anda mengupdate dari versi Edge untuk Private Cloud yang lebih lama dari versi rilis patch sebelumnya.

Setiap rilis patch berisi update untuk komponen tertentu dari Edge untuk Private Cloud, seperti edge-management-server. Untuk menerapkan beberapa versi patch, Anda harus mengupdate setiap komponen Edge yang disertakan dalam rilis patch yang lebih baru dari versi yang saat ini diinstal. Anda dapat menemukan komponen ini dengan melihat catatan rilis Edge untuk Private Cloud untuk semua versi yang lebih baru dari versi saat ini dan memeriksa daftar RPM untuk rilis tersebut. Lihat Catatan Rilis Apigee untuk mengetahui link ke semua catatan rilis Edge untuk Private Cloud.

Catatan: Anda hanya perlu mengupdate setiap komponen satu kali, dengan menginstal RPM untuk versi komponen terbaru yang disertakan dalam rilis patch. Ikuti petunjuk dalam catatan rilis untuk versi tersebut guna mengupdate komponen.

Catatan: Mengupgrade komponen akan otomatis menginstal versi patch terbaru dari sebuah komponen. Jika ingin mengupgrade ke versi patch yang bukan yang terbaru, Anda harus mempertahankan salinan tarball repo Apigee sendiri menggunakan mirror Apigee, dan menggunakan mirror ini untuk penginstalan Apigee. Untuk mengetahui informasi selengkapnya, lihat Menggunakan repositori Edge lokal untuk mempertahankan versi Edge Anda.