Ghi chú phát hành của Edge Microgateway

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. info

Phiên bản 3.3.x

Sửa lỗi và cải tiến phiên bản 3.3.x

3.3.7

Vào ngày 17 tháng 7 năm 2025, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Sửa lỗi và cải tiến:

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

Đã khắc phục các vấn đề bảo mật

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

3.3.6

Vào ngày 16 tháng 4 năm 2025, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.3.6. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Đã khắc phục các vấn đề bảo mật

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

3.3.5

Vào thứ Sáu, ngày 20 tháng 12 năm 2024, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.3.5. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

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

Đã khắc phục các vấn đề bảo mật

• 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

Vào ngày 18 tháng 9 năm 2024, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.3.4. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

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

3.3.3

Vào ngày 25 tháng 4 năm 2024, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.3.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

• 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

Vào ngày 18 tháng 8 năm 2023, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.3.2. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

Không có.

3.3.1

Vào ngày 7 tháng 6 năm 2022, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.3.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

3.3.0

Vào ngày 4 tháng 2 năm 2022, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.3.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

npm install apigeetool@0.15.1

Phiên bản 3.2.x

Sửa lỗi và cải tiến phiên bản 3.2.x

3.2.3

Vào ngày 17 tháng 9 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và điểm cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.2.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

3.2.2

Vào thứ Năm, ngày 15 tháng 7 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.2.2. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

Đã khắc phục các vấn đề bảo mật

3.2.1

Vào thứ Sáu, ngày 5 tháng 3 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.2.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

edgemicro:
 enable_GET_req_body: true

3.2.0

Vào thứ Năm, ngày 21 tháng 1 năm 2021, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.2.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

Phiên bản 3.1.x

Sửa lỗi và cải tiến phiên bản 3.1.x

3.1.8

Vào thứ Hai, ngày 16 tháng 11 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.1.8. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

3.1.7

Vào thứ Năm, ngày 24 tháng 9 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần được liên kết với Edge Microgateway 3.1.7. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

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

3.1.6

Vào thứ Năm, ngày 20 tháng 8 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.1.6. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

3.1.5

Vào thứ Sáu, ngày 26 tháng 6 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.1.5. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

3.1.4

Vào thứ Sáu, ngày 23 tháng 4 năm 2020, chúng tôi đã phát hành bản sửa lỗi sau cho Edge Microgateway.

Sửa lỗi:

Chúng tôi đã khắc phục một vấn đề về phần phụ thuộc trong phiên bản 3.1.3. Phiên bản 3.1.3 đã được đánh dấu là không dùng nữa trong kho lưu trữ npm. Nếu không, tất cả các bản sửa lỗi và tính năng nâng cao được mô tả trong ghi chú phát hành phiên bản 3.1.3 đều áp dụng cho bản phát hành này.

3.1.3

Vào thứ Tư, ngày 15 tháng 4 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.1.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 153509313 – Đã khắc phục vấn đề trong đó mô-đun gỡ lỗi Node.js gây ra tình trạng rò rỉ bộ nhớ. Vấn đề này xuất hiện trong phiên bản 3.1.0, 3.1.1 và 3.1.2.
• 153509313 – Đã khắc phục vấn đề khi cùng một mã nhận dạng thông báo cho 2 giao dịch khác nhau được in trong đầu ra ghi nhật ký.
• 151673570 – Đã khắc phục vấn đề trong đó Edge Microgateway không được cập nhật để sử dụng các API KVM mới của Apigee. Edge Microgateway hiện sử dụng các lệnh mới để thêm và cập nhật các giá trị KVM.
• 152822846 – Trong các bản phát hành trước, Edge Microgateway đã được cập nhật để quá trình xử lý ánh xạ đường dẫn tài nguyên khớp với quá trình xử lý của Apigee Edge. Trong bản phát hành này, một vấn đề đã được khắc phục, đó là mẫu /literal_string/* không được xử lý đúng cách. Ví dụ: /*/2/*. Ngoài ra, hãy xem phần Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**".
• 152005003 – Đã thực hiện các thay đổi để bật giá trị nhận dạng theo phạm vi tổ chức và môi trường cho hạn mức.
• 152005003 – Đã thực hiện các thay đổi để bật giá trị nhận dạng theo phạm vi tổ chức và môi trường cho hạn mức. Tổ hợp "org + env + appName + productName" được dùng làm giá trị nhận dạng hạn mức.

3.1.2

Vào thứ Hai, ngày 16 tháng 3 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.1.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 151285018 – Chúng tôi đã cải tiến một tính năng để thêm chế độ hỗ trợ proxy HTTP cho lưu lượng truy cập giữa Edge Microgateway và các mục tiêu phụ trợ. Ngoài ra, chúng tôi đã khắc phục các vấn đề về tính năng hỗ trợ proxy HTTP hiện có giữa Edge Microgateway và Apigee Edge. Để biết thông tin chi tiết, hãy xem:
  • Sử dụng một proxy HTTP để giao tiếp với Apigee Edge
  • Sử dụng proxy HTTP để giao tiếp với mục tiêu
• 149101890 – Mã thông báo nhật ký cho các trường hợp máy chủ đích hoặc bộ cân bằng tải đóng kết nối đã được thay đổi từ ERROR thành INFO.
• 150746985 – Đã khắc phục một vấn đề trong đó lệnh edgemicro verify không hoạt động đúng cách nếu redisBasedConfigCache: true hoặc quotaUri: https://%s-%s.apigee.net/edgemicro-auth xuất hiện trong tệp cấu hình.
• 151284716 – Chúng tôi đã cải thiện để đóng các kết nối máy chủ nhanh hơn khi các worker được khởi động lại trong quá trình tải lại.
• 151588764 – Cập nhật phiên bản Node.js trong hình ảnh Docker dùng để chạy Edge Microgateway trong một vùng chứa Docker thành 12, vì Node.js phiên bản 8 không được dùng nữa.
• 151306049 – Chúng tôi đã cập nhật tài liệu để liệt kê các API quản lý Apigee Edge mà các lệnh CLI của Edge Microgateway sử dụng. Xem phần Edge Microgateway sử dụng những API quản lý nào?.

3.1.1

Vào thứ Năm, ngày 20 tháng 2, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.1.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 146069701 – Đã khắc phục vấn đề trong đó mô-đun microgateway-core không tuân theo các biến môi trường HTTP_PROXY và HTTPS_PROXY. Với thay đổi này, chế độ cài đặt proxy trong tệp cấu hình YAML (nếu được chỉ định) hiện đã bị bỏ qua; chỉ các biến môi trường được dùng để chỉ định proxy.

  Nếu muốn chỉ định cấu hình proxy trong tệp cấu hình, bạn cũng phải chỉ định một biến HTTP_PROXY đề cập đến cùng một URL proxy như URL được chỉ định trong tệp cấu hình. Ví dụ: nếu bạn chỉ định cấu hình sau:

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

  Bạn cũng phải chỉ định biến môi trường này:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 – Đã thêm một tham số cấu hình mới, edgemicro.headers_timeout. Thuộc tính này giới hạn khoảng thời gian (tính bằng mili giây) mà trình phân tích cú pháp HTTP sẽ chờ nhận tiêu đề HTTP hoàn chỉnh. Ví dụ:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Trong nội bộ, tham số này đặt thuộc tính Server.headersTimeout Node.js trên các yêu cầu. (Mặc định: thêm 5 giây so với thời gian đặt bằng edgemicro.keep_alive_timeout. Chế độ cài đặt mặc định này ngăn bộ cân bằng tải hoặc proxy vô tình làm gián đoạn kết nối.)

• 149278885 – Chúng tôi đã thêm một tính năng mới cho phép bạn đặt thời gian chờ API mục tiêu ở cấp proxy API thay vì sử dụng một chế độ cài đặt thời gian chờ chung.

  Nếu bạn đặt thuộc tính TargetEndpoint io.timeout.millis trong API proxy, Edge Microgateway sẽ có thể truy xuất thuộc tính đó và áp dụng thời gian chờ dành riêng cho điểm cuối đích. Nếu bạn không áp dụng tham số này, Edge Microgateway sẽ sử dụng thời gian chờ chung được chỉ định bằng edgemicro.request_timeout.

3.1.0

Vào thứ Ba, ngày 21 tháng 1, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.1.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 144187500 – Một sự kiện cấp CẢNH BÁO mới sẽ được ghi lại khi cờ quotas.failOpen được kích hoạt. Cờ này được kích hoạt nếu xảy ra lỗi xử lý hạn mức hoặc nếu yêu cầu "áp dụng hạn mức" đối với Edge không cập nhật được bộ đếm hạn mức từ xa. Trong trường hợp này, hạn mức sẽ chỉ được xử lý dựa trên số lượng cục bộ cho đến khi lần đồng bộ hoá hạn mức từ xa tiếp theo diễn ra thành công. Trước đây, sự kiện này chỉ được ghi lại khi cấp nhật ký được đặt thành DEBUG.

  Ví dụ:

  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 – Đã khắc phục vấn đề trong đó các giao dịch đang diễn ra hoặc giao dịch mới bị ảnh hưởng bất cứ khi nào Edge Microgateway phát hiện thấy một thay đổi đối với một proxy API. Giờ đây, khi có thay đổi đối với một proxy, Edge Microgateway sẽ làm mới bộ nhớ đệm và các nút worker sẽ khởi động lại. Với thay đổi này, các giao dịch đang diễn ra và các lệnh gọi API mới được gửi đến cổng siêu nhỏ sẽ không bị ảnh hưởng.
• 146378327 – Cấp nhật ký của sourceRequest, targetRequest và targetResponse đã được thay đổi thành cấp INFO.
• 146019878 – Đã khắc phục sự khác biệt giữa độ trễ được tính cho "Hiệu suất của API Proxy" trong số liệu phân tích của Edge và các sự kiện nhật ký sourceResponse/targetResponse của Edge Microgateway. Giờ đây, độ trễ trong các sự kiện nhật ký của Analytics trên Edge và Microgateway đã được điều chỉnh.
• Những thay đổi liên quan đến logic so khớp mẫu:
  • 147027862 – Trình bổ trợ oauth đã được cập nhật để hỗ trợ các mẫu so khớp đường dẫn tài nguyên sau đây như được chỉ định trong Sản phẩm API:
    • /{literal}**
    • /{literal}*
    • Kết hợp cả hai mẫu trên

    Với thay đổi này, trình bổ trợ Edge Microgateway hiện tuân theo cùng một mẫu so khớp như Apigee Edge, như giải thích trong phần Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**".

  • 145644205 – Cập nhật logic so khớp mẫu của trình bổ trợ apiKeys để khớp với trình bổ trợ oauth.
• 143488312 – Đã khắc phục vấn đề về việc khoảng trắng ở đầu hoặc cuối trong tham số mã ứng dụng khách khiến danh sách sản phẩm JWT được tạo bị trống đối với các yêu cầu về mã thông báo OAuth và khoá API.
• 145640807 và 147579179 – Chúng tôi đã thêm một tính năng mới cho phép một phiên bản Edge Microgateway đặc biệt có tên là "trình đồng bộ hoá" truy xuất dữ liệu cấu hình từ Apigee Edge và ghi dữ liệu đó vào cơ sở dữ liệu Redis cục bộ. Sau đó, bạn có thể định cấu hình các phiên bản microgateway khác để đọc dữ liệu cấu hình của chúng từ cơ sở dữ liệu. Tính năng này giúp Edge Microgateway có khả năng phục hồi. Điều này cho phép các phiên bản microgateway khởi động và hoạt động mà không cần giao tiếp với Apigee Edge. Để biết thông tin chi tiết, hãy xem phần Sử dụng bộ đồng bộ hoá.

  Tính năng đồng bộ hoá hiện được hỗ trợ để hoạt động với Redis 5.0.x.

Phiên bản 3.0.x

Sửa lỗi và cải tiến phiên bản 3.0.x

3.0.10

Vào thứ Sáu, ngày 8 tháng 11, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.0.10. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 142677575 – Chúng tôi đã cập nhật một tính năng để hoạt động so khớp mẫu cho các đường dẫn tài nguyên được dùng trong các sản phẩm API cho Edge Microgateway hiện phù hợp với hoạt động so khớp mẫu đường dẫn tài nguyên mà Apigee Edge sử dụng, như mô tả trong phần Định cấu hình hành vi của đường dẫn tài nguyên '/', '/*' và '/**'.

  Lưu ý: Nếu sử dụng một mẫu tài nguyên kết hợp như /*/2/**, bạn phải đảm bảo rằng proxy edgemicro_auth được thêm vào một sản phẩm API độc lập. Sau đó, bạn phải đưa sản phẩm đó vào Ứng dụng nhà phát triển của proxy, như minh hoạ trong ảnh chụp màn hình sau:

  

  Lưu ý: Thuộc tính cấu hình features.isSingleForwardSlashBlockingEnabled (như mô tả trong phần Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**") không được hỗ trợ cho Edge Microgateway.

• 143740696 – Cấu trúc cấu hình quotas đã thay đổi (xem thêm ghi chú phát hành cho phiên bản 3.0.9). Thuộc tính quotas được dùng để định cấu hình trình bổ trợ hạn mức. Chúng tôi đã thay đổi cấu trúc để cải thiện độ rõ ràng của các phần tử cấu hình. Để định cấu hình trình bổ trợ hạn mức, hãy dùng cấu hình YAML sau. Xin lưu ý rằng thuộc tính cấu hình có tên là quotas. Để biết thông tin chi tiết về từng thuộc tính cấu hình quotas, hãy xem phần Các lựa chọn cấu hình cho hạn mức.

  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 – Chúng tôi đã thêm một tính năng mới cho phép bạn sử dụng Redis làm bộ nhớ dự phòng hạn mức. Nếu useRedis là true, thì mô-đun volos-quota-redis sẽ được dùng. Khi bạn đặt thành true, hạn mức sẽ chỉ giới hạn ở những phiên bản Edge Microgateway kết nối với Redis. Nếu là false, mô-đun volos-quota-apigee sẽ được dùng làm bộ nhớ dự phòng và bộ đếm hạn mức là bộ đếm chung. Để biết thông tin chi tiết, hãy xem phần Các lựa chọn cấu hình cho hạn mức. Ví dụ:

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

• 140574210 – Thời gian hết hạn mặc định cho mã thông báo do proxy edgemicro-auth tạo đã được thay đổi từ 108000 mili giây (1,8 phút) thành 1800 giây (30 phút).
• 143551282 – Để hỗ trợ các tổ chức đã bật SAML, lệnh edgemicro genkeys đã được cập nhật để thêm tham số ‑‑token. Tham số này cho phép bạn sử dụng mã thông báo OAuth để xác thực thay vì tên người dùng/mật khẩu. Để biết thông tin chi tiết, hãy xem phần Tạo khoá.

3.0.9

Vào thứ Sáu, ngày 11 tháng 10, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.0.9. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 141989374 – Đã thêm một tính năng "fail open" (mở khi thất bại) mới cho trình bổ trợ hạn mức. Khi tính năng này được bật, nếu xảy ra lỗi xử lý hạn mức hoặc nếu yêu cầu "áp dụng hạn mức" đến Edge không cập nhật được bộ đếm hạn mức từ xa, thì hạn mức sẽ chỉ được xử lý dựa trên số lượng cục bộ cho đến khi quá trình đồng bộ hoá hạn mức từ xa thành công tiếp theo diễn ra. Trong cả hai trường hợp này, cờ quota-failed-open được đặt trong đối tượng yêu cầu.

  Để bật tính năng "fail open" (mở khi thất bại) cho hạn mức, hãy thiết lập cấu hình sau:

  quotas :
   failOpen : true

  Lưu ý: Ngoài ra, tên của cờ đối tượng yêu cầu fail-open của trình bổ trợ OAuth đã được đổi thành oauth-failed-open.

• 142093764 – Chúng tôi đã thay đổi cấu hình của proxy edgemicro-auth để ngăn tình trạng vượt quá hạn mức. Thay đổi này là để đặt loại hạn mức thành calendar. Để sử dụng tính năng cải tiến này, bạn phải cập nhật edgemicro-auth lên phiên bản 3.0.7 trở lên.
• 142520568 – Chúng tôi đã thêm một tính năng mới để cho phép ghi nhật ký mã nhận dạng MP (trình xử lý thông báo) trong các phản hồi về hạn mức. Để sử dụng tính năng này, bạn phải cập nhật proxy edgemicro-auth lên phiên bản 3.0.7 trở lên và đặt cấu hình sau:

  quotas:
    useDebugMpId: true

  Khi useDebugMpId được đặt, các phản hồi về hạn mức từ Edge sẽ chứa mã MP và sẽ được Edge Microgateway ghi lại. Ví dụ:

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

3.0.8

Vào thứ Năm, ngày 26 tháng 9, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần riêng lẻ được liên kết với Edge Microgateway 3.0.8. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 140025210 – Đã thêm tính năng "fail open" (mở khi thất bại) mới. Tính năng này cho phép quá trình xử lý API tiếp tục nếu không thể làm mới mã thông báo JWT đã hết hạn do lỗi kết nối ngăn chặn lệnh gọi xác minh khoá API thành công đến proxy edgemicro-auth.

  Tính năng này cho phép bạn đặt một khoảng thời gian gia hạn, trong đó mã thông báo cũ vẫn còn trong bộ nhớ đệm và được dùng lại cho đến khi hết thời gian gia hạn. Tính năng này cho phép Edge Microgateway tiếp tục xử lý các yêu cầu trong trường hợp kết nối tạm thời bị lỗi. Khi kết nối được khôi phục và lệnh gọi Verify API Key (Xác minh khoá API) thành công, một JWT mới sẽ được tìm nạp và thay thế JWT cũ trong bộ nhớ đệm.

  Để định cấu hình tính năng "fail open" (mở khi thất bại) mới, hãy làm như sau:

  1. Đặt các thuộc tính sau trong khổ oauth trong tệp cấu hình Edge Microgateway:

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

     Ví dụ:

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

     Trong ví dụ này, mã thông báo cũ sẽ được dùng trong 5 giây nếu không thể làm mới do sự cố kết nối. Sau 5 giây, hệ thống sẽ trả về lỗi xác thực.

• 141168968 – Chúng tôi đã cập nhật để thêm correlation_id vào tất cả đầu ra nhật ký của trình bổ trợ. Ngoài ra, cấp độ nhật ký của một số nhật ký đã được thay đổi thành error theo yêu cầu.
• 140193349 – Chúng tôi đã cập nhật proxy edgemicro-auth để yêu cầu xác minh khoá và mã thông báo bí mật của Edge Microgateway trong mọi yêu cầu Xác minh khoá API. Edge Microgateway đã được cập nhật để luôn gửi khoá và bí mật trong mọi yêu cầu Xác minh khoá API. Thay đổi này ngăn các ứng dụng nhận được JWT chỉ bằng khoá API.
• 140090250 – Chúng tôi đã cập nhật để thêm tính năng ghi nhật ký chẩn đoán cho quá trình xử lý hạn mức. Với thay đổi này, giờ đây, bạn có thể tương quan đầu ra nhật ký hạn mức với phần còn lại của nhật ký Edge Microgateway.

3.0.7

Vào thứ Năm, ngày 12 tháng 9, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Phiên bản thành phần:

Bảng sau đây liệt kê số phiên bản của từng dự án thành phần được liên kết với Edge Microgateway 3.0.7. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt, nên số phiên bản phát hành có thể không khớp với phiên bản sản phẩm chính:

Sửa lỗi và cải tiến:

• 140075602 – Chúng tôi đã cập nhật trình bổ trợ OAuth để trả về mã trạng thái 5xx khi thích hợp. Trước đây, trình bổ trợ chỉ trả về mã trạng thái 4xx trong tất cả các trường hợp không phải 200. Giờ đây, đối với mọi phản hồi thông báo không phải là trạng thái 200, mã 4xx hoặc 5xx chính xác sẽ được trả về, tuỳ thuộc vào lỗi.

  Tính năng này bị tắt theo mặc định. Để bật tính năng này, hãy thêm thuộc tính oauth.useUpstreamResponse: true vào cấu hình Edge Microgateway. Ví dụ:

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

• 140090623 – Trong bản phát hành 3.0.6, một thuộc tính cấu hình mới đã được thêm vào, quota.quotaUri. Đặt thuộc tính cấu hình này nếu bạn muốn quản lý hạn mức thông qua proxy edgemicro-auth được triển khai cho tổ chức của bạn. Nếu bạn không đặt thuộc tính này, thì điểm cuối hạn mức sẽ mặc định là điểm cuối Edge Microgateway nội bộ. Ví dụ:

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

  Trong bản phát hành 3.0.7, edgemicro-auth đã được cập nhật để chấp nhận cấu hình mới này. Để sử dụng thuộc tính quotaUri, bạn phải nâng cấp lên proxy edgemicro-auth mới nhất. Để biết thông tin chi tiết, hãy xem phần Nâng cấp proxy edgemicro-auth.

• 140470888 – Đã thêm một tiêu đề Uỷ quyền vào các lệnh gọi hạn mức để cung cấp thông tin xác thực. Ngoài ra, proxy edgemicro-auth đã được sửa đổi để xoá "organization" khỏi mã nhận dạng hạn mức. Vì điểm cuối hạn mức nằm trong tổ chức của khách hàng, nên không cần giá trị nhận dạng hạn mức nữa.
• 140823165 – Tên thuộc tính sau:

  edgemicro:
      keepAliveTimeout

  được ghi nhận không chính xác trong bản phát hành 3.0.6. Tên tài sản chính xác là:

  edgemicro:
      keep_alive_timeout

• 139526406 – Đã khắc phục lỗi trong đó số lượng hạn mức không chính xác xảy ra nếu một ứng dụng của nhà phát triển có nhiều sản phẩm. Hiện tại, hạn mức được thực thi chính xác cho từng sản phẩm trong một ứng dụng có nhiều sản phẩm. Tổ hợp "appName + productName" được dùng làm mã nhận dạng hạn mức.

3.0.6

Vào thứ Năm, ngày 29 tháng 8, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

• 138633700 – Đã thêm một thuộc tính cấu hình mới, keepAliveTimeout. Thuộc tính này cho phép bạn đặt thời gian chờ của Edge Microgateway (tính bằng mili giây). (Mặc định: 5000 mili giây)

  Ví dụ:

  edgemicro:
    keep_alive_timeout: 600

• 140090623 – Đã thêm một thuộc tính cấu hình mới, quotaUri. Đặt thuộc tính cấu hình này nếu bạn muốn quản lý hạn mức thông qua proxy edgemicro-auth được triển khai cho tổ chức của bạn. Nếu bạn không đặt thuộc tính này, thì điểm cuối hạn mức sẽ mặc định là điểm cuối Edge Microgateway nội bộ. Ví dụ:

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

  Để sử dụng tính năng này, trước tiên, bạn phải triển khai phiên bản mới nhất của proxy edgemicro-auth cho tổ chức của mình. Để biết thông tin chi tiết, hãy xem phần Nâng cấp proxy edgemicro-auth.

• 138722809 – Đã thêm một thuộc tính cấu hình mới, stack_trace. Thuộc tính này cho phép bạn kiểm soát việc dấu vết ngăn xếp có xuất hiện trong tệp nhật ký hay không. Ví dụ:

  stack_trace: false

  Nếu stack_trace được đặt thành true, dấu vết ngăn xếp sẽ được in trong nhật ký. Nếu bạn đặt thành false, dấu vết ngăn xếp sẽ không được in trong nhật ký.

3.0.5

Vào thứ Năm, ngày 15 tháng 8, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

• 139005279 – Đã khắc phục một vấn đề khiến lệnh edgemicro status không trả về đúng số lượng quy trình worker.
• 138437710 – Chúng tôi đã khắc phục một vấn đề trong lớp ExitCounter khiến nhật ký thích hợp không được ghi.

• 139064652 – Đã thêm khả năng thêm các cấp ghi nhật ký trace và debug cho nhật ký sự kiện và nhật ký hệ thống. Hiện tại, chúng tôi chỉ thêm khả năng thêm các cấp độ nhật ký này. Hiện tại, các cấp độ nhật ký có sẵn là info, warn và error.
• 139064616 – Đầu ra nhật ký đã được chuẩn hoá cho tất cả các câu lệnh nhật ký trong bảng điều khiển. Các câu lệnh ghi nhật ký Console hiện bao gồm những thuộc tính sau:
• Dấu thời gian
• Tên thành phần
• ID quá trình
• Thông báo nhật ký trên bảng điều khiển

• 138413755 – Cải thiện thông báo nhật ký liên quan đến khoá và bí mật JWT cho các lệnh CLI sau: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey và configure.

• 138413577 – Thêm và cải thiện khả năng xử lý lỗi cho thời gian chờ của dịch vụ phụ trợ.
• 138413303 – Thêm và cải thiện khả năng xử lý lỗi cho thời gian chờ phản hồi và ổ cắm.
• 138414116 – Thêm và cải thiện khả năng xử lý lỗi cho lỗi "connection refused" (kết nối bị từ chối).

3.0.4

Vào thứ Năm, ngày 1 tháng 8, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

• 134445926 – Cải thiện tính năng xác thực Edge Microgateway nội bộ.
• 137582169 – Khắc phục vấn đề các quy trình không mong muốn khởi động. Các quy trình bổ sung khiến các trình bổ trợ tải lại và sử dụng quá nhiều bộ nhớ. Giờ đây, Edge Microgateway sẽ giữ số lượng quy trình trong giới hạn dự kiến.
• 137768774 – Cải thiện thông báo nhật ký:
  • Đã dọn dẹp nhật ký giao dịch (yêu cầu).
  • Đã thêm nhiều thông báo nhật ký hơn khi cần.
  • Di chuyển thông báo nhật ký giao dịch (yêu cầu) từ đầu ra của bảng điều khiển sang tệp nhật ký có liên quan.
  • Cập nhật nhật ký trong bảng điều khiển để sử dụng một hàm ghi nhật ký tập trung.
• 138321133, 138320563 – Thay đổi nội bộ cơ bản đối với bộ nhớ đệm hạn mức để cho phép các tính năng nâng cao hạn mức trong tương lai.

3.0.3

Vào thứ Ba, ngày 23 tháng 7, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

• Các điểm cải tiến về nhật ký: Nhật ký thời gian chạy hiện có sử dụng một hàm eventLog() mới để ghi lại và lưu dữ liệu thời gian chạy ở định dạng nhất quán. Thông tin nhật ký bao gồm:
  • Dấu thời gian (ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ).
  • Cấp độ nhật ký (lỗi, cảnh báo hoặc thông tin).
  • Tên máy chủ – Tên máy chủ yêu cầu trong tiêu đề yêu cầu.
  • Mã nhận dạng quy trình – Nếu bạn đang chạy một cụm quy trình Node.js, thì đây là mã nhận dạng của quy trình nơi hoạt động ghi nhật ký diễn ra.
  • Tên tổ chức Apigee.
  • Tên môi trường trong tổ chức.
  • Tên proxy API.
  • Địa chỉ IP ứng dụng khách.
  • ClientId.
  • Mã tham chiếu (hiện chưa được đặt).
  • Tên thành phần Edge Microgateway.
  • Thông báo tuỳ chỉnh – Một số đối tượng có thể in thông tin bổ sung được truyền đến thuộc tính lỗi này.
  • Phương thức yêu cầu (nếu là yêu cầu HTTP).
  • Mã trạng thái phản hồi (nếu là yêu cầu HTTP).
  • Thông báo lỗi.
  • Mã lỗi – Nếu một đối tượng có mã lỗi, thì mã lỗi đó sẽ được in trong thuộc tính này.
  • Thời gian thực hiện.
  • Hệ điều hành dấu kết thúc dòng.

  Giá trị thuộc tính rỗng sẽ dẫn đến dấu ngoặc vuông trống, [].

  Ví dụ sau đây cho thấy định dạng nhật ký:

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

  (137770055)

• Hiệu suất: Các sản phẩm API không được lọc dựa trên môi trường. Vấn đề này đã được khắc phục. (135038879)
• Các điểm cải tiến khác về chất lượng mã và việc tích hợp kiểm thử chức năng.

3.0.2

Vào thứ Tư, ngày 3 tháng 7 năm 2019, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

Chất lượng mã – Mã đã được xem xét về chất lượng và các thay đổi về mã đã được thực hiện để đáp ứng các tiêu chuẩn chất lượng mà người dùng yêu cầu. Chúng tôi đã giải quyết các lỗi và cảnh báo về chất lượng mã bắt nguồn từ JSHint. Do đó, một số lỗi mã thực tế đã được xác định và sửa chữa. Tất cả các mô-đun Apigee Edge Microgateway đều trải qua quy trình này. Hãy xem các cam kết ngày 28 tháng 6 và ngày 2 tháng 7 đối với microgateway-config, microgateway-core, microgateway-plugins và microgateway. Tất cả các mô-đun có thay đổi về chất lượng mã đều đã được kiểm thử bằng các công cụ nội bộ để xác minh việc thực thi Edge Microgateway cho các trường hợp sử dụng của khách hàng.

3.0.1

Vào thứ Sáu, ngày 21 tháng 6 năm 2019, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho Edge Microgateway.

• 134834551 – Thay đổi các phiên bản Node.js được hỗ trợ cho Edge Microgateway
  (Các phiên bản Node.js được hỗ trợ: 8 và 12; các phiên bản 7, 9 và 11 là phiên bản thử nghiệm)
• 134751883 – Edge Microgateway gặp sự cố khi tải lại trong quá trình tải
• 134518428 – Điểm cuối Products cho Edge Microgateway trả về 5XX nếu mẫu bộ lọc không chính xác
• 135113408 – Các worker nên khởi động lại nếu bị chấm dứt ngoài ý muốn
• 134945852 – tokenCacheSize không được dùng trong trình bổ trợ oauth
• 134947757 – đặt cacheTTL trong trình bổ trợ oauth
• 135445171 – gracePeriod calculation in OAuth is not correct
• Sử dụng mô-đun memored được cung cấp cùng với quá trình cài đặt Edge Microgateway
• 135367906 – Kiểm tra bảo mật

Phiên bản 2.5.x

Các tính năng mới và điểm cải tiến trong phiên bản 2.5.x

(Đã sửa 2.5.38, ngày 7/6/2019)

JWT có định dạng không đúng cách có thể khiến các worker gặp sự cố khi sử dụng bộ nhớ đệm mã thông báo. Đã khắc phục trong mô-đun microgateway-plugins của Edge. (b/134672029)

(Thêm 2.5.37) Thêm lựa chọn CLI edgemicro-cert -t.

Lựa chọn edgemicro cert -t cho phép bạn chỉ định mã thông báo OAuth để xác thực các API quản lý. Xem thêm bài viết Quản lý chứng chỉ.

(Đã thêm 2.5.35) Thêm tính năng hỗ trợ gỡ lỗi Edge Microgateway bằng edgemicroctl.

Bạn có thể sử dụng cờ mgdebug với edgemicroctl. Xem thêm Các tác vụ tích hợp Kubernetes.

(Đã thêm 2.5.35) Bật bản dựng Windows cho edgemicroctl.

(Đã thêm 2.5.31) API edgemicro-auth/token mới

Một API edgemicro-auth/token mới đã được thêm vào, cho phép bạn truyền ứng dụng/khoá bí mật dưới dạng tiêu đề Uỷ quyền cơ bản được mã hoá Base64 và grant_type dưới dạng tham số biểu mẫu. Xem phần Lấy trực tiếp mã thông báo của người mang.

(Đã khắc phục 2.5.31) Cấu hình riêng tư không tuân theo cờ mã thông báo

Chúng tôi đã khắc phục một vấn đề khiến việc định cấu hình Edge Microgateway để sử dụng mã truy cập OAuth2 trên Edge cho Đám mây riêng không hoạt động đúng cách (mã thông báo không được tuân thủ).

Docker: Hỗ trợ sử dụng chứng chỉ tự ký

(Đã thêm 2.5.29) Nếu đang sử dụng Cơ quan cấp chứng chỉ (CA) mà Node.js không tin cậy theo mặc định, bạn có thể sử dụng tham số NODE_EXTRA_CA_CERTS khi chạy một vùng chứa Docker bằng Edge Microgateway. Để biết thông tin chi tiết, hãy xem bài viết Sử dụng CA không được Node.js tin cậy.

Docker: Hỗ trợ TLS

(Đã thêm 2.5.29) Edge Microgateway chạy trong một vùng chứa Docker hiện hỗ trợ TLS cho các yêu cầu đến máy chủ Edge Microgateway (yêu cầu hướng bắc) và cho các yêu cầu đi từ Edge Microgateway đến một ứng dụng đích (yêu cầu hướng nam).

Các ví dụ sau đây giải thích chi tiết cách thiết lập các cấu hình TLS này:

• Ví dụ về cấu hình TLS hướng bắc
• Ví dụ về cấu hình TLS hướng nam

Trong các ví dụ này, bạn sẽ thấy cách sử dụng điểm gắn kết vùng chứa /opt/apigee/.edgemicro để tải các chứng chỉ. Sau đó, các chứng chỉ này sẽ được tham chiếu trong tệp cấu hình Edge Microgateway.

Docker: Hỗ trợ uỷ quyền yêu cầu

(Thêm 2.5.27) Nếu chạy Edge Microgateway trong một vùng chứa Docker, bạn có thể sử dụng các lựa chọn này để kiểm soát hành vi của proxy khi microgateway đang chạy sau tường lửa:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Để biết thông tin chi tiết, hãy xem bài viết Chạy Edge Micro dưới dạng một vùng chứa Docker.

Docker: Hướng dẫn mới về trình bổ trợ

(Thêm vào ngày 27/5/2024) Nếu chạy Edge Microgateway trong một vùng chứa Docker, thì giờ đây, bạn có 2 lựa chọn để triển khai các trình bổ trợ. Một lựa chọn mới là sử dụng điểm gắn kết Docker. Lựa chọn còn lại không thay đổi nhiều; tuy nhiên, Dockerfile đã được cập nhật. Để biết thông tin chi tiết, hãy tham khảo các đường liên kết sau:

• Cách A: Gắn thư mục trình bổ trợ vào một ổ đĩa (Mới)
• Lựa chọn B: Tạo các trình bổ trợ trong vùng chứa (Mới cập nhật)

Hỗ trợ mã thông báo OAuth mới cho lệnh nâng cấp KVM

(Thêm 2.5.27) Bạn có thể dùng mã thông báo OAuth với lệnh upgradekvm. Để biết thông tin chi tiết, hãy xem phần Nâng cấp KVM.

Phân tách các API trong Edge Analytics

(Thêm 2.5.26) Các cờ trình bổ trợ phân tích mới cho phép bạn phân tách một đường dẫn API cụ thể để đường dẫn đó xuất hiện dưới dạng một proxy riêng trong trang tổng quan Phân tích Edge. Ví dụ: bạn có thể tách riêng các API kiểm tra tình trạng để tránh nhầm lẫn với các lệnh gọi API thực tế. Để biết thêm thông tin, hãy xem bài viết Loại trừ đường dẫn khỏi số liệu phân tích.

Định cấu hình một proxy cục bộ

(Thêm vào ngày 25/5/2023) Với một proxy cục bộ, bạn không cần phải tạo proxy có nhận biết cổng siêu nhỏ theo cách thủ công trên Apigee Edge. Thay vào đó, microgateway sẽ sử dụng đường dẫn cơ sở của proxy cục bộ. Để biết thêm thông tin, hãy xem bài viết Sử dụng chế độ proxy cục bộ.

Sử dụng chế độ độc lập

(Thêm vào ngày 25/2/2025) Bạn có thể chạy Edge Microgateway mà không cần kết nối với bất kỳ thành phần phụ thuộc nào của Apigee Edge. Trường hợp này (gọi là chế độ độc lập) cho phép bạn chạy và kiểm thử Edge Microgateway mà không cần kết nối Internet, hãy xem phần Chạy Edge Microgateway ở chế độ độc lập.

Thu hồi khoá

(Thêm vào ngày 2/5/2019) Đã thêm một lệnh CLI mới thu hồi khoá và thông tin đăng nhập bí mật cho cấu hình Edge Microgateway.

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

Hỗ trợ Docker

(Thêm vào ngày 2/5/2019) Giờ đây, bạn có thể tải bản phát hành Edge Microgateway mới nhất xuống dưới dạng hình ảnh Docker:

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

Hỗ trợ Kubernetes

(Thêm vào ngày 5 tháng 2 năm 2019) Bạn có thể triển khai Edge Microgateway dưới dạng một dịch vụ hoặc dưới dạng một cổng phụ trợ trước các dịch vụ được triển khai trong một cụm Kubernetes. Xem phần: Tổng quan về việc tích hợp Edge Microgateway với Kubernetes.

Hỗ trợ lựa chọn TCP nodelay

(Thêm 2.5.16) Chúng tôi đã thêm một chế độ cài đặt cấu hình mới (nodelay) vào cấu hình Edge Micro.

Theo mặc định, các kết nối TCP sử dụng thuật toán Nagle để lưu vào bộ nhớ đệm dữ liệu trước khi gửi đi. Việc đặt nodelay thành true sẽ vô hiệu hoá hành vi này (dữ liệu sẽ ngay lập tức kích hoạt dữ liệu mỗi khi socket.write() được gọi). Hãy xem thêm tài liệu về Node.js để biết thêm thông tin chi tiết.

Để bật nodelay, hãy chỉnh sửa tệp cấu hình Edge Micro như sau:

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

Các lựa chọn mới cho CLI để giám sát vĩnh viễn

(Thêm 2.5.12) Các tham số mới đã được thêm vào lệnh edgemicro forever. Các tham số này cho phép bạn chỉ định vị trí của tệp forever.json và cho phép bạn bắt đầu hoặc dừng quy trình nền Forever. Xem thêm phần Giám sát vĩnh viễn

Ví dụ:

Cách bắt đầu sử dụng Forever:

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

Cách dừng Forever:

edgemicro forever -a stop

Xoay vòng khoá JWT

Chúng tôi đã thêm một tính năng mới cho phép bạn xoay cặp khoá công khai/riêng tư dùng để tạo mã thông báo JWT dùng cho bảo mật OAuth trên Edge Microgateway. Xem phần Xoay khoá JWT.

Lọc các proxy API đã tải xuống

Theo mặc định, Edge Microgateway sẽ tải tất cả các proxy trong tổ chức Edge của bạn xuống. Các proxy này bắt đầu bằng tiền tố đặt tên "edgemicro_". Bạn có thể thay đổi chế độ mặc định này để tải các proxy có tên khớp với một mẫu. Xem phần Lọc các proxy đã tải xuống.

Chỉ định sản phẩm không có proxy API

Trong Apigee Edge, bạn có thể tạo một sản phẩm API không chứa bất kỳ proxy API nào. Cấu hình sản phẩm này cho phép khoá API được liên kết với sản phẩm đó hoạt động với mọi proxy được triển khai trong tổ chức của bạn. Kể từ phiên bản 2.5.4, Edge Microgateway hỗ trợ cấu hình sản phẩm này.

Hỗ trợ tính năng giám sát vĩnh viễn

Edge Microgateway có một tệp forever.json mà bạn có thể định cấu hình để kiểm soát số lần và khoảng thời gian Edge Microgateway cần khởi động lại. Tệp này định cấu hình một dịch vụ có tên là forever-monitor, giúp quản lý Forever theo phương thức lập trình. Hãy xem phần Giám sát vĩnh viễn.

Quản lý tập trung tệp cấu hình Edge Micro

Nếu chạy nhiều phiên bản Edge Microgateway, bạn có thể muốn quản lý cấu hình của các phiên bản đó từ một vị trí duy nhất. Bạn có thể thực hiện việc này bằng cách chỉ định một điểm cuối HTTP nơi Edge Micro có thể tải tệp cấu hình xuống. Xem phần Chỉ định một điểm cuối của tệp cấu hình.

Hỗ trợ lựa chọn CLI mãi mãi

(Thêm 2.5.8) Sử dụng lệnh edgemicro forever [package.json] để chỉ định vị trí của tệp forever.json. Trước khi thêm lệnh này, tệp cấu hình phải nằm trong thư mục gốc của Edge Microgateway.

Ví dụ:

edgemicro forever ~/mydir/forever.json

Thêm lựa chọn configUrl vào lệnh tải lại

(Thêm 2.5.8) Giờ đây, bạn có thể dùng tuỳ chọn --configUrl hoặc -u với lệnh edgemicro reload.

Thời gian ân hạn cho sự khác biệt về thời gian JWT

(Thêm 2.5.7) Thuộc tính gracePeriod trong cấu hình OAuth giúp ngăn chặn các lỗi do sự khác biệt nhỏ giữa đồng hồ hệ thống của bạn và thời gian Không được phép trước (nbf) hoặc Thời gian phát hành (iat) được chỉ định trong mã thông báo uỷ quyền JWT. Đặt thuộc tính này thành số giây để cho phép những điểm khác biệt như vậy. Xem Thuộc tính OAuth.

(Thêm 2.5.7) Thuộc tính gracePeriod trong cấu hình OAuth giúp ngăn chặn các lỗi do sự khác biệt nhỏ giữa đồng hồ hệ thống của bạn và thời gian Không được phép trước (nbf) hoặc Thời gian phát hành (iat) được chỉ định trong mã thông báo uỷ quyền JWT. Đặt thuộc tính này thành số giây để cho phép những điểm khác biệt như vậy. Xem Thuộc tính OAuth.

Các lỗi đã được khắc phục trong phiên bản 2.5.x

• (Vấn đề #236) Sửa lỗi chính tả khi xoá bộ nhớ đệm.
• (Vấn đề #234) Sự cố tải lại đối với Edge Microgateway 2.5.35.
• (Vấn đề 135) Lỗi tham chiếu máy chủ ảo không hợp lệ "secure" (bảo mật) khi sử dụng lựa chọn -v. Bản sửa lỗi này sửa đổi proxy edgemicro-auth trước khi triển khai để đảm bảo máy chủ ảo khớp chính xác với những gì được chỉ định trong cờ "-v". Ngoài ra, bạn có thể chỉ định số lượng và tên bất kỳ cho máy chủ ảo (không còn bị giới hạn ở mặc định và bảo mật).
• (Vấn đề 141) Lệnh edgemicro reload không hỗ trợ lựa chọn tệp cấu hình -c. Sự cố này đã được khắc phục.
• (Vấn đề 142) Edge Microgateway báo lỗi về tiền mã hoá không dùng nữa tại thời điểm cài đặt. Sự cố này đã được khắc phục.
• (Vấn đề số 145) Hạn mức không hoạt động với Edge Microgateway. Sự cố này đã được khắc phục.
• (Vấn đề về cộng đồng Apigee: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) Mã thông báo JWT được xác thực dựa trên cả API Proxy và URI tài nguyên trong OAUTH. Vấn đề này đã được khắc phục.
• (Vấn đề về cộng đồng Apigee: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway không hoạt động với OAuth. Sự cố này đã được khắc phục.
• Khắc phục pidPath trên Windows.
• (Vấn đề 157) Chúng tôi đã khắc phục vấn đề gây ra thông báo lỗi sau: ReferenceError: deployProxyWithPassword chưa được xác định.
• (Vấn đề #169) Cập nhật các phần phụ thuộc Node.js (kiểm tra npm)
• Giờ đây, proxy edgemicro-auth sử dụng các chính sách JWT của Edge. Proxy không còn phụ thuộc vào Node.js để cung cấp dịch vụ hỗ trợ JWT nữa.

Phiên bản 2.4.x

Các tính năng mới và điểm cải tiến trong phiên bản 2.4.x

1. Đặt một bí danh tuỳ chỉnh cho proxy edgemicro-auth (PR 116)

Bạn có thể thay đổi đường dẫn cơ sở mặc định cho proxy edgemicro-auth. Theo mặc định, basepath là /edgemicro-auth. Để thay đổi, hãy sử dụng cờ -x trên lệnh edgemicro configure.

Ví dụ:

edgemicro configure -x /mypath …

2. Hỗ trợ ký tự đại diện cho đường dẫn cơ sở (PR 77)

Bạn có thể dùng một hoặc nhiều ký tự đại diện "*" trong đường dẫn cơ sở của một proxy edgemicro_*. Ví dụ: đường dẫn cơ sở /team/*/members cho phép các ứng dụng gọi https://[host]/team/blue/members và https://[host]/team/green/members mà bạn không cần tạo các proxy API mới để hỗ trợ các nhóm mới. Xin lưu ý rằng /**/ không được hỗ trợ.

3. Đã thêm đường dẫn cấu hình tuỳ chỉnh vào CLI cho cấu hình Đám mây riêng (PR 99)

Theo mặc định, tệp cấu hình microgateway nằm trong ./config/config.yaml. Trên các lệnh init, configure và start, giờ đây, bạn có thể chỉ định một đường dẫn cấu hình tuỳ chỉnh trên dòng lệnh bằng cách sử dụng cờ -c hoặc --configDir. Khắc phục vấn đề không nhận dạng được thư mục cấu hình tuỳ chỉnh cho các bản cài đặt Đám mây riêng.

Ví dụ:

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

4. Tôn trọng các biến *_PROXY (PR 61)

Nếu Edge Microgateway được cài đặt sau tường lửa và không thể giao tiếp với Apigee Edge trong đám mây công cộng, thì bạn có thể cân nhắc 2 lựa chọn sau:

Cách 1:

Lựa chọn đầu tiên là đặt tuỳ chọn edgemicro: proxy_tunnel thành true trong tệp cấu hình microgateway:

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

Khi proxy_tunnel là true, Edge Microgateway sẽ sử dụng phương thức HTTP CONNECT để chuyển các yêu cầu HTTP qua một kết nối TCP duy nhất. (Điều này cũng đúng nếu các biến môi trường để định cấu hình proxy được bật TLS).

Cách 2:

Lựa chọn thứ hai là chỉ định một proxy và đặt proxy_tunnel thành false trong tệp cấu hình microgateway. Ví dụ:

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

Trong trường hợp này, bạn có thể đặt các biến sau để kiểm soát máy chủ lưu trữ cho từng proxy HTTP mà bạn muốn sử dụng hoặc máy chủ lưu trữ nào không được xử lý proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXY và NO_PROXY. Bạn có thể đặt NO_PROXY làm danh sách các miền được phân tách bằng dấu phẩy mà Edge Microgateway không được chuyển đến. Ví dụ:

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

Để biết thêm thông tin về các biến này, hãy xem:

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

5. Đặt thời gian chờ tuỳ chỉnh cho các yêu cầu mục tiêu (PR 57)

Bạn có thể đặt thời gian chờ tuỳ chỉnh cho các yêu cầu mục tiêu bằng cấu hình này:

edgemicro:
    request_timeout: 10

Thời gian chờ được tính bằng giây. Nếu xảy ra thời gian chờ, Edge Microgateway sẽ phản hồi bằng mã trạng thái 504.

6. Tôn trọng thông báo trạng thái HTTP tuỳ chỉnh trên phản hồi mục tiêu (PR 53)

Edge Microgateway tuân theo các thông báo trạng thái HTTP tuỳ chỉnh được đặt trên phản hồi mục tiêu. Trong các bản phát hành trước, thông báo trạng thái được gửi từ đích đến đã bị ghi đè bằng các giá trị mặc định của Node.js.

7. Tiêu đề X-Forwarded-For có thể đặt client_ip cho số liệu phân tích

Nếu có, tiêu đề X-Forwarded-For sẽ đặt biến client_ip được báo cáo trong Edge Analytics. Tính năng này cho phép bạn biết IP của ứng dụng khách đã gửi yêu cầu đến Edge Microgateway.

8. Các thay đổi về trình bổ trợ OAuth

Trình bổ trợ OAuth hỗ trợ xác minh Khoá API và xác minh mã truy cập OAuth. Trước khi có thay đổi này, trình bổ trợ chấp nhận một trong hai hình thức bảo mật. Với thay đổi này, bạn chỉ có thể cho phép một trong các mô hình bảo mật đó (trong khi vẫn duy trì khả năng tương thích ngược).

Trình bổ trợ OAuth sẽ thêm 2 cờ mới:

• allowOAuthOnly – Nếu được đặt thành true, mọi API phải có một tiêu đề Uỷ quyền kèm theo Mã truy cập của người mang.

• allowAPIKeyOnly – Nếu được đặt thành true, mọi API phải mang theo một tiêu đề x-api-key (hoặc một vị trí tuỳ chỉnh) có Khoá API.

Bạn thiết lập các cờ này trong tệp cấu hình Edge Microgateway như sau:

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

9. Cải thiện proxy edgemicro-auth (PR 40)

Chúng tôi đã cải tiến proxy edgemicro-auth. Trước khi có những thay đổi này, proxy sẽ lưu trữ các khoá trong Edge Secure Store, một kho lưu trữ được mã hoá. Giờ đây, proxy sẽ lưu trữ các khoá trong bản đồ khoá-giá trị (KVM) được mã hoá của Edge.

10. Viết lại URL đích mặc định trong một trình bổ trợ (PR 74)

Bạn cũng có thể ghi đè cổng điểm cuối đích và chọn giữa HTTP và HTTPS. Sửa đổi các biến này trong mã trình bổ trợ: req.targetPort và req.targetSecure. Để chọn HTTPS, hãy đặt req.targetSecure thành true; đối với HTTP, hãy đặt thành false. Nếu bạn đặt req.targetSecure thành true, hãy xem chuỗi thảo luận này để biết thêm thông tin.

11. Hỗ trợ ban đầu cho xác thực mã thông báo OAuth (PR 125)

Bạn có thể định cấu hình Edge Microgateway để sử dụng mã thông báo OAuth cho quy trình xác thực thay vì tên người dùng/mật khẩu. Để sử dụng mã thông báo OAuth, hãy dùng tham số sau trong lệnh edgemicro configure:

-t, --token <token>

Ví dụ:

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

Các lỗi đã được khắc phục trong phiên bản 2.4.3

• Khắc phục vấn đề yêu cầu tổ chức trả phí để chạy proxy edgemicro-auth đúng cách. Giờ đây, bạn cũng có thể sử dụng Edge Microgateway với các tổ chức dùng thử. (PR 5)
• Khắc phục vấn đề luồng chưa xử lý xong dữ liệu nhưng các trình xử lý kết thúc vẫn thực thi. Điều này khiến một phần phản hồi được gửi đi. (PR 71)
• Khắc phục vấn đề trong đó hệ thống không nhận dạng được thư mục cấu hình tuỳ chỉnh cho các bản cài đặt Đám mây riêng. (PR 110)
• Khắc phục vấn đề về SSL hai chiều giữa ứng dụng và Edge Microgateway. (PR 70)
• Khắc phục vấn đề trong đó cần có dấu gạch chéo ở cuối trên đường dẫn cơ sở của proxy để xác minh khoá API hoạt động đúng cách. Giờ đây, bạn không cần dấu gạch chéo ở cuối đường dẫn cơ sở. (PR 48)

Phiên bản 2.3.5

Các tính năng mới và điểm cải tiến trong phiên bản 2.3.5

Lọc proxy

Bạn có thể lọc những proxy có nhận biết microgateway mà một thực thể Edge Microgateway sẽ xử lý. Khi Edge Microgateway khởi động, nó sẽ tải xuống tất cả các proxy có nhận biết microgateway trong tổ chức mà nó được liên kết. Sử dụng cấu hình sau để giới hạn những proxy mà microgateway sẽ xử lý. Ví dụ: cấu hình này giới hạn số lượng proxy mà microgateway sẽ xử lý là 3: edgemicro_proxy-1, edgemicro_proxy-2 và edgemicro_proxy-3:

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

Che giấu dữ liệu Analytics

Một cấu hình mới cho phép bạn ngăn thông tin về đường dẫn yêu cầu xuất hiện trong số liệu phân tích của Edge. Thêm nội dung sau vào cấu hình microgateway để che URI yêu cầu và/hoặc đường dẫn yêu cầu. Lưu ý rằng URI bao gồm tên máy chủ và các phần đường dẫn của yêu cầu.

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

Phiên bản 2.3.3

Các tính năng mới và điểm cải tiến trong phiên bản 2.3.3

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.

Tắt tính năng thăm dò ý kiến tự động về thay đổi

Bạn có thể tắt tính năng thăm dò ý kiến thay đổi tự động bằng cách đặt thuộc tính này trong cấu hình microgateway:

disabled_config_poll_interval: true

Theo mặc định, hoạt động thăm dò ý kiến định kỳ sẽ ghi nhận mọi thay đổi được thực hiện trên Edge (thay đổi đối với sản phẩm, các proxy có nhận biết cổng siêu nhỏ, v.v.) cũng như những thay đổi được thực hiện đối với tệp cấu hình cục bộ. Khoảng thời gian thăm dò mặc định là 600 giây (5 phút).

Viết lại URL mục tiêu trong các trình bổ trợ

Bạn có thể ghi đè URL đích mặc định một cách linh động trong một trình bổ trợ bằng cách sửa đổi các biến này trong mã trình bổ trợ: req.targetHostname và req.targetPath.

Chữ ký hàm của trình bổ trợ mới

Một chữ ký hàm trình bổ trợ mới đã được thêm vào, cung cấp phản hồi mục tiêu dưới dạng một đối số. Việc bổ sung này giúp các trình bổ trợ dễ dàng truy cập vào phản hồi mục tiêu.

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

Đơn giản hoá đầu ra ghi nhật ký mặc định

Theo mặc định, dịch vụ ghi nhật ký hiện bỏ qua JSON của các proxy, sản phẩm và JWT đã tải xuống. Bạn có thể thay đổi để mặc định xuất các đối tượng này bằng cách đặt DEBUG=* khi bạn khởi động Edge Microgateway. Ví dụ:

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

Đã thêm đường dẫn cấu hình tuỳ chỉnh vào CLI

Theo mặc định, tệp cấu hình microgateway nằm trong ./config/config.yaml. Trên các lệnh init, configure và start, giờ đây, bạn có thể chỉ định một đường dẫn cấu hình tuỳ chỉnh trên dòng lệnh. Ví dụ:

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

Các lỗi đã được khắc phục trong phiên bản 2.3.3

• Đã khắc phục lỗi rò rỉ bộ nhớ xảy ra trong các yêu cầu/phản hồi lớn.
• Đã sửa thứ tự thực thi trình bổ trợ. Giờ đây, nó hoạt động theo cách được giải thích trong tài liệu.
• Trình bổ trợ accumulate-request không còn bị treo đối với các yêu cầu GET nữa.
• Đã khắc phục một vấn đề trong trình bổ trợ accumulate-response, trong đó việc thiếu nội dung phản hồi gây ra lỗi.

Bản phát hành 2.3.1

Ghi chú về việc lắp đặt

Một số phiên bản trước của Edge Microgateway cho phép bạn cài đặt phần mềm bằng cách tải tệp ZIP xuống. Các tệp ZIP này không còn được hỗ trợ nữa. Để cài đặt Edge Microgateway, bạn phải sử dụng:

npm install -g edgemicro

Hãy tham khảo chủ đề về việc cài đặt để biết thêm thông tin chi tiết.

Các tính năng mới và điểm cải tiến trong phiên bản 2.3.1

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.

Lọc proxy

Một cấu hình mới cho phép bạn lọc những proxy mà Edge Microgateway sẽ tải khi khởi động. Trước đây, microgateway đã tải tất cả các proxy có nhận biết microgateway (các proxy có tên edgemicro_*) được kéo từ tổ chức/môi trường Edge mà bạn đã chỉ định trong lệnh định cấu hình edgemicro. Tính năng mới này cho phép bạn lọc danh sách các proxy này để Edge Microgateway chỉ tải những proxy mà bạn chỉ định. Bạn chỉ cần thêm phần tử proxies vào tệp cấu hình microgateway như sau:

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

Ví dụ: giả sử bạn có 50 proxy edgemicro_* trong tổ chức/môi trường Edge, bao gồm cả những proxy có tên là edgemicro_foo và edgemicro_bar. Bạn có thể yêu cầu microgateway chỉ sử dụng hai proxy này như sau:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Khi khởi động, cổng siêu nhỏ sẽ chỉ có thể gọi các proxy được chỉ định. Mọi nỗ lực gọi các proxy khác có nhận biết vi cổng được tải xuống từ tổ chức/môi trường Edge sẽ dẫn đến lỗi.

Đặt tiêu đề yêu cầu mục tiêu trong các trình bổ trợ

Có hai mẫu cơ bản cần xem xét nếu bạn muốn thêm hoặc sửa đổi tiêu đề yêu cầu mục tiêu: một mẫu trong đó yêu cầu đến chứa dữ liệu (như trong yêu cầu POST) và một mẫu không chứa dữ liệu (như trong yêu cầu GET đơn giản).

Hãy xem xét trường hợp yêu cầu đến chứa dữ liệu và bạn muốn đặt tiêu đề yêu cầu cho yêu cầu mục tiêu. Trong các phiên bản trước của Edge Microgateway, bạn không thể thiết lập tiêu đề đích một cách đáng tin cậy trong trường hợp này.

Điểm mấu chốt của mẫu này là trước tiên, bạn phải tích luỹ tất cả dữ liệu đến từ ứng dụng. Sau đó, trong hàm onend_request(), hãy dùng hàm request.setOverrideHeader(name, value) mới để tuỳ chỉnh tiêu đề.

Dưới đây là mã mẫu của trình bổ trợ cho biết cách thực hiện việc này. Các tiêu đề được đặt trong onend_request sẽ được gửi đến mục tiêu:

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);
    }

  };

}

Nếu yêu cầu không bao gồm dữ liệu, thì bạn có thể đặt tiêu đề mục tiêu trong trình xử lý onrequest(). Mẫu này không phải là mẫu mới, mà đã được ghi lại trước đây và được dùng trong các trình bổ trợ mẫu đi kèm với 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();
    }

Tính năng tải lại không có thời gian ngừng hoạt động

Sau khi thực hiện thay đổi cấu hình cho Edge Microgateway, bạn có thể tải cấu hình mà không bỏ qua bất kỳ thông báo nào. Với thay đổi này, Edge Microgateway luôn khởi động ở chế độ cụm và lựa chọn --cluster đã bị xoá khỏi lệnh edgemicro start.

Ngoài ra, chúng tôi đã thêm 3 lệnh CLI mới. Bạn phải chạy các lệnh này từ cùng một thư mục nơi lệnh bắt đầu edgemicro được thực thi:

• edgemicro status – Kiểm tra xem Edge Microgateway có đang chạy hay không.
• edgemicro stop – Dừng cụm Edge Microgateway.
• edgemicro reload – Tải lại cấu hình Edge Microgateway mà không bị gián đoạn.

Tự động tải lại cấu hình mà không bị gián đoạn

Edge Microgateway định kỳ tải một cấu hình mới và thực hiện tải lại nếu có thay đổi. Hoạt động thăm dò sẽ ghi nhận mọi thay đổi được thực hiện trên Edge (thay đổi đối với sản phẩm, các proxy có nhận biết cổng siêu nhỏ, v.v.) cũng như những thay đổi được thực hiện đối với tệp cấu hình cục bộ. Khoảng thời gian thăm dò mặc định là 600 giây (5 phút). Bạn có thể thay đổi giá trị mặc định trong tệp cấu hình microgateway như sau:

edgemicro:
    config_change_poll_interval: [seconds]

Đã thêm thông tin phiên bản vào CLI

Đã thêm cờ --version vào CLI. Để lấy phiên bản hiện tại của Edge Microgateway, hãy sử dụng:

edgemicro --version

Các lựa chọn SSL mới của máy chủ Edge Microgateway

Ngoài key và cert, Edge Microgateway hiện hỗ trợ các lựa chọn SSL máy chủ sau:

Gửi tệp nhật ký đến stdout

Bạn có thể gửi dữ liệu nhật ký đến đầu ra chuẩn bằng một chế độ cài đặt cấu hình mới:

edgemicro:
  logging:
    to_console: true  

Xem phần Quản lý tệp nhật ký.

Phiên bản 2.1.2

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.

Cho phép sử dụng điểm cuối API tuỳ chỉnh để định cấu hình

Có các điểm cuối mới có thể định cấu hình cho proxy uỷ quyền, hỗ trợ việc sử dụng dịch vụ uỷ quyền tuỳ chỉnh. Các điểm cuối này là:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Để biết thông tin chi tiết, hãy xem phần Sử dụng dịch vụ uỷ quyền tuỳ chỉnh.

Phiên bản 2.1.1

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.

Triển khai proxy uỷ quyền tương thích trên nhiều nền tảng

Chúng tôi đã cải tiến để lệnh dùng để triển khai proxy uỷ quyền Edge Microgateway cho Edge tương thích với các hệ thống Windows.

Phiên bản 2.1.0

Các tính năng mới và điểm cải tiến trong phiên bản 21.0

Sau đây là các tính năng mới và điểm cải tiến:

Chỉ định các lựa chọn SSL/TLS của máy khách

Bạn có thể chỉ định các lựa chọn của ứng dụng cho các kết nối SSL/TSL đến các mục tiêu bằng cách sử dụng một bộ lựa chọn cấu hình mới. Xem phần Sử dụng các lựa chọn SSL/TSL của máy khách.

Phiên bản 2.0.11

Ghi chú về việc lắp đặt phiên bản 2.0.11

Một số phiên bản trước của Edge Microgateway cho phép bạn cài đặt phần mềm bằng cách tải tệp ZIP xuống. Các tệp ZIP này không còn được hỗ trợ nữa. Để cài đặt Edge Microgateway, bạn phải sử dụng:

npm install -g edgemicro

Hãy tham khảo chủ đề về việc cài đặt để biết thêm thông tin chi tiết.

Các tính năng mới và điểm cải tiến phiên bản 2.0.11

Sau đây là các tính năng mới và điểm cải tiến:

Chỉ định một cổng khi khởi động

Lệnh start cho phép bạn chỉ định một số cổng để ghi đè cổng được chỉ định trong tệp cấu hình. Bạn cũng có thể chỉ định số cổng bằng biến môi trường PORT. Hãy xem lệnh start để biết thông tin chi tiết.

Tuỳ chọn giữ lại tiêu đề uỷ quyền

Một chế độ cài đặt cấu hình mới, keepAuthHeader, cho phép bạn giữ lại tiêu đề Uỷ quyền được gửi trong yêu cầu. Nếu bạn đặt thành true, tiêu đề Uỷ quyền sẽ được truyền đến đích. Xem các thuộc tính oauth.

Có thể sử dụng dịch vụ uỷ quyền tuỳ chỉnh

Nếu bạn muốn sử dụng dịch vụ tuỳ chỉnh của riêng mình để xử lý việc xác thực, hãy thay đổi giá trị authUri trong tệp cấu hình Edge Microgateway để trỏ đến dịch vụ của bạn. Để biết thông tin chi tiết, hãy xem phần Sử dụng dịch vụ uỷ quyền tuỳ chỉnh.

Phiên bản 2.0.4

Edge Microgateway phiên bản 2.0.4 được phát hành vào ngày 25 tháng 5 năm 2016.

Các tính năng mới và điểm cải tiến trong phiên bản 2.0.4

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.

Hỗ trợ đường dẫn tài nguyên trong các sản phẩm

Edge Microgateway hiện hỗ trợ đường dẫn tài nguyên trong các sản phẩm. Đường dẫn tài nguyên cho phép bạn hạn chế quyền truy cập vào các API dựa trên hậu tố đường dẫn của proxy. Để biết thông tin chi tiết về cách tạo sản phẩm và định cấu hình đường dẫn tài nguyên, hãy xem phần Tạo sản phẩm API.

Hỗ trợ cài đặt npm trên toàn cầu

Giờ đây, bạn có thể cài đặt Edge Microgateway bằng cách sử dụng tuỳ chọn npm -g (toàn cầu). Để biết thông tin chi tiết về lựa chọn này, hãy tham khảo tài liệu npm.

Phiên bản 2.0.0

Edge Microgateway phiên bản 2.0.0 được phát hành vào ngày 18 tháng 4 năm 2016.

Các tính năng mới và điểm cải tiến trong phiên bản 2.0.0

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.

Máy chủ một quy trình

Edge Microgateway hiện là một máy chủ xử lý đơn lẻ. Nó không còn sử dụng mô hình hai quy trình nữa, trong đó một quy trình (trước đây gọi là "tác nhân") khởi chạy Edge Microgateway, quy trình thứ hai. Cấu trúc mới giúp việc tự động hoá và tạo vùng chứa trở nên dễ dàng hơn.

Tệp cấu hình có không gian tên

Các tệp cấu hình hiện được đặt tên theo không gian tên bằng cách sử dụng tổ chức và môi trường để nhiều phiên bản Microgateway có thể chạy trên cùng một máy chủ lưu trữ. Bạn có thể tìm thấy các tệp cấu hình trong ~/.edgemicro sau khi chạy lệnh cấu hình Edge Microgateway.

Biến môi trường mới

Hiện có 4 biến môi trường: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Nếu thiết lập các biến này trên hệ thống, bạn không cần chỉ định giá trị của chúng khi sử dụng Giao diện dòng lệnh (CLI) để định cấu hình và khởi động Edge Microgateway.

Cấu hình được lưu vào bộ nhớ đệm

Edge Microgateway sử dụng tệp cấu hình được lưu vào bộ nhớ đệm nếu khởi động lại mà không có kết nối với Apigee Edge.

Chế độ nhóm

Hiện có các lựa chọn để khởi động Edge Microgateway ở chế độ cụm. Chế độ cụm cho phép bạn tận dụng các hệ thống đa lõi. Microgateway sử dụng mô-đun cụm Node.js cho tính năng này. Để biết thông tin chi tiết, hãy xem tài liệu về Node.js.

Các lỗi đã được khắc phục trong phiên bản 2.0.0

Vòng đời sự kiện của trình bổ trợ hiện xử lý đúng mã không đồng bộ có chứa mã bằng một lệnh gọi lại mới.

Phiên bản 1.1.2

Edge Microgateway phiên bản 1.1.2 được phát hành vào ngày 14 tháng 3 năm 2016.

Các tính năng mới và điểm cải tiến trong phiên bản 1.1.2

Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.

Cải thiện hiệu suất

Edge Microgateway hiện sử dụng tác nhân HTTP Node.js đúng cách để nhóm kết nối hiệu quả hơn. Việc cải tiến này giúp cải thiện hiệu suất và độ ổn định tổng thể khi tải cao.

Hỗ trợ trình gỡ lỗi từ xa

Bạn có thể định cấu hình Edge Microgateway để chạy với một trình gỡ lỗi từ xa, chẳng hạn như node-inspector.

Vị trí tệp cấu hình mới

Khi bạn định cấu hình Edge Microgateway, tệp agent/config/default.yaml hiện được sao chép vào ~./edgemicro/config.yaml.

Xoay tệp nhật ký

Một thuộc tính cấu hình mới cho phép bạn chỉ định khoảng thời gian xoay vòng cho nhật ký Edge Microgateway.

Đã sửa lỗi phiên bản 1.1.2

Các lỗi sau đây đã được khắc phục trong phiên bản 1.1.2.