Anda sedang melihat dokumentasi Apigee Edge.
Buka
Dokumentasi Apigee X. info
Versi 3.3.x
Perbaikan bug dan peningkatan v.3.3.x
3.3.3
Pada 25 April 2024, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.3.3. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.3.3 | 3.3.3 | 3.3.3 | 3.3.3 | 3.2.2 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
315939218 | Dihapus |
Plugin klien Eureka telah dihapus dari Edge Microgateway. Penghapusan data ini tidak memengaruhi fungsi inti Edge Microgateway atau menulis ulang URL target. Untuk detail selengkapnya, lihat Menulis ulang URL target di plugin. |
283947053 | Dihapus |
Dukungan untuk |
Masalah keamanan telah diperbaiki
- CVE-2023-0842
- CVE-2023-26115
- CVE-2022-25883
- CVE-2017-20162
- CVE-2022-31129
- CVE-2022-23539
- CVE-2022-23541
- CVE-2022-23540
- CVE-2024-21484
- CVE-2022-46175
- CVE-2023-45133
- CVE-2020-15366
- CVE-2023-26136
- CVE-2023-26115
3.3.2
Pada 18 Agustus 2023, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.3.2. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.3.2 | 3.3.2 | 3.3.2 | 3.3.2 | 3.2.2 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
296187679 | Fitur |
Versi Node.js yang didukung mencakup: 16, 18, dan 20. Mulai versi 3.3.2, perintah CLI Edge Microgateway hanya akan berfungsi pada versi yang didukung. Mengeksekusi Perintah CLI pada versi yang tidak didukung akan menghasilkan error. Lihat juga Software yang didukung dan versi yang didukung Apigee. |
283947053 | Bug |
Masalah telah diperbaiki di mana Edge Microgateway mengembalikan produk API pertama di daftar produk API yang terkait dengan aplikasi. Sekarang kita menentukan produk API yang benar yang ditampilkan berdasarkan permintaan. |
274443329 | Bug |
Masalah telah diperbaiki saat Docker mengambil versi image yang sudah usang.
Versi node Docker telah diupdate ke Node.js versi 18. Sekarang kita membangun Docker
image dengan versi |
Masalah keamanan telah diperbaiki
Tidak ada.
3.3.1
Pada 7 Juni 2022, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.3.1. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.3.1 | 3.3.1 | 3.3.1 | 3.3.1 | 3.2.2 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
220885293 | Fitur |
Node.js versi 16 kini didukung. |
231972608 | Bug |
Masalah telah diperbaiki, yaitu |
233315475 | Bug |
Masalah telah diperbaiki saat plugin |
221432797 | Ubah |
Versi Docker Node.js dari image Edge Microgateway dasar telah diupgrade ke Node.js 14. |
215748732 | Fitur |
Dukungan untuk autentikasi token SAML telah ditambahkan ke perintah revokekeys.
Anda kini dapat meneruskan token SAML, bukan kredensial nama pengguna dan sandi menggunakan opsi Untuk mengetahui detailnya, lihat Referensi command line. |
218723889 | Pembaruan Dokumen |
Dokumentasi telah diperbarui dengan menyertakan link ke Edge Microgateway yang didukung plugin yang disimpan di GitHub. Lihat Plugin yang sudah ada yang dipaketkan dengan Edge Microgateway. |
Masalah keamanan telah diperbaiki
ID Masalah | Deskripsi |
---|---|
CVE-2021-23413 | Ini memengaruhi paket jszip sebelum 3.7.0. Membuat file {i>zip<i} baru dengan nama file diatur ke nilai prototipe Objek (misalnya proto, toString, dll.) menghasilkan objek yang ditampilkan dengan instance prototipe yang dimodifikasi. |
3.3.0
Pada 4 Februari 2022, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.3.0. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.3.0 | 3.3.0 | 3.3.0 | 3.3.0 | 3.2.2 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
219556824 | Masalah Umum | Edge Microgateway Gateway 3.3.0 tidak kompatibel dengan perintah npm audit Fix.
Menjalankan
Jika Anda mengeksekusi
Untuk memperbaiki masalah tersebut, jalankan perintah
untuk memulihkan versi npm install apigeetool@0.15.1 Masalah ini akan diatasi dalam rilis Edge Microgateway mendatang. |
138622990 | Fitur |
Flag baru untuk plugin Quota, |
192534424 | Bug |
Masalah telah diperbaiki jika kode respons yang terlihat di analisis Apigee tidak cocok kode respons Edge Microgateway. |
198986036 | Peningkatan | Edge Microgateway kini mengambil kunci publik penyedia identitas (IDP) pada setiap interval polling dan juga memperbarui kunci jika kunci publik IDP berubah.
Sebelumnya, plugin extauth tidak dapat memperbarui kunci publik tanpa memuat ulang Edge Microgateway jika kunci publik IDP berubah.
|
168713541 | Bug |
Dokumentasi ditingkatkan untuk menjelaskan cara mengonfigurasi TLS/SSL untuk beberapa target. Lihat Menggunakan opsi SSL/TLS klien. |
171538483 | Bug |
Dokumentasi diubah untuk memperbaiki konvensi penamaan file log. Lihat Konvensi penamaan file log. |
157908466 | Bug |
Dokumentasi diubah untuk menjelaskan dengan benar cara menginstal versi tertentu dari Edge Microgateway. Lihat Mengupgrade Edge Microgateway jika Anda memiliki koneksi internet. |
215748427 | Bug | Masalah telah diperbaiki dengan perintah pencabutan kunci menampilkan error saat mencabut kunci dengan menggunakan pasangan kunci dan rahasia yang ada. |
205524197 | Bug | Dokumentasi telah diperbarui untuk menyertakan daftar lengkap level logging. Lihat atribut edgemicro dan Cara menetapkan level logging. |
Versi 3.2.x
Perbaikan bug dan peningkatan v.3.2.x
3.2.3
Pada 17 September 2021, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.2.3. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.2.3 | 3.2.3 | 3.2.3 | 3.2.3 | 3.2.2 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
192416584 | Fitur |
Atribut konfigurasi |
192799989 | Fitur |
Atribut konfigurasi |
148062415 | Bug | Masalah telah diperbaiki saat dalam konteks container Docker, Edge Microgateway tidak ditutup
dengan baik menggunakan perintah docker stop {containerId} . Proses
dihentikan, namun file .sock dan .pid tidak dihapus. Baru saja
file akan dihapus dan memulai ulang penampung yang sama akan berfungsi seperti yang diharapkan.
|
190715670 | Bug | Masalah telah diperbaiki saat beberapa permintaan macet selama aktivitas pemuatan ulang internal
dari microgateway. Masalah ini hanya sesekali dan terjadi dalam situasi traffic tinggi.
Masalah ini terlihat ketika fitur tokenCache dan cacheKey
Plugin OAuth digunakan.
|
183910111 | Bug | Perbaikan masalah terkait URL jalur resource yang diakhiri dengan garis miring telah salah
diinterpretasikan sebagai jalur resource terpisah. Misalnya, jalur
/country/all dan /country/all/ ditafsirkan sebagai hal yang sama
. |
Masalah keamanan telah diperbaiki
ID Masalah | Deskripsi |
---|---|
CVE-2020-28503 | Isian salinan paket sebelum 2.0.5 rentan terhadap Polusi Prototipe melalui fungsi utama. |
CVE-2021-23343 | Semua versi penguraian jalur paket rentan terhadap Penolakan Ekspresi Reguler Layanan (ReDoS) melalui ekspresi reguler splitDeviceRe, splitTailRe, dan splitPathRe. ReDoS menunjukkan kompleksitas waktu kasus terburuk polinomial. |
3.2.2
Pada Kamis, 15 Juli 2021, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.2.2. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.2.2 | 3.2.2 | 3.2.2 | 3.2.2 | 3.2.2 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
185323500 | Ubah |
Nilai
API permintaan token dan permintaan token refresh sekarang menampilkan
Untuk mematuhi
RFC 6749 Framework Otorisasi OAuth 2.0
nilai yang diharapkan untuk parameter konfigurasi |
188492065 | Ubah |
Akhir dukungan Node.js 8
Mulai rilis 3.2.2, Node.js 8 tidak lagi didukung. Untuk selengkapnya informasi selengkapnya, lihat Didukung software dan versi yang didukung: Edge Microgateway. |
183990345 | Fitur |
Mengonfigurasi output log untuk container Docker
Parameter konfigurasi Edge Microgateway
to_console
memungkinkan Anda memilih untuk mengirim informasi log
ke {i>output<i} standar alih-alih ke file log. Jika Anda mengikuti langkah-langkah untuk menjalankan Edge Microgateway dalam container Docker, penampung secara default akan mengalihkan stdout dan output error ke file yang terletak di penampung di lokasi:
Agar informasi log tidak dikirim ke Untuk mengetahui detail tentang cara menggunakan variabel baru ini, lihat Menggunakan Docker untuk Edge Microgateway. |
183057665 | Fitur |
Buat jalur file edgemicro.pid dan edgemicro.sock dapat dikonfigurasi.
Parameter |
191352643 | Fitur | Image Docker untuk Edge Microgateway telah diupdate agar menggunakan NodeJS versi 12.22. Lihat Menggunakan Docker untuk Edge Microgateway. |
Masalah keamanan telah diperbaiki
ID Masalah | Deskripsi |
---|---|
CVE-2021-28860 | Di mixme Node.js, sebelum v0.5.1, penyerang dapat menambah atau mengubah properti objek melalui '__proto__' melalui fungsi mutate() dan merge(). Polusi akan ditetapkan secara langsung ke setiap objek dalam program. Hal ini akan mengganggu ketersediaan program sehingga menyebabkan potensi {i>denial of service<i} (DoS). |
CVE-2021-30246 | Di paket jsrsasign hingga 10.1.13 untuk Node.js, beberapa RSA PKCS#1 yang tidak valid Tanda tangan v1.5 keliru dianggap valid. CATATAN: tidak ada informasi serangan praktis. |
CVE-2021-23358 | Paket garis bawah dari 1.13.0-0 dan sebelum 1.13.0-2, dari 1.3.2 dan sebelumnya 1.12.1 rentan terhadap Injeksi Kode Arbitrer melalui fungsi templat, terutama ketika properti variabel diteruskan sebagai argumen karena tidak dibersihkan. |
CVE-2021-29469 | Node-redis adalah klien Redis Node.js. Sebelum versi 3.1.1, saat klien menggunakan mode pemantauan, ekspresi reguler mulai digunakan untuk mendeteksi pesan yang dapat menyebabkan backtracking eksponensial pada beberapa string. Masalah ini dapat menyebabkan penolakan layanan. Masalah ini di-patch di versi 3.1.1. |
CVE-2020-8174 | Image Docker telah diupdate untuk menggunakan Node.js versi 12.22 |
3.2.1
Pada hari Jumat, 5 Maret 2021, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.2.1. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.2.1 | 3.2.1 | 3.2.1 | 3.2.1 | 3.2.1 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
180362102 | Bug |
Masalah telah diperbaiki saat kunci JWK yang memiliki nilai null menyebabkan aplikasi gagal.
Kondisi null sekarang ditangani untuk menghindari penerusan nilai null di Catatan: Perbaikan ini mengharuskan Anda untuk mengupgrade proxy edgemicro-auth. |
179971737 | Bug |
Masalah telah diperbaiki dengan respons status target 4XX / 5XX dicatat sebagai proxy
error untuk proxy edgemicro_*.
Untuk transaksi Edge Microgateway, jumlah kesalahan target yang salah ditampilkan di dasbor analisis kode error Apigee Edge. Kode error untuk error target dihitung sebagai kesalahan proxy. Masalah ini telah diperbaiki dan targetnya tepat jumlah error akan ditampilkan. |
179674670 | Fitur |
Fitur baru telah ditambahkan yang memungkinkan Anda memfilter daftar produk API yang ditempatkan
di JWT berdasarkan kode status produk.
Produk API memiliki tiga kode status - Tertunda, Disetujui, dan Dicabut.
Properti baru bernama
|
178423436 | Bug |
Nilai kunci dan rahasia yang diteruskan di CLI atau melalui variabel lingkungan terlihat
dalam argumen command line process explorer.
Sebuah masalah dilaporkan di mana kunci dan nilai rahasia Edge Microgateway diteruskan baik dari argumen baris perintah atau melalui variabel lingkungan adalah ditampilkan dalam argumen proses worker/turunan node setelah memulai atau microgateway. Untuk memperbaiki masalah pada skenario variabel lingkungan ini, nilai tidak lagi terlihat dalam argumen command line {i>process explorer<i}. Jika nilai kunci dan rahasia diteruskan di baris perintah saat memulai {i>microgateway<i}, setelan akan menggantikan nilai variabel lingkungan apa pun, jika ditetapkan. Dalam hal ini, nilainya masih terlihat dalam argumen baris perintah {i>process explorer<i}. |
178341593 | Bug |
Error dokumentasi untuk plugin apikeys telah diperbaiki.
File README untuk apikeys
plugin salah menyertakan
Properti |
179366445 | Bug |
Masalah telah diatasi ketika payload dihapus untuk semua permintaan GET
pada target.
Anda dapat mengontrol perilaku yang diinginkan dengan parameter konfigurasi baru, Contoh: edgemicro: enable_GET_req_body: true Menurut RFC 7231, bagian 4.3.1: GET, {i>payload<i} permintaan GET tidak memiliki semantik yang ditetapkan, untuk bisa dikirim ke target. |
3.2.0
Pada hari Kamis, 21 Januari 2021, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.2.0. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.2.0 | 3.2.0 | 3.2.0 | 3.2.0 | 3.2.0 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
152640618 | Bug | Mengaktifkan plugin extauth
untuk menetapkan header x-api-key ke
berisi client_id pada
objek permintaan jika token valid. x-api-key kemudian tersedia untuk
plugin tambahan.
|
168836123, 172295489, 176462355, 176462872 | Fitur | Menambahkan dukungan untuk Node.js 14. |
172376835 | Bug | Gunakan satuan waktu yang benar untuk endpoint /token di
Proxy edgemicro-auth .
Masalah endpoint
Perbaikan tidak mengubah durasi waktu habis masa berlaku, tetapi hanya mengubah unit waktu. Hanya
berlaku untuk kolom Jika klien mengandalkan nilai Apakah klien selalu menggunakan nilai dalam token JWT untuk mengevaluasi token periode pembaruan data, maka klien tidak perlu melakukan perubahan. |
173064680 | Bug | Masalah telah diperbaiki saat microgateway mengakhiri permintaan target
sebelum semua potongan data diproses.
Ini adalah terjadi masalah sesekali pada permintaan ukuran payload yang tinggi dan masalahnya yang diperkenalkan dalam rilis 3.1.7. |
174640712 | Bug | Tambahkan penanganan data yang tepat ke plugin.
Penanganan data yang tepat telah ditambahkan ke plugin berikut: |
Versi 3.1.x
Perbaikan bug dan peningkatan v.3.1.x
3.1.8
Pada hari Senin, 16 November 2020, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk setiap project komponen yang terkait dengan dengan Edge Microgateway 3.1.8. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.8 | 3.1.9 | 3.1.7 | 3.1.3 | 3.1.2 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
169201295 | Bug | Nilai numerik dan boolean salah diuraikan dalam tag variabel lingkungan.
Penanganan penggantian variabel lingkungan menguraikan semua nilai sebagai
string, yang mengakibatkan error penguraian untuk boolean atau numerik
masing-masing. Misalnya, |
169202749 | Bug | Penggantian variabel lingkungan tidak berfungsi dalam beberapa kasus.
Penanganan penggantian variabel lingkungan tidak berfungsi untuk beberapa konfigurasi . Lihat Menyetel atribut konfigurasi dengan variabel lingkungan untuk mengetahui informasi tentang batasan. |
168732942 | Bug | Masalah telah diperbaiki karena cakupan OAuth tidak membatasi akses proxy API
seperti yang diharapkan.
Alur |
170609716 | Bug | Masalah telah diperbaiki saat alur /refresh dalam edgemicro-auth
proxy menghasilkan JWT tanpa apiProductList .
|
170708611 | Bug | Cakupan produk API tidak tersedia untuk plugin kustom.
Cakupan produk API tidak disediakan untuk plugin kustom, dan tidak ditulis ke file konfigurasi cache. Lihat Tentang fungsi init() plugin untuk melihat performa cakupan detail dibuat dapat diakses oleh plugin. |
169810710 | Fitur | Kunci dan rahasia disimpan di file konfigurasi cache.
Kunci dan rahasia Edge Microgateway disimpan dalam file yaml konfigurasi cache pada setiap muat ulang/mulai. Pada 3.1.8, kunci dan rahasia tidak lagi disimpan dalam konfigurasi cache . Jika kunci dan rahasia sebelumnya ditulis dalam file konfigurasi {i>cache<i}, alamat IP tersebut akan dihapus. |
170708621 | Fitur | Tidak dapat menonaktifkan plugin Analytics.
Pada versi {i>microgateway<i} sebelumnya, plugin analitik
diaktifkan secara {i>default<i} dan tidak ada cara untuk
menonaktifkannya. Pada versi 3.1.8, parameter konfigurasi baru, |
159571119 | Bug | Mendapatkan error null dalam hook onerror_request di plugin kustom untuk
waktu tunggu respons/soket.
Perbaikan dilakukan untuk mengisi kode status HTTP dan pesan error yang benar untuk
|
3.1.7
Pada hari Kamis, 24 September 2020, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.1.7. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.7 | 3.1.8 | 3.1.6 | 3.1.2 | 3.1.1 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
131708105 | Bug | Plugin analytics salah menangani respons null dari
axpublisher panggilan dan menyebabkan pekerja keluar.
|
133162200 | Bug | Informasi aplikasi developer tidak diisi di Analytics dengan status 403
respons yang disebabkan oleh jalur resource produk yang tidak sah atau respons 401
disebabkan oleh token yang sudah tidak berlaku atau tidak valid.
|
132194290 | Bug | Data Analytics dihapus saat Apigee Edge menolak beberapa analisis
.
|
158618994 | Bug | Koneksi klien Redis yang berlebihan.
|
161404373 | Bug | Jika terdapat respons status 404, URI proxy lengkap disertakan dalam pesan respons. |
166356972 | Bug | Menjalankan Edge Microgateway dengan Node.js versi 12.13.x atau yang lebih baru menghasilkan error berikut saat mengeksekusi plugin yang mengubah payload permintaan: {"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}
|
168681746 | Bug | Muat ulang manual Edge Microgateway dengan redisBasedConfigCache:true
tidak berfungsi.
|
149256174 | Bug | Error plugin OAuth tidak dicatat untuk jaringan
gagal.
|
166517190 | Bug | Data jwk_public_keys tidak disimpan dan
diambil oleh Synchronizer dan disimpan di Redis.
|
141659881 | Bug | Error saat menangani sertifikat target yang tidak valid
menampilkan respons error yang menyesatkan.
|
142808699 | Bug | Plugin accesscontrol tidak menangani 'allow' dan 'tolak' bagian
dengan benar.
Microgateway kini memproses bagian tolak dengan benar dan mengikuti urutan
'izinkan' dan 'tolak' bagian. Properti |
3.1.6
Pada hari Kamis, 20 Agustus 2020, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.1.6. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.6 | 3.1.7 | 3.1.5 | 3.1.1 | 3.1.1 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
163711992 | Fitur | Opsi lokasi file kunci dan sertifikat kustom untuk perintah rotasikey.
Untuk mengetahui detail tentang opsi perintah baru ini, lihat Rotasi kunci. |
||||||||||||
154838259 | Bug | Memperbaiki rotasi kunci untuk multi-instance di beberapa pusat data
Untuk mengetahui detail tentang opsi perintah baru ini, lihat Rotasi kunci. |
||||||||||||
145525133 | Fitur alfa | Metrik plugin baru
Lihat Metrik plugin baru README di GitHub untuk mengetahui detailnya. |
||||||||||||
159396879 | Bug | Menghapus Bantuan paket yang tidak digunakan | ||||||||||||
161092943 | Bug | Validasi jalur dasar salah
Sebelum versi 3.1.6, basepath proxy dicocokkan dengan tidak benar saat basepath
tidak diakhiri dengan Berikut ini menjelaskan lebih lanjut perilaku sebelumnya (yang diperbaiki pada 3.1.6):
Misalkan proxy dikonfigurasi dengan jalur dasar:
|
||||||||||||
160431789 | Bug | Plugin Kustom - objek konfigurasi yang diteruskan ke init tidak diisi
Konfigurasi Apigee Edge tersedia di objek konfigurasi untuk semua pengguna plugin kustom setelah digabungkan dengan file konfigurasi Edge Microgateway. Lihat konfigurasi. |
||||||||||||
162758808 | Bug | Konfigurasi kuota baru untuk penyimpanan pendukung Redis
Anda dapat menggunakan konfigurasi berikut untuk menentukan penyimpanan cadangan Redis untuk kuota. Untuk mengetahui detailnya, lihat Menggunakan backing store Redis untuk mendapatkan kuota. |
3.1.5
Pada hari Jumat, 26 Juni 2020, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.1.5. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.5 | 3.1.6 | 3.1.4 | 3.1.0 | 3.1.0 |
Perbaikan bug dan peningkatan:
ID Masalah | Jenis | Deskripsi |
---|---|---|
159210507 | Fitur | Konfigurasi untuk mengecualikan pemrosesan plugin
Fitur konfigurasi baru telah ditambahkan agar melewati pemrosesan plugin untuk URL tertentu. Untuk detailnya, lihat Mengonfigurasi pengecualian URL untuk plugin. |
156986819, 158529319 | Bug | Masalah pada plugin json2xml telah diperbaiki
Masalah telah diperbaiki di mana plugin menghasilkan duplikat Header Content-Type dan header yang tidak dikirim ke target seperti yang diharapkan dalam dalam beberapa kasus. |
156560067, 159688634 | Fitur | Menggunakan nilai variabel lingkungan dalam konfigurasi Sebuah fitur telah ditambahkan yang memungkinkan Anda menentukan variabel lingkungan menggunakan tag dalam konfigurasi . Tag variabel lingkungan yang ditentukan diganti dengan lingkungan sebenarnya nilai variabel tertentu. Penggantian hanya disimpan di memori dan tidak disimpan dalam versi aslinya file konfigurasi atau cache. Untuk detailnya, lihat Menetapkan atribut konfigurasi dengan nilai variabel lingkungan. |
155077210 | Bug | Masalah pemformatan log telah diperbaiki.
Masalah telah diperbaiki saat host target muncul di log dengan tambahan titik dua yang tidak relevan IP eksternal mana pun yang ditetapkan pada instance tersebut. |
153673257 | Bug | (Khusus Edge untuk Private Cloud) Produk yang mendukung Microgateway tidak ditarik Masalah telah diperbaiki saat produk berbasis microgateway tidak ditarik. Terbitan ini ada di Edge untuk penginstalan Private Cloud saja. |
154956890, 155008028, 155829434 | Fitur | Mendukung pemfilteran produk yang didownload berdasarkan atribut khusus
Untuk mengetahui detailnya, lihat Memfilter produk berdasarkan atribut khusus |
153949764 | Bug | Masalah telah diperbaiki saat proses Edge Microgateway mengalami error saat
file tujuan log penuh
Penanganan pengecualian telah ditingkatkan untuk menjebak error dan mencetak pesan ke konsol. |
155499600 | Bug | Masalah terkait rotasi kunci dan upgrade KVM telah diperbaiki
Lihat juga Memutar kunci JWT. |
3.1.4
Pada hari Jumat, 23 April 2020, kami merilis perbaikan berikut ke Edge Microgateway.
Perbaikan bug:
Masalah dependensi pada versi 3.1.3 telah diperbaiki. Versi 3.1.3 telah ditandai sebagai tidak digunakan lagi di repositori npm. Jika tidak, semua perbaikan bug dan penyempurnaan yang dijelaskan dalam catatan rilis versi 3.1.3 berlaku untuk rilis ini.
3.1.3
Pada hari Rabu, 15 April 2020, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.1.3. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.3 | 3.1.3 | 3.1.3 | 3.0.14 | 3.0.9 |
Perbaikan bug dan peningkatan:
- 153509313 - Masalah telah diperbaiki saat modul debug Node.js mengakibatkan kebocoran memori. Masalah ini ada dalam versi v3.1.0, v3.1.1, dan 3.1.2.
- 153509313 - Masalah telah diperbaiki dengan ID pesan yang sama untuk dua transaksi yang berbeda yang dicetak di output logging.
- 151673570 - Masalah telah diperbaiki dengan Edge Microgateway tidak diperbarui untuk menggunakan API KVM Apigee. Edge Microgateway kini menggunakan perintah baru untuk menambahkan dan mengupdate nilai KVM.
- 152822846 - Dalam rilis sebelumnya, Edge Microgateway telah diperbarui sehingga pemrosesannya
pemetaan jalur resource yang cocok dengan Apigee Edge. Dalam rilis ini, masalah telah diperbaiki
yang pola
/literal_string/*
tidak ditangani dengan benar. Misalnya,/*/2/*
. Lihat juga Mengonfigurasi perilaku jalur resource '/', '/*', dan '/**'. - 152005003 - Perubahan dilakukan untuk mengaktifkan ID cakupan organisasi dan lingkungan untuk kuota.
- 152005003 - Perubahan dilakukan untuk mengaktifkan ID cakupan organisasi dan lingkungan untuk kuota. Kombinasi 'org + env + appName + productName' digunakan sebagai kuota yang sesuai.
3.1.2
Pada hari Senin, 16 Maret 2020, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.1.3. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.2 | 3.1.2 | 3.1.2 | 3.0.13 | 3.0.9 |
Perbaikan bug dan peningkatan:
- 151285018 - Peningkatan fitur dilakukan untuk menambahkan dukungan proxy HTTP untuk traffic antara Edge Microgateway dan target backend. Selain itu, masalah telah diperbaiki untuk permintaan HTTP yang ada dukungan proxy antara Edge Microgateway dan Apigee Edge. Untuk mengetahui detailnya, lihat:
- 149101890 - Kode notifikasi log untuk kasus ketika server target atau load balancer menutup koneksinya diubah dari ERROR menjadi INFO.
- 150746985 - Masalah telah diperbaiki saat perintah
edgemicro verify
tidak berfungsi dengan baik jikaredisBasedConfigCache: true
atauquotaUri: https://%s-%s.apigee.net/edgemicro-auth
ada di file konfigurasi. - 151284716 - Peningkatan yang dilakukan untuk menutup koneksi server lebih cepat ketika pekerja dimulai ulang selama proses {i>reload<i}.
- 151588764 - Mengupdate versi Node.js di image Docker yang digunakan untuk menjalankan Edge Microgateway di container Docker ke 12, karena Node.js v8 sudah tidak digunakan lagi.
- 151306049 - Pembaruan dokumentasi dilakukan untuk mencantumkan pengelolaan Apigee Edge API yang digunakan oleh perintah CLI Edge Microgateway. Lihat API pengelolaan apa yang digunakan Edge Microgateway?.
3.1.1
Pada hari Kamis, 20 Februari, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.1.1. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.1 | 3.1.1 | 3.1.1 | 3.0.13 | 3.0.9 |
Perbaikan bug dan peningkatan:
-
146069701 - Masalah telah diperbaiki dengan modul
microgateway-core
tidak mematuhi variabel lingkunganHTTP_PROXY
danHTTPS_PROXY
. Dengan perubahan ini, setelan proxy dalam file konfigurasi YAML, jika ditentukan, kini menjadi diabaikan; hanya variabel lingkungan yang digunakan untuk menentukan {i>proxy<i}.Jika Anda ingin menentukan konfigurasi proxy dalam file konfigurasi, Anda juga harus menentukan variabel
HTTP_PROXY
yang menyebutkan URL proxy yang sama dengan yang ditentukan di file konfigurasi. Misalnya, jika Anda menentukan konfigurasi berikut:edge_config: proxy: http://10.128.0.20:3128 proxy_tunnel: true
Anda juga harus menentukan variabel lingkungan ini:
HTTP_PROXY=http://10.128.0.20:3128
- 146320620 - Parameter konfigurasi baru,
edgemicro.headers_timeout
, telah ditambahkan. Atribut ini membatasi jumlah waktu (dalam milidetik) waktu tunggu parser HTTP untuk menerima header HTTP lengkap. Contoh:edgemicro: keep_alive_timeout: 6000 headers_timeout: 12000
Secara internal, parameter ini menetapkan Node.js
Server.headersTimeout
pada permintaan. (Default: 5 detik lebih lama dari waktu yang disetel denganedgemicro.keep_alive_timeout
. Default ini mencegah load balancer atau proxy secara salah menghentikan koneksi.) 149278885 - Fitur baru telah ditambahkan yang memungkinkan Anda untuk mengatur waktu tunggu API target pada Level proxy API sebagai ganti menggunakan satu setelan waktu tunggu global.
Jika Anda menetapkan properti TargetEndpoint
io.timeout.millis
di proxy API, Edge Microgateway akan dapat mengambil properti itu dan menerapkan target waktu tunggu khusus endpoint. Jika parameter ini tidak diterapkan, Edge Microgateway akan menggunakan waktu tunggu global yang ditentukan denganedgemicro.request_timeout
.
3.1.0
Pada hari Selasa, 21 Januari, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.1.0. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.1.0 | 3.1.0 | 3.1.0 | 3.0.12 | 3.0.9 |
Perbaikan bug dan peningkatan:
-
144187500 - Peristiwa level WARN baru akan dicatat dalam log saat tanda
quotas.failOpen
dipicu. Tanda ini dipicu jika terjadi error pemrosesan kuota atau jika "kuota berlaku" minta ke Edge gagal memperbarui penghitung kuota jarak jauh. Dalam hal ini, kuota akan diproses berdasarkan pada jumlah lokal hanya sampai sinkronisasi kuota jarak jauh berikutnya berhasil. Sebelumnya, cara ini peristiwa hanya dicatat ke dalam log saat tingkat log ditetapkan ke DEBUG.Contoh:
2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][] [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60] [GET][][][][]
- 145023519 - Masalah telah diperbaiki jika transaksi yang sedang berlangsung atau transaksi baru terpengaruh setiap kali Edge Microgateway mendeteksi perubahan pada proxy API. Sekarang, ketika perubahan dilakukan pada {i>proxy<i}, Edge Microgateway memuat ulang cache dan node pekerja dimulai ulang. Dengan perubahan ini, transaksi yang sedang berlangsung dan panggilan API baru yang dikirim ke microgateway tidak terdampak.
- 146378327 - Level log
sourceRequest
,targetRequest
, dantargetResponse
telah diubah ke tingkat INFO. - 146019878 - Perbedaan antara latensi yang dihitung untuk "Performa Proxy API" di analisis Edge dan peristiwa log sourceResponse/targetResponse Edge Microgateway telah diperbaiki. Sekarang, latensi dalam analisis Edge dan peristiwa log Microgateway sudah selaras.
- Perubahan terkait logika pencocokan pola:
- 147027862 - Plugin oauth telah diperbarui untuk mendukung jalur resource berikut
pola yang cocok seperti yang ditetapkan dalam Produk API:
/{literal}**
/{literal}*
- Kombinasi dari dua pola di atas
Dengan perubahan ini, plugin Edge Microgateway kini mengikuti hal yang sama pencocokan pola dengan Apigee Edge, sebagaimana dijelaskan dalam Mengonfigurasi perilaku resource jalur '/', '/*', dan '/**'.
- 145644205 - Memperbarui logika pencocokan pola plugin apiKeys agar cocok dengan plugin oauth.
- 147027862 - Plugin oauth telah diperbarui untuk mendukung jalur resource berikut
pola yang cocok seperti yang ditetapkan dalam Produk API:
- 143488312 - Masalah telah diperbaiki dengan spasi di awal atau di akhir client ID telah diperbaiki menyebabkan pembuatan daftar produk JWT kosong untuk token OAuth dan Permintaan kunci API.
- 145640807 dan 147579179 - Fitur baru telah ditambahkan yang memungkinkan Edge Microgateway khusus
yang disebut "sinkronisasi" untuk mengambil data konfigurasi dari Apigee Edge dan menulisnya
ke database Redis lokal. Instance microgateway lainnya kemudian
dapat dikonfigurasi untuk membaca
konfigurasi data dari {i>database<i}. Fitur ini menambahkan tingkat ketahanan pada Edge Microgateway.
Memungkinkan instance microgateway untuk memulai dan berfungsi tanpa perlu berkomunikasi dengan
Apigee Edge. Untuk mengetahui detailnya, lihat
Menggunakan sinkronisasi.
Fitur sinkronisasi saat ini didukung untuk berfungsi dengan Redis 5.0.x.
Versi 3.0.x
Perbaikan bug dan peningkatan v.3.0.x
3.0.10
Pada hari Jumat, 8 November, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.0.10. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.0.10 | 3.0.8 | 3.0.8 | 3.0.11 | 3.0.8 |
Perbaikan bug dan peningkatan:
-
142677575 - Pembaruan fitur sehingga pola cocok untuk jalur sumber daya yang digunakan dalam produk API untuk Edge Microgateway kini selaras dengan pencocokan pola jalur resource yang digunakan Apigee Edge, seperti yang dijelaskan di Mengonfigurasi perilaku jalur resource '/', '/*', dan '/**'.
Catatan: Jika menggunakan pola resource gabungan seperti
/*/2/**
, Anda harus memastikan bahwa proxyedgemicro_auth
ditambahkan ke produk API mandiri. Kemudian, Anda harus menyertakan produk itu dalam Aplikasi Developer proxy, seperti yang digambarkan dalam screenshot berikut:Catatan: Properti konfigurasi
features.isSingleForwardSlashBlockingEnabled
, seperti yang dijelaskan di Mengonfigurasi perilaku jalur resource '/', '/*', dan '/**' tidak didukung untuk Edge Microgateway. 143740696 - Struktur konfigurasi
quotas
telah berubah (lihat juga catatan rilis untuk versi 3.0.9).quotas
digunakan untuk mengonfigurasi plugin kuota. Perubahan struktur dilakukan untuk memperbaiki kejelasan elemen konfigurasi. Untuk mengonfigurasi plugin kuota, gunakan konfigurasi YAML berikut. Perhatikan bahwa properti konfigurasi disebutquotas
. Untuk mengetahui detail tentang konfigurasiquotas
individual properti, lihat Opsi konfigurasi untuk kuota.edgemicro: home: ../gateway port: 8000 max_connections: -1 max_connections_hard: -1 logging: level: info dir: /var/tmp stats_log_interval: 60 plugins: dir: ../plugins sequence: - oauth - quota quotas: bufferSize: hour: 20000 minute: 500 default: 10000 useDebugMpId: true failOpen: true ...
- 141750056 - Fitur baru telah ditambahkan agar Anda dapat menggunakan Redis sebagai kuota
menyimpan cadangan data.
Jika
useRedis
benar, maka yang digunakan untuk modul volos-quota-redis. Jika true (benar), kuota dibatasi hanya untuk instance Edge Microgateway yang dan terhubung ke Redis. Jika salah, atribut volos-quota-apigee digunakan sebagai penyimpanan pendukung, dan penghitung kuota bersifat global. Untuk mengetahui detailnya, lihat Opsi konfigurasi untuk kuota. Contoh:edgemicro: ... quotas: useRedis: true redisHost: localhost redisPort: 6379 redisDb: 1
- 140574210 - Waktu habis masa berlaku default untuk token yang dihasilkan oleh
edgemicro-auth
proxy telah diubah dari 108000 milidetik (1,8 menit) menjadi 1800 detik (30 menit). - 143551282 - Untuk mendukung organisasi yang mendukung SAML, perintah
edgemicro genkeys
memiliki telah diperbarui untuk menyertakan parameter‑‑token
. Parameter ini memungkinkan Anda menggunakan Token OAuth untuk autentikasi, bukan nama pengguna/sandi. Untuk detailnya, lihat Membuat kunci.
3.0.9
Pada hari Jumat, 11 Oktober, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.0.9. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.0.9 | 3.0.7 | 3.0.7 | 3.0.10 | 3.0.7 |
Perbaikan bug dan peningkatan:
- 141989374 - "fail open" baru telah ditambahkan untuk plugin kuota.
Saat fitur ini diaktifkan, jika terjadi error pemrosesan kuota
atau jika "kuota berlaku" permintaan ke Edge gagal memperbarui penghitung kuota jarak jauh, kuota
akan diproses berdasarkan jumlah lokal hanya hingga kuota jarak jauh berikutnya berhasil
sinkronisasi akan terjadi. Dalam kedua kasus ini, flag
quota-failed-open
disetel di objek permintaan.Untuk mengaktifkan kuota "gagal dibuka" , setel konfigurasi berikut:
quotas : failOpen : true
Catatan: Selain itu, nama tanda objek permintaan
fail-open
plugin OAuth telah diubah menjadioauth-failed-open
. - 142093764 - Perubahan konfigurasi dilakukan pada proxy
edgemicro-auth
agar tidak melebihi kuota. Perubahannya adalah mengatur jenis kuota ke kalender. Untuk menggunakan peningkatan ini, Anda harus memperbaruiedgemicro-auth
Anda ke versi 3.0.7 atau yang lebih tinggi. - 142520568 - Fitur baru telah ditambahkan untuk mengaktifkan pencatatan MP
ID (pemroses pesan)
dalam respons kuota. Untuk menggunakan fitur ini, Anda harus mengupdate
proxy
edgemicro-auth
Anda ke versi 3.0.7 atau yang lebih tinggi dan setel konfigurasi berikut:quotas: useDebugMpId: true
Jika
useDebugMpId
disetel, respons kuota dari Edge akan berisi ID MP dan akan dicatat oleh Edge Microgateway. Contoh:{ "allowed": 20, "used": 3, "exceeded": 0, "available": 17, "expiryTime": 1570748640000, "timestamp": 1570748580323, "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a" }
3.0.8
Pada hari Kamis, 26 September, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.0.8. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.0.8 | 3.0.6 | 3.0.6 | 3.0.9 | 3.0.6 |
Perbaikan bug dan peningkatan:
- 140025210 - Suatu "fail open" baru fitur telah ditambahkan. Dengan fitur ini, pemrosesan API dapat dilanjutkan jika
token JWT yang kedaluwarsa tidak dapat
dimuat ulang karena kesalahan koneksi yang mencegah
panggilan verifikasi kunci API yang berhasil ke proxy
edgemicro-auth
.Fitur ini memungkinkan Anda menyetel masa tenggang tempat token lama tetap tersimpan di cache dan digunakan kembali hingga masa tenggang berakhir. Fitur ini memungkinkan Edge Microgateway untuk melanjutkan pemrosesan permintaan jika terjadi kegagalan koneksi sementara. Kapan konektivitas dilanjutkan, dan panggilan Verify API Key berhasil, JWT baru diambil dan menggantikan JWT lama di cache.
Untuk mengonfigurasi "gagal buka" baru , lakukan hal berikut:
- Tetapkan properti berikut dalam stanza
oauth
di Edge Microgateway file konfigurasi:oauth: failOpen: true failopenGraceInterval: time_in_seconds cacheKey: true ...
Contoh:
oauth: failOpen: true failopenGraceInterval: 5 cacheKey: true ...
Dalam contoh ini, token lama akan digunakan selama 5 detik jika tidak dapat dimuat ulang karena masalah konektivitas. Setelah 5 detik, error autentikasi akan ditampilkan.
- Tetapkan properti berikut dalam stanza
- 141168968 - Pembaruan dibuat untuk menyertakan
correlation_id
di semua output log plugin. Selain itu, level log untuk beberapa log diubah menjadierror
sesuai kebutuhan. - 140193349 - Pembaruan dilakukan pada proxy
edgemicro-auth
untuk mewajibkan Edge Microgateway kunci dan rahasia yang akan diverifikasi pada setiap permintaan Verifikasi Kunci API. Edge Microgateway telah diupdate agar selalu mengirim kunci dan rahasia pada setiap permintaan Verifikasi Kunci API. Perubahan ini mencegah klien mendapatkan JWT hanya dengan kunci API. - 140090250 - Update dilakukan untuk menambahkan logging diagnostik untuk pemrosesan kuota. Dengan ini , sekarang kita dapat mengkorelasikan {i>output<i} log quoto dengan sisa Edge Microgateway log.
3.0.7
Pada hari Kamis, 12 September, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Versi komponen:
Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan dengan Edge Microgateway 3.0.7. Perhatikan bahwa karena setiap komponen adalah proyek terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:
microgateway | core | konfigurasi | plugin | edgeauth |
---|---|---|---|---|
3.0.7 | 3.0.5 | 3.0.5 | 3.0.8 | 3.0.5 |
Perbaikan bug dan peningkatan:
140075602 - Pembaruan dilakukan pada plugin OAuth untuk menampilkan kode status 5xx dengan yang sesuai. Sebelumnya, plugin hanya mengembalikan kode status 4xx di semua bukan 200 kasus. Untuk setiap respons pesan yang bukan berstatus 200, Kode 4xx atau 5xx akan ditampilkan, tergantung pada error-nya.
Fitur ini dinonaktifkan secara default. Untuk mengaktifkan fitur ini, tambahkan
oauth.useUpstreamResponse: true
ke konfigurasi Edge Microgateway Anda. Contoh:oauth: allowNoAuthorization: false allowInvalidAuthorization: false gracePeriod: 10 useUpstreamResponse: true
- 140090623 - Dalam rilis 3.0.6, properti konfigurasi baru telah ditambahkan,
quota.quotaUri
. Tetapkan properti konfigurasi ini jika Anda ingin mengelola kuota melaluiedgemicro-auth
yang di-deploy ke organisasi Anda. Jika properti ini tidak ditetapkan, endpoint kuota secara default ke endpoint Edge Microgateway internal. Contoh:edge_config: quotaUri: https://%s-%s.apigee.net/edgemicro-auth
Dalam rilis 3.0.7,
edgemicro-auth
telah diupdate agar dapat menerima konfigurasi Anda. Untuk menggunakan propertiquotaUri
, Anda harus mengupgrade ke proxyedgemicro-auth
terbaru. Untuk detailnya, lihat Mengupgrade edgemicro-auth {i>proxy<i}. - 140470888 - Header Otorisasi telah ditambahkan
ke panggilan kuota untuk memberikan otentikasi.
Selain itu, proxy
edgemicro-auth
telah diubah untuk menghapus "organisasi" dari ID kuota. Karena titik akhir kuota berada di organisasi pelanggan, ID kuota tidak lagi diperlukan. - 140823165 - Nama properti berikut:
edgemicro: keepAliveTimeout
didokumentasikan dengan tidak benar dalam rilis 3.0.6. Nama properti yang benar adalah:
edgemicro: keep_alive_timeout
- 139526406 - Bug telah diperbaiki, ketika jumlah kuota yang salah terjadi jika aplikasi developer memiliki beberapa produk. Kuota sekarang diterapkan dengan benar untuk setiap produk dalam aplikasi yang memiliki beberapa produk. Kombinasi 'appName + productName' digunakan sebagai ID kuota.
3.0.6
Pada hari Kamis, 29 Agustus, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
- 138633700 - Menambahkan properti konfigurasi baru,
keepAliveTimeout
. Properti ini memungkinkan Anda untuk menyetel waktu tunggu Edge Microgateway (dalam milidetik). (Default: 5.000 milidetik)Contoh:
edgemicro: keep_alive_timeout: 600
- 140090623 - Menambahkan properti konfigurasi baru,
quotaUri
. Tetapkan konfigurasi ini jika Anda ingin mengelola kuota melalui proxyedgemicro-auth
yang yang di-deploy ke organisasi Anda. Jika properti ini tidak disetel, endpoint kuota ditetapkan secara default ke endpoint Edge Microgateway internal. Contoh:edge_config: quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
Untuk menggunakan fitur ini, Anda harus terlebih dahulu men-deploy versi terbaru Proxy
edgemicro-auth
ke organisasi Anda. Untuk mengetahui detailnya, lihat Mengupgrade proxy edgemicro-auth. - 138722809 - Menambahkan properti konfigurasi baru,
stack_trace
. Properti ini memungkinkan Anda untuk mengontrol apakah tidak memunculkan pelacakan tumpukan di file log. Contoh:stack_trace: false
Jika
stack_trace
disetel ketrue
, pelacakan tumpukan akan dicetak dalam log. Jika disetel kefalse
, stack pelacakan tidak akan dicetak dalam log.
3.0.5
Pada hari Kamis, 15 Agustus, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Bug diperbaiki- 139005279 - Masalah telah diperbaiki sehingga perintah
edgemicro status
tidak ditampilkan jumlah proses pekerja yang tepat. - 138437710 - Masalah telah diperbaiki di class ExitCounter yang mencegah error log agar tidak ditulis.
- 139064652 - Menambahkan kemampuan untuk menambahkan level logging
trace
dandebug
untuk peristiwa dan log sistem. Untuk saat ini, hanya kemampuan untuk menambahkan level log ini yang ditambahkan. Saat ini, level log yang tersedia adalahinfo
,warn
, danerror
. - 139064616 - Output log telah distandarisasi untuk semua laporan log konsol. Konsol laporan log kini menyertakan atribut berikut:
- Stempel waktu
- Nama komponen
- ID proses
- Pesan log konsol
- 138413755 - Meningkatkan kunci JWT dan pesan log terkait rahasia untuk CLI ini berbagai perintah: sertifikat, verifikasi, upgradekvm, token, genkeys, Capturekeys, rotasikey, dan konfigurasi.
- 138413577 - Menambahkan dan meningkatkan penanganan error untuk waktu tunggu layanan backend.
- 138413303 - Menambahkan dan meningkatkan penanganan error untuk waktu tunggu respons dan soket.
- 138414116 - Menambahkan dan meningkatkan penanganan error untuk "koneksi ditolak" yang sama.
3.0.4
Pada hari Kamis, 1 Agustus, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
- 134445926 - Peningkatan autentikasi Edge Microgateway internal.
- 137582169 - Mengatasi masalah saat memulai proses yang tidak diinginkan. Proses ekstra menyebabkan plugin dimuat ulang dan menggunakan memori secara berlebihan. Edge Microgateway kini mempertahankan jumlah proses dalam batas yang diharapkan.
- 137768774 - Peningkatan pesan log:
- Membersihkan log transaksi (permintaan).
- Menambahkan lebih banyak pesan log jika diperlukan.
- Memindahkan pesan log transaksi (permintaan) dari output konsol ke pesan yang relevan file log.
- Memperbarui log konsol untuk menggunakan fungsi logging terpusat.
- 138321133, 138320563 - Perubahan internal dasar pada penyangga kuota untuk mengaktifkan peningkatan kuota di masa mendatang.
3.0.3
Pada hari Selasa, 23 Juli, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
- Peningkatan logging: Log runtime yang ada menggunakan
Fungsi
eventLog()
yang mengambil dan mencatat data runtime secara konsisten format font. Info log mencakup:- Stempel waktu (ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ).
- Level log (error, peringatan, atau info).
- Nama host - Nama host yang meminta dari header permintaan.
- ID Proses - Jika Anda menjalankan cluster proses Node.js, ini adalah ID proses tempat pencatatan log terjadi.
- Nama organisasi Apigee.
- Nama lingkungan di organisasi.
- Nama proxy API.
- Alamat IP klien.
- IDklien.
- ID Korelasi (saat ini belum ditetapkan).
- Nama komponen Edge Microgateway.
- Pesan khusus - Beberapa objek mungkin mencetak informasi tambahan yang diteruskan ke properti error ini.
- Metode permintaan (jika ada permintaan HTTP).
- Kode status respons (jika ada permintaan HTTP).
- Pesan error.
- Kode error - Jika sebuah objek berisi kode error, objek tersebut akan dicetak di properti ini.
- Waktu yang diperlukan.
- Sistem operasi penanda akhir garis.
Nilai properti null menghasilkan tanda kurung kosong,
[]
.Contoh berikut menunjukkan format log:
Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]
(137770055)
- Performa: Produk API tidak difilter berdasarkan lingkungan. Terbitan ini telah diperbaiki. (135038879)
- Beragam integrasi pengujian fungsional dan peningkatan kualitas kode.
3.0.2
Pada hari Rabu, 3 Juli 2019, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
Kualitas kode - Kode telah ditinjau kualitas dan perubahan kode telah dilakukan untuk
memenuhi standar kualitas
yang diminta oleh pengguna. Kami telah mengatasi error dan peringatan kualitas kode
yang berasal dari JSHint.
Sebagai hasilnya, beberapa error kode yang sebenarnya diidentifikasi dan diperbaiki. Semua Microgateway Apigee Edge
menjalani proses ini. Lihat commit pada 28 Juni dan 2 Juli untuk
microgateway-config
,
microgateway-core
,
microgateway-plugins
,dan
microgateway
.
Semua modul dengan perubahan kualitas kode telah diuji dengan alat internal yang memverifikasi
dan eksekusi Edge Microgateway untuk kasus penggunaan pelanggan.
3.0.1
Pada hari Jumat, 21 Juni 2019, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.
- 134834551 - Mengubah versi Node.js yang didukung untuk Edge Microgateway
(Versi yang didukung Node.js: 8 dan 12; versi 7, 9, dan 11 bersifat eksperimental) - 134751883 - Edge Microgateway error saat memuat ulang dengan beban
- 134518428 - Endpoint produk untuk Edge Microgateway menampilkan 5XX jika pola filternya salah
- 135113408 - Pekerja harus memulai ulang jika mereka berhenti secara tidak terduga
- 134945852 - tokenCacheSize tidak digunakan di plugin OAuth
- 134947757 - menyetel cacheTTL di plugin oauth
- 135445171 - Penghitungan masa tenggang di OAuth salah
- Gunakan modul memo yang disediakan dengan penginstalan Edge Microgateway
- 135367906 - Audit keamanan
Versi 2.5.x
Fitur dan peningkatan baru v.2.5.x
(Tetap 2.5.38, 06/07/2019)
JWT yang tidak diformat dengan benar dapat menyebabkan pekerja mengalami error saat menggunakan cache token. Diperbaiki di Edge modul microgateway-plugins. (b/134672029)
(Ditambahkan 2.5.37) Tambahkan opsi CLI edgemicro-cert -t
.
Opsi edgemicro cert -t
memungkinkan Anda menentukan token OAuth untuk
mengotentikasi API pengelolaan. Lihat juga Mengelola sertifikat.
(Menambahkan 2.5.35) Menambahkan dukungan untuk men-debug Edge Microgateway menggunakan edgemicroctl
.
Anda dapat menggunakan tanda mgdebug
dengan edgemicroctl
. Lihat juga
Tugas integrasi Kubernetes.
(Ditambahkan 2.5.35) Mengaktifkan build Windows untuk edgemicroctl
.
(Ditambahkan 2.5.31) API edgemicro-auth/token baru
API edgemicro-auth/token baru telah ditambahkan, yang memungkinkan Anda meneruskan klien/rahasia sebagai API yang Dienkode Base64 Header Otorisasi Dasar dan Grants_type sebagai parameter formulir. Lihat Mendapatkan token pemilik secara langsung.
(Tetap 2.5.31) Konfigurasi pribadi tidak mematuhi flag token
Masalah telah diperbaiki saat mengonfigurasi Edge Microgateway agar menggunakan token akses OAuth2 di Edge untuk Private Cloud tidak berfungsi dengan baik (token tidak dipatuhi).
Docker: Dukungan untuk menggunakan sertifikat yang ditandatangani sendiri
(Ditambahkan 2.5.29) Jika Anda menggunakan Certificate Authority (CA) yang tidak dipercaya secara default oleh
Pada Node.js, Anda dapat menggunakan parameter NODE_EXTRA_CA_CERTS
saat menjalankan container Docker
dengan Edge Microgateway.
Untuk mengetahui detailnya, lihat Menggunakan CA yang tidak dipercaya oleh Node.js.
Docker: Dukungan untuk TLS
(Ditambahkan 2.5.29) Edge Microgateway yang berjalan dalam container Docker sekarang mendukung TLS untuk permintaan ke server Edge Microgateway (permintaan menuju utara) dan untuk permintaan keluar dari Edge Microgateway ke aplikasi target (permintaan ke arah selatan).
Contoh berikut menjelaskan secara mendetail cara menyiapkan konfigurasi TLS ini:
Dalam contoh ini, Anda akan melihat cara menggunakan titik pemasangan container /opt/apigee/.edgemicro
untuk memuat
sertifikat, yang selanjutnya dirujuk
di file konfigurasi Edge Microgateway.
Docker: Dukungan untuk permintaan proxy
(Ditambahkan 2.5.27) Jika Anda menjalankan Edge Microgateway dalam container Docker, Anda dapat menggunakan opsi ini untuk mengontrol proxy saat microgateway berjalan di belakang firewall:
HTTP_PROXY
HTTPS_PROXY
NO_PROXY
Untuk mengetahui detailnya, lihat Menjalankan Edge Micro sebagai container Docker.
Docker: Petunjuk plugin yang diperbarui
(Ditambahkan 2.5.27) Jika Anda menjalankan Edge Microgateway dalam container Docker, sekarang Anda memiliki dua opsi untuk agar dapat men-deploy plugin. Salah satu opsi yang baru adalah menggunakan titik pemasangan Docker. Opsi lain ada sebelumnya, pada dasarnya tidak berubah; namun, Dockerfile telah diperbarui. Untuk detailnya, lihat link berikut:
- Opsi A: Memasang direktori plugin pada volume (Baru)
- Opsi B: Membangun plugin ke dalam container (Diperbarui)
Dukungan token OAuth baru untuk perintah upgrade KVM
(Ditambahkan 2.5.27) Anda dapat menggunakan token OAuth dengan perintah upgradekvm
. Untuk mengetahui detailnya, lihat
Mengupgrade KVM.
Memisahkan API di Analisis Edge
(Ditambahkan 2.5.26) Tanda plugin analisis baru memungkinkan Anda memisahkan jalur API tertentu sehingga muncul sebagai {i>proxy<i} terpisah di dasbor Edge Analytics. Misalnya, Anda dapat memisahkan API health check untuk menghindari kebingungan dengan panggilan API yang sebenarnya. Untuk informasi selengkapnya, lihat Mengecualikan jalur dari analisis.
Mengonfigurasi proxy lokal
(Ditambahkan 2.5.25) Dengan {i>proxy<i} lokal, Anda tidak perlu membuat proxy berbasis microgateway secara manual di Apigee Edge. Sebagai gantinya, microgateway akan menggunakan jalur dasar proxy lokal. Untuk mengetahui informasi selengkapnya, lihat Menggunakan mode proxy lokal.
Menggunakan mode mandiri
(Ditambahkan 2.5.25) Anda dapat menjalankan Edge Microgateway terputus sepenuhnya dari Dependensi Apigee Edge. Skenario ini, disebut mode mandiri, memungkinkan Anda menjalankan dan menguji Edge Microgateway tanpa koneksi internet., lihat Menjalankan Edge Microgateway dalam mode mandiri.
Mencabut kunci
(Ditambahkan 2.5.19) Perintah CLI baru telah ditambahkan yang mencabut kredensial kunci dan rahasia untuk sebuah Konfigurasi Edge Microgateway.
edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]
Dukungan Docker
(Ditambahkan 2.5.19) Sekarang Anda dapat mendownload rilis Edge Microgateway terbaru sebagai image Docker:
docker pull gcr.io/apigee-microgateway/edgemicro:latest
Dukungan Kubernetes
(Ditambahkan 2.5.19) Anda dapat men-deploy Edge Microgateway sebagai layanan atau sebagai gateway file sespan di depan layanan yang di-deploy di cluster Kubernetes. Lihat: Ringkasan Mengintegrasikan Edge Microgateway dengan Kubernetes.
Dukungan untuk opsi tanpa penundaan TCP
(Ditambahkan 2.5.16) Setelan konfigurasi baru, nodelay
, telah ditambahkan ke konfigurasi Edge Micro.
Secara default koneksi TCP menggunakan Nagle
algoritme untuk mem-buffer data sebelum mengirimnya. Menyetel nodelay
ke true
,
menonaktifkan perilaku ini (data akan langsung mematikan data setiap kali
socket.write()
dipanggil). Lihat juga Node.js
untuk detail selengkapnya.
Untuk mengaktifkan nodelay
, edit file konfigurasi Edge Micro sebagai berikut:
edgemicro: nodelay: true port: 8000 max_connections: 1000 config_change_poll_interval: 600 logging: level: error dir: /var/tmp stats_log_interval: 60 rotate_interval: 24
Opsi CLI baru untuk pemantauan Forever
(Ditambahkan 2.5.12) Parameter baru telah ditambahkan ke perintah edgemicro forever
. Parameter ini memungkinkan Anda
menentukan lokasi file forever.json
, dan memungkinkan Anda memulai atau menghentikan Forever
proses latar belakang. Lihat juga Pemantauan selamanya
Parameter | Deskripsi |
---|---|
-f, --file | Menentukan lokasi file forever.json . |
-a, --action | Berupa start atau stop . Defaultnya adalah start. |
Contoh:
Untuk memulai Selamanya:
edgemicro forever -f ~/mydir/forever.json -a start
Untuk menghentikan Selamanya:
edgemicro forever -a stop
Rotasi kunci JWT
Fitur baru yang ditambahkan yang memungkinkan Anda merotasi pasangan kunci publik/pribadi yang digunakan untuk membuat token JWT yang digunakan untuk keamanan OAuth di Edge Microgateway. Lihat Memutar kunci JWT.
Memfilter proxy API yang didownload
Secara default, Edge Microgateway mendownload semua proxy di organisasi Edge Anda yang diawali dengan awalan nama "edgemicro_". Anda dapat mengubah setelan default ini untuk mendownload proxy yang namanya memiliki pola yang sama. Lihat Memfilter proxy yang didownload.
Menentukan produk tanpa proxy API
Di Apigee Edge, Anda dapat membuat produk API yang tidak berisi proxy API apa pun. Konfigurasi produk ini memungkinkan kunci API yang terkait dengan produk tersebut untuk berfungsi dengan yang di-deploy di organisasi Anda. Mulai versi 2.5.4, Edge Microgateway mendukung produk ini konfigurasi Anda.
Dukungan untuk pemantauan selamanya
Edge Microgateway memiliki file forever.json
yang dapat Anda konfigurasi
mengontrol berapa kali dan dengan interval apa Edge Microgateway harus dimulai ulang. File ini
mengonfigurasi layanan yang disebut always-monitor, yang mengelola Forever secara terprogram. Lihat
Pemantauan selamanya.
Pengelolaan terpusat file konfigurasi Edge Micro
Jika Anda menjalankan beberapa instance Edge Microgateway, Anda mungkin ingin mengelola konfigurasi jaringan dari satu lokasi. Anda dapat melakukannya dengan menentukan endpoint HTTP di mana Edge Micro dapat mendownload file konfigurasinya. Lihat Menentukan endpoint file konfigurasi.
Dukungan untuk opsi CLI selamanya
(Ditambahkan 2.5.8) Gunakan perintah edgemicro forever [package.json]
untuk menentukan
lokasi file forever.json
. Sebelum penambahan perintah ini,
file tersebut harus berada di direktori {i>
root <i}Edge Microgateway.
Contoh:
edgemicro forever ~/mydir/forever.json
Penambahan opsi configUrl untuk memuat ulang perintah
(Ditambahkan 2.5.8) Anda sekarang dapat menggunakan opsi --configUrl
atau -u
dengan
Perintah edgemicro reload
.
Masa tenggang untuk perbedaan waktu JWT
(Ditambahkan 2.5.7) Atribut gracePeriod dalam konfigurasi OAuth membantu mencegah error disebabkan oleh sedikit perbedaan antara jam sistem dan Not Before (nbf) atau Diterbitkan (iat) kali yang ditentukan dalam token otorisasi JWT. Tetapkan atribut ini ke jumlah detik untuk mencegah perbedaan tersebut. Lihat Atribut OAuth.
(Ditambahkan 2.5.7) Atribut gracePeriod dalam konfigurasi OAuth membantu mencegah error disebabkan oleh sedikit perbedaan antara jam sistem dan Not Before (nbf) atau Diterbitkan (iat) kali yang ditentukan dalam token otorisasi JWT. Tetapkan atribut ini ke jumlah detik untuk mencegah perbedaan tersebut. Lihat Atribut OAuth.
Perbaikan bug v2.5.x
- (Masalah #236) Memperbaiki kesalahan ketik saat menghapus cache.
- (Masalah #234) Memuat ulang mogok untuk Edge Microgateway 2.5.35.
- (Masalah #135) Referensi host virtual "aman" tidak valid error saat menggunakan -v. Perbaikan ini mengubah proxy edgemicro-auth sebelum di-deploy ke memastikan {i>host<i} virtual sama persis dengan apa yang ditetapkan dalam tanda "-v" penanda. Selain itu, Anda dapat menentukan berapa pun nomor dan nama apa pun untuk {i>host<i} virtual (tidak lagi terbatas pada secara default dan aman).
- (Masalah #141) Perintah edgemicro reload tidak mendukung opsi file konfigurasi -c. Masalah ini sudah teratasi.
- (Masalah #142) Edge Microgateway mengeluhkan kripto yang tidak digunakan lagi pada waktu penginstalan. Masalah ini sudah teratasi.
- (Masalah #145) Kuota tidak berfungsi dengan Edge Microgateway. Masalah ini sudah teratasi.
- (Masalah Komunitas Apigee: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) Token JWT divalidasi terhadap Proxy API dan URI Resource di OAUTH. Isu ini telah diperbaiki.
- (Masalah Komunitas Apigee: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway tidak berfungsi dengan OAuth. Masalah ini sudah teratasi.
- Memperbaiki pidPath di Windows.
- (Masalah #157) Masalah yang menyebabkan pesan error berikut telah diperbaiki:
ReferenceError: deployProxyWithPassword
tidak ditetapkan. - (Masalah #169) Memperbarui dependensi Node.js (audit npm)
- Proxy
edgemicro-auth
sekarang menggunakan kebijakan Edge JWT. {i>Proxy<i} tidak lagi bergantung pada Node.js untuk menyediakan dukungan JWT.
Versi 2.4.x
Fitur dan peningkatan baru v.2.4.x
1. Menetapkan alias kustom untuk proxy edgemicro-auth (PR 116)
Anda dapat mengubah jalur basis default untuk proxy edgemicro-auth. Secara {i>default<i}, jalur dasarnya adalah /edgemicro-auth. Untuk mengubahnya, gunakan flag -x di perintah edgemicro konfigurasi.
Contoh:
edgemicro configure -x /mypath …
2. Dukungan karakter pengganti untuk jalur dasar (PR 77)
Anda dapat menggunakan satu atau beberapa "*" {i>wildcard <i}di jalur dasar suatu edgemicro_*. Misalnya, jalur dasar /team/*/members memungkinkan klien untuk memanggil https://[host]/team/blue/members dan https://[host]/team/green/members tanpa perlu membuat proxy API baru untuk mendukung tim baru. Perhatikan bahwa /**/ bukan didukung.
Penting: Apigee TIDAK mendukung penggunaan karakter pengganti "*" sebagai elemen pertama dari jalur dasar. Misalnya, ini TIDAK didukung: /*/search.3. Jalur konfigurasi kustom ditambahkan ke CLI untuk konfigurasi Private Cloud (PR 99)
Secara default, file konfigurasi microgateway berada di ./config/config.yaml. Pada perintah init, Configure, dan start, Anda kini dapat menentukan jalur konfigurasi kustom command line menggunakan flag -c atau --configDir. Memperbaiki masalah yang tidak memiliki direktori konfigurasi kustom untuk penginstalan Private Cloud.
Contoh:
edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config
4. Hormati variabel *_PROXY (PR 61)
Jika Edge Microgateway diinstal di belakang firewall dan tidak dapat berkomunikasi dengan Apigee Edge di cloud publik, ada dua opsi yang perlu dipertimbangkan:
Opsi 1:
Opsi pertama adalah menetapkan opsi edgemicro: proxy_tunnel ke true di microgateway file konfigurasi:
edge_config: proxy: http://10.224.16.85:3128 proxy_tunnel: true
Jika proxy_tunnel bernilai true, Edge Microgateway menggunakan HTTP Metode CONNECT untuk melakukan tunnel permintaan HTTP melalui koneksi TCP tunggal. (Hal yang sama berlaku jika variabel lingkungan untuk mengonfigurasi proxy adalah TLS diaktifkan).
Opsi 2:
Opsi kedua adalah menentukan proxy dan menetapkan proxy_tunnel ke false di file konfigurasi microgateway. Contoh:
edge_config: proxy: http://10.224.16.85:3128 proxy_tunnel: false
Dalam kasus ini, Anda dapat menetapkan variabel berikut untuk mengontrol host bagi setiap proxy HTTP yang ingin Anda gunakan, atau host mana yang tidak boleh menangani proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXY, dan NO_PROXY. Anda dapat tetapkan NO_PROXY sebagai daftar domain yang dibatasi koma yang harus dimiliki Edge Microgateway bukan ke {i>proxy<i}. Contoh:
export HTTP_PROXY='http://localhost:3786' export HTTPS_PROXY='https://localhost:3786'
Untuk informasi selengkapnya tentang variabel ini, lihat:
https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables
5. Menetapkan waktu tunggu kustom untuk permintaan target (PR 57)
Anda dapat menetapkan waktu tunggu kustom untuk permintaan target dengan konfigurasi ini:
edgemicro: request_timeout: 10
Waktu tunggu disetel dalam detik. Jika waktu tunggu habis, Edge Microgateway merespons dengan 504 kode status.
6. Menghormati pesan status HTTP khusus pada respons target (PR) 53)
Edge Microgateway mematuhi pesan status HTTP khusus yang ditetapkan pada respons target. Dalam rilis sebelumnya, pesan status yang dikirim dari target diganti dengan Node.js secara default.
7. {i>Header<i} X-Forwarded-For dapat mengatur klien_ip untuk analisis
Jika ada, header X-Forwarded-For akan menyetel client_ip yang dilaporkan di Edge Analytics. Fitur ini memungkinkan Anda mengetahui IP klien yang mengirim permintaan ke Edge Microgateway.
8. Perubahan plugin OAuth
Plugin OAuth mendukung verifikasi Kunci API dan verifikasi token akses OAuth. Sebelum pembaruan perubahan ini, {i>plugin<i} menerima apa pun bentuk keamanannya. Dengan perubahan ini, Anda hanya dapat mengizinkan salah satu model keamanan tersebut (sambil mempertahankan kompatibilitas mundur).
Plugin OAuth menambahkan dua tanda baru:
-
allowOAuthOnly -- Jika ditetapkan ke true, setiap API harus memiliki header Otorisasi dengan Token Akses Pemilik.
-
allowAPIKeyOnly -- Jika ditetapkan ke true, setiap API harus memiliki header x-api-key (atau lokasi kustom) dengan Kunci API.
Anda menetapkan flag ini di file konfigurasi Edge Microgateway seperti ini:
oauth: allowNoAuthorization: false allowInvalidAuthorization: false keep-authorization-header: false allowOAuthOnly: false allowAPIKeyOnly: false
9. Meningkatkan proxy edgemicro-auth (PR 40)
Peningkatan telah dilakukan pada proxy edgemicro-auth. Sebelum pembaruan perubahan ini, kunci {i>proxy<i} yang disimpan di {i>Edge Secure Store<i}, penyimpanan yang dienkripsi. Sekarang, proxy menyimpan kunci dalam peta nilai kunci (KVM) terenkripsi Edge.
10. Menulis ulang URL target default dalam plugin (PR 74)
Anda juga dapat mengganti port endpoint target dan memilih antara HTTP dan HTTPS. Ubah ini variabel dalam kode plugin Anda: req.targetPort dan req.targetSecure. Untuk memilih HTTPS, tetapkan req.targetSecure ke true; untuk HTTP, tetapkan ke false. Jika Anda menetapkan req.targetSecure ke benar, lihat diskusi ini thread untuk informasi selengkapnya.
11. Dukungan awal untuk autentikasi token OAuth (PR 125)
Anda dapat mengonfigurasi Edge Microgateway agar menggunakan token OAuth untuk autentikasi, nama pengguna/sandi. Untuk menggunakan token OAuth, gunakan parameter berikut di edgemicro konfigurasikan:
-t, --token <token>
Contoh:
edgemicro configure -o docs -e test -t <your token>
Perbaikan bug v2.4.3
- Memperbaiki masalah saat organisasi berbayar diperlukan untuk menjalankan proxy edgemicro-auth dengan benar. Sekarang, Anda juga dapat menggunakan Edge Microgateway dengan organisasi uji coba. (PR 5)
- Memperbaiki masalah saat streaming tidak selesai memproses data, tetapi pengendali akhir tetap mengeksekusinya. Hal ini menyebabkan respons parsial dikirim. (PR 71)
- Memperbaiki masalah saat direktori konfigurasi kustom untuk penginstalan Private Cloud tidak dikenali. (PR 110)
- Memperbaiki masalah SSL dua arah antara klien dan Edge Microgateway. (PR 70)
- Memperbaiki masalah garis miring di akhir yang diperlukan pada jalur dasar proxy untuk kunci API verifikasi agar dapat berfungsi dengan benar. Sekarang, garis miring tidak diperlukan di akhir {i>basepath<i}. (PR 48)
Versi 2.3.5
Fitur dan peningkatan baru v.2.3.5
Pemfilteran proxy
Anda dapat memfilter proxy berbasis microgateway mana yang akan diproses oleh instance Edge Microgateway.
Saat Edge Microgateway dimulai, semua proxy berbasis microgateway akan didownload
organisasi yang terkait dengannya. Gunakan konfigurasi berikut untuk membatasi {i>proxy<i} mana
akan diproses oleh microgateway. Misalnya, konfigurasi ini membatasi {i>proxy<i} {i>microgateway<i}
akan memproses ke tiga: edgemicro_proxy-1
, edgemicro_proxy-2
, dan
edgemicro_proxy-3
:
proxies: - edgemicro_proxy-1 - edgemicro_proxy-2 - edgemicro_proxy-3
Penyamaran data Analytics
Konfigurasi baru memungkinkan Anda mencegah informasi jalur permintaan muncul di Edge Analytics. Tambahkan kode berikut ke konfigurasi microgateway untuk menyamarkan URI permintaan dan/atau jalur permintaan. Perhatikan bahwa URI terdiri dari nama host dan bagian jalur yang diminta.
analytics: mask_request_uri: 'string_to_mask' mask_request_path: 'string_to_mask'
Versi 2.3.3
Fitur dan peningkatan baru v.2.3.3
Berikut adalah fitur dan peningkatan baru untuk rilis ini.
Menonaktifkan polling perubahan otomatis
Anda dapat menonaktifkan polling perubahan otomatis dengan menyetel atribut ini di microgateway konfigurasi:
disabled_config_poll_interval: true
Secara default, polling berkala mengambil perubahan yang dilakukan di Edge (perubahan pada produk, {i>microgateway-aware proxy<i}, dll) serta perubahan yang dibuat pada file konfigurasi lokal. Default interval polling adalah 600 detik (lima menit).
Menulis ulang URL target di plugin
Anda dapat mengganti URL target default secara dinamis dalam plugin dengan mengubah variabel ini dalam kode plugin: req.targetHostname dan req.targetPath.
Tanda tangan fungsi plugin baru
Tanda tangan fungsi plugin baru telah ditambahkan yang memberikan respons target sebagai argumen. Penambahan ini mempermudah plugin untuk mengakses respons target.
function(sourceRequest, sourceResponse, targetResponse, data, cb)
Output logging default yang disederhanakan
Secara default, layanan logging sekarang menghilangkan JSON untuk proxy, produk, dan JWT yang didownload.
Anda dapat mengubahnya ke default untuk menghasilkan objek ini dengan menyetel DEBUG=*
saat Anda mulai
Edge Microgateway. Contoh:
DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456
Jalur konfigurasi kustom ditambahkan ke CLI
Secara default, file konfigurasi microgateway berada di ./config/config.yaml. Pada {i>init<i}, mengkonfigurasi, dan memulai perintah, sekarang Anda dapat menentukan jalur konfigurasi khusus pada baris perintah. Contoh:
edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config
Perbaikan bug v2.3.3
- Kebocoran memori telah diperbaiki yang terjadi selama permintaan/respons besar.
- Urutan eksekusi plugin telah diperbaiki. Model kini berperilaku seperti yang dijelaskan dalam dokumentasi tambahan.
- Plugin akumulasi permintaan plugin tidak lagi hang untuk permintaan GET.
- Masalah telah diperbaiki dalam plugin respons akumulasi yang menyebabkan kurangnya isi respons yang sama.
Rilis 2.3.1
Catatan penginstalan
Beberapa Edge Microgateway versi sebelumnya memungkinkan Anda menginstal software dengan mendownload file ZIP . File ZIP ini tidak lagi didukung. Untuk menginstal Edge Microgateway, Anda harus menggunakan:
npm install -g edgemicro
Lihat topik penginstalan untuk secara lebih mendetail.
Fitur dan peningkatan baru v.2.3.1
Berikut adalah fitur dan peningkatan baru untuk rilis ini.
Proxy filter
Konfigurasi baru memungkinkan Anda memfilter proxy mana yang akan dimuat oleh Edge Microgateway sistem dimulai. Sebelumnya, microgateway memuat semua proxy berbasis microgateway (proxy bernama edgemicro_*) yang diambil dari organisasi/lingkungan Edge yang Anda tentukan di edgemicro perintah config. Fitur baru ini memungkinkan Anda memfilter daftar {i>proxy<i} ini sehingga Edge Microgateway hanya memuat software yang Anda tentukan. Cukup tambahkan elemen proxy ke microgateway file konfigurasi seperti ini:
edge micro: proxies: - edgemicro_[name] - edgemicro_[name] ...
Sebagai contoh, misalkan Anda memiliki 50 proxy edgemicro_*
di Edge
org/env, termasuk edgemicro_foo
dan edgemicro_bar
. Anda dapat
beri tahu microgateway agar hanya menggunakan dua proxy ini seperti ini:
edge micro: proxies: - edgemicro_foo - edgemicro_bar
Saat memulai, microgateway hanya dapat memanggil proxy yang ditentukan. Setiap upaya untuk memanggil proxy berbasis microgateway lain yang didownload dari organisasi/lingkungan Edge akan menyebabkan error.
Menetapkan header permintaan target di plugin
Ada dua pola dasar yang perlu dipertimbangkan jika Anda ingin menambahkan atau mengubah header permintaan target: satu permintaan masuk berisi data (seperti dalam permintaan POST) dan satu lagi tidak (seperti dalam permintaan GET sederhana).
Mari kita pertimbangkan kasus ketika permintaan masuk berisi data, dan Anda ingin menetapkan permintaan header pada permintaan target. Di versi Edge Microgateway sebelumnya, tidak mungkin menetapkan header target dengan andal dalam kasus ini.
Kunci dari pola ini adalah pertama-tama mengumpulkan semua data yang masuk dari klien. Lalu, di
onend_request()
, gunakan fungsi baru request.setOverrideHeader(name,
value)
untuk menyesuaikan header.
Berikut adalah contoh kode plugin yang menunjukkan cara melakukannya. {i>Header<i} yang diatur dalam
onend_request
dikirim ke target:
module.exports.init = function(config, logger, stats) { function accumulate(req, data) { if (!req._chunks) req._chunks = []; req._chunks.push(data); } return { ondata_request: function(req, res, data, next) { if (data && data.length > 0) accumulate(req, data); next(null, null); }, onend_request: function(req, res, data, next) { if (data && data.length > 0) accumulate(req, data); var content = Buffer.concat(req._chunks); delete req._chunks; req.setOverrideHeader('foo', 'bar'); req.setOverrideHeader('content-length', content.length); next(null, content); }, onerror_request: function(req, res, data, next) { next(null, null); } }; }
Jika permintaan tidak menyertakan data, Anda dapat menetapkan header target di
Pengendali onrequest()
. Pola ini bukan hal baru -- sebelumnya telah didokumentasikan
dan telah digunakan dalam contoh plugin yang disediakan dengan Edge Microgateway.
onrequest: function(req, res, next) { debug('plugin onrequest'); req.headers['x-foo-request-id'] = "bar"; req.headers['x-foo-request-start'] = Date.now(); next(); }
Fitur muat ulang tanpa periode nonaktif
Setelah melakukan perubahan konfigurasi pada Edge Microgateway, Anda dapat memuat konfigurasi
tanpa meninggalkan pesan apa pun. Dengan perubahan ini, Edge Microgateway
selalu dimulai dalam mode cluster,
dan opsi --cluster
telah dihapus dari edgemicro start
perintah.
Selain itu, tiga perintah CLI baru telah ditambahkan. Anda harus menjalankan perintah ini dari direktori yang sama tempat perintah start edgemicro dijalankan:
edgemicro status
- Memeriksa apakah Edge Microgateway berjalan atau tidak.edgemicro stop
- Menghentikan cluster Edge Microgateway.edgemicro reload
- Memuat ulang Edge Microgateway konfigurasi tanpa periode nonaktif.
Muat ulang konfigurasi otomatis tanpa periode nonaktif
Edge Microgateway memuat konfigurasi baru secara berkala dan menjalankan pemuatan ulang jika ada ubah. Polling ini mencatat semua perubahan yang dibuat di Edge (perubahan pada produk, berbasis microgateway {i>proxy<i}, dll) serta perubahan yang dibuat pada file konfigurasi lokal. Interval polling default adalah 600 detik (lima menit). Anda dapat mengubah {i>default<i} di file konfigurasi microgateway sebagai berikut ini:
edgemicro: config_change_poll_interval: [seconds]
Menambahkan informasi versi ke CLI
Flag --version
telah ditambahkan ke CLI. Untuk mendapatkan versi Edge saat ini
Microgateway, gunakan:
edgemicro --version
Opsi SSL server Edge Microgateway baru
Edge Microgateway sekarang mendukung opsi SSL server berikut selain
key
dan cert
:
Opsi | Deskripsi |
---|---|
pfx |
Jalur ke file pfx yang berisi kunci pribadi, sertifikat, dan sertifikat CA
klien dalam format PFX. |
passphrase |
String yang berisi frasa sandi untuk kunci pribadi atau PFX. |
ca |
Jalur ke file yang berisi daftar sertifikat tepercaya dalam format PEM. |
ciphers |
String yang menjelaskan penyandian yang akan digunakan, dipisahkan dengan tanda ":". |
rejectUnauthorized |
Jika true (benar), sertifikat server akan diverifikasi berdasarkan daftar CA yang diberikan. Jika verifikasi gagal, pesan {i>error<i} akan muncul. |
secureProtocol |
Metode SSL yang akan digunakan. Misalnya, SSLv3_method untuk memaksa SSL ke versi 3. |
servername |
Nama server untuk ekstensi TLS SNI (Server Name Indication). |
Mengirim file log ke stdout
Anda dapat mengirim data log ke output standar dengan setelan konfigurasi baru:
edgemicro: logging: to_console: true
Lihat Mengelola file log.
Versi 2.1.2
Berikut adalah fitur dan peningkatan baru untuk rilis ini.
Mengizinkan endpoint API kustom untuk konfigurasi
Ada endpoint baru yang dapat dikonfigurasi untuk proxy otorisasi yang mendukung penggunaan layanan autentikasi khusus. Endpoint tersebut adalah:
edgeconfig:verify_api_key_url
edgeconfig:products
Untuk detailnya, lihat Menggunakan layanan autentikasi kustom.
Versi 2.1.1
Berikut adalah fitur dan peningkatan baru untuk rilis ini.
Deploy proxy autentikasi kompatibel lintas platform
Peningkatan telah dibuat sehingga perintah yang digunakan untuk men-deploy otorisasi Edge Microgateway proxy ke Edge kompatibel pada sistem Windows.
Versi 2.1.0
Fitur dan peningkatan baru v.21.0
Berikut adalah fitur dan peningkatan baru:
Menentukan opsi SSL/TLS klien
Anda dapat menentukan opsi klien untuk koneksi SSL/TSL ke target menggunakan serangkaian konfigurasi baru lainnya. Lihat Menggunakan opsi SSL/TSL klien.
Versi 2.0.11
Catatan penginstalan v2.0.11
Beberapa Edge Microgateway versi sebelumnya memungkinkan Anda menginstal software dengan mendownload file ZIP . File ZIP ini tidak lagi didukung. Untuk menginstal Edge Microgateway, Anda harus menggunakan:
npm install -g edgemicro
Lihat topik penginstalan untuk secara lebih mendetail.
Fitur dan peningkatan baru v.2.0.11
Berikut adalah fitur dan peningkatan baru:
Menentukan port saat browser dimulai
Perintah start memungkinkan Anda menentukan nomor porta untuk menggantikan porta yang telah ditentukan dalam file konfigurasi Anda. Anda juga dapat menentukan nomor port menggunakan variabel lingkungan PORT. Lihat perintah start untuk mengetahui detailnya.
Anda juga dapat mempertahankan header autentikasi
Setelan konfigurasi baru, keepAuthHeader, memungkinkan Anda mempertahankan Header otorisasi yang dikirim dalam permintaan. Jika disetel ke benar (true), header Auth akan diteruskan ke target. Lihat atribut oauth lebih lanjut.
Kemampuan untuk menggunakan layanan otorisasi kustom
Jika Anda ingin menggunakan layanan khusus Anda sendiri untuk menangani autentikasi, ubah Nilai authUri di file konfigurasi Edge Microgateway agar mengarah ke layanan Anda. Sebagai detail, lihat Menggunakan layanan autentikasi kustom.
Versi 2.0.4
Edge Microgateway v.2.0.4 dirilis pada 25 Mei 2016.
Fitur dan peningkatan baru v2.0.4
Berikut adalah fitur dan peningkatan baru dalam rilis ini.
Dukungan untuk jalur resource dalam produk
Edge Microgateway kini mendukung jalur resource dalam produk. Jalur resource memungkinkan Anda membatasi mengakses API berdasarkan akhiran jalur proxy. Untuk detail tentang cara membuat produk dan mengonfigurasi jalur resource, lihat Membuat API .
Dukungan untuk penginstalan global npm
Kini Anda dapat menginstal Edge Microgateway menggunakan opsi npm -g (global). Untuk mengetahui detail tentang lihat npm dokumentasi tambahan.
Versi 2.0.0
Edge Microgateway v2.0.0 dirilis pada 18 April 2016.
Fitur dan peningkatan baru v.2.0.0
Berikut adalah fitur dan peningkatan baru dalam rilis ini.
Server proses tunggal
Edge Microgateway sekarang menjadi server proses tunggal. Tidak lagi menggunakan model dua proses di mana satu proses (sebelumnya dikenal sebagai "agen") meluncurkan Edge Microgateway, proses kedua {i>checkout<i}. Arsitektur baru ini mempermudah otomatisasi dan containerization.
File konfigurasi dengan namespace
File konfigurasi sekarang diberi namespace menggunakan organisasi dan lingkungan sehingga beberapa Instance Microgateway dapat berjalan pada host yang sama. Anda dapat menemukan file konfigurasi di ~/.edgemicro setelah Anda menjalankan perintah konfigurasi Edge Microgateway.
Variabel lingkungan baru
Sekarang ada 4 variabel lingkungan: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Jika menetapkan variabel ini pada sistem, Anda tidak perlu menentukan saat Anda menggunakan Antarmuka Command-Line (CLI) untuk mengonfigurasi dan memulai Edge Microgateway.
Konfigurasi yang di-cache
Edge Microgateway menggunakan file konfigurasi yang disimpan dalam cache jika dimulai ulang tanpa dan terhubung ke Apigee Edge.
Mode cluster
Sekarang ada opsi untuk memulai Edge Microgateway dalam mode cluster. Mode cluster memungkinkan Anda untuk mengambil keunggulan sistem multi-core. Microgateway menggunakan modul cluster Node.js untuk fitur ini. Untuk mengetahui detailnya, baca dokumentasi Node.js.
Perbaikan bug v2.0.0
Siklus proses peristiwa plugin sekarang menangani kode asinkron yang berisi kode dengan .
Versi 1.1.2
Edge Microgateway v. 1.1.2 dirilis pada 14 Maret 2016.
Fitur dan peningkatan baru v.1.1.2
Berikut adalah fitur dan peningkatan baru dalam rilis ini.
Peningkatan Performa
Edge Microgateway kini menggunakan agen HTTP Node.js dengan benar untuk penggabungan koneksi yang lebih baik. Ini peningkatan performa dan stabilitas keseluruhan saat beban tinggi.
Dukungan debugger jarak jauh
Anda dapat mengonfigurasi Edge Microgateway agar berjalan dengan debugger jarak jauh, seperti node-inspector.
Lokasi file konfigurasi baru
Saat Anda mengonfigurasi Edge Microgateway, file agent/config/default.yaml
sekarang
disalin ke ~./edgemicro/config.yaml
.
Rotasi file log
Atribut konfigurasi baru memungkinkan Anda menentukan interval rotasi untuk Edge Microgateway log.
Perbaikan bug v1.1.2
Bug berikut telah diperbaiki dalam v. 1.1.2.
Deskripsi |
---|
Info Java untuk proxy internal edgemicro yang digunakan dengan Edge lokal kini menggunakan MGMT yang tepat server tertentu. |
Menghapus dependensi typescript dari agen. |
Memperbaiki bug CLI saat menggunakan opsi deployment tanpa lemak. |
Memperbaiki referensi dependensi logika sertifikat. |