Masalah umum pada Apigee

Saat variabel alur cachehit digunakan setelah kebijakan LookupCache, karena cara titik debug dikirim untuk perilaku asinkron, LookupPolicy mengisi objek DebugInfo sebelum callback dieksekusi, sehingga menyebabkan error.

Solusi: Ulangi prosesnya (lakukan panggilan kedua) lagi tepat setelah panggilan pertama.

Menetapkan PurgeChildEntries dalam kebijakan InvalidateCache hanya akan menghapus nilai elemen KeyFragment, tetapi akan menghapus seluruh cache.

Solusi: Gunakan kebijakan KeyValueMapOperations untuk melakukan iterasi pembuatan versi cache dan mengabaikan kebutuhan untuk membatalkan validasi cache.

Hal ini dapat terjadi, misalnya, saat pipeline deployment CI/CD dijalankan secara serentak menggunakan revisi yang berbeda. Untuk menghindari masalah ini, jangan deploy proxy API atau SharedFlow sebelum deployment saat ini selesai.

Solusi: Hindari deployment proxy API atau SharedFlow serentak.

Edge API Analytics terkadang dapat berisi data duplikat untuk panggilan API. Dalam hal ini, jumlah yang ditampilkan untuk panggilan API di Edge API Analytics lebih tinggi daripada nilai yang sebanding yang ditampilkan di alat analisis pihak ketiga.

Solusi: Ekspor data analisis dan gunakan kolom gateway_flow_id untuk menghapus duplikat data.

• Apigee Edge mendukung Spesifikasi OpenAPI 3.0 saat Anda membuat spesifikasi menggunakan editor spesifikasi dan memublikasikan API menggunakan SmartDocs di portal, meskipun sebagian fitur belum didukung.

  Misalnya, fitur berikut dari Spesifikasi OpenAPI 3.0 belum didukung:

  • Properti allOf untuk menggabungkan dan memperluas skema
  • Referensi jarak jauh

  Jika fitur yang tidak didukung dirujuk dalam Spesifikasi OpenAPI Anda, dalam beberapa kasus alat akan mengabaikan fitur tersebut, tetapi tetap merender dokumentasi referensi API. Dalam kasus lain, fitur yang tidak didukung akan menyebabkan error yang mencegah rendering dokumentasi referensi API berhasil. Dalam kedua kasus tersebut, Anda harus mengubah Spesifikasi OpenAPI untuk menghindari penggunaan fitur yang tidak didukung hingga fitur tersebut didukung dalam rilis mendatang.

  Catatan: Karena editor spesifikasi kurang membatasi daripada SmartDocs saat merender dokumentasi referensi API, Anda mungkin mengalami hasil yang berbeda di antara alat tersebut.

• Saat menggunakan Coba API ini di portal, header Accept ditetapkan ke application/json, terlepas dari nilai yang ditetapkan untuk consumes dalam Spesifikasi OpenAPI.
• 138438484: Beberapa server tidak didukung.

• Pembaruan portal simultan (seperti pengeditan halaman, tema, CSS, atau skrip) oleh beberapa pengguna saat ini tidak didukung.
• Jika Anda menghapus halaman dokumentasi referensi API dari portal, tidak ada cara untuk membuatnya ulang; Anda harus menghapus dan menambahkan ulang produk API, serta membuat ulang dokumentasi referensi API.
• Saat mengonfigurasi kebijakan keamanan konten, mungkin perlu waktu hingga 15 menit agar perubahan diterapkan sepenuhnya.
• Saat menyesuaikan tema portal, mungkin perlu waktu hingga 5 menit agar perubahan diterapkan sepenuhnya.

• Penelusuran akan diintegrasikan ke portal terintegrasi dalam rilis mendatang.

Kerentanan (CVE-2026-42945) diungkapkan yang memengaruhi ngx_http_rewrite_module di NGINX. Alat pemindaian keamanan dapat menandai biner NGINX yang disertakan dengan Apigee Edge for Private Cloud karena modul ini dikompilasi secara statis ke dalam NGINX.

Dampak pada Apigee Edge for Private Cloud:

Apigee Edge for Private Cloud tidak terpengaruh oleh kerentanan ini dalam konfigurasi default yang disertakan. Kemampuan eksploitasi CVE-2026-42945 bergantung pada pola konfigurasi NGINX tertentu, terutama penggunaan direktif rewrite dalam urutan tertentu. Pola ini tidak ada dalam konfigurasi NGINX Apigee Edge for Private Cloud standar.

Tindakan yang Diperlukan:

• Untuk Konfigurasi Apigee Edge for Private Cloud Default: Tidak diperlukan patch, upgrade, atau perubahan operasional. Temuan pemindai terkait CVE-2026-42945 dapat dianggap sebagai positif palsu untuk penginstalan default. Anda dapat menggunakan teks berikut untuk mendokumentasikan pengecualian ini di sistem pengelolaan kerentanan Anda:

  CVE-2026-42945 — Accepted exception (false positive for Apigee Edge for Private Cloud). Apigee Edge for Private Cloud does not use the rewrite directive in any shipped NGINX configuration. The vulnerable code path in ngx_http_rewrite_module is configuration-gated and is not reachable in the default Apigee Edge for Private Cloud deployment.

• Untuk Konfigurasi NGINX yang Disesuaikan: Jika Anda telah mengubah file konfigurasi NGINX secara manual dalam penginstalan Apigee Edge for Private Cloud (misalnya, di bawah /opt/nginx), Anda harus melakukan pemeriksaan mandiri berikut untuk memastikan penyesuaian Anda tidak secara tidak sengaja memperkenalkan pola yang rentan:
  1. Periksa direktif rewrite: Di setiap node NGINX, jalankan perintah:

     sudo grep -rnI '^\s*rewrite\b' /opt/nginx

  2. Analisis Hasil:
     • Jika perintah tidak menampilkan output, sistem Anda tidak terpengaruh.
     • Jika kecocokan ditemukan, tinjau setiap instance. Kerentanan ada hanya jika semua kondisi berikut terpenuhi untuk blok tertentu:
       • Direktif rewrite digunakan.
       • Direktif ini segera diikuti oleh direktif rewrite, if, atau set lain dalam blok konfigurasi yang sama.
       • Grup pengambilan PCRE yang tidak diberi nama (misalnya, $1, $2, dll.) digunakan dalam direktif.
       • String pengganti dalam direktif berisi tanda tanya (?).
  3. Mitigasi (jika rentan): Jika semua kondisi di atas benar untuk bagian mana pun dari konfigurasi kustom Anda, lakukan mitigasi dengan:
     • Menghapus tanda tanya (?) dari string pengganti.
     • Menggunakan grup pengambilan PCRE bernama, bukan yang tidak bernama.
     • Mengevaluasi kembali kebutuhan direktif yang dirangkai.

Di Edge for Private Cloud 4.53.00 dan yang lebih baru, UI menampilkan "Akhir Masa Pakai" (EOL) pop-up peringatan. Peringatan ini muncul
berulang kali dan frekuensinya tidak dapat dicegah atau dikurangi.

Saat ini, tidak ada metode yang tersedia bagi pengguna untuk menonaktifkan atau mengurangi frekuensi peringatan EOL ini.

Masalah ini hanya memengaruhi pengguna yang menggunakan MINT atau mengaktifkan MINT di penginstalan Edge for Private Cloud.

Komponen yang terpengaruh: edge-message-processor

Masalah: Jika Anda mengaktifkan monetisasi dan menginstal 4.52.01 sebagai penginstalan baru atau mengupgrade dari versi Private Cloud sebelumnya, Anda akan mengalami masalah dengan pemroses pesan. Jumlah thread terbuka akan meningkat secara bertahap sehingga menyebabkan kehabisan resource. Pengecualian berikut terlihat di edge-message-processor system.log:

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread

Kerentanan Penolakan Layanan (DoS) baru-baru ini ditemukan di beberapa penerapan protokol HTTP/2 (CVE-2023-44487), termasuk di Apigee Edge for Private Cloud. Kerentanan ini dapat menyebabkan DoS pada fungsi pengelolaan API Apigee. Untuk mengetahui detail selengkapnya, lihat Buletin Keamanan Apigee GCP-2023-032.

Komponen router dan server pengelolaan Edge for Private Cloud diekspos ke internet dan berpotensi rentan. Meskipun HTTP/2 diaktifkan di port pengelolaan komponen khusus Edge lainnya dari Edge for Private Cloud, tidak ada komponen tersebut yang diekspos ke internet. Pada komponen non-Edge, seperti Cassandra, Zookeeper, dan lainnya, HTTP/2 tidak diaktifkan. Sebaiknya lakukan langkah-langkah berikut untuk mengatasi kerentanan Edge for Private Cloud:

• Langkah-langkah untuk Edge for Private Cloud versi 4.51.00.11 atau yang lebih baru
• Langkah-langkah untuk Edge for Private Cloud versi yang lebih lama dari 4.51.00.11

Ikuti langkah-langkah berikut jika Anda menggunakan Edge Private Cloud versi 4.51.00.11 atau yang lebih baru:

1. Update server pengelolaan:

   1. Di setiap node server pengelolaan, buka /opt/apigee/customer/application/management-server.properties
   2. Tambahkan baris ini ke file properti:

      conf_webserver_http2.enabled=false

   3. Mulai ulang komponen server pengelolaan:

      apigee-service edge-management-server restart

2. Update pemroses pesan:

   1. Di setiap node pemroses pesan, buka /opt/apigee/customer/application/message-processor.properties
   2. Tambahkan baris ini ke file properti:

      conf_webserver_http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-message-processor restart

3. Update router:

   1. Di setiap node router, buka /opt/apigee/customer/application/router.properties
   2. Tambahkan baris ini ke file properti:

      conf_webserver_http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-router restart

4. Update QPID:

   1. Di setiap node QPID, buka /opt/apigee/customer/application/qpid-server.properties
   2. Tambahkan baris ini ke file properti:

      conf_webserver_http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-qpid-server restart

5. Update Postgres:

   1. Di setiap node Postgres, buka /opt/apigee/customer/application/postgres-server.properties
   2. Tambahkan baris ini ke file properti:

      conf_webserver_http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-postgres-server restart

Ikuti langkah-langkah berikut jika Anda menggunakan Edge for Private Cloud versi yang lebih lama dari 4.51.00.11:

1. Update server pengelolaan:

   1. Di setiap node server pengelolaan, buka /opt/apigee/customer/application/management-server.properties
   2. Tambahkan dua baris berikut ke file properti:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mulai ulang komponen server pengelolaan:

      apigee-service edge-management-server restart

2. Update pemroses pesan:

   1. Di setiap node pemroses pesan, buka /opt/apigee/customer/application/message-processor.properties
   2. Tambahkan dua baris berikut ke file properti:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-message-processor restart

3. Update router:

   1. Di setiap node router, buka /opt/apigee/customer/application/router.properties
   2. Tambahkan dua baris berikut ke file properti:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-router restart

4. Update QPID:

   1. Di setiap node QPID, buka /opt/apigee/customer/application/qpid-server.properties
   2. Tambahkan dua baris berikut ke file properti:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-qpid-server restart

5. Update Postgres:

   1. Di setiap node Postgres, buka /opt/apigee/customer/application/postgres-server.properties
   2. Tambahkan dua baris berikut ke file properti:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mulai ulang komponen pemroses pesan:

      apigee-service edge-postgres-server restart

Apigee-postgresql mengalami masalah saat mengupgrade dari Edge for Private Cloud versi 4.50 atau 4.51 ke versi 4.52. Masalah ini terutama terjadi jika jumlah tabel lebih dari 500.

Anda dapat memeriksa jumlah total tabel di Postgres dengan menjalankan kueri SQL di bawah:

select count(*) from information_schema.tables

Solusi: Saat Mengupdate Apigee Edge 4.50.00 atau 4.51.00 ke 4.52.00, pastikan untuk melakukan langkah awal sebelum mengupgrade Apigee-postgresql.

149245401: Setelan kumpulan koneksi LDAP untuk JNDI yang dikonfigurasi melalui resource LDAP tidak tercermin, dan default JNDI menyebabkan koneksi sekali pakai setiap kali. Akibatnya, koneksi dibuka dan ditutup setiap kali untuk sekali pakai, sehingga membuat sejumlah besar koneksi per jam ke server LDAP.

Solusi:

Untuk mengubah properti kumpulan koneksi LDAP, lakukan langkah-langkah berikut untuk menetapkan perubahan global di semua kebijakan LDAP.

1. Buat file properti konfigurasi jika belum ada:

   /opt/apigee/customer/application/message-processor.properties

2. Tambahkan hal berikut ke file (ganti nilai properti Java Naming and Directory Interface (JNDI) berdasarkan persyaratan konfigurasi resource LDAP Anda).

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. Pastikan file /opt/apigee/customer/application/message-processor.properties dimiliki oleh apigee:apigee.
4. Mulai ulang setiap pemroses pesan.

Untuk memverifikasi bahwa properti JNDI kumpulan koneksi Anda berlaku, Anda dapat melakukan tcpdump untuk mengamati perilaku kumpulan koneksi LDAP dari waktu ke waktu.

139051927: Latensi pemrosesan proxy yang tinggi yang ditemukan di Pemroses Pesan memengaruhi semua Proxy API. Gejalanya mencakup penundaan 200-300 md dalam waktu pemrosesan di atas waktu respons API normal dan dapat terjadi secara acak meskipun dengan TPS rendah. Hal ini dapat terjadi jika lebih dari 50 server target tempat pemroses pesan membuat koneksi.

Penyebab utama: Pemroses pesan menyimpan cache yang memetakan URL server target ke objek HTTPClient untuk koneksi keluar ke server target. Secara default, setelan ini ditetapkan ke 50 yang mungkin terlalu rendah untuk sebagian besar deployment. Jika deployment memiliki beberapa kombinasi org/env dalam penyiapan, dan memiliki sejumlah besar server target yang melebihi 50 secara keseluruhan, URL server target akan terus dikeluarkan dari cache, sehingga menyebabkan latensi.

Validasi: Untuk menentukan apakah pengeluaran URL server target menyebabkan masalah latensi, telusuri system.logs Pemroses Pesan untuk kata kunci "onEvict" atau "Eviction". Keberadaannya dalam log menunjukkan bahwa URL server target dikeluarkan dari cache HTTPClient karena ukuran cache terlalu kecil.

Solusi: Untuk Edge for Private Cloud versi 19.01 dan 19.06, Anda dapat mengedit dan mengonfigurasi cache HTTPClient, /opt/apigee/customer/application/message-processor.properties:

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

Kemudian, mulai ulang pemroses pesan. Buat perubahan yang sama untuk semua pemroses pesan.

Nilai 500 adalah contoh. Nilai optimal untuk penyiapan Anda harus lebih besar dari jumlah server target yang akan terhubung dengan pemroses pesan. Tidak ada efek samping dari menetapkan properti ini lebih tinggi, dan satu-satunya efeknya adalah peningkatan waktu pemrosesan permintaan proxy pemroses pesan.

Catatan: Edge for Private Cloud versi 50.00 memiliki setelan default 500.

157933959: Penyisipan dan update serentak ke peta nilai kunci (KVM) yang sama yang dicakup ke tingkat organisasi atau lingkungan menyebabkan data yang tidak konsisten dan update yang hilang.

Catatan: Batasan ini hanya berlaku untuk Edge for Private Cloud. Edge for Public Cloud dan Hybrid tidak memiliki batasan ini.

Untuk solusi di Edge for Private Cloud, buat KVM di cakupan apiproxy.