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

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

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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.3.3. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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à cải tiến sau đây cho Edge Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.3.2. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.3.1. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.3.0. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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à cải tiến sau đây cho Edge Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.2.3. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.2.2. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.2.1. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.2.0. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.8. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.7. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.6. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.5. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 đây cho Edge Cổng nhỏ.

Sửa lỗi:

Đã khắc phục sự cố 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à cải tiến được mô tả trong ghi chú phát hành phiên bản 3.1.3 á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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.3. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 được sự cố trong đó mô-đun gỡ lỗi Node.js dẫn đến rò rỉ bộ nhớ. Vấn đề này tồn tại trong các phiên bản 3.1.0, 3.1.1 và 3.1.2.
• 153509313 – Đã khắc phục một sự cố có cùng một mã nhận dạng thư cho hai giao dịch khác nhau đã được in trong đầu ra nhật ký.
• 151673570 – Đã khắc phục sự cố trong đó Edge Microgateway không được cập nhật để sử dụng phiên bản mới API KVM của Apigee. 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 để việc xử lý liên kết đường dẫn tài nguyên khớp với dữ liệu của Apigee Edge. Trong bản phát hành này, một vấn đề đã được khắc phục trong đó mẫu /literal_string/* không được xử lý đúng cách. Ví dụ: /*/2/*. Xem cũng Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**".
• 152005003 – Các thay đổi được thực hiện để bật các giá trị nhận dạng ở phạm vi tổ chức và môi trường để có hạn mức.
• 152005003 – Các thay đổi được thực hiện để bật các giá trị nhận dạng ở phạm vi tổ chức và môi trường để có hạn mức. Tổ hợp "org + env + appName + productName" sẽ được dùng làm hạn mức giá trị nhận dạng.

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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.3. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 – Tính năng nâng cao để thêm dịch vụ hỗ trợ proxy HTTP cho lưu lượng truy cập giữa Edge Microgateway và mục tiêu phụ trợ. Ngoài ra, các vấn đề đã được khắc phục cho HTTP hiện có hỗ trợ proxy giữa Edge Microgateway và Apigee Edge. Để biết thông tin chi tiết, hãy xem:
  • Dùng proxy HTTP để giao tiếp với Apigee Edge
  • Dùng một proxy HTTP để giao tiếp mục tiêu
• 149101890 – Mã thông báo nhật ký cho trường hợp máy chủ mục tiêu hoặc trình cân bằng tải đóng kết nối đã được thay đổi từ LỖI thành INFO.
• 150746985 – Đã khắc phục một sự cố trong đó lệnh edgemicro verify không sẽ 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 – Chúng tôi đã cải tiến để đóng các kết nối máy chủ nhanh hơn khi các worker đều 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 được sử dụng để chạy Edge Microgateway trong vùng chứa Docker lên 12, vì Node.js v8 không được dùng nữa.
• 151306049 – Cập nhật tài liệu để liệt kê quyền quản lý Apigee Edge Những API mà các lệnh CLI của Edge Microgateway sử dụng. Xem Edge Microgateway sử dụ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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.1. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 sự cố trong đó mô-đun microgateway-core không tuân theo 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) giờ đây đã 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 với biến đượ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 sau:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 – Thông số cấu hình mới, edgemicro.headers_timeout, là đã thêm. 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ộ, thông số này đặt Node.js Server.headersTimeout theo yêu cầu. (Mặc định: nhiều hơn 5 giây thời gian được đặt bằng edgemicro.keep_alive_timeout. Chế độ mặc định này chế độ cài đặt ngăn chặn trình cân bằng tải hoặc proxy làm gián đoạn kết nối.)

• 149278885 – Một tính năng mới được thêm vào cho phép bạn đặt thời gian chờ API mục tiêu tại 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 mục tiêu thời gian chờ theo từng thiết bị đầu cuối. Nếu tham số này không được áp dụng, 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.1.0. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 mới ở cấp WARN 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 "áp dụng hạn mức" gửi yêu cầu đến 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ẽ được xử lý dựa trên cho đến khi đồng bộ hoá hạn mức từ xa thành công tiếp theo. Trước đây, sự kiện 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 sự cố do các giao dịch mới hoặc giao dịch đang bay bị ảnh hưởng bất cứ khi nào Edge Microgateway phát hiện có sự thay đổi đối với proxy API. Bây giờ, khi thay đổi được thực hiện đối với proxy, Edge Microgateway làm mới bộ nhớ đệm và các nút worker khởi động lại. Với thay đổi này, giao dịch trên chuyến bay và các 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, targetRequest, và targetResponse đã được thay đổi thành cấp INFO.
• 146019878 – Sự chênh lệch giữa độ trễ được tính cho "Hiệu suất proxy API" trong Analytics của Edge và các sự kiện trong nhật ký của Edge Microgateway sourceResponse/targetResponse đã được đã được khắc phục. Giờ đây, độ trễ trong các sự kiện trong nhật ký của Edge và Microgateway đã được điều chỉnh cho phù hợp.
• Các 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ợ đường dẫn tài nguyên sau mẫu so khớp theo quy đị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 giờ đây cũng tuân theo cùng một khớp mẫu dưới dạng Apigee Edge, như được giải thích trong Định cấu hình hành vi của tài nguyên đường dẫn của '/', '/*' và '/**'.

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

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 cho Edge Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.0.10. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 – Bản cập nhật tính năng đã được thực hiện để 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 phương pháp so khớp mẫu đường dẫn tài nguyên mà Apigee Edge, như mô tả trong Đị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ẫ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 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 đây:

  

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

• 143740696 – Cấu hình quotas đã thay đổi (xem thêm các ghi chú phát hành cho phiên bản 3.0.9). quotas được dùng để định cấu hình trình bổ trợ hạn mức. Thay đổi cấu trúc được thực hiện để cải thiện sự 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 đây. Lưu ý rằng được gọi là quotas. Để biết thông tin chi tiết về cấu hình quotas riêng lẻ thuộc tính, hãy xem 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 dưới dạng hạn mức kho sao lưu. Nếu useRedis là đúng thì volos-quota-redis được sử dụng. Khi đúng, hạn mức sẽ chỉ áp dụng cho các phiên bản Edge Microgateway kết nối với Redis. Nếu sai, volos-quota-apigee mô-đun này được dùng làm kho lưu trữ sao lưu và bộ đếm hạn mức là bộ đếm toàn cục. Để biết thông tin chi tiết, hãy xem 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 các mã thông báo do edgemicro-auth tạo proxy đã đượ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 hỗ trợ SAML, lệnh edgemicro genkeys có đã được cập nhật để bao gồ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 chi tiết, hãy xem Đang 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 cho Edge Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.0.9. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 – Lỗi mới "thất bại" thêm tính năng 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 "áp dụng hạn mức" yêu cầu Edge không thể cập nhật bộ đếm hạn mức từ xa, hạn mức sẽ chỉ được xử lý dựa trên số lượng cục bộ cho đến khi hạn mức từ xa thành công tiếp theo đồng bộ hoá 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 hạn mức "không mở được" , hãy đặt 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 – Đã thực hiện thay đổi cấu hình đối với proxy edgemicro-auth để tránh tình trạng vượt hạn mức. Thay đổi là đặt loại hạn mức thành lịch. Để sử dụng tính năng cải tiến này, bạn phải cập nhật edgemicro-auth của bạn 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ý MP mã (trình xử lý thông báo) về phản hồi hạn mức. Để sử dụng tính năng này, bạn phải cập nhật proxy edgemicro-auth của bạn sang 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 theo hạn mức từ Edge sẽ chứa id 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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.0.8. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 – Lỗi mới "không thành công" tính năng đã được thêm. 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 không cho 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 thiết lập thời gian gia hạn mà mã thông báo cũ vẫn còn trong bộ nhớ đệm và được sử dụng lại cho đến khi hết thời gian ân 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 lỗi kết nối tạm thời. Thời gian kết nối tiếp tục và lệnh gọi Xác minh khoá API thành công được thực hiện, JWT mới sẽ được tìm nạp và thay thế JWT cũ trong bộ nhớ đệm.

  Để định cấu hình trạng thái "không thành công" mới, , hãy làm như sau:

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

     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 vấn đề kết nối. Sau 5 giây, hệ thống sẽ trả về lỗi xác thực.

• 141168968 – Bản cập nhật đã được thực hiện để bao gồm correlation_id trong 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 Edge Microgateway khoá và khoá bí mật cần được xác minh 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 trên mọi yêu cầu Xác minh khoá API. Sự thay đổi này ngăn ứng dụng lấy JWT chỉ bằng khoá API.
• 140090250 – Bản cập nhật đã thêm tính năng ghi nhật ký chẩn đoán để xử lý hạn mức. Bằng cách này thì hiện có thể tương quan đầu ra nhật ký quoto với phần còn lại của Edge Microgateway nhật ký.

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 Cổng nhỏ.

Các 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 riêng lẻ được liên kết với Edge Microgateway 3.0.7. Lưu ý rằng mỗi thành phần là một dự án riêng biệt, số 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 – Trình bổ trợ OAuth đã được cập nhật để trả về mã trạng thái 5xx trong đó phù hợp. Trước đây, trình bổ trợ này chỉ trả về mã trạng thái 4xx trong tất cả không phải 200 trường hợp. Bây giờ, đối với mọi phản hồi tin nhắn không phải là trạng thái 200, giá trị chính xác Mã 4xx hoặc 5xx 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 của bạn. 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 edgemicro-auth proxy đượ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 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 phiên bản 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 chi tiết, hãy xem Nâng cấp Edgemicro-auth proxy.

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

  edgemicro:
      keepAliveTimeout

  được ghi lại không chính xác trong bản phát hành 3.0.6. Tên chính xác của cơ sở lưu trú là:

  edgemicro:
      keep_alive_timeout

• 139526406 – Khắc phục lỗi khi số lượng hạn mức không chính xác 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 mỗi sản phẩm trong ứ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 Cổng nhỏ.

• 138633700 – Thêm một thuộc tính cấu hình mới là keepAliveTimeout. Thuộc tính này cho phép bạn để đặt thời gian chờ 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 là quotaUri. Đặt 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 thuộc tính này không được thiết lập, mặc định điểm cuối hạn mức 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 edgemicro-auth proxy đến tổ chức của bạn. Để biết thông tin chi tiết, hãy xem Nâng cấp proxy Edgemicro-auth.

• 138722809 – Thêm một thuộc tính cấu hình mới là stack_trace. Cơ sở lưu trú này cho phép bạn kiểm soát việc có hoặc không phải dấu vết ngăn xếp xuất hiện trong tệp nhật ký. 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 giá trị này thành false, ngăn xếp dấu vết 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 Cổng nhỏ.

• 139005279 – Đã khắc phục một sự cố trong đó lệnh edgemicro status không trả về số lượng quy trình worker phù hợp.
• 138437710 – Một sự cố đã được khắc phục trong lớp ExitCounter ngăn chặn việc thích hợp nhật ký được ghi.

• 139064652 – Thêm tính năng thêm cấp độ ghi nhật ký trace và debug cho sự kiện và nhật ký hệ thống. Hiện tại, chúng tôi chỉ thêm tính năng thêm các cấp độ nhật ký này. Hiện tại, cấp độ nhật ký hiện có 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ý trên bảng điều khiển. Giao diện dòng lệnh Các câu lệnh ghi nhật ký 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 điệp nhật ký trên bảng điều khiển

• 138413755 – Cải thiện khoá JWT và thông điệp nhật ký liên quan đến bí mật cho các CLI này các lệnh: cert, xác minh, Upgradekvm, token, genkeys,recyclekeys, xoákey và cấu hình.

• 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 đối với "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 Cổng nhỏ.

• 134445926 – Cải tiến cơ chế xác thực Edge Microgateway nội bộ.
• 137582169 – Giải quyết sự cố trong đó các quy trình không mong muốn khởi động. Quy trình bổ sung khiến plugin 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 thiện thông điệp nhật ký:
  • Đã xoá nhật ký giao dịch (yêu cầu).
  • Thêm các thông điệp nhật ký khác khi cần.
  • Đã di chuyển thông điệp nhật ký giao dịch (yêu cầu) từ dữ liệu đầu ra của bảng điều khiển sang dữ liệu có liên quan tệp nhật ký.
  • Cập nhật nhật ký bảng điều khiển để sử dụng chức năng ghi nhật ký tập trung.
• 138321133, 138320563 – Thay đổi nội bộ cơ bản đối với vùng đệm hạn mức để tăng 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 Cổng nhỏ.

• Tính năng ghi nhật ký nâng cao: Nhật ký thời gian chạy hiện có sử dụng Hàm eventLog() giúp ghi lại và ghi nhật ký dữ liệu thời gian chạy một cách 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 đề của yêu cầu.
  • Mã quy trình – Nếu bạn đang chạy một cụm quy trình Node.js, thì đây là mã của nơi diễn ra hoạt động 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.
  • Mã ứng dụng khách.
  • 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êm thông tin đã được truyền cho 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 chứa mã lỗi thì đối tượng đó sẽ được in trong thuộc tính này.
  • Thời gian chụp.
  • Hệ điều hành điểm đánh dấu cuối dòng.

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

  Ví dụ sau đây minh hoạ đị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 công cụ tích hợp kiểm thử chức năng khác 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à cải tiến sau đây cho Edge Cổng nhỏ.

Chất lượng mã – Mã đã được xem xét về chất lượng và thực hiện các thay đổi về mã thành đáp ứng tiêu chuẩn chất lượng mà người dùng yêu cầu. Chúng tôi đã xử lý các cảnh báo và lỗi về chất lượng mã bắt nguồn từ JSHint. Do đó, một số lỗi thực tế liên quan đến mã đã được xác định và sửa chữa. Tất cả cửa hàng ứng dụng Apigee Edge đã được đưa qua quá trình này. Xem các thay đổi vào ngày 28 tháng 6 và ngày 2 tháng 7 cho microgateway-config, microgateway-core, microgateway-plugins và microgateway. Tất cả các mô-đun có thay đổi về chất lượng mã đã được kiểm thử bằng các công cụ nội bộ nhằm xác minh triển khai 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 Cổng nhỏ.

• 134834551 – Thay đổi các phiên bản Node.js được hỗ trợ cho Edge Microgateway
  (Các phiên bản được hỗ trợ của Node.js: 8 và 12; phiên bản 7, 9 và 11 đang thử nghiệm)
• 134751883 – Edge Microgateway gặp sự cố khi tải lại khi đang tải
• 134518428 – Điểm cuối của sản phẩm cho Edge Microgateway trả về 5XX nếu dạng bộ lọc là không chính xác
• 135113408 – Worker sẽ khởi động lại nếu chấm dứt đột ngột
• 134945852 – tokenCacheSize không được sử dụng trong trình bổ trợ oauth
• 134947757 - đặt cacheTTL trong plugin oauth
• 135445171 – phép tính khoảng thời gian gia hạn trong OAuth không chính xác
• Sử dụng mô-đun đã ghi nhớ được cung cấp khi 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à tính năng nâng cao phiên bản 2.5.x

(Bản sửa lỗi 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 của mã thông báo. Đã khắc phục trong Edge mô-đun trình bổ trợ microgateway. (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 API quản lý. Xem thêm phần 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 Nhiệm vụ tích hợp Kubernetes.

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

(Thêm phiên bản 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/bí mật dưới dạng một Mã hoá Base64 Tiêu đề Uỷ quyền cơ bản và Grant_type làm thông số biểu mẫu. Hãy xem bài viết Trực tiếp lấy mã thông báo truy cập.

(Đã sửa 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 sự cố khi định cấu hình Edge Microgateway để sử dụng mã truy cập OAuth2 trên Edge cho Đám mây riêng tư không hoạt động đúng cách (mã thông báo không được tuân thủ).

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

(Đã thêm 2.5.29) Nếu bạn đang sử dụng Tổ chức phát hành chứng chỉ (CA) không được tin cậy theo mặc định Node.js, bạn có thể 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 không được Node.js 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 tới máy chủ Edge Microgateway (yêu cầu đi theo hướng bắc) và cho các yêu cầu đi từ Edge Microgateway tới ứng dụng mục tiêu (yêu cầu hướng về phía 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 về phía nam

Trong các ví dụ này, bạn sẽ thấy cách sử dụng điểm gắn 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ợ yêu cầu proxy

(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 này để kiểm soát proxy khi cổng vi mô đ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: Hướng dẫn cập nhật về trình bổ trợ

(Thêm 2.5.27) Nếu chạy Edge Microgateway trong vùng chứa Docker, bạn hiện có hai lựa chọn cho triển khai trình bổ trợ. Có một tuỳ chọn mới, đó là sử dụng điểm gắn của Docker. Lựa chọn khác đã tồn tại trước đó, về cơ bản là không thay đổi; tuy nhiên, Dockerfile đã được cập nhật. Để biết thông tin chi tiết, vui lòng tham khảo các đường liên kết sau:

• Cách A: Kết nối thư mục trình bổ trợ vào một ổ đĩa (Mới)
• Cách B: Tạo trình bổ trợ vào vùng chứa (Đã cập nhật)

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

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

Tách biệt các API trong Edge Analytics

(Thêm 2.5.26) Các cờ trình bổ trợ Analytics mới cho phép bạn tách riêng 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 của Edge Analytics. 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 Loại trừ đường dẫn khỏi Analytics.

Đị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 một proxy nhận biết microgateway trên Apigee Edge theo cách thủ công. Thay vào đó, cổng nhỏ 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 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 khi bị ngắt kết nối hoàn toàn từ bất kỳ 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ó kết nối Internet., hãy xem phần Chạy Edge Microgateway ở chế độ độc lập.

Thu hồi khoá

(Thêm 2.5.19) Một lệnh CLI mới đã được thêm vào để thu hồi thông tin xác thực khoá và bí mật của một Cấu hình Microgateway ở cạnh.

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

Hỗ trợ Docker

(Đã thêm 2.5.19) Giờ đây, bạn có thể tải xuống bản phát hành Edge Microgateway mới nhất dưới dạng Hình ảnh Docker:

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

Dịch vụ hỗ trợ củaKubernetes

(Thêm 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 một cổng trợ giúp ở phía trước các dịch vụ mới được triển khai trong cụm Kubernetes. Hãy xem: Tích hợp Edge Microgateway với thông tin tổng quan về Kubernetes.

Hỗ trợ tuỳ chọn nút TCP

(Bổ sung 2.5.16) Chế độ cài đặt cấu hình mới nodelay đã được thêm vào cấu hình Edge Micro.

Theo mặc định, các kết nối TCP sử dụng Nagle thuật toán để lưu dữ liệu vào vùng đệm trước khi gửi đi. Đặt nodelay thành true, tắt hành vi này (dữ liệu sẽ kích hoạt dữ liệu ngay lập tức mỗi lần socket.write() sẽ được gọi). Xem thêm phần Node.js để biết thêm 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 về CLI để giám sát vĩnh viễn

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

Ví dụ:

Để bắt đầu vĩnh viễn:

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

Để dừng vĩnh viễn:

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 vòng các cặp khoá công khai/riêng tư dùng để tạo mã thông báo JWT dùng để bảo mật OAuth trên Edge Microgateway. Xem Xoay các 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 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 proxy xuống có tên khớp với một mẫu. Xem 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 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 bất kỳ đượ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ợ sản phẩm này .

Hỗ trợ 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 khởi động lại Edge Microgateway. Tệp này định cấu hình một dịch vụ có tên cố gắng giám sát vĩnh viễn. Dịch vụ này sẽ quản lý vĩnh viễn dịch vụ này theo phương thức lập trình. Xem 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 nên quản lý 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 Chỉ định điểm cuối của tệp cấu hình.

Hỗ trợ tuỳ chọn CLI vĩnh viễn

(Thêm bản 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, 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

Bổ sung tuỳ chọn configUrl để tải lại lệnh

(Đã thêm phiên bản 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 đối với các trường hợp không xác định 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ự khác biệt nhỏ giữa đồng hồ hệ thống của bạn và Thời gian không trước (nbf) hoặc Được cấp vào (iat) lần đượ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 để tạo ra 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ự khác biệt nhỏ giữa đồng hồ hệ thống của bạn và Thời gian không trước (nbf) hoặc Được cấp vào (iat) lần đượ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 để tạo ra những khác biệt như vậy. Xem Thuộc tính OAuth.

Sửa lỗi 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) Tải lại sự cố cho Edge Microgateway 2.5.35.
• (Vấn đề #135) Tham chiếu máy chủ ảo không hợp lệ "bảo mật" lỗi khi sử dụng tính năng -v. Bản sửa lỗi này sửa đổi proxy xác thực Edgemicro trước khi triển khai thành đảm bảo máy chủ ảo khớp chính xác với nội dung được chỉ định trong "-v" cờ. Ngoài ra, bạn có thể chỉ định bất kỳ số lượng và bất kỳ tên nào cho máy chủ ảo (không còn bị giới hạn ở mặc định và an toàn).
• (Vấn đề #141) Lệnh edgemicro tải lại không hỗ trợ tùy 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ề việc tiền mã hoá không còn được 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. Vấn đề này đã được đã được khắc phục.
• (Vấn đề 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) Sự cố gây ra thông báo lỗi sau đã được khắc phục: 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)
• 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 để cung cấp hỗ trợ JWT.

Phiên bản 2.4.x

Các tính năng mới và tính năng nâng cao phiên bản 2.4.x

1. Đặt email đại diện tuỳ chỉnh dà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 chế độ cài đặt này, hãy sử dụng cờ -x bằng lệnh Edgemicro Configurations.

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 "*" các ký tự đại diện trong đường dẫn cơ sở của edgemicro_*. Ví dụ: đường dẫn cơ sở của /team/*/members cho phép khách hàng gọi https://[host]/team/blue/members và https://[host]/team/green/members mà không cần tạo proxy API mới để hỗ trợ các nhóm mới. Lưu ý rằng /**/ không phải là đượ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 tư (PR) 99)

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

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 phía sau tường lửa và không thể giao tiếp với Apigee Ngoài đám mây công cộng, có hai lựa chọn cần cân nhắc:

Cách 1:

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

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

Khi proxy_tunnel là true, Edge Microgateway sử dụng HTTP Phương thức KẾT NỐI để tạo đường hầm cho các yêu cầu HTTP qua một kết nối TCP. (Đ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 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 mỗi proxy HTTP mà bạn muốn sử dụng hoặc máy chủ nào không được xử lý proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXY và NO_PROXY. Bạn có thể đặt NO_PROXY thành danh sách các miền được phân tách bằng dấu phẩy mà Edge Microgateway nên không phải proxy. 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 tính bằng giây. Nếu hết thời gian chờ, Edge Microgateway sẽ phản hồi bằng mã 504 mã trạng thái.

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)

Edge Microgateway tuân thủ 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ừ mục tiêu đã bị ghi đè bằng Node.js mặc định.

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 giá trị 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. Thay đổi trình bổ trợ OAuth

Trình bổ trợ OAuth hỗ trợ tính năng xác minh Khoá API và xác minh mã truy cập OAuth. Trướ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).

Cá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 mang tiêu đề Uỷ quyền có Mã truy cập của người dùng.

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

Bạn đặt những 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 xác thực Edgemicro (PR 40)

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

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

Bạn cũng có thể ghi đè cổng điểm cuối đích rồi chọn giữa HTTP và HTTPS. Sửa đổi các biến trong mã trình bổ trợ của bạn: req.targetPort và req.targetSecure. Để chọn HTTPS, hãy đặt req.targetSecure thành true; cho HTTP, hãy đặt thành false. Nếu bạn đặt req.targetSecure thành true, xem cuộc thảo luận này luồng để 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 để dùng mã thông báo OAuth nhằm xác thực thay vì tên người dùng/mật khẩu. Để dùng mã thông báo OAuth, hãy dùng tham số sau trên Edgemicro cấu hình:

-t, --token <token>

Ví dụ:

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

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

• Khắc phục sự cố yêu cầu tổ chức trả phí phải chạy proxy Edgemicro-auth đúng cách. Bây giờ, 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ý cuối vẫn đang thực thi. Do đó, hệ thống đã gửi một phần phản hồi. (PR 71)
• Khắc phục vấn đề không chứa thư mục cấu hình tuỳ chỉnh để cài đặt Đám mây riêng tư đã nhận dạng. (110 quan hệ công chúng)
• Khắc phục sự cố SSL hai chiều giữa ứng dụng và Edge Microgateway. (PR 70)
• Khắc phục vấn đề phải có dấu gạch chéo ở cuối trên đường dẫn cơ sở proxy cho khoá API xác minh để hoạt động chính xác. Bây giờ, 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à tính năng nâng cao phiên bản 2.3.5

Lọc proxy

Bạn có thể lọc những proxy nhận biết cổng vi mô mà phiên bản Edge Microgateway sẽ xử lý. Khi Edge Microgateway khởi động, Edge Microgateway sẽ tải xuống tất cả các proxy nhận biết microgateway trong tổ chức liên kết với tài khoản đó. Sử dụng cấu hình sau để giới hạn các proxy microgateway sẽ xử lý. Ví dụ: cấu hình này giới hạn các proxy cổng vi mô sẽ xử lý thành 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 phân tích

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 Edge số liệu phân tích. Thêm phần sau đây vào cấu hình microgateway để che giấu URI yêu cầu và/hoặc đường dẫn yêu cầu. Lưu ý rằng URI bao gồm các phần đường dẫn và tên máy chủ 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à tính năng nâng cao phiên bản 2.3.3

Sau đây là các tính năng mới và tính năng nâng cao cho 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 thiết lập thuộc tính này trong cổng vi mô cấu hình:

disabled_config_poll_interval: true

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

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

Bạn có thể tự động ghi đè URL mục tiêu mặc định 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ợ của bạn: req.targetHostname và req.targetPath.

Chữ ký của hàm 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ố. Thao tác này giúp trình bổ trợ truy cập vào phản hồi mục tiêu dễ dàng hơn.

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

Đơn giản hoá dữ liệu 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 sản phẩm, proxy đã tải xuống và JWT. Bạn có thể thay đổi thành mặc định để xuất các đối tượng này bằng cách đặt DEBUG=* khi bắt đầu Cổng nhỏ ở rìa. 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 khởi tạo, định cấu hình và bắt đầu lệnh, 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

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

• Đã khắc phục sự cố rò rỉ bộ nhớ xảy ra trong các yêu cầu/phản hồi lớn.
• Đã khắc phục thứ tự thực thi trình bổ trợ. Nó hiện hoạt động theo cách được giải thích trong tài liệu.
• Trình bổ trợ tích luỹ yêu cầu không còn bị treo đối với các yêu cầu GET.
• Khắc phục một sự cố trong trình bổ trợ phản hồi tích luỹ do thiếu nội dung phản hồi .

Bản phát hành 2.3.1

Ghi chú cài đặ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

Tham khảo chủ đề cài đặt cho chi tiết hơn.

Các tính năng mới và tính năng nâng cao phiên bản 2.3.1

Sau đây là các tính năng mới và tính năng nâng cao cho 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 dựa trên của bạn. Trước đây, microgateway tải tất cả các proxy nhận biết cổng vi mô (các proxy có tên là cạnhmicro_*) được lấy từ tổ chức/môi trường Edge mà bạn đã chỉ định trong Edgemicro config. Tính năng mới này cho phép bạn lọc danh sách proxy này để Edge Microgateway chỉ tải những trang mà bạn chỉ định. Chỉ cần thêm phần tử proxy vào cổng vi mô config như sau:

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

Ví dụ: giả sử bạn có 50 proxy edgemicro_* trong Edge org/env, bao gồm cả 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 vi mô sẽ chỉ có thể gọi các proxy đã chỉ định. Mọi lần thử gọi các proxy nhận biết cổng vi mô khác được tải xuống từ tổ chức/môi trường Edge sẽ dẫn đến lỗi.

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

Có 2 mẫu cơ bản cần cân nhắc nếu muốn thêm hoặc sửa đổi tiêu đề của yêu cầu mục tiêu: một nơi mà yêu cầu đến chứa dữ liệu (như trong một yêu cầu POST) và một nơi mà trong đó nó không chứa dữ liệu (như trong một 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 thiết lập yêu cầu trên 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ể đặt tiêu đề mục tiêu một cách đáng tin cậy trong trường hợp này.

Trước tiên, khoá của mẫu này là để tích luỹ tất cả dữ liệu đến từ ứng dụng. Sau đó, trong Hàm onend_request(), hãy sử dụng hàm mới request.setOverrideHeader(name, value) để 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. Tiêu đề được đặt trong onend_request đượ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(). Đây không phải là mẫu mới. Mẫu này đã được ghi nhận trước đó và đã được dùng trong các trình bổ trợ mẫu được cung cấp cùng 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 khi không có thời gian ngừng hoạt động

Sau khi thay đổi cấu hình thành Edge Microgateway, bạn có thể tải cấu hình mà không bỏ bất kỳ thư 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 edgemicro start .

Ngoài ra, chúng tôi bổ sung 3 lệnh CLI mới. Bạn phải chạy các lệnh này từ cùng 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 Edge Microgateway mà không có thời gian ngừng hoạt động.

Cấu hình tự động tải lại mà không phải ngừng hoạt động

Edge Microgateway tải một cấu hình mới theo định kỳ và thực hiện tải lại nếu có đã thay đổi. Cuộc thăm dò ý kiến cho biết mọi thay đổi được thực hiện trên Edge (các thay đổi đối với sản phẩm, nhận biết qua cổng vi mô proxy, v.v.) cũng như các 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 thà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 Edge hiện tại Cổng nhỏ, sử dụng:

edgemicro --version

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

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

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

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

edgemicro:
  logging:
    to_console: true  

Xem 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à tính năng nâng cao cho 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 mới có thể định cấu hình cho proxy uỷ quyền hỗ trợ việc sử dụng dịch vụ xác thực tuỳ chỉnh. Những điểm cuối này là:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Để biết chi tiết, hãy xem 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à tính năng nâng cao cho bản phát hành này.

Triển khai proxy xác thực tương thích với nhiều nền tảng

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

Phiên bản 2.1.0

Các tính năng mới và tính năng nâng cao phiên bản 21.0

Sau đây là các tính năng và tính năng nâng cao mới:

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

Bạn có thể chỉ định tuỳ chọn ứng dụng cho kết nối SSL/TSL với các mục tiêu bằng cách sử dụng một tập hợp cấu hình mới . Xem 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 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

Tham khảo chủ đề cài đặt cho chi tiết hơn.

Các tính năng mới và tính năng nâng cao phiên bản 2.0.11

Sau đây là các tính năng và tính năng nâng cao mới:

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

Lệnh bắt đầu 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. Xem start Command (lệnh bắt đầu) để biết chi tiết.

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

Cài đặt cấu hình mới, keepAuthHeader, bạn có thể giữ Tiêu đề uỷ quyền được gửi trong yêu cầu. Nếu được đặt thành true, tiêu đề Xác thực sẽ được chuyển tới . Xem Các 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. Cho chi tiết, xem Sử dụng dịch vụ xác thực tuỳ chỉnh.

Phiên bản 2.0.4

Edge Microgateway v.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à cải tiến v2.0.4

Sau đây là các tính năng mới và tính năng nâng cao 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ợ đườ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 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, xem phần Tạo API của chúng tôi.

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

Giờ đây, bạn có thể cài đặt Edge Microgateway bằng cách sử dụng tuỳ chọn npm -g (global). Để biết thông tin chi tiết tham chiếu đến npm .

Phiên bản 2.0.0

Edge Microgateway v2.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à tính năng nâng cao phiên bản 2.0.0

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

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

Edge Microgateway hiện là máy chủ một quy trình. Không còn sử dụng mô hình hai quá trình trong đó một quy trình (trước đây gọi là "tác nhân") triển khai Edge Microgateway, quy trình thứ hai của chúng tôi. Kiến trúc mới giúp quá trình tự động hoá và vùng chứa trở nên dễ dàng hơn.

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

Tệp cấu hình giờ được đặt tên không gian tên bằng cách sử dụng tổ chức và môi trường để nhiều Các thực thể Microgateway có thể chạy trên cùng một máy chủ. Bạn có thể tìm thấy các tệp cấu hình trong ~/.edgemicro sau khi bạn 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 đặt các biến này trên hệ thống của mình, bạn không cần phải chỉ định các biến này khi bạn sử dụng Giao diện dòng lệnh (CLI) để định cấu hình và khởi động Edge Cổng nhỏ.

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 trong bộ nhớ đệm nếu tệp này khởi động lại mà không kết nối với Apigee Edge.

Chế độ cụm

Hiện tại, bạn có thể khởi động Edge Microgateway ở chế độ cụm đồng hồ. Chế độ cụm cho phép bạn lấy của 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.

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

Giờ đây, vòng đời sự kiện trình bổ trợ sẽ xử lý đúng cách mã không đồng bộ chứa mã có .

Phiên bản 1.1.2

Edge Microgateway v. 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à tính năng nâng cao phiên bản 1.1.2

Sau đây là các tính năng mới và tính năng nâng cao 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 để tạo nhóm kết nối tốt hơn. Chiến dịch này tính năng nâng cao cải thiện hiệu suất và độ ổn định tổng thể dưới tải cao.

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

Bạn có thể định cấu hình cho Edge Microgateway để chạy bằng một trình gỡ lỗi từ xa, chẳng hạn như node-inspector (công cụ kiểm tra nút).

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

Khi bạn định cấu hình Edge Microgateway, tệp agent/config/default.yaml sẽ trở thành đã sao chép vào ~./edgemicro/config.yaml.

Rotatio tệp nhật kýn

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

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