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

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

Versi komponen:

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

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

Tidak ada.

3.3.1

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

3.3.0

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

Versi komponen:

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

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

3.2.2

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

Masalah keamanan telah diperbaiki

3.2.1

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

edgemicro:
 enable_GET_req_body: true

3.2.0

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

Versi 3.1.x

Perbaikan bug dan peningkatan v.3.1.x

3.1.8

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

3.1.7

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

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

3.1.6

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

3.1.5

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

3.1.4

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

Perbaikan bug:

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

3.1.3

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 153509313 - Masalah telah diperbaiki saat modul debug Node.js mengakibatkan kebocoran memori. Masalah ini ada dalam versi v3.1.0, v3.1.1, dan 3.1.2.
• 153509313 - Masalah telah diperbaiki dengan ID pesan yang sama untuk dua transaksi yang berbeda yang dicetak di output logging.
• 151673570 - Masalah telah diperbaiki dengan Edge Microgateway tidak diperbarui untuk menggunakan API KVM Apigee. Edge Microgateway kini menggunakan perintah baru untuk menambahkan dan mengupdate nilai KVM.
• 152822846 - Dalam rilis sebelumnya, Edge Microgateway telah diperbarui sehingga pemrosesannya pemetaan jalur resource yang cocok dengan Apigee Edge. Dalam rilis ini, masalah telah diperbaiki yang pola /literal_string/* tidak ditangani dengan benar. Misalnya, /*/2/*. Lihat juga Mengonfigurasi perilaku jalur resource '/', '/*', dan '/**'.
• 152005003 - Perubahan dilakukan untuk mengaktifkan ID cakupan organisasi dan lingkungan untuk kuota.
• 152005003 - Perubahan dilakukan untuk mengaktifkan ID cakupan organisasi dan lingkungan untuk kuota. Kombinasi 'org + env + appName + productName' digunakan sebagai kuota yang sesuai.

3.1.2

Pada hari Senin, 16 Maret 2020, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 151285018 - Peningkatan fitur dilakukan untuk menambahkan dukungan proxy HTTP untuk traffic antara Edge Microgateway dan target backend. Selain itu, masalah telah diperbaiki untuk permintaan HTTP yang ada dukungan proxy antara Edge Microgateway dan Apigee Edge. Untuk mengetahui detailnya, lihat:
  • Menggunakan proxy HTTP untuk komunikasi dengan Apigee Edge
  • Menggunakan proxy HTTP untuk komunikasi target
• 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 jika redisBasedConfigCache: true atau quotaUri: https://%s-%s.apigee.net/edgemicro-auth ada di file konfigurasi.
• 151284716 - Peningkatan yang dilakukan untuk menutup koneksi server lebih cepat ketika pekerja dimulai ulang selama proses {i>reload<i}.
• 151588764 - Mengupdate versi Node.js di image Docker yang digunakan untuk menjalankan Edge Microgateway di container Docker ke 12, karena Node.js v8 sudah tidak digunakan lagi.
• 151306049 - Pembaruan dokumentasi dilakukan untuk mencantumkan pengelolaan Apigee Edge API yang digunakan oleh perintah CLI Edge Microgateway. Lihat API pengelolaan apa yang digunakan Edge Microgateway?.

3.1.1

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 146069701 - Masalah telah diperbaiki dengan modul microgateway-core tidak mematuhi variabel lingkungan HTTP_PROXY dan HTTPS_PROXY. Dengan perubahan ini, setelan proxy dalam file konfigurasi YAML, jika ditentukan, kini menjadi diabaikan; hanya variabel lingkungan yang digunakan untuk menentukan {i>proxy<i}.

  Jika Anda ingin menentukan konfigurasi proxy dalam file konfigurasi, Anda juga harus menentukan variabel HTTP_PROXY yang menyebutkan URL proxy yang sama dengan yang ditentukan di file konfigurasi. Misalnya, jika Anda menentukan konfigurasi berikut:

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

  Anda juga harus menentukan variabel lingkungan ini:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 - Parameter konfigurasi baru, edgemicro.headers_timeout, telah ditambahkan. Atribut ini membatasi jumlah waktu (dalam milidetik) waktu tunggu parser HTTP untuk menerima header HTTP lengkap. Contoh:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

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

• 149278885 - Fitur baru telah ditambahkan yang memungkinkan Anda untuk mengatur waktu tunggu API target pada Level proxy API sebagai ganti menggunakan satu setelan waktu tunggu global.

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

3.1.0

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 144187500 - Peristiwa level WARN baru akan dicatat dalam log saat tanda quotas.failOpen dipicu. Tanda ini dipicu jika terjadi error pemrosesan kuota atau jika "kuota berlaku" minta ke Edge gagal memperbarui penghitung kuota jarak jauh. Dalam hal ini, kuota akan diproses berdasarkan pada jumlah lokal hanya sampai sinkronisasi kuota jarak jauh berikutnya berhasil. Sebelumnya, cara ini peristiwa hanya dicatat ke dalam log saat tingkat log ditetapkan ke DEBUG.

  Contoh:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519 - Masalah telah diperbaiki jika transaksi yang sedang berlangsung atau transaksi baru terpengaruh setiap kali Edge Microgateway mendeteksi perubahan pada proxy API. Sekarang, ketika perubahan dilakukan pada {i>proxy<i}, Edge Microgateway memuat ulang cache dan node pekerja dimulai ulang. Dengan perubahan ini, transaksi yang sedang berlangsung dan panggilan API baru yang dikirim ke microgateway tidak terdampak.
• 146378327 - Level log sourceRequest, targetRequest, dan targetResponse telah diubah ke tingkat INFO.
• 146019878 - Perbedaan antara latensi yang dihitung untuk "Performa Proxy API" di analisis Edge dan peristiwa log sourceResponse/targetResponse Edge Microgateway telah diperbaiki. Sekarang, latensi dalam analisis Edge dan peristiwa log Microgateway sudah selaras.
• Perubahan terkait logika pencocokan pola:
  • 147027862 - Plugin oauth telah diperbarui untuk mendukung jalur resource berikut pola yang cocok seperti yang ditetapkan dalam Produk API:
    • /{literal}**
    • /{literal}*
    • Kombinasi dari dua pola di atas

    Dengan perubahan ini, plugin Edge Microgateway kini mengikuti hal yang sama pencocokan pola dengan Apigee Edge, sebagaimana dijelaskan dalam Mengonfigurasi perilaku resource jalur '/', '/*', dan '/**'.

  • 145644205 - Memperbarui logika pencocokan pola plugin apiKeys agar cocok dengan plugin oauth.
• 143488312 - Masalah telah diperbaiki dengan spasi di awal atau di akhir client ID telah diperbaiki menyebabkan pembuatan daftar produk JWT kosong untuk token OAuth dan Permintaan kunci API.
• 145640807 dan 147579179 - Fitur baru telah ditambahkan yang memungkinkan Edge Microgateway khusus yang disebut "sinkronisasi" untuk mengambil data konfigurasi dari Apigee Edge dan menulisnya ke database Redis lokal. Instance microgateway lainnya kemudian dapat dikonfigurasi untuk membaca konfigurasi data dari {i>database<i}. Fitur ini menambahkan tingkat ketahanan pada Edge Microgateway. Memungkinkan instance microgateway untuk memulai dan berfungsi tanpa perlu berkomunikasi dengan Apigee Edge. Untuk mengetahui detailnya, lihat Menggunakan sinkronisasi.

  Fitur sinkronisasi saat ini didukung untuk berfungsi dengan Redis 5.0.x.

Versi 3.0.x

Perbaikan bug dan peningkatan v.3.0.x

3.0.10

Pada hari Jumat, 8 November, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 142677575 - Pembaruan fitur sehingga pola cocok untuk jalur sumber daya yang digunakan dalam produk API untuk Edge Microgateway kini selaras dengan pencocokan pola jalur resource yang digunakan Apigee Edge, seperti yang dijelaskan di Mengonfigurasi perilaku jalur resource '/', '/*', dan '/**'.

  Catatan: Jika menggunakan pola resource gabungan seperti /*/2/**, Anda harus memastikan bahwa proxy edgemicro_auth ditambahkan ke produk API mandiri. Kemudian, Anda harus menyertakan produk itu dalam Aplikasi Developer proxy, seperti yang digambarkan dalam screenshot berikut:

  

  Catatan: Properti konfigurasi features.isSingleForwardSlashBlockingEnabled, seperti yang dijelaskan di Mengonfigurasi perilaku jalur resource '/', '/*', dan '/**' tidak didukung untuk Edge Microgateway.

• 143740696 - Struktur konfigurasi quotas telah berubah (lihat juga catatan rilis untuk versi 3.0.9). quotas digunakan untuk mengonfigurasi plugin kuota. Perubahan struktur dilakukan untuk memperbaiki kejelasan elemen konfigurasi. Untuk mengonfigurasi plugin kuota, gunakan konfigurasi YAML berikut. Perhatikan bahwa properti konfigurasi disebut quotas. Untuk mengetahui detail tentang konfigurasi quotas individual properti, lihat Opsi konfigurasi untuk kuota.

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056 - Fitur baru telah ditambahkan agar Anda dapat menggunakan Redis sebagai kuota menyimpan cadangan data. Jika useRedis benar, maka yang digunakan untuk modul volos-quota-redis. Jika true (benar), kuota dibatasi hanya untuk instance Edge Microgateway yang dan terhubung ke Redis. Jika salah, atribut volos-quota-apigee digunakan sebagai penyimpanan pendukung, dan penghitung kuota bersifat global. Untuk mengetahui detailnya, lihat Opsi konfigurasi untuk kuota. Contoh:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210 - Waktu habis masa berlaku default untuk token yang dihasilkan oleh edgemicro-auth proxy telah diubah dari 108000 milidetik (1,8 menit) menjadi 1800 detik (30 menit).
• 143551282 - Untuk mendukung organisasi yang mendukung SAML, perintah edgemicro genkeys memiliki telah diperbarui untuk menyertakan parameter ‑‑token. Parameter ini memungkinkan Anda menggunakan Token OAuth untuk autentikasi, bukan nama pengguna/sandi. Untuk detailnya, lihat Membuat kunci.

3.0.9

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 141989374 - "fail open" baru telah ditambahkan untuk plugin kuota. Saat fitur ini diaktifkan, jika terjadi error pemrosesan kuota atau jika "kuota berlaku" permintaan ke Edge gagal memperbarui penghitung kuota jarak jauh, kuota akan diproses berdasarkan jumlah lokal hanya hingga kuota jarak jauh berikutnya berhasil sinkronisasi akan terjadi. Dalam kedua kasus ini, flag quota-failed-open disetel di objek permintaan.

  Untuk mengaktifkan kuota "gagal dibuka" , setel konfigurasi berikut:

  quotas :
   failOpen : true

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

• 142093764 - Perubahan konfigurasi dilakukan pada proxy edgemicro-auth agar tidak melebihi kuota. Perubahannya adalah mengatur jenis kuota ke kalender. Untuk menggunakan peningkatan ini, Anda harus memperbarui edgemicro-auth Anda ke versi 3.0.7 atau yang lebih tinggi.
• 142520568 - Fitur baru telah ditambahkan untuk mengaktifkan pencatatan MP ID (pemroses pesan) dalam respons kuota. Untuk menggunakan fitur ini, Anda harus mengupdate proxy edgemicro-auth Anda ke versi 3.0.7 atau yang lebih tinggi dan setel konfigurasi berikut:

  quotas:
    useDebugMpId: true

  Jika useDebugMpId disetel, respons kuota dari Edge akan berisi ID MP dan akan dicatat oleh Edge Microgateway. Contoh:

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

Pada hari Kamis, 26 September, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 140025210 - Suatu "fail open" baru fitur telah ditambahkan. Dengan fitur ini, pemrosesan API dapat dilanjutkan jika token JWT yang kedaluwarsa tidak dapat dimuat ulang karena kesalahan koneksi yang mencegah panggilan verifikasi kunci API yang berhasil ke proxy edgemicro-auth.

  Fitur ini memungkinkan Anda menyetel masa tenggang tempat token lama tetap tersimpan di cache dan digunakan kembali hingga masa tenggang berakhir. Fitur ini memungkinkan Edge Microgateway untuk melanjutkan pemrosesan permintaan jika terjadi kegagalan koneksi sementara. Kapan konektivitas dilanjutkan, dan panggilan Verify API Key berhasil, JWT baru diambil dan menggantikan JWT lama di cache.

  Untuk mengonfigurasi "gagal buka" baru , lakukan hal berikut:

  1. Tetapkan properti berikut dalam stanza oauth di Edge Microgateway file konfigurasi:

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     Contoh:

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

     Dalam contoh ini, token lama akan digunakan selama 5 detik jika tidak dapat dimuat ulang karena masalah konektivitas. Setelah 5 detik, error autentikasi akan ditampilkan.

• 141168968 - Pembaruan dibuat 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 Edge Microgateway kunci dan rahasia yang akan diverifikasi pada setiap permintaan Verifikasi Kunci API. Edge Microgateway telah diupdate agar selalu mengirim kunci dan rahasia pada setiap permintaan Verifikasi Kunci API. Perubahan ini mencegah klien mendapatkan JWT hanya dengan kunci API.
• 140090250 - Update dilakukan untuk menambahkan logging diagnostik untuk pemrosesan kuota. Dengan ini , sekarang kita dapat mengkorelasikan {i>output<i} log quoto dengan sisa Edge Microgateway log.

3.0.7

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

Versi komponen:

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

Perbaikan bug dan peningkatan:

• 140075602 - Pembaruan dilakukan pada plugin OAuth untuk menampilkan kode status 5xx dengan yang sesuai. Sebelumnya, plugin hanya mengembalikan kode status 4xx di semua bukan 200 kasus. Untuk setiap respons pesan yang bukan berstatus 200, Kode 4xx atau 5xx akan ditampilkan, tergantung pada error-nya.

  Fitur ini dinonaktifkan secara default. Untuk mengaktifkan fitur ini, tambahkan oauth.useUpstreamResponse: true ke konfigurasi Edge Microgateway Anda. Contoh:

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• 140090623 - Dalam rilis 3.0.6, properti konfigurasi baru telah ditambahkan, quota.quotaUri. Tetapkan properti konfigurasi ini jika Anda ingin mengelola kuota melalui edgemicro-auth yang di-deploy ke organisasi Anda. Jika properti ini tidak ditetapkan, endpoint kuota secara default ke endpoint Edge Microgateway internal. Contoh:

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  Dalam rilis 3.0.7, edgemicro-auth telah diupdate agar dapat menerima konfigurasi Anda. Untuk menggunakan properti quotaUri, Anda harus mengupgrade ke proxy edgemicro-auth terbaru. Untuk detailnya, lihat Mengupgrade edgemicro-auth {i>proxy<i}.

• 140470888 - Header Otorisasi telah ditambahkan ke panggilan kuota untuk memberikan otentikasi. Selain itu, proxy edgemicro-auth telah diubah untuk menghapus "organisasi" dari ID kuota. Karena titik akhir kuota berada di organisasi pelanggan, ID kuota tidak lagi diperlukan.
• 140823165 - Nama properti berikut:

  edgemicro:
      keepAliveTimeout

  didokumentasikan dengan tidak benar dalam rilis 3.0.6. Nama properti yang benar adalah:

  edgemicro:
      keep_alive_timeout

• 139526406 - Bug telah diperbaiki, ketika jumlah kuota yang salah terjadi jika aplikasi developer memiliki beberapa produk. Kuota sekarang diterapkan dengan benar untuk setiap produk dalam aplikasi yang memiliki beberapa produk. Kombinasi 'appName + productName' digunakan sebagai ID kuota.

3.0.6

Pada hari Kamis, 29 Agustus, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.

• 138633700 - Menambahkan properti konfigurasi baru, keepAliveTimeout. Properti ini memungkinkan Anda untuk menyetel waktu tunggu Edge Microgateway (dalam milidetik). (Default: 5.000 milidetik)

  Contoh:

  edgemicro:
    keep_alive_timeout: 600

• 140090623 - Menambahkan properti konfigurasi baru, quotaUri. Tetapkan konfigurasi ini jika Anda ingin mengelola kuota melalui proxy edgemicro-auth yang yang di-deploy ke organisasi Anda. Jika properti ini tidak disetel, endpoint kuota ditetapkan secara default ke endpoint Edge Microgateway internal. Contoh:

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  Untuk menggunakan fitur ini, Anda harus terlebih dahulu men-deploy versi terbaru Proxy edgemicro-auth ke organisasi Anda. Untuk mengetahui detailnya, lihat Mengupgrade proxy edgemicro-auth.

• 138722809 - Menambahkan properti konfigurasi baru, stack_trace. Properti ini memungkinkan Anda untuk mengontrol apakah tidak memunculkan pelacakan tumpukan di file log. Contoh:

  stack_trace: false

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

3.0.5

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

• 139005279 - Masalah telah diperbaiki sehingga perintah edgemicro status tidak ditampilkan jumlah proses pekerja yang tepat.
• 138437710 - Masalah telah diperbaiki di class ExitCounter yang mencegah error log agar tidak ditulis.

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

• 138413755 - Meningkatkan kunci JWT dan pesan log terkait rahasia untuk CLI ini berbagai perintah: sertifikat, verifikasi, upgradekvm, token, genkeys, Capturekeys, rotasikey, dan konfigurasi.

• 138413577 - Menambahkan dan meningkatkan penanganan error untuk waktu tunggu layanan backend.
• 138413303 - Menambahkan dan meningkatkan penanganan error untuk waktu tunggu respons dan soket.
• 138414116 - Menambahkan dan meningkatkan penanganan error untuk "koneksi ditolak" yang sama.

3.0.4

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

• 134445926 - Peningkatan autentikasi Edge Microgateway internal.
• 137582169 - Mengatasi masalah saat memulai proses yang tidak diinginkan. Proses ekstra menyebabkan plugin dimuat ulang dan menggunakan memori secara berlebihan. Edge Microgateway kini mempertahankan jumlah proses dalam batas yang diharapkan.
• 137768774 - Peningkatan pesan log:
  • Membersihkan log transaksi (permintaan).
  • Menambahkan lebih banyak pesan log jika diperlukan.
  • Memindahkan pesan log transaksi (permintaan) dari output konsol ke pesan yang relevan file log.
  • Memperbarui log konsol untuk menggunakan fungsi logging terpusat.
• 138321133, 138320563 - Perubahan internal dasar pada penyangga kuota untuk mengaktifkan peningkatan kuota di masa mendatang.

3.0.3

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

• Peningkatan logging: Log runtime yang ada menggunakan Fungsi eventLog() yang mengambil dan mencatat data runtime secara konsisten format font. Info log mencakup:
  • Stempel waktu (ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ).
  • Level log (error, peringatan, atau info).
  • Nama host - Nama host yang meminta dari header permintaan.
  • ID Proses - Jika Anda menjalankan cluster proses Node.js, ini adalah ID proses tempat pencatatan log terjadi.
  • Nama organisasi Apigee.
  • Nama lingkungan di organisasi.
  • Nama proxy API.
  • Alamat IP klien.
  • IDklien.
  • ID Korelasi (saat ini belum ditetapkan).
  • Nama komponen Edge Microgateway.
  • Pesan khusus - Beberapa objek mungkin mencetak informasi tambahan yang diteruskan ke properti error ini.
  • Metode permintaan (jika ada permintaan HTTP).
  • Kode status respons (jika ada permintaan HTTP).
  • Pesan error.
  • Kode error - Jika sebuah objek berisi kode error, objek tersebut akan dicetak di properti ini.
  • Waktu yang diperlukan.
  • Sistem operasi penanda akhir garis.

  Nilai properti null menghasilkan tanda kurung kosong, [].

  Contoh berikut menunjukkan format log:

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• Performa: Produk API tidak difilter berdasarkan lingkungan. Terbitan ini telah diperbaiki. (135038879)
• Beragam integrasi pengujian fungsional dan peningkatan kualitas kode.

3.0.2

Pada hari Rabu, 3 Juli 2019, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.

Kualitas kode - Kode telah ditinjau kualitas dan perubahan kode telah dilakukan untuk memenuhi standar kualitas yang diminta oleh pengguna. Kami telah mengatasi error dan peringatan kualitas kode yang berasal dari JSHint. Sebagai hasilnya, beberapa error kode yang sebenarnya diidentifikasi dan diperbaiki. Semua Microgateway Apigee Edge menjalani proses ini. Lihat commit pada 28 Juni dan 2 Juli untuk microgateway-config, microgateway-core, microgateway-plugins,dan microgateway. Semua modul dengan perubahan kualitas kode telah diuji dengan alat internal yang memverifikasi dan eksekusi Edge Microgateway untuk kasus penggunaan pelanggan.

3.0.1

Pada hari Jumat, 21 Juni 2019, kami merilis perbaikan dan peningkatan berikut untuk Edge Microgateway.

• 134834551 - Mengubah versi Node.js yang didukung untuk Edge Microgateway
  (Versi yang didukung Node.js: 8 dan 12; versi 7, 9, dan 11 bersifat eksperimental)
• 134751883 - Edge Microgateway error saat memuat ulang dengan beban
• 134518428 - Endpoint produk untuk Edge Microgateway menampilkan 5XX jika pola filternya salah
• 135113408 - Pekerja harus memulai ulang jika mereka berhenti secara tidak terduga
• 134945852 - tokenCacheSize tidak digunakan di plugin OAuth
• 134947757 - menyetel cacheTTL di plugin oauth
• 135445171 - Penghitungan masa tenggang di OAuth salah
• Gunakan modul memo yang disediakan dengan penginstalan Edge Microgateway
• 135367906 - Audit keamanan

Versi 2.5.x

Fitur dan peningkatan baru v.2.5.x

(Tetap 2.5.38, 06/07/2019)

JWT yang tidak diformat dengan benar dapat menyebabkan pekerja mengalami error saat menggunakan cache token. Diperbaiki di Edge modul microgateway-plugins. (b/134672029)

(Ditambahkan 2.5.37) Tambahkan opsi CLI edgemicro-cert -t.

Opsi edgemicro cert -t memungkinkan Anda menentukan token OAuth untuk mengotentikasi API pengelolaan. Lihat juga Mengelola sertifikat.

(Menambahkan 2.5.35) Menambahkan dukungan untuk men-debug Edge Microgateway menggunakan edgemicroctl.

Anda dapat menggunakan tanda mgdebug dengan edgemicroctl. Lihat juga Tugas integrasi Kubernetes.

(Ditambahkan 2.5.35) Mengaktifkan build Windows untuk edgemicroctl.

(Ditambahkan 2.5.31) API edgemicro-auth/token baru

API edgemicro-auth/token baru telah ditambahkan, yang memungkinkan Anda meneruskan klien/rahasia sebagai API yang Dienkode Base64 Header Otorisasi Dasar dan Grants_type sebagai parameter formulir. Lihat Mendapatkan token pemilik secara langsung.

(Tetap 2.5.31) Konfigurasi pribadi tidak mematuhi flag token

Masalah telah diperbaiki saat mengonfigurasi Edge Microgateway agar menggunakan token akses OAuth2 di Edge untuk Private Cloud tidak berfungsi dengan baik (token tidak dipatuhi).

Docker: Dukungan untuk menggunakan sertifikat yang ditandatangani sendiri

(Ditambahkan 2.5.29) Jika Anda menggunakan Certificate Authority (CA) yang tidak dipercaya secara default oleh Pada Node.js, Anda dapat menggunakan parameter NODE_EXTRA_CA_CERTS saat menjalankan container Docker dengan Edge Microgateway. Untuk mengetahui detailnya, lihat Menggunakan CA yang tidak dipercaya oleh Node.js.

Docker: Dukungan untuk TLS

(Ditambahkan 2.5.29) Edge Microgateway yang berjalan dalam container Docker sekarang mendukung TLS untuk permintaan ke server Edge Microgateway (permintaan menuju utara) dan untuk permintaan keluar dari Edge Microgateway ke aplikasi target (permintaan ke arah selatan).

Contoh berikut menjelaskan secara mendetail cara menyiapkan konfigurasi TLS ini:

• Contoh konfigurasi TLS arah utara
• Contoh konfigurasi TLS selatan

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

Docker: Dukungan untuk permintaan proxy

(Ditambahkan 2.5.27) Jika Anda menjalankan Edge Microgateway dalam container Docker, Anda dapat menggunakan opsi ini untuk mengontrol proxy saat microgateway berjalan di belakang firewall:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Untuk mengetahui detailnya, lihat Menjalankan Edge Micro sebagai container Docker.

Docker: Petunjuk plugin yang diperbarui

(Ditambahkan 2.5.27) Jika Anda menjalankan Edge Microgateway dalam container Docker, sekarang Anda memiliki dua opsi untuk agar dapat men-deploy plugin. Salah satu opsi yang baru adalah menggunakan titik pemasangan Docker. Opsi lain ada sebelumnya, pada dasarnya tidak berubah; namun, Dockerfile telah diperbarui. Untuk detailnya, lihat link berikut:

• Opsi A: Memasang direktori plugin pada volume (Baru)
• Opsi B: Membangun plugin ke dalam container (Diperbarui)

Dukungan token OAuth baru untuk perintah upgrade KVM

(Ditambahkan 2.5.27) Anda dapat menggunakan token OAuth dengan perintah upgradekvm. Untuk mengetahui detailnya, lihat Mengupgrade KVM.

Memisahkan API di Analisis Edge

(Ditambahkan 2.5.26) Tanda plugin analisis baru memungkinkan Anda memisahkan jalur API tertentu sehingga muncul sebagai {i>proxy<i} terpisah di dasbor Edge Analytics. Misalnya, Anda dapat memisahkan API health check untuk menghindari kebingungan dengan panggilan API yang sebenarnya. Untuk informasi selengkapnya, lihat Mengecualikan jalur dari analisis.

Mengonfigurasi proxy lokal

(Ditambahkan 2.5.25) Dengan {i>proxy<i} lokal, Anda tidak perlu membuat proxy berbasis microgateway secara manual di Apigee Edge. Sebagai gantinya, microgateway akan menggunakan jalur dasar proxy lokal. Untuk mengetahui informasi selengkapnya, lihat Menggunakan mode proxy lokal.

Menggunakan mode mandiri

(Ditambahkan 2.5.25) Anda dapat menjalankan Edge Microgateway terputus sepenuhnya dari Dependensi Apigee Edge. Skenario ini, disebut mode mandiri, memungkinkan Anda menjalankan dan menguji Edge Microgateway tanpa koneksi internet., lihat Menjalankan Edge Microgateway dalam mode mandiri.

Mencabut kunci

(Ditambahkan 2.5.19) Perintah CLI baru telah ditambahkan yang mencabut kredensial kunci dan rahasia untuk sebuah Konfigurasi Edge Microgateway.

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

Dukungan Docker

(Ditambahkan 2.5.19) Sekarang Anda dapat mendownload rilis Edge Microgateway terbaru sebagai image Docker:

docker pull gcr.io/apigee-microgateway/edgemicro:latest

Dukungan Kubernetes

(Ditambahkan 2.5.19) Anda dapat men-deploy Edge Microgateway sebagai layanan atau sebagai gateway file sespan di depan layanan yang di-deploy di cluster Kubernetes. Lihat: Ringkasan Mengintegrasikan Edge Microgateway dengan Kubernetes.

Dukungan untuk opsi tanpa penundaan TCP

(Ditambahkan 2.5.16) Setelan konfigurasi baru, nodelay, telah ditambahkan ke konfigurasi Edge Micro.

Secara default koneksi TCP menggunakan Nagle algoritme untuk mem-buffer data sebelum mengirimnya. Menyetel nodelay ke true, menonaktifkan perilaku ini (data akan langsung mematikan data setiap kali socket.write() dipanggil). Lihat juga Node.js untuk detail selengkapnya.

Untuk mengaktifkan nodelay, edit file konfigurasi Edge Micro sebagai berikut:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

Opsi CLI baru untuk pemantauan Forever

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

Contoh:

Untuk memulai Selamanya:

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

Untuk menghentikan Selamanya:

edgemicro forever -a stop

Rotasi kunci JWT

Fitur baru yang ditambahkan yang memungkinkan Anda merotasi pasangan kunci publik/pribadi yang digunakan untuk membuat token JWT yang digunakan untuk keamanan OAuth di Edge Microgateway. Lihat Memutar kunci JWT.

Memfilter proxy API yang didownload

Secara default, Edge Microgateway mendownload semua proxy di organisasi Edge Anda yang diawali dengan awalan nama "edgemicro_". Anda dapat mengubah setelan default ini untuk mendownload proxy yang namanya memiliki pola yang sama. Lihat Memfilter proxy yang didownload.

Menentukan produk tanpa proxy API

Di Apigee Edge, Anda dapat membuat produk API yang tidak berisi proxy API apa pun. Konfigurasi produk ini memungkinkan kunci API yang terkait dengan produk tersebut untuk berfungsi dengan yang di-deploy di organisasi Anda. Mulai versi 2.5.4, Edge Microgateway mendukung produk ini konfigurasi Anda.

Dukungan untuk pemantauan selamanya

Edge Microgateway memiliki file forever.json yang dapat Anda konfigurasi mengontrol berapa kali dan dengan interval apa Edge Microgateway harus dimulai ulang. File ini mengonfigurasi layanan yang disebut always-monitor, yang mengelola Forever secara terprogram. Lihat Pemantauan selamanya.

Pengelolaan terpusat file konfigurasi Edge Micro

Jika Anda menjalankan beberapa instance Edge Microgateway, Anda mungkin ingin mengelola konfigurasi jaringan dari satu lokasi. Anda dapat melakukannya dengan menentukan endpoint HTTP di mana Edge Micro dapat mendownload file konfigurasinya. Lihat Menentukan endpoint file konfigurasi.

Dukungan untuk opsi CLI selamanya

(Ditambahkan 2.5.8) Gunakan perintah edgemicro forever [package.json] untuk menentukan lokasi file forever.json. Sebelum penambahan perintah ini, file tersebut harus berada di direktori {i> root <i}Edge Microgateway.

Contoh:

edgemicro forever ~/mydir/forever.json

Penambahan opsi configUrl untuk memuat ulang perintah

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

Masa tenggang untuk perbedaan waktu JWT

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

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

Perbaikan bug v2.5.x

• (Masalah #236) Memperbaiki kesalahan ketik saat menghapus cache.
• (Masalah #234) Memuat ulang mogok untuk Edge Microgateway 2.5.35.
• (Masalah #135) Referensi host virtual "aman" tidak valid error saat menggunakan -v. Perbaikan ini mengubah proxy edgemicro-auth sebelum di-deploy ke memastikan {i>host<i} virtual sama persis dengan apa yang ditetapkan dalam tanda "-v" penanda. Selain itu, Anda dapat menentukan berapa pun nomor dan nama apa pun untuk {i>host<i} virtual (tidak lagi terbatas pada secara default dan aman).
• (Masalah #141) Perintah edgemicro reload tidak mendukung opsi file konfigurasi -c. Masalah ini sudah teratasi.
• (Masalah #142) Edge Microgateway mengeluhkan kripto yang tidak digunakan lagi pada waktu penginstalan. Masalah ini sudah teratasi.
• (Masalah #145) Kuota tidak berfungsi dengan Edge Microgateway. Masalah ini sudah teratasi.
• (Masalah Komunitas Apigee: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) Token JWT divalidasi terhadap Proxy API dan URI Resource di OAUTH. Isu ini telah diperbaiki.
• (Masalah Komunitas Apigee: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway tidak berfungsi dengan OAuth. Masalah ini sudah teratasi.
• Memperbaiki pidPath di Windows.
• (Masalah #157) Masalah yang menyebabkan pesan error berikut telah diperbaiki: ReferenceError: deployProxyWithPassword tidak ditetapkan.
• (Masalah #169) Memperbarui dependensi Node.js (audit npm)
• Proxy edgemicro-auth sekarang menggunakan kebijakan Edge JWT. {i>Proxy<i} tidak lagi bergantung pada Node.js untuk menyediakan dukungan JWT.

Versi 2.4.x

Fitur dan peningkatan baru v.2.4.x

1. Menetapkan alias kustom untuk proxy edgemicro-auth (PR 116)

Anda dapat mengubah jalur basis default untuk proxy edgemicro-auth. Secara {i>default<i}, jalur dasarnya adalah /edgemicro-auth. Untuk mengubahnya, gunakan flag -x di perintah edgemicro konfigurasi.

Contoh:

edgemicro configure -x /mypath …

2. Dukungan karakter pengganti untuk jalur dasar (PR 77)

Anda dapat menggunakan satu atau beberapa "*" {i>wildcard <i}di jalur dasar suatu edgemicro_*. Misalnya, jalur dasar /team/*/members memungkinkan klien untuk memanggil https://[host]/team/blue/members dan https://[host]/team/green/members tanpa perlu membuat proxy API baru untuk mendukung tim baru. Perhatikan bahwa /**/ bukan didukung.

3. Jalur konfigurasi kustom ditambahkan ke CLI untuk konfigurasi Private Cloud (PR 99)

Secara default, file konfigurasi microgateway berada di ./config/config.yaml. Pada perintah init, Configure, dan start, Anda kini dapat menentukan jalur konfigurasi kustom command line menggunakan flag -c atau --configDir. Memperbaiki masalah yang tidak memiliki direktori konfigurasi kustom untuk penginstalan Private Cloud.

Contoh:

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

4. Hormati variabel *_PROXY (PR 61)

Jika Edge Microgateway diinstal di belakang firewall dan tidak dapat berkomunikasi dengan Apigee Edge di cloud publik, ada dua opsi yang perlu dipertimbangkan:

Opsi 1:

Opsi pertama adalah menetapkan opsi edgemicro: proxy_tunnel ke true di microgateway file konfigurasi:

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

Jika proxy_tunnel bernilai true, Edge Microgateway menggunakan HTTP Metode CONNECT untuk melakukan tunnel permintaan HTTP melalui koneksi TCP tunggal. (Hal yang sama berlaku jika variabel lingkungan untuk mengonfigurasi proxy adalah TLS diaktifkan).

Opsi 2:

Opsi kedua adalah menentukan proxy dan menetapkan proxy_tunnel ke false di file konfigurasi microgateway. Contoh:

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

Dalam kasus ini, Anda dapat menetapkan variabel berikut untuk mengontrol host bagi setiap proxy HTTP yang ingin Anda gunakan, atau host mana yang tidak boleh menangani proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXY, dan NO_PROXY. Anda dapat tetapkan NO_PROXY sebagai daftar domain yang dibatasi koma yang harus dimiliki Edge Microgateway bukan ke {i>proxy<i}. Contoh:

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

Untuk informasi selengkapnya tentang variabel ini, lihat:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5. Menetapkan waktu tunggu kustom untuk permintaan target (PR 57)

Anda dapat menetapkan waktu tunggu kustom untuk permintaan target dengan konfigurasi ini:

edgemicro:
    request_timeout: 10

Waktu tunggu disetel dalam detik. Jika waktu tunggu habis, Edge Microgateway merespons dengan 504 kode status.

6. Menghormati pesan status HTTP khusus pada respons target (PR) 53)

Edge Microgateway mematuhi pesan status HTTP khusus yang ditetapkan pada respons target. Dalam rilis sebelumnya, pesan status yang dikirim dari target diganti dengan Node.js secara default.

7. {i>Header<i} X-Forwarded-For dapat mengatur klien_ip untuk analisis

Jika ada, header X-Forwarded-For akan menyetel client_ip yang dilaporkan di Edge Analytics. Fitur ini memungkinkan Anda mengetahui IP klien yang mengirim permintaan ke Edge Microgateway.

8. Perubahan plugin OAuth

Plugin OAuth mendukung verifikasi Kunci API dan verifikasi token akses OAuth. Sebelum pembaruan perubahan ini, {i>plugin<i} menerima apa pun bentuk keamanannya. Dengan perubahan ini, Anda hanya dapat mengizinkan salah satu model keamanan tersebut (sambil mempertahankan kompatibilitas mundur).

Plugin OAuth menambahkan dua tanda baru:

• allowOAuthOnly -- Jika ditetapkan ke true, setiap API harus memiliki header Otorisasi dengan Token Akses Pemilik.

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

Anda menetapkan flag ini di file konfigurasi Edge Microgateway seperti ini:

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

9. Meningkatkan proxy edgemicro-auth (PR 40)

Peningkatan telah dilakukan pada proxy edgemicro-auth. Sebelum pembaruan perubahan ini, kunci {i>proxy<i} yang disimpan di {i>Edge Secure Store<i}, penyimpanan yang dienkripsi. Sekarang, proxy menyimpan kunci dalam peta nilai kunci (KVM) terenkripsi Edge.

10. Menulis ulang URL target default dalam plugin (PR 74)

Anda juga dapat mengganti port endpoint target dan memilih antara HTTP dan HTTPS. Ubah ini variabel dalam kode plugin Anda: req.targetPort dan req.targetSecure. Untuk memilih HTTPS, tetapkan req.targetSecure ke true; untuk HTTP, tetapkan ke false. Jika Anda menetapkan req.targetSecure ke benar, lihat diskusi ini thread untuk informasi selengkapnya.

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

Anda dapat mengonfigurasi Edge Microgateway agar menggunakan token OAuth untuk autentikasi, nama pengguna/sandi. Untuk menggunakan token OAuth, gunakan parameter berikut di edgemicro konfigurasikan:

-t, --token <token>

Contoh:

edgemicro configure -o docs -e test -t <your token>

Perbaikan bug v2.4.3

• Memperbaiki masalah saat organisasi berbayar diperlukan untuk menjalankan proxy edgemicro-auth dengan benar. Sekarang, Anda juga dapat menggunakan Edge Microgateway dengan organisasi uji coba. (PR 5)
• Memperbaiki masalah saat streaming tidak selesai memproses data, tetapi pengendali akhir tetap mengeksekusinya. Hal ini menyebabkan respons parsial dikirim. (PR 71)
• Memperbaiki masalah saat direktori konfigurasi kustom untuk penginstalan Private Cloud tidak dikenali. (PR 110)
• Memperbaiki masalah SSL dua arah antara klien dan Edge Microgateway. (PR 70)
• Memperbaiki masalah garis miring di akhir yang diperlukan pada jalur dasar proxy untuk kunci API verifikasi agar dapat berfungsi dengan benar. Sekarang, garis miring tidak diperlukan di akhir {i>basepath<i}. (PR 48)

Versi 2.3.5

Fitur dan peningkatan baru v.2.3.5

Pemfilteran proxy

Anda dapat memfilter proxy berbasis microgateway mana yang akan diproses oleh instance Edge Microgateway. Saat Edge Microgateway dimulai, semua proxy berbasis microgateway akan didownload organisasi yang terkait dengannya. Gunakan konfigurasi berikut untuk membatasi {i>proxy<i} mana akan diproses oleh microgateway. Misalnya, konfigurasi ini membatasi {i>proxy<i} {i>microgateway<i} akan memproses ke tiga: edgemicro_proxy-1, edgemicro_proxy-2, dan edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Penyamaran data Analytics

Konfigurasi baru memungkinkan Anda mencegah informasi jalur permintaan muncul di Edge Analytics. Tambahkan kode berikut ke konfigurasi microgateway untuk menyamarkan URI permintaan dan/atau jalur permintaan. Perhatikan bahwa URI terdiri dari nama host dan bagian jalur yang diminta.

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

Versi 2.3.3

Fitur dan peningkatan baru v.2.3.3

Berikut adalah fitur dan peningkatan baru untuk rilis ini.

Menonaktifkan polling perubahan otomatis

Anda dapat menonaktifkan polling perubahan otomatis dengan menyetel atribut ini di microgateway konfigurasi:

disabled_config_poll_interval: true

Secara default, polling berkala mengambil perubahan yang dilakukan di Edge (perubahan pada produk, {i>microgateway-aware proxy<i}, dll) serta perubahan yang dibuat pada file konfigurasi lokal. Default interval polling adalah 600 detik (lima menit).

Menulis ulang URL target di plugin

Anda dapat mengganti URL target default secara dinamis dalam plugin dengan mengubah variabel ini dalam kode plugin: req.targetHostname dan req.targetPath.

Tanda tangan fungsi plugin baru

Tanda tangan fungsi plugin baru telah ditambahkan yang memberikan respons target sebagai argumen. Penambahan ini mempermudah plugin untuk mengakses respons target.

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

Output logging default yang disederhanakan

Secara default, layanan logging sekarang menghilangkan JSON untuk proxy, produk, dan JWT yang didownload. Anda dapat mengubahnya ke default untuk menghasilkan objek ini dengan menyetel DEBUG=* saat Anda mulai Edge Microgateway. Contoh:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

Jalur konfigurasi kustom ditambahkan ke CLI

Secara default, file konfigurasi microgateway berada di ./config/config.yaml. Pada {i>init<i}, mengkonfigurasi, dan memulai perintah, sekarang Anda dapat menentukan jalur konfigurasi khusus pada baris perintah. Contoh:

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

Perbaikan bug v2.3.3

• Kebocoran memori telah diperbaiki yang terjadi selama permintaan/respons besar.
• Urutan eksekusi plugin telah diperbaiki. Model kini berperilaku seperti yang dijelaskan dalam dokumentasi tambahan.
• Plugin akumulasi permintaan plugin tidak lagi hang untuk permintaan GET.
• Masalah telah diperbaiki dalam plugin respons akumulasi yang menyebabkan kurangnya isi respons yang sama.

Rilis 2.3.1

Catatan penginstalan

Beberapa Edge Microgateway versi sebelumnya memungkinkan Anda menginstal software dengan mendownload file ZIP . File ZIP ini tidak lagi didukung. Untuk menginstal Edge Microgateway, Anda harus menggunakan:

npm install -g edgemicro

Lihat topik penginstalan untuk secara lebih mendetail.

Fitur dan peningkatan baru v.2.3.1

Berikut adalah fitur dan peningkatan baru untuk rilis ini.

Proxy filter

Konfigurasi baru memungkinkan Anda memfilter proxy mana yang akan dimuat oleh Edge Microgateway sistem dimulai. Sebelumnya, microgateway memuat semua proxy berbasis microgateway (proxy bernama edgemicro_*) yang diambil dari organisasi/lingkungan Edge yang Anda tentukan di edgemicro perintah config. Fitur baru ini memungkinkan Anda memfilter daftar {i>proxy<i} ini sehingga Edge Microgateway hanya memuat software yang Anda tentukan. Cukup tambahkan elemen proxy ke microgateway file konfigurasi seperti ini:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

Sebagai contoh, misalkan Anda memiliki 50 proxy edgemicro_* di Edge org/env, termasuk edgemicro_foo dan edgemicro_bar. Anda dapat beri tahu microgateway agar hanya menggunakan dua proxy ini seperti ini:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Saat memulai, microgateway hanya dapat memanggil proxy yang ditentukan. Setiap upaya untuk memanggil proxy berbasis microgateway lain yang didownload dari organisasi/lingkungan Edge akan menyebabkan error.

Menetapkan header permintaan target di plugin

Ada dua pola dasar yang perlu dipertimbangkan jika Anda ingin menambahkan atau mengubah header permintaan target: satu permintaan masuk berisi data (seperti dalam permintaan POST) dan satu lagi tidak (seperti dalam permintaan GET sederhana).

Mari kita pertimbangkan kasus ketika permintaan masuk berisi data, dan Anda ingin menetapkan permintaan header pada permintaan target. Di versi Edge Microgateway sebelumnya, tidak mungkin menetapkan header target dengan andal dalam kasus ini.

Kunci dari pola ini adalah pertama-tama mengumpulkan semua data yang masuk dari klien. Lalu, di onend_request(), gunakan fungsi baru request.setOverrideHeader(name, value) untuk menyesuaikan header.

Berikut adalah contoh kode plugin yang menunjukkan cara melakukannya. {i>Header<i} yang diatur dalam onend_request dikirim ke target:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

Jika permintaan tidak menyertakan data, Anda dapat menetapkan header target di Pengendali onrequest(). Pola ini bukan hal baru -- sebelumnya telah didokumentasikan dan telah digunakan dalam contoh plugin yang disediakan dengan Edge Microgateway.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

Fitur muat ulang tanpa periode nonaktif

Setelah melakukan perubahan konfigurasi pada Edge Microgateway, Anda dapat memuat konfigurasi tanpa meninggalkan pesan apa pun. Dengan perubahan ini, Edge Microgateway selalu dimulai dalam mode cluster, dan opsi --cluster telah dihapus dari edgemicro start perintah.

Selain itu, tiga perintah CLI baru telah ditambahkan. Anda harus menjalankan perintah ini dari direktori yang sama tempat perintah start edgemicro dijalankan:

• edgemicro status - Memeriksa apakah Edge Microgateway berjalan atau tidak.
• edgemicro stop - Menghentikan cluster Edge Microgateway.
• edgemicro reload - Memuat ulang Edge Microgateway konfigurasi tanpa periode nonaktif.

Muat ulang konfigurasi otomatis tanpa periode nonaktif

Edge Microgateway memuat konfigurasi baru secara berkala dan menjalankan pemuatan ulang jika ada ubah. Polling ini mencatat semua perubahan yang dibuat di Edge (perubahan pada produk, berbasis microgateway {i>proxy<i}, dll) serta perubahan yang dibuat pada file konfigurasi lokal. Interval polling default adalah 600 detik (lima menit). Anda dapat mengubah {i>default<i} di file konfigurasi microgateway sebagai berikut ini:

edgemicro:
    config_change_poll_interval: [seconds]

Menambahkan informasi versi ke CLI

Flag --version telah ditambahkan ke CLI. Untuk mendapatkan versi Edge saat ini Microgateway, gunakan:

edgemicro --version

Opsi SSL server Edge Microgateway baru

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

Mengirim file log ke stdout

Anda dapat mengirim data log ke output standar dengan setelan konfigurasi baru:

edgemicro:
  logging:
    to_console: true  

Lihat Mengelola file log.

Versi 2.1.2

Berikut adalah fitur dan peningkatan baru untuk rilis ini.

Mengizinkan endpoint API kustom untuk konfigurasi

Ada endpoint baru yang dapat dikonfigurasi untuk proxy otorisasi yang mendukung penggunaan layanan autentikasi khusus. Endpoint tersebut adalah:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Untuk detailnya, lihat Menggunakan layanan autentikasi kustom.

Versi 2.1.1

Berikut adalah fitur dan peningkatan baru untuk rilis ini.

Deploy proxy autentikasi kompatibel lintas platform

Peningkatan telah dibuat sehingga perintah yang digunakan untuk men-deploy otorisasi Edge Microgateway proxy ke Edge kompatibel pada sistem Windows.

Versi 2.1.0

Fitur dan peningkatan baru v.21.0

Berikut adalah fitur dan peningkatan baru:

Menentukan opsi SSL/TLS klien

Anda dapat menentukan opsi klien untuk koneksi SSL/TSL ke target menggunakan serangkaian konfigurasi baru lainnya. Lihat Menggunakan opsi SSL/TSL klien.

Versi 2.0.11

Catatan penginstalan v2.0.11

Beberapa Edge Microgateway versi sebelumnya memungkinkan Anda menginstal software dengan mendownload file ZIP . File ZIP ini tidak lagi didukung. Untuk menginstal Edge Microgateway, Anda harus menggunakan:

npm install -g edgemicro

Lihat topik penginstalan untuk secara lebih mendetail.

Fitur dan peningkatan baru v.2.0.11

Berikut adalah fitur dan peningkatan baru:

Menentukan port saat browser dimulai

Perintah start memungkinkan Anda menentukan nomor porta untuk menggantikan porta yang telah ditentukan dalam file konfigurasi Anda. Anda juga dapat menentukan nomor port menggunakan variabel lingkungan PORT. Lihat perintah start untuk mengetahui detailnya.

Anda juga dapat mempertahankan header autentikasi

Setelan konfigurasi baru, keepAuthHeader, memungkinkan Anda mempertahankan Header otorisasi yang dikirim dalam permintaan. Jika disetel ke benar (true), header Auth akan diteruskan ke target. Lihat atribut oauth lebih lanjut.

Kemampuan untuk menggunakan layanan otorisasi kustom

Jika Anda ingin menggunakan layanan khusus Anda sendiri untuk menangani autentikasi, ubah Nilai authUri di file konfigurasi Edge Microgateway agar mengarah ke layanan Anda. Sebagai detail, lihat Menggunakan layanan autentikasi kustom.

Versi 2.0.4

Edge Microgateway v.2.0.4 dirilis pada 25 Mei 2016.

Fitur dan peningkatan baru v2.0.4

Berikut adalah fitur dan peningkatan baru dalam rilis ini.

Dukungan untuk jalur resource dalam produk

Edge Microgateway kini mendukung jalur resource dalam produk. Jalur resource memungkinkan Anda membatasi mengakses API berdasarkan akhiran jalur proxy. Untuk detail tentang cara membuat produk dan mengonfigurasi jalur resource, lihat Membuat API .

Dukungan untuk penginstalan global npm

Kini Anda dapat menginstal Edge Microgateway menggunakan opsi npm -g (global). Untuk mengetahui detail tentang lihat npm dokumentasi tambahan.

Versi 2.0.0

Edge Microgateway v2.0.0 dirilis pada 18 April 2016.

Fitur dan peningkatan baru v.2.0.0

Berikut adalah fitur dan peningkatan baru dalam rilis ini.

Server proses tunggal

Edge Microgateway sekarang menjadi server proses tunggal. Tidak lagi menggunakan model dua proses di mana satu proses (sebelumnya dikenal sebagai "agen") meluncurkan Edge Microgateway, proses kedua {i>checkout<i}. Arsitektur baru ini mempermudah otomatisasi dan containerization.

File konfigurasi dengan namespace

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

Variabel lingkungan baru

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

Konfigurasi yang di-cache

Edge Microgateway menggunakan file konfigurasi yang disimpan dalam cache jika dimulai ulang tanpa dan terhubung ke Apigee Edge.

Mode cluster

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

Perbaikan bug v2.0.0

Siklus proses peristiwa plugin sekarang menangani kode asinkron yang berisi kode dengan .

Versi 1.1.2

Edge Microgateway v. 1.1.2 dirilis pada 14 Maret 2016.

Fitur dan peningkatan baru v.1.1.2

Berikut adalah fitur dan peningkatan baru dalam rilis ini.

Peningkatan Performa

Edge Microgateway kini menggunakan agen HTTP Node.js dengan benar untuk penggabungan koneksi yang lebih baik. Ini peningkatan performa dan stabilitas keseluruhan saat beban tinggi.

Dukungan debugger jarak jauh

Anda dapat mengonfigurasi Edge Microgateway agar berjalan dengan debugger jarak jauh, seperti node-inspector.

Lokasi file konfigurasi baru

Saat Anda mengonfigurasi Edge Microgateway, file agent/config/default.yaml sekarang disalin ke ~./edgemicro/config.yaml.

Rotasi file log

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

Perbaikan bug v1.1.2

Bug berikut telah diperbaiki dalam v. 1.1.2.