Catatan rilis Edge Microgateway

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.7

Pada 17 Juli 2025, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Perbaikan bug dan peningkatan:

edgemicro:
  plugins:
    excludeUrls: '/hello,/proxy_one/*' # global exclude urls
    sequence:
      -oauth
      -json2xml
      -quota
      -json2xml:
          excludeUrls: '/hello/xml/*'  # plugin level exclude urls

Masalah keamanan telah diperbaiki

• CVE-2024-12905
• CVE-2025-46653

3.3.6

Pada 16 April 2025, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.3.6. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Masalah keamanan telah diperbaiki

• CVE-2025-27789
• CVE-2024-21538
• CVE-2024-12133

3.3.5

Pada Jumat, 20 Desember 2024, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.3.5. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

current nodejs version is  18.x.x Note, v18.x.x will be out of support soon, see https://docs.apigee.com/release/notes/edge-microgateway-release-notes-0

You are using a version of NodeJS that is not supported

Masalah keamanan telah diperbaiki

• CVE-2024-21538
• CVE-2024-45590
• CVE-2019-3844
• CVE-2019-12290
• CVE-2020-1751
• CVE-2018-12886
• CVE-2023-50387
• CVE-2019-3843
• CVE-2022-4415
• CVE-2021-3997

3.3.4

Pada 18 September 2024, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.3.4. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

• CVE-2021-23337
• CVE-2024-4068
• CVE-2020-28469
• CVE-2020-28503

3.3.3

Pada 25 April 2024, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.3.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

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 pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.3.2. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

Tidak ada.

3.3.1

Pada 7 Juni 2022, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.3.1. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

3.3.0

Pada 4 Februari 2022, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.3.0. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

npm install apigeetool@0.15.1

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 mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.2.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

3.2.2

Pada Kamis, 15 Juli 2021, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.2.2. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

3.2.1

Pada Jumat, 5 Maret 2021, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.2.1. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

edgemicro:
 enable_GET_req_body: true

3.2.0

Pada Kamis, 21 Januari 2021, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.2.0. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

Versi 3.1.x

Perbaikan bug dan peningkatan v.3.1.x

3.1.8

Pada Senin, 16 November 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.8. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

3.1.7

Pada Kamis, 24 September 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.7. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

Pada Kamis, 20 Agustus 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.6. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

3.1.5

Pada Jumat, 26 Juni 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.5. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

3.1.4

Pada Jumat, 23 April 2020, kami merilis perbaikan berikut untuk Edge Microgateway.

Perbaikan bug:

Masalah dependensi di versi 3.1.3 telah diperbaiki. Versi 3.1.3 telah ditandai sebagai tidak digunakan lagi di repositori npm. Selain itu, semua perbaikan bug dan peningkatan yang dijelaskan dalam catatan rilis versi 3.1.3 berlaku untuk rilis ini.

3.1.3

Pada Rabu, 15 April 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

• 153509313 - Masalah yang menyebabkan kebocoran memori pada modul debug Node.js telah diperbaiki. Masalah ini ada di versi v3.1.0, v3.1.1, dan 3.1.2.
• 153509313 - Masalah telah diperbaiki yang menyebabkan ID pesan yang sama untuk dua transaksi berbeda dicetak dalam output logging.
• 151673570 - Masalah telah diperbaiki saat Edge Microgateway tidak diupdate untuk menggunakan API KVM Apigee baru. Edge Microgateway kini menggunakan perintah baru untuk menambahkan dan memperbarui nilai KVM.
• 152822846 - Pada rilis sebelumnya, Edge Microgateway telah diupdate sehingga pemrosesan pemetaan jalur resource-nya cocok dengan Apigee Edge. Dalam rilis ini, masalah telah diperbaiki saat 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 Senin, 16 Maret 2020, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.3. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

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 dukungan proxy HTTP yang ada antara Edge Microgateway dan Apigee Edge. Untuk mengetahui detailnya, lihat:
  • Menggunakan proxy HTTP untuk komunikasi dengan Apigee Edge
  • Menggunakan proxy HTTP untuk komunikasi target
• 149101890 - Kode notifikasi log untuk kasus saat server target atau load balancer menutup koneksinya diubah dari ERROR menjadi INFO.
• 150746985 - Masalah telah diperbaiki saat perintah edgemicro verify tidak berfungsi dengan benar jika redisBasedConfigCache: true atau quotaUri: https://%s-%s.apigee.net/edgemicro-auth ada dalam file konfigurasi.
• 151284716 - Peningkatan dilakukan untuk menutup koneksi server lebih cepat saat pekerja dimulai ulang selama pemuatan ulang.
• 151588764 - Update versi Node.js di image Docker yang digunakan untuk menjalankan Edge Microgateway dalam container Docker ke 12, karena Node.js v8 tidak digunakan lagi.
• 151306049 - Pembaruan dokumentasi dilakukan untuk mencantumkan API pengelolaan Apigee Edge yang digunakan oleh perintah CLI Edge Microgateway. Lihat API pengelolaan apa yang digunakan Edge Microgateway?.

3.1.1

Pada Kamis, 20 Februari, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.1. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

• 146069701 - Masalah telah diperbaiki saat modul microgateway-core tidak mematuhi variabel lingkungan HTTP_PROXY dan HTTPS_PROXY. Dengan perubahan ini, setelan proxy dalam file konfigurasi YAML, jika ditentukan, kini 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, telah ditambahkan. Atribut ini membatasi jumlah waktu (dalam milidetik) yang akan ditunggu oleh parser HTTP untuk menerima header HTTP lengkap. Contoh:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Secara internal, parameter ini menetapkan atribut Server.headersTimeout Node.js pada permintaan. (Default: 5 detik lebih lama dari waktu yang ditetapkan dengan edgemicro.keep_alive_timeout. Setelan default ini mencegah load balancer atau proxy menghentikan koneksi secara keliru.)

• 149278885 - Fitur baru telah ditambahkan yang memungkinkan Anda menetapkan waktu tunggu API target di tingkat proxy API, bukan menggunakan satu setelan waktu tunggu global.

  Jika Anda menyetel properti TargetEndpoint io.timeout.millis di proxy API, Edge Microgateway akan dapat mengambil properti tersebut dan menerapkan batas waktu khusus endpoint target. Jika parameter ini tidak diterapkan, Edge Microgateway akan menggunakan waktu tunggu global yang ditentukan dengan edgemicro.request_timeout.

3.1.0

Pada Selasa, 21 Januari, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.1.0. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

• 144187500 - Peristiwa tingkat PERINGATAN baru akan dicatat saat tanda quotas.failOpen dipicu. Flag ini dipicu jika terjadi error pemrosesan kuota atau jika permintaan "penerapan kuota" ke Edge gagal memperbarui penghitung kuota jarak jauh. Dalam hal ini, kuota akan diproses berdasarkan jumlah lokal saja hingga sinkronisasi kuota jarak jauh berikutnya berhasil. Sebelumnya, peristiwa ini hanya dicatat ke dalam log saat level log disetel 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 yang menyebabkan transaksi dalam proses atau transaksi baru terpengaruh setiap kali Edge Microgateway mendeteksi perubahan pada proxy API. Sekarang, saat perubahan dilakukan pada proxy, Edge Microgateway akan memperbarui cache dan node pekerja akan dimulai ulang. Dengan perubahan ini, transaksi dalam proses dan panggilan API baru yang dikirim ke microgateway tidak terpengaruh.
• 146378327 - Level log sourceRequest, targetRequest, dan targetResponse telah diubah ke level INFO.
• 146019878 - Perbedaan antara latensi yang dihitung untuk "Performa Proxy API" di Analytics Edge dan peristiwa log sourceResponse/targetResponse Edge Microgateway telah diperbaiki. Sekarang, latensi dalam peristiwa log analisis Edge dan Microgateway sudah selaras.
• Perubahan terkait logika pencocokan pola:
  • 147027862 - Plugin oauth telah diupdate untuk mendukung pola pencocokan jalur resource berikut seperti yang ditentukan dalam Produk API:
    • /{literal}**
    • /{literal}*
    • Kombinasi 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 - Update logika pencocokan pola plugin apiKeys agar cocok dengan plugin oauth.
• 143488312 - Masalah telah diperbaiki ketika spasi di awal atau akhir parameter ID klien menyebabkan pembuatan daftar produk JWT menjadi kosong untuk permintaan token OAuth dan kunci API.
• 145640807 dan 147579179 - Fitur baru telah ditambahkan yang memungkinkan instance Edge Microgateway khusus yang disebut "penyinkron" mengambil data konfigurasi dari Apigee Edge dan menuliskannya ke database Redis lokal. Instance microgateway lainnya kemudian dapat dikonfigurasi untuk membaca data konfigurasi dari database. Fitur ini menambahkan tingkat ketahanan ke Edge Microgateway. Hal ini memungkinkan instance microgateway dimulai dan berfungsi tanpa perlu berkomunikasi dengan Apigee Edge. Untuk mengetahui detailnya, lihat Menggunakan sinkronisasi.

  Fitur sinkronisasi 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 Jumat, 8 November, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.0.10. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

• 142677575 - Pembaruan 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 Anda menggunakan pola resource gabungan seperti /*/2/**, Anda harus memastikan bahwa proxy edgemicro_auth ditambahkan ke produk API mandiri. Kemudian, Anda harus menyertakan produk tersebut di Aplikasi Developer proxy, seperti yang diilustrasikan 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). Properti quotas 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 disebut quotas. Untuk mengetahui detail tentang masing-masing properti konfigurasi quotas, 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 yang memungkinkan Anda menggunakan Redis sebagai penyimpanan pendukung kuota. Jika useRedis bernilai benar, maka modul volos-quota-redis akan digunakan. Jika benar (true), kuota hanya dibatasi untuk instance Edge Microgateway yang terhubung ke Redis. Jika salah (false), modul 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 dibuat oleh proxy edgemicro-auth telah diubah dari 108.000 milidetik (1,8 menit) menjadi 1.800 detik (30 menit).
• 143551282 - Untuk mendukung organisasi yang mengaktifkan SAML, perintah edgemicro genkeys telah diperbarui untuk menyertakan parameter ‑‑token. Dengan parameter ini, Anda dapat menggunakan token OAuth untuk autentikasi, bukan nama pengguna/sandi. Untuk mengetahui detailnya, lihat Membuat kunci.

3.0.9

Pada Jumat, 11 Oktober, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.0.9. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

• 141989374 - Fitur "fail open" baru ditambahkan untuk plugin kuota. Jika 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 saja hingga sinkronisasi kuota jarak jauh berikutnya berhasil. Dalam kedua kasus ini, tanda quota-failed-open ditetapkan dalam objek permintaan.

  Untuk mengaktifkan fitur "fail open" kuota, tetapkan konfigurasi berikut:

  quotas :
   failOpen : true

  Catatan: Selain itu, nama tanda objek permintaan fail-open plugin OAuth telah diubah menjadi oauth-failed-open.

• 142093764 - Perubahan konfigurasi dilakukan pada proxy edgemicro-auth untuk mencegah penggunaan kuota berlebih. Perubahan ini adalah menetapkan jenis kuota ke calendar. Untuk menggunakan peningkatan ini, Anda harus mengupdate edgemicro-auth ke versi 3.0.7 atau yang lebih tinggi.
• 142520568 - Fitur baru telah ditambahkan untuk mengaktifkan pencatatan ID MP (message processor) 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 ditetapkan, 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 Kamis, 26 September, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.0.8. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

• 140025210 - Fitur "fail open" baru telah ditambahkan. Fitur ini memungkinkan pemrosesan API berlanjut jika token JWT yang sudah habis masa berlakunya tidak dapat di-refresh karena error koneksi yang mencegah panggilan verifikasi kunci API yang berhasil ke proxy edgemicro-auth.

  Fitur ini memungkinkan Anda menyetel masa tenggang saat token lama tetap berada di cache dan digunakan kembali hingga masa tenggang berakhir. Fitur ini memungkinkan Edge Microgateway untuk terus memproses permintaan jika terjadi kegagalan koneksi sementara. Saat konektivitas dilanjutkan, dan panggilan Verify API Key berhasil dilakukan, JWT baru akan diambil dan menggantikan JWT lama dalam cache.

  Untuk mengonfigurasi fitur "fail open" baru, lakukan hal berikut:

  1. Tetapkan properti berikut di stanza oauth dalam 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 di-refresh karena masalah konektivitas. Setelah 5 detik, error autentikasi akan ditampilkan.

• 141168968 - Pembaruan dilakukan untuk menyertakan correlation_id di semua output log plugin. Selain itu, level log untuk beberapa log diubah menjadi error sesuai kebutuhan.
• 140193349 - Pembaruan dilakukan pada proxy edgemicro-auth untuk mewajibkan verifikasi kunci dan rahasia Edge Microgateway pada setiap permintaan Verifikasi Kunci API. Edge Microgateway telah diperbarui untuk selalu mengirimkan kunci dan rahasia pada setiap permintaan Verifikasi Kunci API. Perubahan ini mencegah klien mendapatkan JWT hanya dengan kunci API.
• 140090250 - Pembaruan dilakukan untuk menambahkan logging diagnostik untuk pemrosesan kuota. Dengan perubahan ini, kini Anda dapat menghubungkan output log kuota dengan log Edge Microgateway lainnya.

3.0.7

Pada Kamis, 12 September, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Versi komponen:

Tabel berikut mencantumkan nomor versi untuk masing-masing project komponen yang terkait dengan Edge Microgateway 3.0.7. Perhatikan bahwa karena setiap komponen adalah project terpisah, nomor rilis mungkin tidak cocok dengan versi produk utama:

Perbaikan bug dan peningkatan:

• 140075602 - Plugin OAuth telah diupdate untuk menampilkan kode status 5xx jika sesuai. Sebelumnya, plugin hanya menampilkan kode status 4xx dalam semua kasus non-200. Sekarang, untuk respons pesan apa pun yang bukan status 200, kode 4xx atau 5xx yang tepat akan ditampilkan, bergantung pada errornya.

  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 - Pada rilis 3.0.6, properti konfigurasi baru ditambahkan, quota.quotaUri. Tetapkan properti konfigurasi ini jika Anda ingin mengelola kuota melalui proxy edgemicro-auth yang di-deploy ke organisasi Anda. Jika properti ini tidak ditetapkan, endpoint kuota secara default adalah 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 properti quotaUri, Anda harus mengupgrade ke proxy edgemicro-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 "organization" dari ID kuota. Karena endpoint kuota berada di organisasi pelanggan, ID kuota tidak lagi diperlukan.
• 140823165 - Nama properti berikut:

  edgemicro:
      keepAliveTimeout

  didokumentasikan secara salah di rilis 3.0.6. Nama properti yang benar adalah:

  edgemicro:
      keep_alive_timeout

• 139526406 - Bug telah diperbaiki yang menyebabkan jumlah kuota salah jika aplikasi developer memiliki beberapa produk. Kuota kini diterapkan dengan benar untuk setiap produk di aplikasi yang memiliki beberapa produk. Kombinasi 'appName + productName' digunakan sebagai ID kuota.

3.0.6

Pada 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 proxy edgemicro-auth yang di-deploy ke organisasi Anda. Jika properti ini tidak ditetapkan, 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 men-deploy versi terbaru proxy edgemicro-auth ke organisasi Anda terlebih dahulu. Untuk mengetahui detailnya, lihat Mengupgrade proxy edgemicro-auth.

• 138722809 - Menambahkan properti konfigurasi baru, stack_trace. Properti ini memungkinkan Anda mengontrol apakah stack trace muncul dalam file log atau tidak. Contoh:

  stack_trace: false

  Jika stack_trace disetel ke true, pelacakan tumpukan akan dicetak dalam log. Jika disetel ke false, stack trace tidak akan dicetak dalam log.

3.0.5

Pada Kamis, 15 Agustus, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

• 139005279 - Masalah telah diperbaiki saat perintah edgemicro status tidak menampilkan jumlah proses pekerja yang benar.
• 138437710 - Masalah telah diperbaiki di class ExitCounter yang mencegah log yang benar ditulis.

• 139064652 - Menambahkan kemampuan untuk menambahkan level logging trace dan debug untuk log peristiwa dan sistem. Untuk saat ini, hanya kemampuan untuk menambahkan tingkat log ini yang ditambahkan. Saat ini, level log yang tersedia adalah info, warn, dan error.
• 139064616 - Output log telah distandardisasi untuk semua pernyataan log konsol. Pernyataan logging konsol kini menyertakan atribut berikut:
• Stempel waktu
• Nama komponen
• ID proses
• Pesan log konsol

• 138413755 - Meningkatkan kualitas pesan log terkait kunci dan secret JWT untuk perintah CLI berikut: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey, dan configure.

• 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 error "koneksi ditolak".

3.0.4

Pada Kamis, 1 Agustus, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

• 134445926 - Peningkatan pada autentikasi Edge Microgateway internal.
• 137582169 - Memperbaiki masalah saat proses yang tidak diinginkan dimulai. Proses tambahan menyebabkan plugin dimuat ulang dan menggunakan memori yang berlebihan. Edge Microgateway kini menjaga jumlah proses dalam batas yang diharapkan.
• 137768774 - Peningkatan pesan log:
  • Membersihkan log transaksi (permintaan).
  • Menambahkan pesan log lainnya jika diperlukan.
  • Memindahkan pesan log transaksi (permintaan) dari output konsol ke file log yang relevan.
  • Memperbarui log konsol untuk menggunakan fungsi logging terpusat.
• 138321133, 138320563 - Perubahan internal mendasar pada buffer kuota untuk memungkinkan peningkatan kuota di masa mendatang.

3.0.3

Pada Selasa, 23 Juli, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

• Peningkatan pencatatan log: Log runtime yang ada menggunakan fungsi eventLog() baru yang merekam 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 logging terjadi.
  • Nama organisasi Apigee.
  • Nama lingkungan dalam organisasi.
  • Nama proxy API.
  • Alamat IP klien.
  • ClientId.
  • ID korelasi (saat ini tidak 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 menyertakan kode error, kode tersebut akan dicetak dalam properti ini.
  • Waktu yang dibutuhkan.
  • Sistem operasi penanda akhir baris.

  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 Rabu, 3 Juli 2019, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

Kualitas kode - Kode telah ditinjau kualitasnya dan perubahan kode telah dilakukan untuk memenuhi standar kualitas yang diminta oleh pengguna. Kami mengatasi error dan peringatan kualitas kode yang berasal dari JSHint. Beberapa error kode yang sebenarnya telah diidentifikasi dan diperbaiki sebagai hasilnya. Semua modul Apigee Edge Microgateway telah melalui 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 Jumat, 21 Juni 2019, kami merilis perbaikan dan peningkatan berikut pada Edge Microgateway.

• 134834551 - Mengubah versi Node.js yang didukung untuk Edge Microgateway
  (Versi Node.js yang didukung: 8 dan 12; versi 7, 9, dan 11 bersifat eksperimental)
• 134751883 - Edge Microgateway mengalami error saat memuat ulang di bawah beban
• 134518428 - Endpoint produk untuk Edge Microgateway menampilkan 5XX jika pola filter salah
• 135113408 - Pekerja harus memulai ulang jika mereka berhenti secara tiba-tiba
• 134945852 - tokenCacheSize tidak digunakan di plug-in oauth
• 134947757 - set cacheTTL in oauth plug-in
• 135445171 - gracePeriod calculation in OAuth is not correct
• Menggunakan modul memored yang disediakan dengan penginstalan Edge Microgateway
• 135367906 - Audit keamanan

Versi 2.5.x

Fitur dan peningkatan baru v.2.5.x

(Diperbaiki 2.5.38, 06/07/2019)

JWT yang tidak diformat dengan benar dapat menyebabkan error pada pekerja saat menggunakan cache token. Diperbaiki dalam modul microgateway-plugins 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 pada 2.5.35) Aktifkan build Windows untuk edgemicroctl.

(Ditambahkan 2.5.31) API edgemicro-auth/token baru

API edgemicro-auth/token baru telah ditambahkan yang memungkinkan Anda meneruskan client/secret sebagai header Otorisasi Dasar yang Di-Encode Base64 dan grant_type sebagai parameter formulir. Lihat Mendapatkan token pembawa secara langsung.

(Diperbaiki di 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 dipertimbangkan).

Docker: Dukungan untuk menggunakan sertifikat yang ditandatangani sendiri

(Ditambahkan 2.5.29) Jika Anda menggunakan Otoritas Sertifikat (CA) yang tidak dipercaya secara default oleh Node.js, Anda dapat menggunakan parameter NODE_EXTRA_CA_CERTS saat menjalankan penampung 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 utara) dan untuk permintaan keluar dari Edge Microgateway ke aplikasi target (permintaan ke selatan).

Contoh berikut menjelaskan secara mendetail cara menyiapkan konfigurasi TLS ini:

• Contoh konfigurasi TLS northbound
• Contoh konfigurasi TLS southbound

Dalam contoh ini, Anda akan melihat cara menggunakan titik pemasangan container /opt/apigee/.edgemicro untuk memuat sertifikat, yang kemudian dirujuk dalam file konfigurasi Edge Microgateway.

Docker: Dukungan untuk proxy permintaan

(Ditambahkan 2.5.27) Jika menjalankan Edge Microgateway dalam 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 Menjalankan Edge Micro sebagai container Docker.

Docker: Petunjuk plugin yang diperbarui

(Ditambahkan 2.5.27) Jika Anda menjalankan Edge Microgateway dalam container Docker, kini Anda memiliki dua opsi untuk men-deploy plugin. Salah satu opsi, menggunakan titik pemasangan Docker, adalah opsi baru. Opsi lainnya sudah 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 Edge Analytics

(Ditambahkan 2.5.26) Plugin analisis baru memungkinkan Anda memisahkan jalur API tertentu sehingga muncul sebagai proxy terpisah di dasbor Edge Analytics. Misalnya, Anda dapat memisahkan API pemeriksaan kondisi untuk menghindari kebingungan dengan panggilan API sebenarnya. Untuk mengetahui informasi selengkapnya, lihat Mengecualikan jalur dari analisis.

Mengonfigurasi proxy lokal

(Ditambahkan 25.2.25) Dengan proxy lokal, Anda tidak perlu membuat proxy yang kompatibel dengan 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 25.2.2025) Anda dapat menjalankan Edge Microgateway yang sepenuhnya terputus dari dependensi Apigee Edge. Skenario ini, yang 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 konfigurasi Edge Microgateway.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

Dukungan Docker

(Ditambahkan 2.5.19) Anda kini 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 sidecar di depan layanan yang di-deploy di cluster Kubernetes. Lihat: Mengintegrasikan Edge Microgateway dengan ringkasan Kubernetes.

Dukungan untuk opsi TCP nodelay

(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 mengirimkannya. Menetapkan nodelay ke true akan menonaktifkan perilaku ini (data akan segera dikirim setiap kali socket.write() dipanggil). Lihat 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 Forever

(Ditambahkan 2.5.12) Parameter baru telah ditambahkan ke perintah edgemicro forever. Dengan parameter ini, Anda dapat menentukan lokasi file forever.json, dan memulai atau menghentikan proses latar belakang Forever. Lihat juga Pemantauan selamanya

Contoh:

Untuk memulai Forever:

edgemicro forever -f ~/mydir/forever.json -a start

Untuk menghentikan Forever:

edgemicro forever -a stop

Rotasi kunci JWT

Fitur baru telah ditambahkan yang memungkinkan Anda mengganti pasangan kunci publik/pribadi yang digunakan untuk membuat token JWT yang digunakan untuk keamanan OAuth di Edge Microgateway. Lihat Merotasi 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 apa pun. 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 berapa kali dan dengan interval apa Edge Microgateway harus dimulai ulang. File ini mengonfigurasi layanan yang disebut forever-monitor, yang mengelola Forever secara terprogram. Lihat Pemantauan selamanya.

Pengelolaan terpusat file konfigurasi Edge Micro

Jika menjalankan beberapa instance Edge Microgateway, Anda mungkin ingin 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 pada 2.5.8) Gunakan perintah edgemicro forever [package.json] untuk menentukan lokasi file forever.json. Sebelum perintah ini ditambahkan, file config harus berada di direktori root Edge Microgateway.

Contoh:

edgemicro forever ~/mydir/forever.json

Penambahan opsi configUrl ke perintah muat ulang

(Ditambahkan 2.5.8) Anda kini dapat menggunakan opsi --configUrl atau -u dengan perintah edgemicro reload.

Masa tenggang untuk perbedaan waktu JWT

(Ditambahkan pada 2.5.7) Atribut gracePeriod dalam konfigurasi OAuth membantu mencegah error yang disebabkan oleh sedikit perbedaan antara waktu sistem Anda dan waktu Not Before (nbf) atau Issued At (iat) yang ditentukan dalam token otorisasi JWT. Tetapkan atribut ini ke jumlah detik untuk memungkinkan perbedaan tersebut. Lihat atribut OAuth.

(Ditambahkan pada 2.5.7) Atribut gracePeriod dalam konfigurasi OAuth membantu mencegah error yang disebabkan oleh sedikit perbedaan antara waktu sistem Anda dan waktu Not Before (nbf) atau Issued At (iat) yang ditentukan dalam token otorisasi JWT. Tetapkan atribut ini ke jumlah detik untuk memungkinkan perbedaan tersebut. Lihat atribut OAuth.

Bug yang diperbaiki v2.5.x

• (Masalah #236) Memperbaiki kesalahan ketik saat menghapus cache.
• (Masalah #234) Terjadi error saat memuat ulang untuk Edge Microgateway 2.5.35.
• (Masalah #135) Error referensi host virtual "secure" yang tidak valid saat menggunakan opsi -v. Perbaikan ini mengubah proxy edgemicro-auth sebelum deployment untuk memastikan host virtual cocok persis dengan yang ditentukan dalam tanda "-v". Selain itu, Anda dapat menentukan jumlah dan nama host virtual (tidak lagi dibatasi untuk 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. 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) Perbarui 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 basepath default untuk proxy edgemicro-auth. Secara default, basepath-nya 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 Anda perlu membuat proxy API baru untuk mendukung tim baru. Perhatikan bahwa /**/ tidak didukung.

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 di command line menggunakan flag -c atau --configDir. Memperbaiki 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. Menghormati 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 menyetel opsi edgemicro: proxy_tunnel ke benar (true) di file konfigurasi microgateway:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

Jika proxy_tunnel adalah true, Edge Microgateway akan menggunakan metode HTTP CONNECT untuk membuat tunnel permintaan HTTP melalui satu koneksi TCP. (Hal yang sama berlaku jika variabel lingkungan untuk mengonfigurasi proxy diaktifkan TLS).

Opsi 2:

Opsi kedua adalah menentukan proxy dan menyetel 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 untuk 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 dibatasi koma yang tidak boleh di-proxy oleh Edge Microgateway. Contoh:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

Untuk mengetahui 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 ditetapkan dalam detik. Jika terjadi waktu tunggu habis, 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 ditetapkan pada respons target. Pada rilis sebelumnya, pesan status yang dikirim dari target digantikan dengan default Node.js.

7. Header X-Forwarded-For dapat menetapkan client_ip untuk analytics

Jika ada, header X-Forwarded-For akan menetapkan variabel 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 perubahan ini, plugin menerima kedua bentuk keamanan. Dengan perubahan ini, Anda hanya dapat mengizinkan salah satu model keamanan tersebut (sambil mempertahankan kompatibilitas mundur).

Plugin OAuth menambahkan dua flag baru:

• allowOAuthOnly -- Jika disetel ke true, setiap API harus menyertakan header Otorisasi dengan Token Akses Bearer.

• allowAPIKeyOnly -- Jika disetel ke true, setiap API harus menyertakan header x-api-key (atau lokasi kustom) dengan Kunci API.

Anda menetapkan tanda ini dalam file konfigurasi Edge Microgateway seperti ini:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. Meningkatkan kualitas proxy edgemicro-auth (PR 40)

Peningkatan telah dilakukan pada proxy edgemicro-auth. Sebelum perubahan ini, proxy menyimpan kunci di Edge Secure Store, sebuah vault terenkripsi. Sekarang, proxy menyimpan kunci dalam 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 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 menyetel req.targetSecure ke true, lihat thread diskusi ini untuk mengetahui informasi selengkapnya.

11. Dukungan awal untuk autentikasi token OAuth (PR 125)

Anda dapat mengonfigurasi Edge Microgateway untuk 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 yang diperbaiki 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 stream tidak selesai memproses data, tetapi handler akhir tetap dieksekusi. Hal ini menyebabkan respons sebagian 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 saat garis miring di akhir diperlukan di basepath proxy agar verifikasi kunci API berfungsi dengan benar. Sekarang, garis miring di akhir basepath tidak diperlukan. (PR 48)

Versi 2.3.5

Fitur dan peningkatan baru v.2.3.5

Pemfilteran proxy

Anda dapat memfilter proxy yang kompatibel dengan microgateway yang akan diproses oleh instance Edge Microgateway. Saat dimulai, Edge Microgateway akan mendownload semua proxy yang kompatibel dengan microgateway di organisasi yang terkait dengannya. Gunakan konfigurasi berikut untuk membatasi proxy yang akan diproses microgateway. Misalnya, konfigurasi ini membatasi proxy yang akan diproses microgateway menjadi 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 analisis Edge. Tambahkan hal berikut ke konfigurasi microgateway untuk menyamarkan URI permintaan dan/atau jalur permintaan. Perhatikan 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 menyetel atribut ini di konfigurasi microgateway:

disabled_config_poll_interval: true

Secara default, polling berkala mengambil perubahan apa pun yang dilakukan di Edge (perubahan pada produk, proxy yang kompatibel dengan microgateway, dll.) serta perubahan yang dilakukan pada file konfigurasi lokal. Interval polling default adalah 600 detik (lima menit).

Menulis ulang URL target di plugin

Anda dapat mengganti URL target default secara dinamis di 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 memudahkan plugin mengakses respons target.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

Output logging default yang disederhanakan

Secara default, layanan logging kini menghilangkan JSON proxy, produk, dan JWT yang didownload. Anda dapat mengubah default untuk menampilkan objek ini dengan menyetel DEBUG=* saat Anda 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. Pada perintah init, configure, dan start, Anda kini dapat menentukan jalur konfigurasi kustom pada command line. Contoh:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

Bug yang diperbaiki v2.3.3

• Kebocoran memori yang terjadi selama permintaan/respons besar telah diperbaiki.
• Urutan eksekusi plugin telah diperbaiki. Sekarang, perilaku ini sesuai dengan yang dijelaskan dalam dokumentasi.
• Plugin accumulate-request tidak lagi ditangguhkan untuk permintaan GET.
• Masalah telah diperbaiki di plugin accumulate-response saat tidak adanya 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 mengetahui detail selengkapnya.

Fitur dan peningkatan baru v.2.3.1

Berikut adalah fitur dan peningkatan baru untuk rilis ini.

Memfilter proxy

Konfigurasi baru memungkinkan Anda memfilter proxy yang akan dimuat Edge Microgateway saat startup. Sebelumnya, microgateway memuat semua proxy yang kompatibel dengan microgateway (proxy yang diberi nama 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 hanya dua proxy ini seperti berikut:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Saat dimulai, microgateway hanya dapat memanggil proxy yang ditentukan. Setiap upaya untuk memanggil proxy lain yang kompatibel dengan microgateway 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 saat permintaan masuk berisi data (seperti dalam permintaan POST) dan satu saat tidak (seperti dalam permintaan GET sederhana).

Mari kita pertimbangkan kasus saat permintaan masuk berisi data, dan Anda ingin menetapkan header permintaan pada permintaan target. Pada versi Edge Microgateway sebelumnya, header target tidak dapat ditetapkan dengan andal dalam kasus ini.

Kunci dari pola ini adalah mengumpulkan semua data masuk dari klien terlebih dahulu. Kemudian, dalam fungsi onend_request(), gunakan fungsi request.setOverrideHeader(name, value) baru untuk menyesuaikan header.

Berikut adalah contoh kode plugin yang menunjukkan cara melakukannya. Header yang ditetapkan di 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 menyetel header target di handler onrequest(). Pola ini bukan hal baru -- pola ini telah didokumentasikan sebelumnya dan telah digunakan dalam plugin contoh 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 pemuatan ulang tanpa periode nonaktif

Setelah melakukan perubahan konfigurasi pada Edge Microgateway, Anda dapat memuat konfigurasi tanpa menghilangkan 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 sedang berjalan atau tidak.
• edgemicro stop - Menghentikan cluster Edge Microgateway.
• edgemicro reload - Memuat ulang konfigurasi Edge Microgateway tanpa waktu non-operasional.

Pemuatan ulang konfigurasi otomatis tanpa waktu non-operasional

Edge Microgateway memuat konfigurasi baru secara berkala dan menjalankan pemuatan ulang jika ada perubahan. Polling mengambil perubahan apa pun yang dilakukan di Edge (perubahan pada produk, proxy yang kompatibel dengan microgateway, dll.) serta perubahan yang dilakukan pada file konfigurasi lokal. Interval polling default adalah 600 detik (lima menit). Anda dapat mengubah 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 saat ini, gunakan:

edgemicro --version

Opsi SSL server Edge Microgateway baru

Edge Microgateway kini mendukung opsi SSL server berikut selain key dan cert:

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 ini 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 di 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 mengetahui 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.

Mempertahankan header autentikasi secara opsional

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.

Kemampuan untuk menggunakan layanan otorisasi kustom

Jika Anda ingin menggunakan layanan kustom Anda sendiri untuk menangani autentikasi, ubah nilai authUri dalam file konfigurasi Edge Microgateway agar mengarah ke layanan Anda. Untuk 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 sufiks jalur proxy. Untuk mengetahui detail tentang cara membuat produk dan mengonfigurasi jalur resource, lihat Membuat produk API.

Dukungan untuk penginstalan global npm

Sekarang Anda dapat menginstal Edge Microgateway menggunakan opsi npm -g (global). Untuk mengetahui 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 menjadi server proses tunggal. Model ini tidak lagi menggunakan model dua proses di mana satu proses (sebelumnya dikenal sebagai "agen") meluncurkan Edge Microgateway, proses kedua. Arsitektur baru ini mempermudah otomatisasi dan containerisasi.

File konfigurasi dengan namespace

File konfigurasi kini diberi namespace menggunakan organisasi dan lingkungan sehingga beberapa instance Microgateway dapat berjalan di host yang sama. Anda dapat menemukan file konfigurasi di ~/.edgemicro setelah menjalankan perintah konfigurasi Edge Microgateway.

Variabel lingkungan baru

Sekarang ada 4 variabel lingkungan: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Jika Anda menetapkan variabel ini di sistem, Anda tidak perlu menentukan nilainya saat menggunakan Command-Line Interface (CLI) untuk mengonfigurasi dan memulai Edge Microgateway.

Konfigurasi yang di-cache

Edge Microgateway menggunakan file konfigurasi yang di-cache jika dimulai ulang tanpa koneksi ke Apigee Edge.

Mode cluster

Sekarang ada opsi untuk memulai Edge Microgateway dalam mode cluster. Mode cluster memungkinkan Anda memanfaatkan sistem multi-core. Microgateway menggunakan modul cluster Node.js untuk fitur ini. Untuk mengetahui detailnya, lihat dokumentasi Node.js.

Bug yang diperbaiki v2.0.0

Siklus proses peristiwa plugin kini menangani kode asinkron yang berisi kode dengan callback baru dengan benar.

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 saat 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 disalin ke ~./edgemicro/config.yaml.

Rotasi file log

Atribut konfigurasi baru memungkinkan Anda menentukan interval rotasi untuk log Edge Microgateway.

Bug diperbaiki v1.1.2

Bug berikut diperbaiki di v. 1.1.2.