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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.3.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 fitur ini tidak memengaruhi fungsi inti Edge Microgateway atau menulis ulang URL target. Untuk mengetahui detail selengkapnya, lihat Menulis ulang URL target dalam plugin'. |
283947053 | Dihapus |
Dukungan untuk |
Perbaikan masalah keamanan
- 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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.3.2. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 Apigee dan versi yang didukung. |
283947053 | Bug |
Masalah telah diperbaiki saat Edge Microgateway menampilkan produk API pertama dalam daftar produk API yang terkait dengan aplikasi. Sekarang kami menentukan produk API yang benar untuk ditampilkan berdasarkan permintaan. |
274443329 | Bug |
Masalah telah diperbaiki saat Docker mengambil versi image yang sudah tidak berlaku.
Versi node Docker telah diupdate ke Node.js versi 18. Sekarang kami membangun image Docker dengan versi |
Perbaikan masalah keamanan
Tidak ada.
3.3.1
Pada 7 Juni 2022, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.3.1. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 saat perintah |
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 diperbarui untuk menyertakan link ke plugin Edge Microgateway yang didukung dan disimpan di GitHub. Lihat Plugin yang sudah ada yang dipaketkan dengan Edge Microgateway. |
Perbaikan masalah keamanan
ID Masalah | Deskripsi |
---|---|
CVE-2021-23413 | Hal ini memengaruhi paket jszip sebelum 3.7.0. Pembuatan file zip baru dengan nama file yang ditetapkan ke nilai prototipe Objek (misalnya proto, toString, dll.) akan menghasilkan objek yang ditampilkan dengan instance prototipe yang dimodifikasi. |
3.3.0
Pada 4 Februari 2022, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.3.0. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 perbaikan.
Menjalankan
Jika Anda mengeksekusi
Untuk memperbaiki masalah ini, jalankan perintah berikut 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 saat kode respons yang terlihat di analisis Apigee tidak cocok dengan 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 mengupdate kunci publik tanpa memuat ulang Edge Microgateway jika kunci publik IDP berubah.
|
168713541 | Bug |
Dokumentasi telah ditingkatkan untuk menjelaskan cara mengonfigurasi TLS/SSL untuk beberapa target. Lihat Menggunakan opsi SSL/TLS klien. |
171538483 | Bug |
Dokumentasi telah diubah untuk memperbaiki konvensi penamaan file log. Lihat Konvensi penamaan file log. |
157908466 | Bug |
Dokumentasi diubah untuk menjelaskan cara menginstal Edge Microgateway versi tertentu dengan benar. Lihat Mengupgrade Edge Microgateway jika Anda memiliki koneksi internet. |
215748427 | Bug | Masalah telah diperbaiki, yaitu perintah mencabutkeys menampilkan error saat mencabut kunci menggunakan pasangan kunci dan rahasia yang ada. |
205524197 | Bug | Dokumentasi diperbarui untuk menyertakan daftar lengkap level {i>logging<i}. 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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.2.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 ini diperbaiki, karena dalam konteks container Docker, Edge Microgateway tidak mati dengan baik menggunakan perintah docker stop {containerId} . Proses dihentikan, tetapi file .sock dan .pid tidak dihapus. Sekarang
file tersebut telah dihapus dan memulai ulang penampung yang sama berfungsi seperti yang diharapkan.
|
190715670 | Bug | Masalah telah diperbaiki saat beberapa permintaan macet selama aktivitas pemuatan ulang internal
di microgateway. Masalah ini hanya sesekali dan terjadi dalam situasi lalu lintas yang tinggi.
Masalah ini terlihat saat fitur tokenCache dan cacheKey dari plugin OAuth digunakan.
|
183910111 | Bug | Masalah telah diperbaiki saat URL jalur resource dengan garis miring di akhir salah
ditafsirkan sebagai jalur resource terpisah. Sekarang, misalnya, jalur /country/all dan /country/all/ ditafsirkan sebagai jalur yang sama. |
Perbaikan masalah keamanan
ID Masalah | Deskripsi |
---|---|
CVE-2020-28503 | Paket copy-props sebelum 2.0.5 rentan terhadap Polusi Prototipe melalui fungsi utama. |
CVE-2021-23343 | Semua versi path-parse paket rentan terhadap ekspresi reguler Regular Expression Denial of Service (ReDoS) melalui splitDeviceRe, splitTailRe, dan splitPathRe. ReDoS menunjukkan kompleksitas waktu kasus terburuk polinomial. |
3.2.2
Pada hari Kamis, 15 Juli 2021, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.2.2. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 token refresh kini menampilkan
Untuk mematuhi
RFC 6749 Framework Otorisasi OAuth 2.0,
nilai yang diharapkan untuk parameter konfigurasi |
188492065 | Ubah |
Akhir dari dukungan Node.js 8
Mulai rilis 3.2.2, Node.js 8 tidak lagi didukung. Untuk mengetahui informasi selengkapnya, lihat Software yang didukung 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 output standar, bukan ke file log. Jika Anda mengikuti langkah-langkah untuk menjalankan Edge Microgateway dalam container Docker, container secara default akan mengalihkan stdout dan output error ke file yang terletak dalam container di lokasi:
Untuk mencegah informasi log 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 diupdate untuk menggunakan NodeJS versi 12.22. Lihat Menggunakan Docker untuk Edge Microgateway. |
Perbaikan masalah keamanan
ID Masalah | Deskripsi |
---|---|
CVE-2021-28860 | Di mixme Node.js, sebelum v0.5.1, penyerang dapat menambahkan atau mengubah properti objek melalui '__proto__' melalui fungsi mutate() dan merge(). Atribut yang tercemar akan langsung ditetapkan ke setiap objek dalam program. Hal ini akan membahayakan ketersediaan program yang menyebabkan potensi denial of service (DoS). |
CVE-2021-30246 | Dalam paket jsrsasign hingga 10.1.13 untuk Node.js, beberapa tanda tangan RSA PKCS#1 v1.5 yang tidak valid akan keliru dianggap valid. CATATAN: tidak ada serangan praktis yang diketahui. |
CVE-2021-23358 | Garis bawah paket dari 1.13.0-0 dan sebelum 1.13.0-2, dari 1.3.2, dan sebelum 1.12.1 rentan terhadap Injeksi Kode Arbitrer melalui fungsi template, terutama jika 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 berada dalam mode pemantauan, ekspresi reguler mulai digunakan untuk mendeteksi pesan monitor yang dapat menyebabkan backtracking eksponensial pada beberapa string. Masalah ini dapat menyebabkan denial of service. Masalah ini di-patch dalam versi 3.1.1. |
CVE-2020-8174 | Image Docker diupdate sehingga menggunakan Node.js versi 12.22 |
3.2.1
Pada hari Jumat, 5 Maret 2021, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.2.1. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 memiliki nilai null yang menyebabkan aplikasi gagal.
Kondisi null kini ditangani untuk menghindari penerusan nilai null di Catatan: Perbaikan ini mengharuskan Anda mengupgrade proxy edgemicro-auth. |
179971737 | Bug |
Masalah telah diperbaiki dengan respons status target 4XX / 5XX yang dicatat sebagai error proxy untuk proxy edgemicro_*.
Untuk transaksi Edge Microgateway, jumlah error target yang salah ditampilkan di dasbor analisis kode error Apigee Edge. Kode error untuk error target dihitung sebagai error proxy. Masalah ini telah diperbaiki dan jumlah error target yang benar kini ditampilkan. |
179674670 | Fitur |
Sebuah 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.
Terjadi masalah saat kunci dan nilai secret Edge Microgateway yang diteruskan, baik dari argumen command line maupun yang disetel melalui variabel lingkungan, ditampilkan dalam argumen proses pekerja/turunan node setelah memulai microgateway. Untuk memperbaiki masalah ini pada skenario variabel lingkungan, nilai tidak lagi terlihat dalam argumen command line process explorer. Jika nilai kunci dan rahasia diteruskan di command line saat memulai microgateway, setelan tersebut akan menggantikan nilai variabel lingkungan, jika disetel. Dalam hal ini, nilai masih terlihat dalam argumen command line process explorer. |
178341593 | Bug |
Error dokumentasi untuk plugin apikeys telah diperbaiki.
File README untuk plugin apikeys salah menyertakan properti
Properti |
179366445 | Bug |
Masalah telah teratasi saat payload dihapus untuk semua permintaan GET ke 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, payload permintaan GET tidak memiliki semantik yang ditetapkan, sehingga dapat dikirim ke target. |
3.2.0
Pada hari Kamis, 21 Januari 2021, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.2.0. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 agar memuat client_id pada objek permintaan jika token valid. x-api-key kemudian tersedia untuk
plugin berikutnya.
|
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 telah diperbaiki saat endpoint
Perbaikan tidak mengubah durasi waktu habis masa berlaku, tetapi hanya mengubah satuan waktu. Ini hanya berlaku untuk kolom Jika klien sangat mengandalkan nilai Jika klien selalu menggunakan nilai dalam token JWT untuk mengevaluasi periode refresh token, klien tidak perlu melakukan perubahan. |
173064680 | Bug | Masalah telah diperbaiki saat microgateway mengakhiri permintaan target sebelum semua potongan data diproses.
Ini adalah masalah sesekali yang diamati pada permintaan ukuran payload yang tinggi dan masalah ini diperkenalkan dalam rilis 3.1.7. |
174640712 | Bug | Tambahkan penanganan data yang tepat untuk 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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.8. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 mengurai semua nilai sebagai string, yang mengakibatkan error penguraian untuk nilai boolean atau numerik. Misalnya, |
169202749 | Bug | Penggantian variabel lingkungan tidak berfungsi pada beberapa kasus.
Penanganan penggantian variabel lingkungan tidak berfungsi untuk beberapa atribut konfigurasi. Lihat Menyetel atribut konfigurasi dengan nilai variabel lingkungan untuk mengetahui informasi tentang batasan. |
168732942 | Bug | Masalah telah diperbaiki saat cakupan OAuth tidak membatasi akses proxy API seperti yang diharapkan.
Alur |
170609716 | Bug | Masalah telah diperbaiki saat alur /refresh di proxy edgemicro-auth menghasilkan JWT tanpa apiProductList .
|
170708611 | Bug | Cakupan produk API tidak tersedia untuk plugin kustom.
Cakupan produk API tidak disediakan untuk plugin kustom, dan juga tidak ditulis ke file konfigurasi cache. Lihat Tentang fungsi init() plugin untuk melihat bagaimana detail cakupan 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 setiap kali dimuat ulang/dimulai. Pada versi 3.1.8, kunci dan rahasia tidak lagi disimpan dalam file konfigurasi cache. Jika kunci dan rahasia sebelumnya telah ditulis dalam file konfigurasi cache, kunci dan rahasia tersebut akan dihapus. |
170708621 | Fitur | Tidak dapat menonaktifkan plugin analisis.
Pada versi microgateway sebelumnya, plugin analisis diaktifkan secara default dan tidak ada cara untuk menonaktifkannya. Pada versi 3.1.8, parameter konfigurasi baru, |
159571119 | Bug | Mendapatkan error null pada hook onerror_request di plugin kustom untuk
waktu tunggu respons/soket.
Perbaikan dilakukan untuk mengisi kode status HTTP dan pesan error yang benar untuk peristiwa |
3.1.7
Pada hari Kamis, 24 September 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.7. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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
panggilan axpublisher dan menyebabkan pekerja keluar.
|
133162200 | Bug | Informasi aplikasi developer tidak diisi di analisis dengan respons status 403
yang disebabkan oleh jalur resource produk yang tidak sah atau respons 401
yang disebabkan oleh token yang sudah tidak berlaku atau tidak valid.
|
132194290 | Bug | Data Analytics dihapus saat Apigee Edge menolak beberapa data analisis.
|
158618994 | Bug | Koneksi klien Redis yang berlebihan.
|
161404373 | Bug | Jika muncul 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 menjalankan 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 karena kegagalan
jaringan.
|
166517190 | Bug | Data jwk_public_keys tidak disimpan serta diambil oleh Synchronizer dan disimpan dalam Redis.
|
141659881 | Bug | Error penanganan sertifikat target yang tidak valid
menampilkan respons error yang menyesatkan.
|
142808699 | Bug | Plugin accesscontrol tidak menangani bagian 'allow' dan 'deny' dengan benar.
Microgateway kini memproses bagian tolak dengan benar dan mengikuti urutan bagian 'allow' dan 'deny'. Properti |
3.1.6
Pada hari Kamis, 20 Agustus 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.6. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 sertifikat dan kunci kustom untuk perintah rotasi kunci.
Untuk mengetahui detail tentang opsi perintah baru ini, lihat Rotasi tombol. |
||||||||||||
154838259 | Bug | Memperbaiki rotasi kunci untuk multi-instance di beberapa pusat data
Untuk mengetahui detail tentang opsi perintah baru ini, lihat Rotasi tombol. |
||||||||||||
145525133 | Fitur alfa | Metrik plugin baru
Lihat README Metrik plugin baru di GitHub untuk mengetahui detailnya. |
||||||||||||
159396879 | Bug | Menghapus Helper paket yang tidak digunakan | ||||||||||||
161092943 | Bug | Validasi jalur dasar salah
Sebelum versi 3.1.6, jalur dasar proxy salah dicocokkan jika jalur dasar
tidak diakhiri dengan Yang berikut ini menjelaskan lebih lanjut perilaku sebelumnya (yang telah diperbaiki di 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 plugin kustom setelah digabungkan dengan file konfigurasi Edge Microgateway. Lihat config. |
||||||||||||
162758808 | Bug | Konfigurasi kuota baru untuk backing store Redis
Anda dapat menggunakan konfigurasi berikut untuk menentukan penyimpanan pendukung Redis untuk kuota. Untuk mengetahui detailnya, lihat Menggunakan backing store Redis untuk kuota. |
3.1.5
Pada hari Jumat, 26 Juni 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.5. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 untuk melewati pemrosesan plugin untuk URL yang ditentukan. Untuk detailnya, lihat Mengonfigurasi URL pengecualian untuk plugin. |
156986819, 158529319 | Bug | Masalah pada plugin json2xml telah diperbaiki
Perbaikan masalah saat plugin menghasilkan header Jenis Konten duplikat dan header tidak dikirim ke target seperti yang diharapkan dalam beberapa kasus. |
156560067, 159688634 | Fitur | Menggunakan nilai variabel lingkungan dalam konfigurasi Fitur telah ditambahkan yang memungkinkan Anda menentukan variabel lingkungan menggunakan tag pada file konfigurasi. Tag variabel lingkungan yang ditentukan diganti dengan nilai variabel lingkungan yang sebenarnya. Penggantian hanya disimpan dalam memori dan tidak disimpan dalam konfigurasi asli atau file cache. Untuk mengetahui 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 titik dua tidak relevan yang ditambahkan ke dalamnya. |
153673257 | Bug | (Edge untuk Private Cloud saja) Produk yang peka Microgateway tidak diambil Masalah telah diperbaiki saat produk yang peka terhadap microgateway tidak ditarik. Masalah ini terdapat di Edge hanya untuk penginstalan Private Cloud. |
154956890, 155008028, 155829434 | Fitur | Mendukung pemfilteran produk yang didownload berdasarkan atribut khusus
Untuk mengetahui detailnya, lihat Memfilter produk menurut 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 rotasi kunci dan upgrade KVM telah diperbaiki
Lihat juga Memutar kunci JWT. |
3.1.4
Pada Jumat, 23 April 2020, kami merilis perbaikan berikut untuk 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 peningkatan yang dijelaskan dalam catatan rilis versi 3.1.3 akan diterapkan untuk rilis ini.
3.1.3
Pada hari Rabu, 15 April 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 menyebabkan kebocoran memori. Masalah ada pada versi v3.1.0, v3.1.1, dan 3.1.2.
- 153509313 - Masalah telah diperbaiki saat ID pesan yang sama untuk dua transaksi berbeda dicetak dalam output logging.
- 151673570 - Masalah telah diperbaiki saat Edge Microgateway tidak diupdate untuk menggunakan Apigee KVM API yang baru. Edge Microgateway kini menggunakan perintah baru untuk menambahkan dan mengupdate nilai KVM.
- 152822846 - Dalam rilis sebelumnya, Edge Microgateway telah diupdate sehingga pemrosesan pemetaan jalur resource-nya cocok dengan yang ada di Apigee Edge. Dalam rilis ini, masalah telah diperbaiki
sehingga 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 ID kuota.
3.1.2
Pada hari Senin, 16 Maret 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 untuk dukungan proxy HTTP yang ada antara Edge Microgateway dan Apigee Edge telah diperbaiki. 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 dalam file konfigurasi. - 151284716 - Penyempurnaan dilakukan untuk menutup koneksi server lebih cepat saat pekerja dimulai ulang selama pemuatan ulang.
- 151588764 - Mengupdate versi Node.js di image Docker yang digunakan untuk menjalankan Edge Microgateway dalam container Docker ke versi 12, karena Node.js v8 tidak digunakan lagi.
- 151306049 - Update dokumentasi dibuat untuk mencantumkan API pengelolaan Edge Apigee 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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.1. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 saat modul
microgateway-core
tidak mematuhi variabel lingkunganHTTP_PROXY
danHTTPS_PROXY
. Dengan perubahan ini, setelan proxy dalam file konfigurasi YAML, jika ditentukan, sekarang diabaikan; hanya variabel lingkungan yang digunakan untuk menentukan proxy.Jika ingin menentukan konfigurasi proxy dalam file konfigurasi, Anda juga harus menentukan variabel
HTTP_PROXY
yang menyebutkan URL proxy yang sama dengan yang ditentukan dalam 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
, 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 tersebut menetapkan atribut
Server.headersTimeout
Node.js pada permintaan. (Default: 5 detik lebih lama dari waktu yang ditetapkan denganedgemicro.keep_alive_timeout
. Setelan default ini mencegah load balancer atau proxy tidak sengaja memutuskan koneksi.) 149278885 - Fitur baru telah ditambahkan yang memungkinkan Anda menetapkan waktu tunggu API target pada level proxy API, dan bukan menggunakan satu setelan waktu tunggu global.
Jika Anda menetapkan properti TargetEndpoint
io.timeout.millis
di proxy API, Edge Microgateway akan dapat mengambil properti tersebut dan menerapkan waktu tunggu khusus endpoint target. 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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.1.0. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 tingkat WARN baru akan dicatat saat flag
quotas.failOpen
dipicu. Flag ini dipicu jika terjadi error pemrosesan kuota atau jika permintaan "kuota berlaku" ke Edge gagal memperbarui penghitung kuota jarak jauh. Dalam hal ini, kuota akan diproses berdasarkan jumlah lokal hanya hingga sinkronisasi kuota jarak jauh berikutnya yang berhasil terjadi. Sebelumnya, peristiwa ini hanya dicatat saat level 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 saat transaksi yang sedang berlangsung atau transaksi baru terpengaruh setiap kali Edge Microgateway mendeteksi perubahan pada proxy API. Kini, saat perubahan dilakukan pada proxy, Edge Microgateway akan memuat ulang cache dan node pekerja akan memulai ulang. Dengan perubahan ini, transaksi yang sedang berlangsung dan panggilan API baru yang dikirim ke microgateway tidak akan terpengaruh.
- 146378327 - Level log
sourceRequest
,targetRequest
, dantargetResponse
telah diubah ke level INFO. - 146019878 - Perbedaan antara latensi yang dihitung untuk "Performa Proxy API" di analisis Edge dan peristiwa log Edge Microgateway sourceResponse/targetResponse telah diperbaiki. Sekarang, latensi di analisis Edge dan peristiwa log Microgateway telah disesuaikan.
- Perubahan terkait logika pencocokan pola:
- 147027862 - Plugin oauth diperbarui untuk mendukung pola pencocokan jalur resource berikut seperti yang ditentukan dalam Produk API:
/{literal}**
/{literal}*
- Kombinasi apa pun dari dua pola di atas
Dengan perubahan ini, plugin Edge Microgateway kini mengikuti pencocokan pola yang sama dengan Apigee Edge, seperti yang dijelaskan dalam Mengonfigurasi perilaku jalur resource '/', '/*', dan '/**'.
- 145644205 - Memperbarui logika pencocokan pola dari plugin apiKeys agar cocok dengan plugin oauth.
- 147027862 - Plugin oauth diperbarui untuk mendukung pola pencocokan jalur resource berikut seperti yang ditentukan dalam Produk API:
- 143488312 - Masalah telah diperbaiki saat spasi di bagian awal atau akhir dalam parameter client ID menyebabkan pembuatan daftar produk JWT menjadi kosong untuk permintaan token OAuth dan kunci API.
- 145640807 dan 147579179 - Sebuah fitur baru telah ditambahkan yang memungkinkan instance 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 data konfigurasinya dari database. Fitur ini menambah tingkat ketahanan Edge Microgateway.
Ini memungkinkan instance microgateway untuk memulai dan berfungsi tanpa perlu berkomunikasi dengan Apigee Edge. Untuk mengetahui detailnya, lihat
Menggunakan sinkronisasi.
Fitur syncrhonizer saat ini didukung untuk bekerja 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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.0.10. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 - Update fitur dilakukan sehingga pencocokan pola untuk jalur resource yang digunakan dalam produk API untuk Edge Microgateway kini selaras dengan pencocokan pola jalur resource yang digunakan oleh Apigee Edge, seperti yang dijelaskan dalam 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 tersebut di Aplikasi Developer proxy, seperti yang ditunjukkan dalam screenshot berikut:Catatan: Properti konfigurasi
features.isSingleForwardSlashBlockingEnabled
, seperti yang dijelaskan dalam 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). Propertiquotas
digunakan untuk mengonfigurasi plugin kuota. Perubahan struktur dilakukan untuk meningkatkan kejelasan elemen konfigurasi. Untuk mengonfigurasi plugin kuota, gunakan konfigurasi YAML berikut. Perhatikan bahwa properti konfigurasi disebutquotas
. Untuk mengetahui detail tentang setiap properti konfigurasiquotas
, 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 - Sebuah fitur baru telah ditambahkan yang memungkinkan Anda menggunakan Redis sebagai penyimpanan pendukung kuota.
Jika
useRedis
bernilai true, modul volos-quota-redis akan digunakan. Jika benar, kuota dibatasi hanya untuk instance Edge Microgateway yang terhubung ke Redis. Jika salah, modul volos-quota-apigee akan digunakan sebagai backing store, 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 dibuat oleh proxy
edgemicro-auth
telah diubah dari 108.000 milidetik (1,8 menit) menjadi 1800 detik (30 menit). - 143551282 - Untuk mendukung organisasi yang mendukung SAML, perintah
edgemicro genkeys
telah diperbarui untuk menyertakan parameter‑‑token
. Parameter ini memungkinkan Anda menggunakan token OAuth untuk autentikasi, bukan nama pengguna/sandi. Untuk mengetahui detailnya, lihat Membuat kunci.
3.0.9
Pada hari Jumat, 11 Oktober, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.0.9. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 - Fitur "gagal dibuka" baru ditambahkan untuk plugin kuota.
Saat fitur ini diaktifkan, jika terjadi error pemrosesan kuota atau jika permintaan "penerapan kuota" ke Edge gagal memperbarui penghitung kuota jarak jauh, kuota akan diproses berdasarkan jumlah lokal hanya hingga sinkronisasi kuota jarak jauh berikutnya yang berhasil dilakukan. Dalam kedua kasus ini, flag
quota-failed-open
ditetapkan dalam objek permintaan.Untuk mengaktifkan fitur "gagal dibuka", tetapkan konfigurasi berikut:
quotas : failOpen : true
Catatan: Selain itu, nama flag objek permintaan
fail-open
plugin OAuth telah diubah menjadioauth-failed-open
. - 142093764 - Perubahan konfigurasi dilakukan pada proxy
edgemicro-auth
untuk mencegah kelebihan kuota. Perubahannya adalah menetapkan jenis kuota ke calendar. Untuk menggunakan peningkatan ini, Anda harus mengupdateedgemicro-auth
ke versi 3.0.7 atau yang lebih tinggi. - 142520568 - Fitur baru telah ditambahkan untuk mengaktifkan logging ID MP (pemroses pesan) dalam respons kuota. Untuk menggunakan fitur ini, Anda harus mengupdate
proxy
edgemicro-auth
ke versi 3.0.7 atau yang lebih tinggi dan menetapkan konfigurasi berikut:quotas: useDebugMpId: true
Jika
useDebugMpId
disetel, respons kuota dari Edge akan berisi ID MP dan akan dicatat dalam log 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 pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.0.8. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 - Fitur "gagal dibuka" baru ditambahkan. Fitur ini memungkinkan pemrosesan API berlanjut jika token JWT yang sudah habis masa berlakunya tidak dapat dimuat ulang karena terjadi error koneksi yang mencegah panggilan verifikasi kunci API yang berhasil ke proxy
edgemicro-auth
.Fitur ini memungkinkan Anda menetapkan masa tenggang ketika token lama tetap berada dalam cache dan digunakan kembali hingga masa tenggang berakhir. Dengan fitur ini, Edge Microgateway dapat melanjutkan pemrosesan permintaan jika terjadi kegagalan koneksi sementara. Saat konektivitas dilanjutkan, dan panggilan Kunci API Verifikasi yang berhasil berhasil, JWT baru akan diambil dan menggantikan JWT lama di cache.
Untuk mengonfigurasi fitur "gagal dibuka" yang baru, lakukan hal berikut:
- Tetapkan properti berikut dalam stanza
oauth
di file konfigurasi Edge Microgateway: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 diperbarui karena masalah konektivitas. Setelah 5 detik, error autentikasi akan ditampilkan.
- Tetapkan properti berikut dalam stanza
- 141168968 - Update dilakukan untuk menyertakan
correlation_id
di semua output log plugin. Selain itu, level log untuk beberapa log diubah menjadierror
sesuai kebutuhan. - 140193349 - Update dilakukan pada proxy
edgemicro-auth
untuk mewajibkan kunci dan rahasia Edge Microgateway diverifikasi pada setiap permintaan Verify API Key. Edge Microgateway telah diupdate untuk selalu mengirim kunci dan secret pada setiap permintaan Verify API Key. Perubahan ini mencegah klien mendapatkan JWT hanya dengan kunci API. - 140090250 - Pembaruan dilakukan guna menambahkan pencatatan log diagnostik untuk pemrosesan kuota. Dengan perubahan ini, output log quoto kini dapat dihubungkan dengan log Edge Microgateway lainnya.
3.0.7
Pada hari Kamis, 12 September, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Versi komponen:
Tabel berikut berisi nomor versi untuk setiap project komponen yang terkait dengan Edge Microgateway 3.0.7. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak sesuai 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 - Update telah dilakukan pada plugin OAuth untuk menampilkan kode status 5xx jika sesuai. Sebelumnya, plugin hanya menampilkan kode status 4xx di semua kasus non-200. Sekarang, untuk respons pesan apa pun yang bukan status 200, kode 4xx atau 5xx yang tepat akan ditampilkan, bergantung pada error-nya.
Fitur ini dinonaktifkan secara default. Untuk mengaktifkan fitur ini, tambahkan properti
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 ditambahkan,
quota.quotaUri
. Tetapkan properti konfigurasi ini jika Anda ingin mengelola kuota melalui proxyedgemicro-auth
yang di-deploy ke organisasi Anda. Jika properti ini tidak disetel, endpoint kuota akan ditetapkan secara default ke endpoint Edge Microgateway internal. Contoh:edge_config: quotaUri: https://%s-%s.apigee.net/edgemicro-auth
Pada rilis 3.0.7,
edgemicro-auth
diupdate untuk menerima konfigurasi baru ini. Untuk menggunakan propertiquotaUri
, Anda harus mengupgrade ke proxyedgemicro-auth
terbaru. Untuk mengetahui detailnya, lihat Mengupgrade proxy edgemicro-auth. - 140470888 - Header Otorisasi ditambahkan ke panggilan kuota untuk memberikan autentikasi.
Selain itu, proxy
edgemicro-auth
diubah untuk menghapus "organisasi" dari ID kuota. Karena endpoint kuota berada di organisasi pelanggan, ID kuota tidak lagi diperlukan. - 140823165 - Nama properti berikut:
edgemicro: keepAliveTimeout
tidak didokumentasikan dengan benar dalam rilis 3.0.6. Nama properti yang benar adalah:
edgemicro: keep_alive_timeout
- 139526406 - Bug telah diperbaiki saat penghitungan kuota yang salah terjadi jika aplikasi developer memiliki beberapa produk. Kuota sekarang diterapkan dengan benar untuk setiap produk di 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 pada Edge Microgateway.
- 138633700 - Menambahkan properti konfigurasi baru,
keepAliveTimeout
. Properti ini memungkinkan Anda menetapkan waktu tunggu Edge Microgateway (dalam milidetik). (Default: 5.000 milidetik)Contoh:
edgemicro: keep_alive_timeout: 600
- 140090623 - Menambahkan properti konfigurasi baru,
quotaUri
. Tetapkan properti konfigurasi ini jika Anda ingin mengelola kuota melalui proxyedgemicro-auth
yang di-deploy ke organisasi Anda. Jika properti ini tidak disetel, endpoint kuota akan 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 proxy versi terbaru
edgemicro-auth
ke organisasi. Untuk mengetahui detailnya, lihat Mengupgrade proxy edgemicro-auth. - 138722809 - Menambahkan properti konfigurasi baru,
stack_trace
. Properti ini memungkinkan Anda mengontrol apakah pelacakan tumpukan muncul dalam file log atau tidak. Contoh:stack_trace: false
Jika
stack_trace
ditetapkan ketrue
, pelacakan tumpukan akan dicetak dalam log. Jika kebijakan ini disetel kefalse
, pelacakan tumpukan tidak akan dicetak dalam log.
3.0.5
Pada hari Kamis, 15 Agustus, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Bug yang diperbaiki- 139005279 - Masalah telah diperbaiki saat perintah
edgemicro status
tidak menampilkan jumlah proses pekerja yang tepat. - 138437710 - Masalah telah diperbaiki dalam class ExitCounter yang mencegah penulisan log yang tepat.
- 139064652 - Menambahkan kemampuan untuk menambahkan level logging
trace
dandebug
untuk log peristiwa dan 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 distandardisasi untuk semua laporan log konsol. Laporan logging konsol kini mencakup atribut berikut:
- Stempel waktu
- Nama komponen
- ID proses
- Pesan log konsol
- 138413755 - Meningkatkan kunci JWT dan pesan log terkait rahasia untuk perintah CLI ini: cert, Verify, upgradekvm, token, genkeys, removekeys, turnkey, and Configure.
- 138413577 - Menambahkan dan meningkatkan penanganan error untuk waktu tunggu layanan backend.
- 138413303 - Menambahkan dan meningkatkan penanganan error untuk respons dan waktu tunggu soket.
- 138414116 - Menambahkan dan meningkatkan penanganan kesalahan untuk kesalahan "koneksi ditolak".
3.0.4
Pada hari Kamis, 1 Agustus, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
- 134445926 - Peningkatan pada autentikasi Edge Microgateway internal.
- 137582169 - Mengatasi masalah saat proses yang tidak diinginkan dimulai. Proses tambahan ini menyebabkan plugin dimuat ulang dan menggunakan memori secara berlebihan. Edge Microgateway kini mempertahankan jumlah proses dalam batas yang diharapkan.
- 137768774 - Peningkatan kualitas pesan log:
- Membersihkan log transaksi (permintaan).
- Menambahkan lebih banyak pesan log jika diperlukan.
- Memindahkan pesan log transaksi (permintaan) dari output konsol ke file log yang relevan.
- Mengupdate log konsol untuk menggunakan fungsi logging terpusat.
- 138321133, 138320563 - Perubahan internal dasar pada buffering kuota untuk memungkinkan peningkatan kuota di masa mendatang.
3.0.3
Pada hari Selasa, 23 Juli, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
- Peningkatan logging: Log runtime yang ada menggunakan fungsi
eventLog()
baru yang menangkap dan mencatat data runtime dalam format yang konsisten. 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 terjadinya logging.
- Nama organisasi Apigee.
- Nama lingkungan di organisasi.
- Nama proxy API.
- Alamat IP klien.
- ClientID.
- ID Korelasi (saat ini belum ditetapkan).
- Nama komponen Edge Microgateway.
- Pesan kustom - Beberapa objek dapat mencetak informasi tambahan yang diteruskan ke properti error ini.
- Metode permintaan (jika permintaan HTTP).
- Kode status respons (jika permintaan HTTP).
- Pesan error.
- Kode error - Jika objek berisi kode error, objek tersebut akan dicetak di properti ini.
- Waktu yang diperlukan.
- penanda garis akhir.
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. Masalah ini telah diperbaiki. (135038879)
- Berbagai integrasi pengujian fungsional dan peningkatan kualitas kode.
3.0.2
Pada hari Rabu, 3 Juli 2019, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.
Kualitas kode - Kode telah ditinjau untuk mengetahui kualitas dan perubahan kode telah dilakukan untuk memenuhi standar kualitas yang diminta oleh pengguna. Kami menangani error dan peringatan kualitas kode yang berasal dari JSHint.
Sebagai hasilnya, beberapa kesalahan kode yang sebenarnya telah diidentifikasi dan diperbaiki. Semua modul Apigee Edge Microgateway
telah menjalani proses ini. Lihat commit 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
eksekusi Edge Microgateway untuk kasus penggunaan pelanggan.
3.0.1
Pada hari Jumat, 21 Juni 2019, kami merilis perbaikan dan peningkatan berikut pada 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 mengalami error saat memuat ulang saat dimuat ulang
- 134518428 - Endpoint produk untuk Edge Microgateway menampilkan 5XX jika pola filter 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 - Perhitungan masa tenggang di OAuth salah
- Gunakan modul memored 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 error saat menggunakan cache token. Diperbaiki dalam modul plugin microgateway Edge. (b/134672029)
(Ditambahkan 2.5.37) Tambahkan opsi CLI edgemicro-cert -t
.
Opsi edgemicro cert -t
memungkinkan Anda menentukan token OAuth untuk mengautentikasi API pengelolaan. Lihat juga Mengelola sertifikat.
(Ditambahkan 2.5.35) Menambahkan dukungan untuk men-debug Edge Microgateway menggunakan edgemicroctl
.
Anda dapat menggunakan flag 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
Menambahkan API edgemicro-auth/token baru yang memungkinkan Anda meneruskan klien/secret sebagai header Otorisasi Dasar yang Dienkode Base64 dangrant_type sebagai parameter formulir. Lihat Mendapatkan token pemilik secara langsung.
(Perbaikan 2.5.31) Konfigurasi pribadi tidak mematuhi flag token
Masalah telah diperbaiki saat mengonfigurasi Edge Microgateway untuk menggunakan token akses OAuth2 di Edge untuk Private Cloud tidak berfungsi dengan benar (token tidak diterapkan).
Docker: Dukungan untuk menggunakan sertifikat yang ditandatangani sendiri
(Ditambahkan 2.5.29) Jika menggunakan Certificate Authority (CA) yang tidak dipercaya secara default oleh 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 di container Docker kini mendukung TLS untuk permintaan masuk ke server Edge Microgateway (permintaan ke arah utara) dan untuk permintaan keluar dari Edge Microgateway ke aplikasi target (permintaan arah selatan).
Contoh berikut menjelaskan secara detail cara menyiapkan konfigurasi TLS ini:
Dalam contoh ini, Anda akan melihat cara menggunakan titik pemasangan container /opt/apigee/.edgemicro
untuk memuat sertifikat, yang kemudian dirujuk di file konfigurasi Edge Microgateway.
Docker: Dukungan untuk pembuatan proxy permintaan
(Ditambahkan 2.5.27) Jika menjalankan Edge Microgateway di container Docker, Anda dapat menggunakan opsi ini untuk mengontrol perilaku proxy saat microgateway berjalan di belakang firewall:
HTTP_PROXY
HTTPS_PROXY
NO_PROXY
Untuk mengetahui detailnya, lihat Run Edge Micro as a Docker container.
Docker: Petunjuk plugin yang diperbarui
(Ditambahkan 2.5.27) Jika menjalankan Edge Microgateway di container Docker, Anda kini memiliki dua opsi untuk men-deploy plugin. Salah satu opsi, menggunakan direktori pemasangan Docker, adalah opsi baru. Opsi lain yang ada sebelumnya pada dasarnya tidak berubah; namun, Dockerfile telah diupdate. Untuk mengetahui detailnya, lihat link berikut:
- Opsi A: Pasang direktori plugin pada volume (Baru)
- Opsi B: Membangun plugin ke dalam penampung (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 yang baru memungkinkan Anda memisahkan jalur API tertentu sehingga muncul sebagai proxy terpisah di dasbor Edge Analytics. Misalnya, Anda dapat memisahkan API health check agar tidak membingungkan API tersebut dengan panggilan API yang sebenarnya. Untuk informasi selengkapnya, lihat Mengecualikan jalur dari analisis.
Mengonfigurasi proxy lokal
(Ditambahkan 2.5.25) Dengan proxy lokal, Anda tidak perlu membuat proxy yang peka microgateway secara manual di Apigee Edge. Sebagai gantinya, microgateway akan menggunakan jalur dasar proxy lokal. Untuk 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 apa pun. Skenario yang disebut mode mandiri ini memungkinkan Anda menjalankan dan menguji Edge Microgateway tanpa koneksi Internet.. Lihat Menjalankan Edge Microgateway dalam mode mandiri.
Mencabut kunci
(Menambahkan 2.5.19) Perintah CLI baru telah ditambahkan yang mencabut kredensial kunci dan rahasia untuk konfigurasi Edge Microgateway.
edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]Untuk mengetahui informasi selengkapnya, lihat Mencabut kunci.
Dukungan Docker
(Ditambahkan 2.5.19) Kini Anda dapat mendownload rilis Edge Microgateway terbaru sebagai gambar 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 sespan di depan layanan yang diterapkan 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 algoritma Nagle untuk mem-buffer data sebelum mengirimnya. Menetapkan nodelay
ke true
akan menonaktifkan perilaku ini (data akan langsung mengaktifkan data setiap kali socket.write()
dipanggil). Baca juga dokumentasi Node.js untuk mengetahui 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 Selamanya
(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 proses latar belakang Selamanya. Lihat juga Pemantauan selamanya
Parameter | Deskripsi |
---|---|
-f, --file | Menentukan lokasi file forever.json . |
-a, --action | Berupa start atau stop . Defaultnya adalah mulai. |
Contoh:
Untuk memulai Selamanya:
edgemicro forever -f ~/mydir/forever.json -a start
Untuk menghentikan Selamanya:
edgemicro forever -a stop
Rotasi kunci JWT
Fitur baru telah ditambahkan yang memungkinkan Anda merotasi pasangan kunci publik/pribadi yang digunakan untuk menghasilkan 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 dimulai dengan awalan penamaan "edgemicro_". Anda dapat mengubah default ini untuk mendownload proxy yang namanya cocok dengan pola. Lihat Memfilter proxy yang didownload.
Menentukan produk tanpa proxy API
Di Apigee Edge, Anda dapat membuat produk API yang tidak berisi proxy API. Konfigurasi produk ini memungkinkan kunci API yang terkait dengan produk tersebut berfungsi dengan proxy apa pun yang di-deploy di organisasi Anda. Mulai versi 2.5.4, Edge Microgateway mendukung konfigurasi produk ini.
Dukungan untuk pemantauan selamanya
Edge Microgateway memiliki file forever.json
yang dapat Anda konfigurasi untuk
mengontrol frekuensi dan interval yang harus dimulai ulang Edge Microgateway. File ini mengonfigurasi layanan bernama selamanya-monitor, yang mengelola Forever secara terprogram. Lihat
Pemantauan selamanya.
Pengelolaan terpusat file konfigurasi Edge Micro
Jika menjalankan beberapa instance Edge Microgateway, Anda dapat mengelola konfigurasinya dari satu lokasi. Anda dapat melakukannya dengan menentukan endpoint HTTP tempat 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 perintah ini ditambahkan, file konfigurasi harus berada di direktori root Edge Microgateway.
Contoh:
edgemicro forever ~/mydir/forever.json
Penambahan opsi configUrl untuk memuat ulang perintah
(Ditambahkan 2.5.8) Kini Anda 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 yang disebabkan oleh sedikit perbedaan antara jam sistem Anda dan waktu Not Before (nbf) atau Diterbitkan Pada (iat) yang ditentukan dalam token otorisasi JWT. Setel atribut ini ke jumlah detik untuk memungkinkan perbedaan tersebut. Lihat Atribut OAuth.
(Ditambahkan 2.5.7) Atribut gracePeriod dalam konfigurasi OAuth membantu mencegah error yang disebabkan oleh sedikit perbedaan antara jam sistem Anda dan waktu Not Before (nbf) atau Diterbitkan Pada (iat) yang ditentukan dalam token otorisasi JWT. Setel atribut ini ke jumlah detik untuk memungkinkan perbedaan tersebut. Lihat Atribut OAuth.
Bug yang diperbaiki v2.5.x
- (Masalah #236) Memperbaiki kesalahan ketik dalam membersihkan cache.
- (Masalah #234) Memuat ulang error untuk Edge Microgateway 2.5.35.
- (Masalah #135) Referensi host virtual error "secure" tidak valid saat menggunakan opsi -v. Perbaikan ini memodifikasi proxy edgemicro-auth sebelum deployment untuk memastikan host virtual sama persis dengan yang ditetapkan dalam flag "-v". Selain itu, Anda dapat menentukan berapa pun jumlah dan nama untuk host virtual (tidak lagi dibatasi pada 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- pengaturan-api-proxies-a.html#answer-33336) Token JWT divalidasi dengan Proxy API dan URI Resource di OAUTH. Masalah 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 ditentukan. - (Masalah #169) Mengupdate dependensi Node.js (audit npm)
- Proxy
edgemicro-auth
kini menggunakan kebijakan JWT Edge. Proxy tidak lagi bergantung pada Node.js untuk memberikan 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 dasar default untuk proxy edgemicro-auth. Secara default, jalur dasarnya adalah /edgemicro-auth. Untuk mengubahnya, gunakan flag -x pada perintah edgemicro Configure.
Contoh:
edgemicro configure -x /mypath …
2. Dukungan karakter pengganti untuk jalur dasar (PR 77)
Anda dapat menggunakan satu atau beberapa karakter pengganti "*" di jalur dasar proxy edgemicro_*. Misalnya, jalur dasar /team/*/members memungkinkan klien memanggil https://[host]/team/blue/members dan https://[host]/team/green/members tanpa perlu membuat proxy API baru untuk mendukung tim baru. Perhatikan bahwa /**/ tidak didukung.
Penting: Apigee TIDAK mendukung penggunaan karakter pengganti "*" sebagai elemen pertama jalur dasar. Misalnya, perintah ini TIDAK didukung: /*/search.3. Jalur konfigurasi kustom ditambahkan ke CLI untuk konfigurasi Private Cloud (PR 99)
Secara default, file konfigurasi microgateway ada di ./config/config.yaml. Pada perintah init, konfigurasikan, dan mulai, Anda kini dapat menentukan jalur konfigurasi khusus pada command line menggunakan flag -c atau --configDir. Perbaikan masalah saat direktori konfigurasi kustom untuk penginstalan Private Cloud tidak dikenali.
Contoh:
edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config
4. Mematuhi 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 dapat dipertimbangkan:
Opsi 1:
Opsi pertama adalah menyetel opsi edgemicro: proxy_tunnel ke true dalam file konfigurasi microgateway:
edge_config: proxy: http://10.224.16.85:3128 proxy_tunnel: true
Jika proxy_tunnel bernilai true, Edge Microgateway akan menggunakan metode HTTP CONNECT untuk meneruskan permintaan HTTP melalui koneksi TCP tunggal. (Hal yang sama berlaku jika variabel lingkungan untuk mengonfigurasi proxy mengaktifkan TLS).
Opsi 2:
Opsi kedua adalah menentukan proxy dan menetapkan proxy_tunnel ke false dalam file konfigurasi microgateway. Contoh:
edge_config: proxy: http://10.224.16.85:3128 proxy_tunnel: false
Dalam hal 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 menetapkan NO_PROXY sebagai daftar domain yang dipisahkan koma yang tidak boleh dijadikan proxy oleh Edge Microgateway. Contoh:
export HTTP_PROXY='http://localhost:3786' export HTTPS_PROXY='https://localhost:3786'
Untuk informasi selengkapnya tentang variabel tersebut, 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 terjadi, Edge Microgateway akan merespons dengan kode status 504.
6. Mematuhi pesan status HTTP kustom pada respons target (PR 53)
Edge Microgateway mematuhi pesan status HTTP kustom yang disetel pada respons target. Pada rilis sebelumnya, pesan status yang dikirim dari target diganti dengan default Node.js.
7. Header X-Forwarded-For dapat menetapkan client_ip untuk analisis
Jika ada, header X-Forwarded-For akan menetapkan variabel client_ip yang dilaporkan dalam 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 perubahan ini, plugin menerima salah satu bentuk keamanan. Dengan perubahan ini, Anda hanya dapat mengizinkan salah satu model keamanan tersebut (sekaligus mempertahankan kompatibilitas mundur).
Plugin OAuth menambahkan dua tanda baru:
-
allowOAuthOnly -- Jika ditetapkan ke true, setiap API harus membawa header Otorisasi dengan Token Akses Pemilik.
-
allowAPIKeyOnly -- Jika ditetapkan ke true, setiap API harus membawa 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 perubahan ini diterapkan, proxy menyimpan kunci di Edge Secure Store, yaitu vault terenkripsi. Sekarang, proxy menyimpan kunci di peta nilai kunci (KVM) terenkripsi Edge.
10. Menulis ulang URL target default di plugin (PR 74)
Anda juga dapat mengganti port endpoint target dan memilih antara HTTP dan HTTPS. Ubah variabel-variabel ini 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 true, lihat thread diskusi ini untuk informasi selengkapnya.
11. Dukungan awal untuk autentikasi token OAuth (PR 125)
Anda dapat mengonfigurasi Edge Microgateway agar menggunakan token OAuth untuk autentikasi, bukan nama pengguna/sandi. Untuk menggunakan token OAuth, gunakan parameter berikut pada perintah edgemicro Configure:
-t, --token <token>
Contoh:
edgemicro configure -o docs -e test -t <your token>
Bug perbaikan v2.4.3
- Memperbaiki masalah ketika organisasi berbayar diperlukan untuk menjalankan proxy edgemicro-auth dengan benar. Sekarang, Anda juga dapat menggunakan Edge Microgateway dengan organisasi uji coba. (Humas 5)
- Memperbaiki masalah saat streaming belum selesai memproses data, tetapi pengendali akhir tetap dieksekusi. Hal ini menyebabkan respons sebagian dikirim. (Humas 71)
- Perbaikan masalah saat direktori konfigurasi kustom untuk penginstalan Private Cloud tidak dikenali. (Humas 110)
- Memperbaiki masalah SSL dua arah antara klien dan Edge Microgateway. (Humas 70)
- Memperbaiki masalah saat garis miring penutup diperlukan pada jalur dasar proxy agar verifikasi kunci API berfungsi dengan benar. Sekarang, garis miring tidak diperlukan di akhir jalur {i>basepath<i}. (Humas 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, Edge akan mendownload semua proxy yang peka terhadap microgateway di organisasi yang terkait dengannya. Gunakan konfigurasi berikut untuk membatasi proxy yang akan diproses oleh microgateway. Misalnya, konfigurasi ini membatasi proxy yang akan diproses oleh microgateway 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 permintaan informasi jalur muncul di analisis Edge. Tambahkan kode berikut ke konfigurasi microgateway untuk menyamarkan URI permintaan dan/atau jalur permintaan. Perlu diketahui bahwa URI terdiri dari bagian nama host dan jalur permintaan.
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 menetapkan atribut ini dalam konfigurasi microgateway:
disabled_config_poll_interval: true
Secara default, polling berkala mendeteksi setiap perubahan yang dilakukan di Edge (perubahan pada produk, proxy yang mendukung microgateway, dll.) serta perubahan yang dilakukan pada file konfigurasi lokal. Interval polling default adalah 600 detik (lima menit).
Menulis ulang URL target dalam plugin
Anda dapat mengganti URL target default secara dinamis dalam plugin dengan mengubah variabel berikut 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 memudahkan plugin untuk mengakses respons target.
function(sourceRequest, sourceResponse, targetResponse, data, cb)
Output logging default yang disederhanakan
Secara default, layanan logging kini menghilangkan JSON dari proxy, produk, dan JWT yang didownload.
Anda dapat mengubahnya menjadi default untuk menghasilkan objek ini dengan menyetel DEBUG=*
saat memulai 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 ada di ./config/config.yaml. Dengan perintah init, konfigurasikan, dan mulai, Anda kini dapat menentukan jalur konfigurasi khusus pada command line. Contoh:
edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config
Bug diperbaiki v2.3.3
- Kebocoran memori telah diperbaiki yang terjadi selama permintaan/respons yang besar.
- Urutan eksekusi plugin telah diperbaiki. Atribut ini kini berperilaku seperti yang dijelaskan dalam dokumentasi.
- Plugin collect-request plugin tidak lagi berhenti untuk permintaan GET.
- Masalah dalam plugin akumulasi-respons telah diperbaiki, di mana kurangnya isi respons menyebabkan error.
Rilis 2.3.1
Catatan penginstalan
Beberapa versi Edge Microgateway 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 detail selengkapnya.
Fitur dan peningkatan baru v.2.3.1
Berikut adalah fitur dan peningkatan baru untuk rilis ini.
Filter proxy
Konfigurasi baru memungkinkan Anda memfilter proxy yang akan dimuat Edge Microgateway saat startup. Sebelumnya, microgateway memuat semua proxy yang peka terhadap microgateway (proxy bernama edgemicro_*) yang diambil dari organisasi/lingkungan Edge yang Anda tentukan dalam perintah konfigurasi edgemicro. Fitur baru ini memungkinkan Anda memfilter daftar proxy ini sehingga Edge Microgateway hanya memuat proxy yang Anda tentukan. Cukup tambahkan elemen proxy ke file konfigurasi microgateway seperti ini:
edge micro: proxies: - edgemicro_[name] - edgemicro_[name] ...
Misalnya, Anda memiliki 50 proxy edgemicro_*
di org/env Edge, termasuk yang bernama edgemicro_foo
dan edgemicro_bar
. Anda dapat memberi tahu microgateway untuk menggunakan dua proxy ini saja seperti ini:
edge micro: proxies: - edgemicro_foo - edgemicro_bar
Saat memulai, microgateway hanya akan dapat memanggil proxy yang ditentukan. Setiap upaya untuk memanggil proxy yang peka terhadap microgateway lain yang didownload dari organisasi/lingkungan Edge akan menghasilkan error.
Menetapkan header permintaan target di plugin
Ada dua pola dasar yang perlu dipertimbangkan jika Anda ingin menambahkan atau mengubah header permintaan target: satu pola di mana permintaan masuk berisi data (seperti dalam permintaan POST) dan satu pola yang tidak berisi data (seperti dalam permintaan GET sederhana).
Mari kita perhatikan kasus ketika permintaan masuk berisi data, dan Anda ingin menetapkan header permintaan pada permintaan target. Pada Edge Microgateway versi sebelumnya, dalam kasus ini, Anda tidak dapat menetapkan header target secara andal.
Kunci dari pola ini adalah mengumpulkan semua data yang masuk dari klien terlebih dahulu. Kemudian, dalam
fungsi onend_request()
, gunakan fungsi baru request.setOverrideHeader(name,
value)
untuk menyesuaikan header.
Berikut adalah contoh kode plugin yang menunjukkan cara melakukannya. Header yang ditetapkan dalam onend_request
akan 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 -- pola ini telah didokumentasikan sebelumnya
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 melepaskan pesan apa pun. Dengan perubahan ini, Edge Microgateway selalu dimulai dalam mode cluster,
dan opsi --cluster
telah dihapus dari perintah
edgemicro start
.
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 konfigurasi Edge Microgateway tanpa periode nonaktif.
Pemuatan ulang konfigurasi otomatis tanpa periode nonaktif
Edge Microgateway memuat konfigurasi baru secara berkala dan mengeksekusi pemuatan ulang jika ada perubahan. Polling ini mendeteksi setiap perubahan yang dilakukan di Edge (perubahan pada produk, proxy yang peka microgateway, dll.) serta perubahan yang dilakukan pada file konfigurasi lokal. Interval polling default adalah 600 detik (lima menit). Anda dapat mengubah setelan default di file konfigurasi microgateway sebagai berikut:
edgemicro: config_change_poll_interval: [seconds]
Menambahkan informasi versi ke CLI
Flag --version
telah ditambahkan ke CLI. Untuk mendapatkan versi Edge
Microgateway terbaru, gunakan:
edgemicro --version
Opsi SSL server Edge Microgateway baru
Edge Microgateway kini 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 disediakan. Jika verifikasi gagal, pesan error akan ditampilkan. |
secureProtocol |
Metode SSL yang akan digunakan. Misalnya, SSLv3_method untuk memaksa SSL ke versi 3. |
servername |
Nama server untuk ekstensi TLS SNI (Indikasi Nama Server). |
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 kustom. Endpoint tersebut adalah:
edgeconfig:verify_api_key_url
edgeconfig:products
Untuk mengetahui detailnya, lihat Menggunakan layanan autentikasi kustom.
Versi 2.1.1
Berikut adalah fitur dan peningkatan baru untuk rilis ini.
Men-deploy proxy autentikasi yang kompatibel dengan lintas platform
Peningkatan dilakukan sehingga perintah yang digunakan untuk men-deploy proxy otorisasi Edge Microgateway ke Edge kompatibel dengan 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 opsi konfigurasi baru. Lihat Menggunakan opsi SSL/TSL klien.
Versi 2.0.11
Catatan penginstalan v2.0.11
Beberapa versi Edge Microgateway 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 detail selengkapnya.
Fitur dan peningkatan baru v.2.0.11
Berikut adalah fitur dan peningkatan baru:
Menentukan port saat memulai
Perintah start memungkinkan Anda menentukan nomor port untuk menggantikan port yang ditentukan dalam file konfigurasi. Anda juga dapat menentukan nomor port menggunakan variabel lingkungan PORT. Lihat perintah start untuk mengetahui detailnya.
Pertahankan header autentikasi secara opsional
Setelan konfigurasi baru, keepAuthHeader, memungkinkan Anda mempertahankan header Otorisasi yang dikirim dalam permintaan. Jika ditetapkan ke true, header Auth akan diteruskan ke target. Lihat atribut oauth.
Kemampuan untuk menggunakan layanan otorisasi kustom
Jika ingin menggunakan layanan kustom Anda sendiri untuk menangani autentikasi, ubah nilai authUri di file konfigurasi Edge Microgateway agar mengarah ke layanan Anda. Untuk mengetahui detailnya, 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 akses ke API berdasarkan akhiran jalur proxy. Untuk mengetahui detail tentang cara membuat produk dan mengonfigurasi jalur resource, lihat Membuat produk API.
Dukungan untuk penginstalan global npm
Anda sekarang dapat menginstal Edge Microgateway menggunakan opsi npm -g (global). Untuk detail tentang opsi ini, lihat dokumentasi npm.
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 kini adalah server proses tunggal. Platform ini tidak lagi menggunakan model dua proses, di mana satu proses (sebelumnya dikenal sebagai "agen") meluncurkan Edge Microgateway, yakni proses kedua. Arsitektur baru ini mempermudah otomatisasi dan containerization.
File konfigurasi dengan namespace
Sekarang file konfigurasi diberi namespace menggunakan organisasi dan lingkungan sehingga beberapa instance Microgateway dapat dijalankan pada host yang sama. Anda dapat menemukan file konfigurasi di ~/.edgemicro setelah menjalankan perintah konfigurasi Edge Microgateway.
Variabel lingkungan baru
Kini ada 4 variabel lingkungan: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Jika variabel ini ditetapkan di sistem, Anda tidak perlu menentukan nilainya saat 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 aplikasi dimulai ulang tanpa koneksi ke Apigee Edge.
Mode cluster
Kini ada opsi untuk memulai Edge Microgateway dalam mode cluster. Dengan mode cluster, Anda dapat memanfaatkan sistem multi-core. Microgateway menggunakan modul cluster Node.js untuk fitur ini. Untuk mengetahui detailnya, baca dokumentasi Node.js.
Bug perbaikan v2.0.0
Siklus proses peristiwa plugin kini menangani kode asinkron yang berisi kode dengan benar menggunakan callback baru.
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. Peningkatan ini meningkatkan performa dan stabilitas secara keseluruhan pada beban tinggi.
Dukungan debugger jarak jauh
Anda dapat mengonfigurasi Edge Microgateway untuk berjalan dengan debugger jarak jauh, seperti node-inspector.
Lokasi file konfigurasi baru
Saat Anda mengonfigurasi Edge Microgateway, file agent/config/default.yaml
kini
akan disalin ke ~./edgemicro/config.yaml
.
Pemutaran file log
Atribut konfigurasi baru memungkinkan Anda menentukan interval rotasi untuk log Edge Microgateway.
Bug yang diperbaiki v1.1.2
Bug berikut telah diperbaiki di v. 1.1.2.
Deskripsi |
---|
Info Java untuk proxy internal edgemicro-yang digunakan dengan Edge lokal sekarang menggunakan server MGMT yang tepat. |
Hapus dependensi typescript dari agen. |
Memperbaiki bug CLI saat menggunakan opsi deployment ramping. |
Memperbaiki referensi dependensi logika sertifikat. |