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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Phiên bản 3.3.x

Các bản sửa lỗi và tính năng nâng cao v.3.3.x

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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.3.5 3.3.5 3.3.5 3.3.5 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
383024578 Tính năng

Chúng tôi đã thêm tính năng hỗ trợ cho Node.js phiên bản 22 và xoá tính năng hỗ trợ cho phiên bản 16. Nếu bạn đang sử dụng Node.js phiên bản 18, thì Edge Microgateway sẽ in thông báo lỗi sau khi khởi động:

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

Nếu đang chạy phiên bản Node.js cũ, bạn sẽ thấy thông báo lỗi này:

You are using a version of NodeJS that is not supported

Khắc phục các vấn đề về 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

Các bản sửa lỗi và tính năng nâng cao v.3.3.x

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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.3.4 3.3.4 3.3.4 3.3.4 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
675987751 Lỗi

Khắc phục vấn đề Edge Microgateway không ghi lại địa chỉ IP của máy khách.

Khắc phục các vấn đề về 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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.3.3 3.3.3 3.3.3 3.3.3 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
315939218 Đã xoá

Trình bổ trợ ứng dụng Eureka đã bị xoá khỏi Edge Microgateway. Việc xoá tính năng này không ảnh hưởng đến chức năng cốt lõi của Cổng vi mô Edge hoặc việc viết lại URL đích. Để biết thêm chi tiết, hãy xem phần Viết lại URL đích trong trình bổ trợ.

283947053 Đã xoá

Xoá tính năng hỗ trợ forever-monitor khỏi Edge Microgateway. Bạn có thể thay thế forever-monitor bằng PM2. Để biết thông tin chi tiết, hãy xem bài đăng này trên Cộng đồng Apigee: Edgemicro + PM2: Khởi động edgemicro dưới dạng dịch vụ.

Khắc phục các vấn đề về 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 Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.3.2 3.3.2 3.3.2 3.3.2 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
296187679 Tính năng

Các phiên bản Node.js được hỗ trợ bao gồm: 16, 18 và 20. Kể từ phiên bản 3.3.2, các lệnh CLI của Edge Microgateway sẽ chỉ hoạt động trên các phiên bản được hỗ trợ. Việc thực thi các lệnh CLI trên các phiên bản không được hỗ trợ sẽ dẫn đến lỗi. Xem thêm phần Phần mềm và phiên bản được hỗ trợ của Apigee.

283947053 Lỗi

Khắc phục vấn đề Edge Microgateway trả về sản phẩm API đầu tiên trong danh sách sản phẩm API liên kết với một ứng dụng. Giờ đây, chúng tôi xác định sản phẩm API chính xác để trả về dựa trên yêu cầu.

274443329 Lỗi

Khắc phục vấn đề Docker đang kéo phiên bản hình ảnh đã lỗi thời. Phiên bản nút Docker đã được cập nhật lên Node.js phiên bản 18. Bây giờ, chúng ta sẽ tạo hình ảnh Docker bằng phiên bản 18.17-buster-slim.

Khắc phục các vấn đề về 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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.3.1 3.3.1 3.3.1 3.3.1 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
220885293 Tính năng

Node.js phiên bản 16 hiện đã được hỗ trợ.

231972608 Lỗi

Khắc phục vấn đề khi lệnh private configure gửi lỗi trong khi cố gắng định cấu hình cho đám mây riêng.

233315475 Lỗi

Khắc phục vấn đề trình bổ trợ json2xml gửi lỗi phân tích cú pháp trong khi chuyển đổi phản hồi từ JSON sang XML và khi được sử dụng kết hợp với trình bổ trợ accumulate-response.

221432797 Chuyển

Phiên bản Docker Node.js của hình ảnh Edge Microgateway cơ sở đã được nâng cấp lên Node.js 14.

215748732 Tính năng

Thêm tính năng hỗ trợ xác thực mã thông báo SAML vào lệnh revokekeys.

Giờ đây, bạn có thể truyền mã thông báo SAML thay vì thông tin đăng nhập tên người dùng và mật khẩu bằng cách sử dụng tuỳ chọn -t trên lệnh revokekeys.

Để biết thông tin chi tiết, hãy xem Tài liệu tham khảo về dòng lệnh.

218723889 Cập nhật tài liệu

Tài liệu đã được cập nhật để thêm đường liên kết đến các trình bổ trợ Edge Microgateway được hỗ trợ được lưu trữ trên GitHub. Xem Các trình bổ trợ hiện có đi kèm với Edge Microgateway.

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

ID vấn đề Mô tả
CVE-2021-23413 Điều này ảnh hưởng đến gói jszip trước phiên bản 3.7.0. Việc tạo một tệp zip mới với tên tệp được đặt thành giá trị nguyên mẫu của đối tượng (ví dụ: proto, toString, v.v.) sẽ dẫn đến một đối tượng được trả về với một thực thể nguyên mẫu đã sửa đổi.

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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.3.0 3.3.0 3.3.0 3.3.0 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
219556824 Vấn đề đã biết Edge Microgateway Gateway 3.3.0 không tương thích với lệnh npm audit fix (sửa lỗi kiểm tra npm).

Việc chạy npm audit fix sẽ khiến apigeetool được nâng cấp lên 0.15.2, điều này sẽ ảnh hưởng đến lệnh edgemicro upgradeauth.

Nếu thực thi npm audit fix và sau đó thực thi edgemicro upgradeauth, bạn sẽ thấy lỗi này:

Error: This method has been removed in JSZip 3.0, please check the upgrade guide.

Để khắc phục vấn đề, hãy thực thi lệnh sau để khôi phục phiên bản chính xác của apigeetool:

npm install apigeetool@0.15.1

Vấn đề này sẽ được giải quyết trong bản phát hành Edge Microgateway trong tương lai.

138622990 Tính năng

Cờ mới cho trình bổ trợ Hạn mức, isHTTPStatusTooManyRequestEnabled, định cấu hình trình bổ trợ để trả về trạng thái phản hồi HTTP 429 thay vì trạng thái 403 nếu có lỗi vi phạm hạn mức. Xem Các tuỳ chọn cấu hình cho hạn mức.

192534424 Lỗi

Khắc phục vấn đề mã phản hồi trong số liệu phân tích Apigee không khớp với mã phản hồi của Edge Microgateway.

198986036 Các tính năng nâng cao Edge Microgateway hiện tìm nạp khoá công khai của nhà cung cấp danh tính (IDP) tại mỗi khoảng thời gian thăm dò ý kiến và cũng cập nhật khoá trong trường hợp khoá công khai của IDP thay đổi. Trước đây, trình bổ trợ extauth không thể cập nhật khoá công khai mà không cần tải lại Edge Microgateway nếu khoá công khai của một IDP thay đổi.
168713541 Lỗi

Tài liệu được cải tiến để giải thích cách định cấu hình TLS/SSL cho nhiều mục tiêu. Xem phần Sử dụng các tuỳ chọn SSL/TLS của ứng dụng.

171538483 Lỗi

Tài liệu đã được thay đổi để sửa đổi quy ước đặt tên tệp nhật ký. Xem Quy ước đặt tên tệp nhật ký.

157908466 Lỗi

Tài liệu đã được thay đổi để giải thích chính xác cách cài đặt một phiên bản cụ thể của Edge Microgateway. Xem phần Nâng cấp Cổng vi mô Edge nếu bạn có kết nối Internet.

215748427 Lỗi Khắc phục vấn đề lệnh revokekeys trả về lỗi khi thu hồi khoá bằng cách sử dụng một cặp khoá và khoá bí mật hiện có.
205524197 Lỗi Tài liệu đã được cập nhật để bao gồm danh sách đầy đủ các cấp độ ghi nhật ký. Xem các thuộc tính edgemicroCách đặt cấp độ ghi nhật ký.

Phiên bản 3.2.x

Các bản sửa lỗi và tính năng nâng cao v.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 Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.2.3 3.2.3 3.2.3 3.2.3 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
192416584 Tính năng

Thuộc tính cấu hình disableStrictLogFile cho phép bạn nới lỏng các quyền tệp nghiêm ngặt trên tệp nhật ký ứng dụng api-log.log. Để biết thông tin chi tiết, hãy xem phần Cách nới lỏng quyền đối với tệp nhật ký.

192799989 Tính năng

Thuộc tính cấu hình on_target_response_abort cho phép bạn kiểm soát cách Edge Microgateway hoạt động nếu kết nối giữa ứng dụng (Edge Microgateway) và máy chủ mục tiêu đóng sớm. Để biết thông tin chi tiết, hãy xem thuộc tính edgemicro.

148062415 Lỗi Khắc phục vấn đề trong ngữ cảnh vùng chứa Docker, Edge Microgateway không tắt một cách linh hoạt bằng lệnh docker stop {containerId}. Quy trình này đã bị huỷ, nhưng các tệp .sock.pid không bị xoá. Bây giờ, các tệp đã bị xoá và việc khởi động lại cùng một vùng chứa sẽ hoạt động như dự kiến.
190715670 Lỗi Khắc phục vấn đề một số yêu cầu bị treo trong hoạt động tải lại nội bộ của cổng vi mô. Vấn đề này xảy ra không liên tục và trong các tình huống có lưu lượng truy cập cao. Vấn đề này xảy ra khi sử dụng các tính năng tokenCachecacheKey của trình bổ trợ OAuth.
183910111 Lỗi Khắc phục vấn đề URL đường dẫn tài nguyên có dấu gạch chéo ở cuối bị diễn giải không chính xác là một đường dẫn tài nguyên riêng biệt. Ví dụ: giờ đây, các đường dẫn /country/all/country/all/ được hiểu là cùng một đường dẫn.

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

ID vấn đề Mô tả
CVE-2020-28503 Gói copy-props trước phiên bản 2.0.5 dễ bị ô nhiễm nguyên mẫu thông qua chức năng chính.
CVE-2021-23343 Tất cả phiên bản phân tích cú pháp đường dẫn gói đều dễ bị tấn công từ chối dịch vụ bằng biểu thức chính quy (ReDoS) thông qua các biểu thức chính quy splitDeviceRe, splitTailRe và splitPathRe. ReDoS thể hiện độ phức tạp về thời gian trong trường hợp xấu nhất là đa thức.

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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.2.2 3.2.2 3.2.2 3.2.2 3.2.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
185323500 Chuyển

Giá trị expires_in đã thay đổi từ chuỗi thành số nguyên

API yêu cầu mã thông báo và yêu cầu làm mới mã thông báo hiện trả về expires_in dưới dạng giá trị số nguyên được chỉ định bằng giây.

Để tuân thủ RFC 6749 Khung uỷ quyền OAuth 2.0 giá trị dự kiến cho tham số cấu hình expires_in đã được thay đổi từ chuỗi thành số nguyên. Để biết thông tin chi tiết, hãy xem phần Tài liệu tham khảo về hoạt động và cấu hình.

188492065 Chuyển Ngừng hỗ trợ Node.js 8

Kể từ bản phát hành 3.2.2, chúng tôi sẽ không còn hỗ trợ Node.js 8 nữa. Để biết thêm thông tin, hãy xem phần Phần mềm và phiên bản được hỗ trợ: Cổng vi mô Edge.

183990345 Tính năng Định cấu hình đầu ra nhật ký cho vùng chứa Docker

Tham số cấu hình Edge Microgateway to_console cho phép bạn chọn gửi thông tin nhật ký đến đầu ra chuẩn thay vì tệp nhật ký. Nếu bạn làm theo các bước để chạy Edge Microgateway trong vùng chứa Docker, thì theo mặc định, vùng chứa sẽ chuyển hướng stdout và đầu ra lỗi đến một tệp nằm trong vùng chứa tại vị trí: ${APIGEE_ROOT}/logs/edgemicro.log.

Để ngăn thông tin nhật ký được gửi đến edgemicro.log, hãy sử dụng biến LOG_CONSOLE_OUTPUT_TO_FILE mới khi bạn chạy vùng chứa.

Để biết thông tin chi tiết về cách sử dụng biến mới này, hãy xem bài viết Sử dụng Docker cho Edge Microgateway.

183057665 Tính năng Định cấu hình đường dẫn tệp edgemicro.pidedgemicro.sock.

Tham số -w, --workdir mới để chạy vùng chứa Docker bằng Cổng vi mô Edge, cho phép bạn chỉ định đường dẫn đến thư mục nơi tạo tệp edgemicro.sockedgemicro.pid trong vùng chứa Docker. Xem phần Sử dụng Docker cho Edge Microgateway.

191352643 Tính năng Hình ảnh Docker cho Edge Microgateway đã được cập nhật để sử dụng NodeJS phiên bản 12.22. Xem phần Sử dụng Docker cho Edge Microgateway.

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

ID vấn đề Mô tả
CVE-2021-28860 Trong Node.js mixme, trước phiên bản 0.5.1, kẻ tấn công có thể thêm hoặc thay đổi các thuộc tính của một đối tượng thông qua "__proto__" thông qua các hàm mutate() và merge(). Thuộc tính bị ô nhiễm sẽ được chỉ định trực tiếp cho mọi đối tượng trong chương trình. Điều này sẽ làm ảnh hưởng đến khả năng hoạt động của chương trình, có thể gây ra tình trạng từ chối dịch vụ (DoS).
CVE-2021-30246 Trong gói jsrsasign qua phiên bản 10.1.13 cho Node.js, một số chữ ký RSA PKCS#1 v1.5 không hợp lệ bị nhầm là hợp lệ. LƯU Ý: chưa có cuộc tấn công thực tế nào được biết đến.
CVE-2021-23358 Gói dấu gạch dưới từ phiên bản 1.13.0-0 trở về trước 1.13.0-2, từ phiên bản 1.3.2 trở về trước 1.12.1 dễ bị chèn mã tuỳ ý thông qua hàm mẫu, đặc biệt là khi một thuộc tính biến được truyền dưới dạng đối số vì không được dọn dẹp.
CVE-2021-29469 Node-redis là một ứng dụng Redis Node.js. Trước phiên bản 3.1.1, khi ứng dụng ở chế độ giám sát, biểu thức chính quy bắt đầu được dùng để phát hiện thông báo giám sát có thể gây ra hiệu ứng hồi quy luỹ thừa trên một số chuỗi. Vấn đề này có thể dẫn đến việc từ chối cung cấp dịch vụ. Vấn đề này đã được khắc phục trong phiên bản 3.1.1.
CVE-2020-8174 Hình ảnh Docker đã được cập nhật để sử dụng Node.js phiên bản 12.22

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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.2.1 3.2.1 3.2.1 3.2.1 3.2.1

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
180362102 Lỗi Khắc phục vấn đề trong đó các khoá JWK có giá trị rỗng khiến ứng dụng không hoạt động.

Điều kiện rỗng hiện được xử lý để tránh truyền giá trị rỗng trong jwkPublicKeys.

Lưu ý: Bản sửa lỗi này yêu cầu bạn nâng cấp proxy edgemicro-auth.

179971737 Lỗi Khắc phục vấn đề phản hồi trạng thái 4XX / 5XX mục tiêu được ghi lại dưới dạng lỗi proxy cho proxy edgemicro_*.

Đối với các giao dịch Edge Microgateway, số lượng lỗi mục tiêu không chính xác đã xuất hiện trong trang tổng quan phân tích mã lỗi Apigee Edge. Mã lỗi cho lỗi mục tiêu đang được tính là lỗi proxy. Vấn đề này đã được khắc phục và số lỗi mục tiêu chính xác hiện đã hiển thị.

179674670 Tính năng Chúng tôi đã thêm một tính năng mới cho phép bạn lọc danh sách sản phẩm API được đặt trong JWT dựa trên mã trạng thái sản phẩm.

Sản phẩm API có 3 mã trạng thái là Đang chờ xử lý, Đã phê duyệt và Đã thu hồi. Một thuộc tính mới có tên là allowProductStatus đã được thêm vào chính sách Đặt biến JWT trong proxy edgemicro-auth. Cách sử dụng thuộc tính này để lọc các sản phẩm API được liệt kê trong JWT:

  1. Mở proxy edgemicro-auth trong trình chỉnh sửa proxy Apigee.
  2. Thêm thuộc tính allowProductStatus vào tệp XML của chính sách SetJWTVariables và chỉ định danh sách mã trạng thái được phân tách bằng dấu phẩy để lọc. Ví dụ: để lọc theo trạng thái Đang chờ xử lýĐã thu hồi:
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Javascript timeLimit="20000" async="false" continueOnError="false"
        enabled="true" name="Set-JWT-Variables">
        <DisplayName>Set JWT Variables</DisplayName>
        <FaultRules/>
        <Properties>
            <Property name="allowProductStatus">Pending,Revoked</Property>
        </Properties>
        <ResourceURL>jsc://set-jwt-variables.js</ResourceURL>
    </Javascript>
    
    

    Nếu bạn chỉ muốn đăng các sản phẩm Được phê duyệt, hãy đặt thuộc tính như sau:

    <Property name="allowProductStatus">Approved</Property>
  3. Lưu proxy.

    Nếu không có thẻ Property, thì các sản phẩm có tất cả mã trạng thái sẽ được liệt kê trong JWT.

    Để sử dụng tài sản mới này, bạn phải nâng cấp proxy edgemicro-auth.

178423436 Lỗi Các giá trị khoá và giá trị bí mật được truyền trong CLI hoặc thông qua các biến môi trường sẽ hiển thị trong đối số dòng lệnh của trình khám phá quy trình.

Một vấn đề đã được báo cáo, trong đó khoá Edge Microgateway và các giá trị bí mật được truyền từ đối số dòng lệnh hoặc được đặt thông qua các biến môi trường được hiển thị trong đối số của trình chạy nút/quy trình con sau khi khởi động cổng vi mô.

Để khắc phục vấn đề này cho trường hợp biến môi trường, các giá trị sẽ không còn hiển thị trong đối số dòng lệnh của trình khám phá quy trình.

Nếu khoá và giá trị bí mật được truyền trong dòng lệnh trong khi khởi động cổng vi mô, thì các chế độ cài đặt sẽ thay thế mọi giá trị biến môi trường, nếu được đặt. Trong trường hợp này, các giá trị vẫn xuất hiện trong đối số dòng lệnh của trình khám phá quy trình.

178341593 Lỗi Sửa lỗi tài liệu cho trình bổ trợ apikeys.

Tệp README cho trình bổ trợ apikeys đã đưa thuộc tính gracePeriod vào không chính xác. Chúng tôi đã xoá thuộc tính này và nội dung mô tả thuộc tính đó khỏi tệp README.

Thuộc tính gracePeriod được triển khai trong trình bổ trợ oauth. Để sử dụng tính năng thời gian gia hạn, bạn phải sử dụng trình bổ trợ oauth.

179366445 Lỗi Đã giải quyết vấn đề về tải trọng bị loại bỏ cho tất cả các yêu cầu GET đến mục tiêu.

Bạn có thể kiểm soát hành vi mong muốn bằng một tham số cấu hình mới, edgemicro: enable_GET_req_body. Khi được đặt thành true, tiêu đề yêu cầu transfer-encoding: chunked sẽ được thêm vào tất cả các yêu cầu GET và tải trọng GET (nếu có) sẽ được gửi đến mục tiêu. Nếu là false (mặc định), tải trọng sẽ được xoá một cách thầm lặng trước khi yêu cầu được gửi đến mục tiêu.

Ví dụ:

edgemicro:
 enable_GET_req_body: true

Theo RFC 7231, mục 4.3.1: GET, tải trọng yêu cầu GET không có ngữ nghĩa được xác định, vì vậy, tải trọng này có thể được gửi đến mục tiêu.

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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.2.0 3.2.0 3.2.0 3.2.0 3.2.0

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
152640618 Lỗi Bật trình bổ trợ extauth để đặt tiêu đề x-api-key chứa client_id trên đối tượng yêu cầu khi mã thông báo hợp lệ. Sau đó, x-api-key sẽ có sẵn cho các trình bổ trợ tiếp theo.
168836123, 172295489, 176462355, 176462872 Tính năng Thêm tính năng hỗ trợ cho Node.js 14.
172376835 Lỗi Sử dụng đơn vị thời gian chính xác cho điểm cuối /token trong proxy edgemicro-auth.

Khắc phục vấn đề điểm cuối /token trong proxy edgemicro-auth trả về expires_in tính bằng mili giây; tuy nhiên, theo Thông số kỹ thuật OAuth, điểm cuối này phải nhất quán với đơn vị thời gian cho refresh_token_expires_in, tức là giây.

Bản sửa lỗi không thay đổi thời lượng hết hạn mà chỉ thay đổi đơn vị thời gian. Phương thức này chỉ áp dụng cho trường expires_in trong tải trọng phản hồi mã thông báo truy cập. Mã thông báo JWT trong cùng một tải trọng phản hồi sẽ chứa hai trường, iatexp, và các trường này được tạo chính xác và luôn được tạo bằng đơn vị thời gian seconds.

Nếu ứng dụng đã dựa vào giá trị expires_in, tính bằng mili giây, để làm mới mã thông báo trước khi mã thông báo hết hạn, thì việc áp dụng bản sửa lỗi này mà không sửa đổi ứng dụng sẽ khiến việc làm mới diễn ra thường xuyên và không cần thiết hơn nhiều. Bạn cần sửa đổi các ứng dụng này để tính đến sự thay đổi về đơn vị thời gian nhằm duy trì hành vi ban đầu.

Nếu ứng dụng luôn sử dụng các giá trị trong mã thông báo JWT để đánh giá khoảng thời gian làm mới mã thông báo, thì ứng dụng sẽ không cần thay đổi.

173064680 Lỗi Khắc phục vấn đề trong đó cổng vi mô đã kết thúc yêu cầu mục tiêu trước khi tất cả các đoạn dữ liệu được xử lý.

Đây là vấn đề gián đoạn được quan sát thấy trên các yêu cầu có kích thước tải trọng cao và vấn đề này đã xuất hiện trong bản phát hành 3.1.7.

174640712 Lỗi Thêm tính năng xử lý dữ liệu thích hợp vào trình bổ trợ.

Thêm tính năng xử lý dữ liệu thích hợp vào các trình bổ trợ sau: json2xml, accumulate-request, accumulate-responseheader-uppercase. Để biết thông tin chi tiết về trình bổ trợ, hãy xem microgateway-plugins.

Phiên bản 3.1.x

Các bản sửa lỗi và điểm cải tiến v.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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.8 3.1.9 3.1.7 3.1.3 3.1.2

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
169201295 Lỗi Các giá trị số và boolean đã được phân tích cú pháp không chính xác trong thẻ biến môi trường.

Việc xử lý thay thế biến môi trường đã phân tích cú pháp tất cả các giá trị dưới dạng chuỗi, dẫn đến lỗi phân tích cú pháp cho các giá trị boolean hoặc số. Ví dụ: edgemicro.port dự kiến và yêu cầu một giá trị số. Các bản sửa lỗi đã được thực hiện để hỗ trợ giá trị boolean và số. Hãy xem phần Đặt thuộc tính cấu hình bằng giá trị biến môi trường để biết thông tin chi tiết về cấu hình.

169202749 Lỗi Tính năng thay thế biến môi trường không hoạt động trong một số trường hợp.

Tính năng xử lý thay thế biến môi trường không hoạt động đối với một số thuộc tính cấu hình. Hãy xem phần Đặt thuộc tính cấu hình bằng giá trị biến môi trường để biết thông tin về các giới hạn.

168732942 Lỗi Khắc phục vấn đề phạm vi OAuth không hạn chế quyền truy cập proxy API như dự kiến.

Luồng /token trong proxy edgemicro-auth đã tạo JWT mà không có phạm vi sản phẩm chính xác được xác định trên Edge do hai trường hợp khác nhau: 1) tải trọng yêu cầu đến luồng /token không truyền tham số phạm vi hoặc 2) phạm vi không hợp lệ đã được truyền trong tải trọng yêu cầu đến luồng /token. Đã khắc phục lỗi để trả về tất cả các phạm vi được xác định trong các sản phẩm API trên Apigee Edge.

170609716 Lỗi Khắc phục vấn đề trong đó luồng /refresh trong proxy edgemicro-auth tạo ra một JWT không có apiProductList.

170708611 Lỗi Trình bổ trợ tuỳ chỉnh không dùng được phạm vi sản phẩm API.

Phạm vi sản phẩm API không được cung cấp cho các trình bổ trợ tuỳ chỉnh cũng như không được ghi vào tệp cấu hình bộ nhớ đệm. Hãy xem phần Giới thiệu về hàm init() của trình bổ trợ để biết cách cung cấp thông tin chi tiết về phạm vi cho trình bổ trợ.

169810710 Tính năng Khoá và bí mật được lưu trong tệp cấu hình bộ nhớ đệm.

Khoá và khoá bí mật của Edge Microgateway đang được lưu trong tệp yaml cấu hình bộ nhớ đệm trên mỗi lần tải lại/khởi động. Trong phiên bản 3.1.8, khoá và khoá bí mật không còn được lưu trong tệp cấu hình bộ nhớ đệm nữa. Nếu trước đó bạn đã ghi khoá và khoá bí mật vào tệp cấu hình bộ nhớ đệm, thì các khoá và khoá bí mật đó sẽ bị xoá.

170708621 Tính năng Không thể tắt trình bổ trợ phân tích.

Trong các phiên bản cổng vi mô trước, trình bổ trợ phân tích được bật theo mặc định và không có cách nào để tắt trình bổ trợ này. Trong phiên bản 3.1.8, chúng tôi đã giới thiệu một tham số cấu hình mới, enableAnalytics, để bật hoặc tắt trình bổ trợ phân tích. Hãy xem Tài liệu tham khảo về cấu hình để biết thông tin chi tiết.

159571119 Lỗi Gặp lỗi rỗng trong trình nối onerror_request trong các trình bổ trợ tuỳ chỉnh cho thời gian chờ phản hồi/ổ cắm.

Chúng tôi đã khắc phục để điền chính xác mã trạng thái HTTP và thông báo lỗi cho các sự kiện onerror_request cũng như điền chính xác thông báo lỗi cho các sự kiện onerror_response.

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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.7 3.1.8 3.1.6 3.1.2 3.1.1

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
131708105 Lỗi Trình bổ trợ analytics xử lý không đúng phản hồi rỗng từ các lệnh gọi axpublisher và khiến worker thoát.

133162200 Lỗi Thông tin ứng dụng của nhà phát triển không được điền vào số liệu phân tích bằng các phản hồi trạng thái 403 do đường dẫn tài nguyên sản phẩm trái phép hoặc phản hồi 401 do mã thông báo đã hết hạn hoặc không hợp lệ.

132194290 Lỗi Bản ghi Analytics bị loại bỏ khi Apigee Edge từ chối một số bản ghi phân tích.

158618994 Lỗi Quá nhiều kết nối ứng dụng Redis.

161404373 Lỗi Trong trường hợp phản hồi trạng thái 404, URI proxy đầy đủ đã được đưa vào thông báo phản hồi.
166356972 Lỗi

Việc chạy Edge Microgateway với Node.js phiên bản 12.13.x trở lên dẫn đến lỗi sau khi thực thi các trình bổ trợ chuyển đổi tải trọng yêu cầu:

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

168681746 Lỗi Tính năng tải lại thủ công Edge Microgateway bằng redisBasedConfigCache:true không hoạt động.

149256174 Lỗi Lỗi trình bổ trợ OAuth không được ghi lại đối với các lỗi mạng.

166517190 Lỗi Dữ liệu jwk_public_keys không được lưu trữ và tìm nạp bằng Trình đồng bộ hoá và lưu trữ trong Redis.

141659881 Lỗi Việc xử lý lỗi chứng chỉ mục tiêu không hợp lệ cho thấy các phản hồi lỗi gây hiểu lầm.

142808699 Lỗi Trình bổ trợ accesscontrol không xử lý đúng cách các phần "allow" và "deny".

Cổng vi mô hiện xử lý phần từ chối đúng cách và tuân theo thứ tự của các phần "cho phép" và "từ chối". Thêm một thuộc tính noRuleMatchAction mới vào tệp cấu hình của cổng vi mô để cung cấp tính năng tương đương với chính sách AccessControl của Apigee Edge. Xem thêm README về Trình bổ trợ kiểm soát quyền truy cập trên GitHub.

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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.6 3.1.7 3.1.5 3.1.1 3.1.1

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
163711992 Tính năng Các tuỳ chọn vị trí tệp khoá và chứng chỉ tuỳ chỉnh cho lệnh rotatekey.

Để biết thông tin chi tiết về các tuỳ chọn lệnh mới này, hãy xem phần Xoay khoá.

154838259 Lỗi Khắc phục việc xoay vòng khoá cho nhiều phiên bản trong nhiều trung tâm dữ liệu

Để biết thông tin chi tiết về các tuỳ chọn lệnh mới này, hãy xem phần Xoay khoá.

145525133 Tính năng ở giai đoạn alpha Các chỉ số mới về trình bổ trợ

Hãy xem phần Các chỉ số trình bổ trợ mới trên GitHub để biết thông tin chi tiết.

159396879 Lỗi Xoá Trợ lý gói không dùng đến
161092943 Lỗi Xác thực đường dẫn cơ sở không chính xác

Trước phiên bản 3.1.6, đường dẫn cơ sở của proxy được so khớp không chính xác khi đường dẫn cơ sở không kết thúc bằng /.

Phần sau đây giải thích thêm về hành vi trước đó (đã được khắc phục trong phiên bản 3.1.6):

Giả sử một proxy được định cấu hình bằng đường dẫn cơ sở: /hello/v1 và đường dẫn đích đến https://mocktarget.apigee.net. Bây giờ, giả sử proxy nhận được các yêu cầu sau:

Đường dẫn yêu cầu Đường dẫn đã phân giải Kết quả
/hello/v1/json https://mocktarget.apigee.net/json Đường dẫn đã phân giải là chính xác vì đường dẫn cơ sở của /hello/v1 được so khớp chính xác.
Đường dẫn yêu cầu Đường dẫn đã phân giải Kết quả
/hello/v1json https://mocktarget.apigee.netjson Đường dẫn đã phân giải không chính xác vì /hello/v1 là một chuỗi con của /hello/v1json. Vì /hello/v1json không phải là đường dẫn hợp lệ, nên Edge Microgateway sẽ gửi lỗi 404. Trong phiên bản 3.1.6 trở lên, lỗi 404 sẽ được gửi trong trường hợp này.
160431789 Lỗi Trình bổ trợ tuỳ chỉnh – đối tượng cấu hình được truyền đến init không được điền sẵn

Cấu hình Apigee Edge được cung cấp trong đối tượng cấu hình cho tất cả các trình bổ trợ tuỳ chỉnh sau khi hợp nhất với tệp cấu hình Edge Microgateway. Xem cấu hình.

162758808 Lỗi Cấu hình hạn mức mới cho kho lưu trữ sao lưu Redis

Bạn có thể sử dụng cấu hình sau để chỉ định bộ nhớ đệm Redis cho hạn mức. Để biết thông tin chi tiết, hãy xem phần Sử dụng bộ nhớ đệm Redis cho hạn mức.

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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần đượ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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.5 3.1.6 3.1.4 3.1.0 3.1.0

Các bản sửa lỗi và điểm cải tiến:

ID vấn đề Loại Mô tả
159210507 Tính năng Cấu hình để loại trừ quá trình xử lý trình bổ trợ

Thêm một tính năng cấu hình mới để bỏ qua việc xử lý các trình bổ trợ cho các URL đã chỉ định. Để biết thông tin chi tiết, hãy xem phần Định cấu hình URL loại trừ cho trình bổ trợ.

156986819, 158529319 Lỗi Khắc phục các vấn đề về trình bổ trợ json2xml

Khắc phục các vấn đề trong đó trình bổ trợ tạo ra tiêu đề Content-Type trùng lặp và trong đó tiêu đề không được gửi đến mục tiêu như dự kiến trong một số trường hợp.

156560067, 159688634 Tính năng

Sử dụng giá trị biến môi trường trong cấu hình

Thêm một tính năng cho phép bạn chỉ định biến môi trường bằng cách sử dụng thẻ trong tệp cấu hình. Các thẻ biến môi trường được chỉ định sẽ được thay thế bằng giá trị biến môi trường thực tế. Các nội dung thay thế chỉ được lưu trữ trong bộ nhớ và không được lưu trữ trong cấu hình hoặc tệp bộ nhớ đệm gốc. Để biết thông tin chi tiết, hãy xem phần Thiết lập thuộc tính cấu hình bằng giá trị biến môi trường.

155077210 Lỗi Khắc phục vấn đề về định dạng nhật ký.

Khắc phục vấn đề máy chủ mục tiêu xuất hiện trong nhật ký với dấu hai chấm thừa được thêm vào.

153673257 Lỗi

(Chỉ dành cho Edge for Private Cloud) Các sản phẩm nhận biết được Microgateway không được lấy

Khắc phục vấn đề không kéo được các sản phẩm nhận biết được cổng vi mô. Vấn đề này chỉ xảy ra trên Edge đối với các lượt cài đặt trên đám mây riêng.

154956890, 155008028, 155829434 Tính năng Hỗ trợ lọc sản phẩm đã tải xuống theo thuộc tính tuỳ chỉnh

Để biết thông tin chi tiết, hãy xem bài viết Lọc sản phẩm theo thuộc tính tuỳ chỉnh

153949764 Lỗi Khắc phục vấn đề trong đó quy trình Edge Microgateway gặp sự cố khi tệp đích nhật ký đã đầy

Cải thiện khả năng xử lý ngoại lệ để phát hiện lỗi và in thông báo vào bảng điều khiển.

155499600 Lỗi Khắc phục các vấn đề về tính năng xoay khoá và nâng cấp KVM

Xem thêm phần Xoay khoá JWT.

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 Cổng vi mô Edge.

Sửa lỗi:

Khắc phục 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. Ngoài ra, 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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.3 3.1.3 3.1.3 3.0.14 3.0.9

Các bản sửa lỗi và điểm cải tiến:

  • 153509313 – Khắc phục vấn đề mô-đun gỡ lỗi Node.js dẫn đến rò rỉ bộ nhớ. Sự cố này xảy ra trong phiên bản v3.1.0, v3.1.1 và 3.1.2.
  • 153509313 – Khắc phục vấn đề cùng một mã thông báo cho hai giao dịch khác nhau được in trong kết quả ghi nhật ký.
  • 151673570 – Khắc phục vấn đề Edge Microgateway không được cập nhật để sử dụng các API KVM Apigee mới. Edge Microgateway hiện sử dụng các lệnh mới để thêm và cập nhật 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ý liên kết đườ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, chúng tôi đã khắc phục vấn đề trong đó mẫu /literal_string/* không được xử lý chính xác. 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 – Chúng tôi đã thực hiện các thay đổi để cho phép sử dụng giá trị nhận dạng trong phạm vi tổ chức và môi trường cho hạn mức.
  • 152005003 – Chúng tôi đã thực hiện các thay đổi để cho phép sử dụng giá trị nhận dạng trong 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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.2 3.1.2 3.1.2 3.0.13 3.0.9

Các bản sửa lỗi và điểm cải tiến:

  • 151285018 – Chúng tôi đã cải tiến tính năng để thêm tính năng 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, các vấn đề về tính năng hỗ trợ proxy HTTP hiện có giữa Edge Microgateway và Apigee Edge đã được khắc phục. Để biết thông tin chi tiết, hãy xem:
  • 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 lỗi 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 có trong tệp cấu hình.
  • 151284716 – Cải tiến để đóng 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 vùng chứa Docker lên phiên bản 12, vì Node.js v8 không còn được dùng nữa.
  • 151306049 – 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 bài viết Microgateway của Edge 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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.1 3.1.1 3.1.1 3.0.13 3.0.9

Các bản sửa lỗi và điểm cải tiến:

  • 146069701 – Khắc phục lỗi mô-đun microgateway-core không tuân thủ các biến môi trường HTTP_PROXYHTTPS_PROXY. Với thay đổi này, các chế độ cài đặt proxy trong tệp cấu hình YAML (nếu được chỉ định) hiện sẽ bị bỏ qua; chỉ các biến môi trường mới đượ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 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 được các 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 của Node.js trên các yêu cầu. (Mặc định: 5 giây nhiều hơn thời gian được đặt bằng edgemicro.keep_alive_timeout. Chế độ cài đặt mặc định này ngăn trình cân bằng tải hoặc proxy vô tình ngắt kết nối.)

  • 149278885 – 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 proxy API, 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 mục tiêu. 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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.1.0 3.1.0 3.1.0 3.0.12 3.0.9

Các bản sửa lỗi và điểm cải tiến:

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

      Với thay đổi này, trình bổ trợ Edge Microgateway hiện tuân theo quy tắc so khớp mẫu giống như Apigee Edge, như được 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 đề trong đó các dấu cách ở đầu hoặc cuối trong tham số mã ứng dụng khiến danh sách sản phẩm JWT bị trống đối với các yêu cầu mã thông báo OAuth và khoá API.
  • 145640807 và 147579179 – Thêm một tính năng mới cho phép một thực thể 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 thực thể cổng vi mô 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 tăng khả năng phục hồi cho Cổng vi mô Edge. API này cho phép các thực thể của cổng vi mô 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 trình đồ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

Các bản sửa lỗi và tính năng nâng cao v.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à điểm cải tiến sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.0.10 3.0.8 3.0.8 3.0.11 3.0.8

Các bản sửa lỗi và điểm cải tiến:

  • 142677575 – Chúng tôi đã cập nhật tính năng để hoạt động so khớp mẫu cho đường dẫn tài nguyên được sử 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 là "/", "/*" và "/**".

    Lưu ý: Nếu sử dụng mẫu tài nguyên phức 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 dành cho nhà phát triển của proxy, như minh hoạ trong ảnh chụp màn hình sau:

    alt_text

    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 Cổng vi mô Edge.

  • 143740696 – Cấu trúc cấu hình quotas đã thay đổi (xem thêm ghi chú phát hành của 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. Thay đổi về cấu trúc được thực hiện để 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 sử dụng cấu hình YAML sau. Xin lưu ý rằng thuộc tính cấu hình được gọi 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 Tuỳ 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 – Thêm một tính năng mới cho phép bạn sử dụng Redis làm bộ nhớ sao lưu hạn mức. Nếu useRedis là đúng, thì mô-đun voto-quota-redis sẽ được sử dụng. Khi đúng, hạn mức chỉ được áp dụng cho các phiên bản Edge Microgateway kết nối với Redis. Nếu giá trị là false, mô-đun volos-quota-apigee sẽ được dùng làm bộ nhớ đệm và bộ đếm hạn mức là toàn cục. Để biết thông tin chi tiết, hãy xem phần Tuỳ 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. Thông 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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.0.9 3.0.7 3.0.7 3.0.10 3.0.7

Các bản sửa lỗi và điểm cải tiến:

  • 141989374 – Thêm tính năng "fail open" (không thành công nhưng vẫn mở) 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" cho 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" (không thành công nhưng vẫn mở) của 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 thay đổi thành oauth-failed-open.

  • 142093764 – Thay đổi cấu hình cho proxy edgemicro-auth để tránh vượt quá hạn mức. Thay đổi này là để đặt loại hạn mức thành lịch. Để sử dụng điểm 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 – Thêm một tính năng mới để cho phép ghi nhật ký mã nhận dạng của trình xử lý thông báo (MP) 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 bạn đặt useDebugMpId, các phản hồi hạn mức từ Edge sẽ chứa mã nhận dạng 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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho từng dự án thành phần 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.0.8 3.0.6 3.0.6 3.0.9 3.0.6

Các bản sửa lỗi và điểm cải tiến:

  • 140025210 – Thêm tính năng "fail open" (không thành công nhưng vẫn mở). Tính năng này cho phép tiếp tục xử lý API 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 khiến lệnh gọi xác minh khoá API đến proxy edgemicro-auth không thành công.

    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 nằm trong bộ nhớ đệm và được sử dụng lại cho đến khi khoảng thời gian gia hạn hết hạn. Tính năng này cho phép Cổng vi mô Edge tiếp tục xử lý các yêu cầu trong trường hợp tạm thời không kết nối được. Khi kết nối được tiếp tục và lệnh gọi 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" (không thành công nhưng vẫn mở) mới, hãy làm như sau:

    1. Đặt các thuộc tính sau trong khổ thơ oauth trong tệp cấu hình của Cổng vi mô Edge:
      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 sử dụng trong 5 giây nếu không thể làm mới mã thông báo do sự cố kết nối. Sau 5 giây, hệ thống sẽ trả về lỗi xác thực.

  • 141168968 – Cập nhật để đưa correlation_id vào tất cả đầu ra nhật ký trình bổ trợ. Ngoài ra, các cấp độ nhật ký cho một số nhật ký đã được thay đổi thành error theo yêu cầu.
  • 140193349 – Cập nhật proxy edgemicro-auth để yêu cầu xác minh khoá và mã xác thực của Cổng vi mô Edge trên mọi yêu cầu Xác minh khoá API. Edge Microgateway đã được cập nhật để luôn gửi khoá và khoá bí mật trong mọi yêu cầu Xác minh khoá API. Thay đổi này ngăn ứng dụng lấy JWT chỉ bằng một khoá API.
  • 140090250 – 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ể liên kết đầu ra nhật ký quoto với các nhật ký còn lại của 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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

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

Bảng sau đây liệt kê số phiên bản cho 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ố bản phát hành có thể không khớp với phiên bản sản phẩm chính:

cổng vi mô core config trình bổ trợ edgeauth
3.0.7 3.0.5 3.0.5 3.0.8 3.0.5

Các bản sửa lỗi và điểm cải tiến:

  • 140075602 – 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 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, chúng tôi đã thêm một thuộc tính cấu hình mới là 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, đ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 Cập nhật proxy edgemicro-auth.

  • 140470888 – Thêm tiêu đề Uỷ quyền vào các lệnh gọi hạn mức để xác thực. Ngoài ra, chúng tôi đã sửa đổi proxy edgemicro-auth để xoá "organization" (tổ chức) khỏi giá trị 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 bạn không cần mã 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 thuộc tính chính xác là:

    edgemicro:
        keep_alive_timeout
  • 139526406 – Khắc phục lỗi số lượng hạn mức không chính xác xảy ra nếu ứng dụng của nhà phát triển có nhiều sản phẩm. Giờ đây, 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 giá trị 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à điểm cải tiến sau đây cho Cổng vi mô Edge.

  • 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, đ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 bài viết Cập nhật 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 bạn đặt stack_trace 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à điểm cải tiến sau đây cho Cổng vi mô Edge.

Sửa lỗi
  • 139005279 – Khắc phục vấn đề lệnh edgemicro status không trả về số lượng quy trình worker chính xác.
  • 138437710 – Khắc phục vấn đề trong lớp ExitCounter khiến không ghi được nhật ký thích hợp.
Các điểm cải tiến chung về thông điệp nhật ký
  • 139064652 – Thêm khả năng thêm các cấp độ ghi nhật ký tracedebug cho 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, warnerror.
  • 139064616 – Đầu ra nhật ký đã được chuẩn hoá cho tất 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 các 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
Cải tiến thông báo nhật ký khoá và khoá bí mật JWT
  • 138413755 – Cải thiện khoá JWT và thông điệp nhật ký liên quan đến khoá bí mật cho các lệnh CLI sau: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey và configure.
Cải tiến thông báo lỗi về thời gian chờ và kết nối bị từ chối
  • 138413577 – Thêm và cải thiện khả năng xử lý lỗi khi hết thời gian chờ 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" (từ chối kết nố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à điểm cải tiến sau đây cho Cổng vi mô Edge.

  • 134445926 – Cải tiến tính năng xác thực Microgateway Edge 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 này khiến trình bổ trợ tải lại và sử dụng quá nhiều bộ nhớ. Edge Microgateway hiện giữ số lượng quy trình trong giới hạn dự kiến.
  • 137768774 – Cải tiến thông báo nhật ký:
    • Xoá nhật ký giao dịch (yêu cầu).
    • Thêm thông điệp nhật ký khác nếu cần.
    • Di chuyển thông báo nhật ký giao dịch (yêu cầu) từ đầu ra bảng điều khiển sang tệp nhật ký liên quan.
    • Cập nhật nhật ký bảng điều khiển để sử dụng hàm ghi nhật ký tập trung.
  • 138321133, 138320563 – Thay đổi cơ bản nội bộ đối với vùng đệm hạn mức để hỗ trợ 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à điểm cải tiến sau đây cho Cổng vi mô Edge.

  • Tính năng nâng cao về nhật ký: Các nhật ký thời gian chạy hiện có sử dụng hàm eventLog() mới để ghi lại và ghi nhật ký 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 từ 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 xảy ra quá trình ghi nhật ký.
    • Tên tổ chức Apigee.
    • Tên môi trường trong tổ chức.
    • Tên proxy API.
    • Địa chỉ IP của ứng dụng khách.
    • ClientId.
    • Mã tương quan (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êm thông tin được truyền vào 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.
    • Dấu kết thúc dòng của hệ điều hành.

    Giá trị thuộc tính rỗng sẽ dẫn đến dấu ngoặc 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. Chúng tôi đã khắc phục vấn đề này. (135038879)
  • Các tính năng tích hợp kiểm thử chức năng khác nhau và cải thiện chất lượng mã.

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à điểm cải tiến sau đây cho Cổng vi mô Edge.

Chất lượng mã – Mã đã được xem xét về chất lượng và đã có các thay đổi về mã để đá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à khắc phục. Tất cả mô-đun Cổng vi mô Apigee Edge đều trải qua quy trình này. Xem các thay đổi vào ngày 28 tháng 6 và ngày 2 tháng 7 đối với microgateway-config, microgateway-core, microgateway-pluginsmicrogateway. 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 Cổng vi mô Edge 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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

  • 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; 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 của sản phẩm cho Edge Microgateway trả về 5XX nếu mẫu bộ lọc không chính xác
  • 135113408 – Worker phải khởi động lại nếu bị chấm dứt đột ngột
  • 134945852 – tokenCacheSize không được dùng trong trình bổ trợ oauth
  • 134947757 – đặt cacheTTL trong trình bổ trợ oauth
  • 135445171 – Tính toán gracePeriod trong OAuth không chính xác
  • Sử dụng mô-đun đã ghi nhớ đượ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 v.2.5.x

(Đã sửa 2.5.38, 07/06/2019)

JWT được định dạng không đúng cách có thể khiến worker gặp sự cố khi sử dụng bộ nhớ đệm mã thông báo. Khắc phục trong mô-đun trình bổ trợ cổng vi mô Edge. (b/134672029)

(Thêm 2.5.37) Thêm tuỳ chọn CLI edgemicro-cert -t.

Tuỳ 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 cho 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

Thêm một API edgemicro-auth/token mới cho phép bạn truyền ứng dụng/mật khẩu 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 Trực tiếp lấy mã thông báo thông báo.

(Đã 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

Khắc phục vấn đề khi định cấu hình Edge Microgateway để sử dụng mã thông báo truy cập OAuth2 trên Edge cho Private Cloud 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 một Tổ chức phát hành chứng chỉ (CA) không đáng tin cậy theo mặc định của Node.js, bạn có thể sử dụng tham số NODE_EXTRA_CA_CERTS khi chạy vùng chứa Docker bằng Edge Microgateway. Để biết thông tin chi tiết, hãy xem phần Sử dụng CA mà Node.js không tin cậy.

Docker: Hỗ trợ TLS

(Thêm 2.5.29) Edge Microgateway chạy trong 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 bắc) và cho các yêu cầu đi từ Edge Microgateway đến ứng dụng mục tiêu (yêu cầu 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:

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 tham chiếu trong tệp cấu hình Edge Microgateway.

Docker: Hỗ trợ proxy yêu cầu

(Thêm 2.5.27) Nếu chạy Edge Microgateway trong vùng chứa Docker, bạn có thể sử dụng các tuỳ chọn sau để 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 phần Chạy Edge Micro dưới dạng vùng chứa Docker.

Docker: Cập nhật hướng dẫn về trình bổ trợ

(Thêm 2.5.27) Nếu chạy Edge Microgateway trong vùng chứa Docker, giờ đây, bạn có hai tuỳ chọn để triển khai trình bổ trợ. Một tuỳ chọn mới là sử dụng điểm gắn Docker. Tuỳ chọn khác đã tồn tại trước đó, về cơ bản không thay đổi; 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:

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ể sử dụng mã thông báo OAuth bằng 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 API trong Edge Analytics

(Thêm 2.5.26) 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 biệt trong trang tổng quan của Edge Analytics. Ví dụ: bạn có thể tách biệt 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 proxy cục bộ

(Thêm 2.5.25) Với proxy cục bộ, bạn không cần phải tạo proxy nhận biết được cổng vi mô theo cách thủ công trên Apigee Edge. Thay vào đó, cổng vi mô 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 phần Sử dụng chế độ proxy cục bộ.

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

(Thêm 2.5.25) Bạn có thể chạy Edge Microgateway hoàn toàn tách biệt với mọi phần phụ thuộc Apigee Edge. Tình huống này, được 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.

Rút lại khoá

(Thêm 2.5.19) Thêm một lệnh CLI mới để thu hồi khoá và thông tin xác thực bí mật cho cấu hình Cổng vi mô Edge.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]
Để biết thêm thông tin, hãy xem phần Huỷ cấp khoá.

Hỗ trợ Docker

(Thêm vào phiên bản 2.5.19) 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 phiên bản 2.5.19) Bạn có thể triển khai Edge Microgateway dưới dạng một dịch vụ hoặc dưới dạng cổng sidecar trước các dịch vụ được triển khai trong cụm Kubernetes. Xem: Tổng quan về cách tích hợp Edge Microgateway với Kubernetes.

Hỗ trợ tuỳ chọn nodelay của TCP

(Thêm vào phiên bản 2.5.16) 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 dữ liệu vào bộ đệm trước khi gửi dữ liệu. Việc đặt nodelay thành true sẽ tắt 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 tuỳ chọn CLI mới để giám sát Forever

(Thêm 2.5.12) Thêm các tham số mới 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 mãi mãi

Thông sốMô tả
-f, --fileChỉ định vị trí của tệp forever.json.
-a, --actionstart hoặc stop. Giá trị mặc định là start.

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ác 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 Cổng vi mô Edge. Xem phần Xoay vòng khoá JWT.

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

Theo mặc định, Edge Microgateway sẽ tải tất cả proxy trong tổ chức Edge của bạn xuống, bắt đầu bằng tiền tố đặt tên "edgemicro_". Bạn có thể thay đổi giá trị mặc định này để tải các proxy có tên khớp với một mẫu xuống. Xem phần Lọ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 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 liên tục

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 khởi động lại Edge Microgateway. Tệp này định cấu hình một dịch vụ có tên là forever-monitor, dịch vụ này quản lý Forever theo phương thức lập trình. Xem phần Giám sát mãi mãi.

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 nê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 mà Edge Micro có thể tải tệp cấu hình xuống. Xem phần Chỉ định điểm cuối của tệp cấu hình.

Hỗ trợ tuỳ 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 tuỳ chọn configUrl vào lệnh tải lại

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

Thời gian ân hạn cho sự chênh lệch 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 lỗi do sự chênh lệch nhỏ giữa đồng hồ hệ thống và thời gian Không 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 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 lỗi do sự chênh lệch nhỏ giữa đồng hồ hệ thống và thời gian Không 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 khác biệt như vậy. Xem Thuộc tính OAuth.

Các lỗi đã sửa 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 cho Edge Microgateway 2.5.35.
  • (Vấn đề #135) Lỗi "secure" (an toàn) tham chiếu máy chủ ảo không hợp lệ khi sử dụng tuỳ 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 rằng máy chủ ảo khớp chính xác với nội dung đượ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 ở chế độ mặc định và bảo mật).
  • (Vấn đề #141) Lệnh edgemicro reload (tải lại edgemicro) không hỗ trợ tuỳ chọn tệp cấu hình -c. Sự cố này đã được khắc phục.
  • (Vấn đề #142) Edge Microgateway phàn nàn 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 đề #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ả Proxy API và URI tài nguyên trong OAUTH. Chúng tôi đã khắc phục vấn đề này.
  • (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) Khắc phục vấn đề gây ra thông báo lỗi sau: ReferenceError: deployProxyWithPassword không được xác định.
  • (Vấn đề #169) Cập nhật các phần phụ thuộc Node.js (kiểm tra npm)
  • Proxy edgemicro-auth hiện 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 để 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 v.2.4.x

1. Đặ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, đường dẫn cơ sở là /edgemicro-auth. Để thay đổi giá trị này, 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ể sử 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 ứng dụng gọi https://[host]/team/blue/membershttps://[host]/team/green/members mà bạn không cần tạo proxy API mới để hỗ trợ các nhóm mới. Xin lưu ý rằng /**/ không được hỗ trợ.

Lưu ý quan trọng: Apigee KHÔNG hỗ trợ việc sử dụng ký tự đại diện "*" làm phần tử đầu tiên của đường dẫn cơ sở. Ví dụ: nội dung sau đây KHÔNG được hỗ trợ: /*/search.

3. Thêm đường dẫn cấu hình tuỳ chỉnh vào CLI cho cấu hình Private Cloud (PR 99)

Theo mặc định, tệp cấu hình của cổng vi mô nằm trong ./config/config.yaml. Trên các lệnh khởi tạo, định cấu hình và bắt đầu, giờ đây, bạn có thể chỉ định đườ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 lượt cài đặt trên Private Cloud.

Ví dụ:

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

4. Tuân thủ 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, bạn có thể cân nhắc hai 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 của microgateway:

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

Khi proxy_tunneltrue, Edge Microgateway sẽ sử dụng phương thức CONNECT HTTP để tạo đường hầm cho 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 của cổng vi mô. 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ữ không nên xử lý proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXYNO_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à Cổng vi mô Edge không được proxy đế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 sau:

edgemicro:
    request_timeout: 10

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

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

Cổng vi mô Edge tuân theo 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ừ mục tiêu đã 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 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 Cổng vi mô Edge.

8. 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ó sự thay đổi này, trình bổ trợ chấp nhận cả 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 thêm hai cờ mới:

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

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

Bạn đặt 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ó các thay đổi này, proxy lưu trữ các khoá trong Edge Secure Store, một kho tiền mã hoá. Giờ đây, proxy lưu trữ các khoá trong bản đồ khoá-giá trị đã mã hoá (KVM) của Edge.

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

Bạn cũng có thể ghi đè cổng điểm cuối mục tiêu và chọn giữa HTTP và HTTPS. Sửa đổi các biến này trong mã trình bổ trợ: req.targetPortreq.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 đúng, hãy xem luồng thảo luận này để biết thêm thông tin.

11. Hỗ trợ ban đầu cho việc 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 để 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 sử dụng tham số sau trên lệnh edgemicro configure (định cấu hình edgemicro):

-t, --token <token>

Ví dụ:

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

Các lỗi đã sửa trong phiên bản 2.4.3

  • Khắc phục vấn đề yêu cầu một tổ chức trả phí để chạy đúng cách proxy edgemicro-auth. 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 trình xử lý cuối vẫn thực thi. Điều này đã khiến hệ thống gửi một phần phản hồi. (PR 71)
  • 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 lượt cài đặt trên Private Cloud. (PR 110)
  • Khắc phục vấn đề với SSL hai chiều giữa ứng dụng và Edge Microgateway. (PR 70)
  • Khắc phục vấn đề cần có dấu gạch chéo ở cuối đường dẫn cơ sở của proxy để quy trình xác minh khoá API hoạt động đúng cách. Giờ đây, bạn không cần đặt 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 và điểm cải tiến mới v.2.3.5

Lọc proxy

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

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

Che giấu dữ liệu Analytics

Cấu hình mới cho phép bạn ngăn thông tin đườ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 của cổng vi mô để che giấu URI yêu cầu và/hoặc đường dẫn yêu cầu. Xin lưu ý rằng URI bao gồm tên máy chủ và 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 v.2.3.3

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

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

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

disabled_config_poll_interval: true

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

Viết lại URL đích trong trình bổ trợ

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

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

Thêm chữ ký hàm trình bổ trợ mới để cung cấp phản hồi mục tiêu dưới dạng đố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 hơn.

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 chế độ mặc định để xuất các đối tượng này bằng cách đặt DEBUG=* khi khởi động Edge Microgateway. Ví dụ:

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

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

Theo mặc định, tệp cấu hình của cổng vi mô nằm trong ./config/config.yaml. Trên các lệnh khởi tạo, định cấu hình và bắt đầu, giờ đây, bạn có thể chỉ định đườ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 đã sửa trong phiên bản 2.3.3

  • Khắc phục lỗi rò rỉ bộ nhớ xảy ra trong quá trình yêu cầu/phản hồi lớn.
  • Sửa thứ tự thực thi trình bổ trợ. Giờ đây, lớp này hoạt động như đượ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.
  • Khắc phục vấn đề trong trình bổ trợ accumulate-response (tích luỹ phản hồi) khi thiếu nội dung phản hồi gây ra lỗi.

Bản phát hành 2.3.1

Lưu ý về việc cài đặt

Một số phiên bản Edge Microgateway trước đây 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ủ đề 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 v.2.3.1

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

Lọc proxy

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, cổng vi mô đã tải tất cả proxy nhận biết được cổng vi mô (proxy có tên edgemicro_*) được lấy 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 proxy này để Cổng vi mô Edge chỉ tải các proxy mà bạn chỉ định. Bạn chỉ cần thêm phần tử proxy vào tệp cấu hình của cổng vi mô như sau:

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

Ví dụ: giả sử bạn có 50 proxy edgemicro_* trong org/env của Edge, bao gồm cả các proxy có tên edgemicro_fooedgemicro_bar. Bạn có thể yêu cầu cổng vi mô chỉ sử dụng hai proxy này như sau:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

Khi khởi động, cổng vi mô sẽ chỉ có thể gọi các proxy đã chỉ định. Mọi nỗ lực gọi các proxy khác nhận biết được cổng vi mô đượ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 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 yêu cầu đến chứa dữ liệu (như trong yêu cầu POST) và một mẫu yêu cầu đến 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 trên yêu cầu mục tiêu. Trong các phiên bản Edge Microgateway trước, bạn không thể đặt tiêu đề mục tiêu 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, hãy tích luỹ tất cả dữ liệu đến từ ứng dụng khách. Sau đó, trong hàm onend_request(), hãy sử dụng hàm request.setOverrideHeader(name, value) mới để tuỳ chỉnh tiêu đề.

Dưới đây là mã trình bổ trợ mẫu cho thấy 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ới – mẫu này đã được ghi nhận trước đó và được sử dụng trong các trình bổ trợ mẫu được cung cấp cùng 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 thay đổi cấu hình cho Edge Microgateway, bạn có thể tải cấu hình mà không làm mất 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à tuỳ 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 thư mục đã thực thi lệnh khởi động edgemicro:

  • edgemicro status – Kiểm tra xem Cổng vi mô Edge 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 Cổng vi mô Edge mà không có thời gian ngừng hoạt động.

Tự động tải lại cấu hình mà không có thời gian ngừng hoạt động

Edge Microgateway tải định kỳ một cấu hình mới và thực thi lệnh tải lại nếu có bất kỳ thay đổi nào. Tính năng thăm dò ý kiến sẽ nhận biết mọi thay đổi được thực hiện trên Edge (thay đổi đối với sản phẩm, proxy nhận biết được cổng vi mô, v.v.) cũng như thay đổi đối với tệp cấu hình cục bộ. Khoảng thời gian thăm dò ý kiến 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 của cổng vi mô 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. Để tải phiên bản hiện tại của Cổng vi mô Edge, hãy sử dụng:

edgemicro --version

Các tuỳ chọn SSL mới cho máy chủ Edge Microgateway

Edge Microgateway hiện hỗ trợ các tuỳ chọn SSL máy chủ sau đây ngoài keycert:

Phương thức Mô tả
pfx Đường dẫn đến tệp pfx chứa khoá riêng tư, chứng chỉ và chứng chỉ CA của ứng dụng ở định dạng PFX.
passphrase Một chuỗi chứa cụm mật khẩu cho khoá riêng tư hoặc PFX.
ca Đường dẫn đến tệp chứa danh sách các chứng chỉ đáng tin cậy ở định dạng PEM.
ciphers Một chuỗi mô tả các thuật toán mã hoá cần sử dụng, được phân tách bằng dấu ":".
rejectUnauthorized Nếu đúng, chứng chỉ máy chủ sẽ được xác minh theo danh sách CA được cung cấp. Nếu quá trình xác minh không thành công, hệ thống sẽ trả về lỗi.
secureProtocol Phương thức SSL cần sử dụng. Ví dụ: SSLv3_method để buộc SSL chuyển sang phiên bản 3.
servername Tên máy chủ cho tiện ích TLS SNI (Chỉ báo tên máy chủ).

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 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 của bản phát hành này.

Cho phép điểm cuối API tuỳ chỉnh cho cấu hình

Có các điểm cuối có thể định cấu hình mới cho proxy uỷ quyền hỗ trợ việc sử dụng dịch vụ xác thực 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ụ xác thực 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 của bản phát hành này.

Triển khai proxy xác thực 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 của Cổng vi mô Edge cho Edge tương thích trên 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 phiên bản 21.0

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

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

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

Phiên bản 2.0.11

Ghi chú cài đặt phiên bản 2.0.11

Một số phiên bản Edge Microgateway trước đây 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ủ đề 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 v.2.0.11

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

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

Lệnh start cho phép bạn chỉ định 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 cách sử dụng biến môi trường PORT. Hãy xem lệnh bắt đầu để biết thông tin chi tiết.

Có thể giữ lại các tiêu đề xác thực

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

Khả năng 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ụ xác thực 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 v2.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 sản phẩm

Edge Microgateway hiện hỗ trợ các đường dẫn tài nguyên trong 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 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 hệ thống

Giờ đây, bạn có thể cài đặt Edge Microgateway bằng tuỳ chọn npm -g (toàn cục). Để biết thông tin chi tiết về tuỳ chọn này, hãy tham khảo tài liệu về 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 v.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ủ quy trình đơn

Edge Microgateway hiện là một máy chủ quy trình duy nhất. Công cụ này không còn sử dụng mô hình hai quy trình mà trong đó một quy trình (trước đây gọi là "trình đại diện") sẽ 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à đóng gói 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 không gian 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.

Các 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 các biến đó khi sử dụng Giao diện dòng lệnh (CLI) để định cấu hình và khởi động Cổng vi mô Edge.

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ế độ cụm

Hiện có các tuỳ 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 nhân. Cổng vi mô 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.

Sửa lỗi phiên bản 2.0.0

Vòng đời sự kiện của trình bổ trợ hiện xử lý đúng cách mã không đồng bộ chứa mã có 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 v.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 đúng tác nhân HTTP Node.js để gộp kết nối hiệu quả hơn. Tính năng nâng cao này 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 sẽ đượ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ý của Cổng vi mô Edge.

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.

Mô tả
Chú thích Java cho proxy nội bộ edgemicro dùng với Edge tại chỗ hiện sử dụng máy chủ MGMT phù hợp.
Xoá các phần phụ thuộc typescript khỏi tác nhân.
Khắc phục lỗi CLI khi sử dụng tuỳ chọn triển khai tinh gọn.
Khắc phục tham chiếu phần phụ thuộc logic chứng chỉ.