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

microgateway core cấu hình trình bổ trợ edgeauth
3.3.2 3.3.2 3.3.2 3.3.2 3.2.2

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

ID vấn đề Loại Nội dung 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 mềm được hỗ trợ API và các phiên bản được hỗ trợ.

283947053 Con rệp

Khắc phục sự cố trong đó 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. Hiện chúng tôi xác định đúng sản phẩm API cần trả về dựa trên yêu cầu.

274443329 Con rệp

Khắc phục sự cố 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. Hiện chúng ta tạo hình ảnh Docker bằng phiên bản 18.17-buster-slim.

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

Không nội dung nào.

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

microgateway core cấu hình trình bổ trợ edgeauth
3.3.1 3.3.1 3.3.1 3.3.1 3.2.2

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

ID vấn đề Loại Nội dung mô tả
220885293 Tính năng

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

231972608 Con rệp

Khắc phục sự cố trong đó lệnh private configure đã báo lỗi trong khi cố gắng định cấu hình cho một đám mây riêng tư.

233315475 Con rệp

Chúng tôi đã khắc phục sự cố trong đó plugin json2xml báo 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 dùng kết hợp với plugin 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

Chúng tôi đã thêm tính năng hỗ trợ xác thực mã thông báo SAML vào lệnh khoá thu hồi.

Giờ đây, bạn có thể chuyển mã thông báo SAML thay vì thông tin xác thực 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 phần 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 này được cập nhật để thêm một đường liên kết đến các trình bổ trợ Edge Microgateway được hỗ trợ 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 đề bảo mật

ID vấn đề Nội dung mô tả
CVE-2021-23413 Điều này ảnh hưởng đến gói jszip trước 3.7.0. Việc tạo một tệp zip mới có tên tệp được đặt thành giá trị nguyên mẫu đối tượng (ví dụ: proto, toString, v.v.) dẫn đến việc một đối tượng được trả về có 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à 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.3.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.3.0 3.3.0 3.3.0 3.3.0 3.2.2

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

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

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

Nếu thực thi npm audit fix rồi thực thi edgemicro upgradeauth sau đó, 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 đề này, hãy thực thi lệnh sau để khôi phục đúng phiên bản apigeetool:

npm install apigeetool@0.15.1

Vấn đề này sẽ được giải quyết trong bản phát hành tiếp theo của Edge Microgateway.

138622990 Tính năng

Một cờ mới cho trình bổ trợ Hạn mức, isHTTPStatusTooManyRequestEnabled, sẽ đị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 lựa chọn cấu hình cho hạn mức.

192534424 Con rệp

Chúng tôi đã khắc phục sự cố khiến mã phản hồi mà bạn thấy trong số liệu phân tích Apigee không khớp với mã phản hồi 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, đồng thời cập nhật khoá này 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 nếu không tải lại Edge Microgateway nếu khoá công khai của IDP thay đổi.
168713541 Con rệp

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 Sử dụng các tuỳ chọn SSL/TLS của ứng dụng khách.

171538483 Con rệp

Thay đổi tài liệu để chỉnh sửa quy ước đặt tên tệp nhật ký. Xem phần Quy ước đặt tên tệp nhật ký.

157908466 Con rệp

Thay đổi tài liệu để 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 Edge Microgateway nếu bạn có kết nối Internet.

215748427 Con rệp Chúng tôi đã khắc phục sự cố trong đó lệnh Recallkeys trả về lỗi khi thu hồi khoá bằng cách sử dụng cặp khoá và khoá bí mật hiện có.
205524197 Con rệp Tài liệu được cập nhật để thêm danh sách đầy đủ các cấp độ ghi nhật ký. Xem thuộc tính EdgemicroCách đặt cấp độ ghi nhật ký.

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

microgateway core cấu hình trình bổ trợ edgeauth
3.2.3 3.2.3 3.2.3 3.2.3 3.2.2

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

ID vấn đề Loại Nội dung mô tả
192416584 Tính năng

Thuộc tính cấu hình disableStrictLogFile cho phép bạn giảm bớt các quyền nghiêm ngặt đối với tệp trên tệp nhật ký ứng dụng api-log.log. Để biết thông tin chi tiết, hãy xem nội dung Cách giảm bớt các 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 hoạt động của Edge Microgateway 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 nội dung về thuộc tính Edgemicro.

148062415 Con rệp Khắc phục sự cố trong ngữ cảnh vùng chứa Docker, Edge Microgateway không tắt dễ dàng bằng lệnh docker stop {containerId}. Quá trình đã bị vô hiệu hóa nhưng các tệp .sock.pid không bị xoá. Giờ đây, các tệp sẽ 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 Con rệp Khắc phục sự cố, trong đó một số yêu cầu bị kẹt trong hoạt động tải lại nội bộ của cổng vi mô. Vấn đề này không liên tục và xảy ra trong tình huống lưu lượng truy cập cao. Chúng tôi phát hiện thấy sự cố này khi sử dụng các tính năng tokenCachecacheKey của trình bổ trợ OAuth.
183910111 Con rệp Khắc phục vấn đề khi một URL đường dẫn tài nguyên có dấu gạch chéo ở cuối bị diễn giải nhầm thành một đường dẫn tài nguyên riêng biệt. Chẳng hạn, bây giờ, các đường dẫn /country/all/country/all/ được hiểu là một đường dẫn.

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

ID vấn đề Nội dung mô tả
CVE-2020-28503 Các bản sao của gói trước 2.0.5 dễ bị ô nhiễm nguyên mẫu thông qua chức năng chính.
CVE-2021-23343 Mọi phiên bản của trình phân tích cú pháp đường dẫn gói đều dễ bị từ chối dịch vụ (ReDoS) biểu thức chính quy thông qua biểu thức chính quy splitDeviceRe, splitTailRe và splitPathRe. ReDoS thể hiện độ phức tạp của thời gian trong trường hợp xấu nhất của đ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à đ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 của từng dự án thành phần được liên kết với Edge Microgateway 3.2.2. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.2.2 3.2.2 3.2.2 3.2.2 3.2.2

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

ID vấn đề Loại Nội dung mô tả
185323500 Chuyển

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

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

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

188492065 Chuyển Kết thúc hỗ trợ Node.js 8

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

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ì gửi đến 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 này sẽ chuyển hướng stdout và đầu ra lỗi sang một tệp nằm trong vùng chứa tại vị trí: ${APIGEE_ROOT}/logs/edgemicro.log.

Để ngăn việc gửi thông tin nhật ký đế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 phần Sử dụng Docker cho Edge Microgateway.

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

Với tham số -w, --workdir mới để chạy vùng chứa Docker bằng Edge Microgateway, bạn có thể chỉ định đường dẫn đến thư mục mà tại đó các tệp edgemicro.sockedgemicro.pid sẽ được tạo 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 đề bảo mật

ID vấn đề Nội dung 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 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 ô nhiễm sẽ được gán trực tiếp cho mọi đối tượng trong chương trình. Việc này sẽ khiến chương trình gặp rủi ro và có nguy cơ bị từ chối dịch vụ (DoS).
CVE-2021-30246 Trong gói jsrsasign đến 10.1.13 cho Node.js, một số chữ ký RSA PKCS#1 phiên bản 1.5 không hợp lệ bị nhận dạng nhầm là hợp lệ. LƯU Ý: không có cuộc tấn công thực tế nào đã biết.
CVE-2021-23358 Dấu gạch dưới của gói từ 1.13.0-0 và trước 1.13.0-2, từ 1.3.2 và trước 1.12.1 có thể 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ì nó chưa được dọn dẹp.
CVE-2021-29469 Node-redis là một ứng dụng Node.js Redis. 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 dùng để phát hiện các thông báo giám sát có thể dẫn đến việc theo dõi ngược theo cấp số nhân trên một số chuỗi. Vấn đề này có thể khiến thiết bị bị từ chối dịch vụ. Sự cố 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à 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.2.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.2.1 3.2.1 3.2.1 3.2.1 3.2.1

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

ID vấn đề Loại Nội dung mô tả
180362102 Con rệp Khắc phục sự cố khiến các khoá JWK có giá trị rỗng khiến ứng dụng không hoạt động được.

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

Lưu ý: Để khắc phục vấn đề này, bạn phải nâng cấp proxy edgemicro-auth.

179971737 Con rệp Đã khắc phục một sự cố khiến phản hồi trạng thái 4XX / 5XX được ghi lại dưới dạng lỗi proxy cho các proxy edgemicro_*.

Đối với các giao dịch Edge Microgateway, số lỗi mục tiêu không chính xác đã hiển thị trong trang tổng quan phân tích mã lỗi Apigee Edge. Các mã lỗi cho lỗi mục tiêu đượ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 đã được hiển thị.

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

Các sản phẩm API có 3 mã trạng thái: Đang chờ xử lý, Được 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 của Apigee.
  2. Thêm thuộc tính allowProductStatus vào 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 mà bạn muốn 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 Đã 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, các sản phẩm có tất cả cá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 Con rệp Khoá và giá trị bí mật được chuyển vào 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á và giá trị bí mật của Edge Microgateway được truyền qua các đối số dòng lệnh hoặc được đặt thông qua các biến môi trường đã hiển thị trong đối số của trình chạy nút/quy trình con sau khi bắt đầu vi cổng.

Để khắc phục vấn đề này cho trường hợp biến môi trường, các giá trị 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ữa.

Nếu giá trị khoá và giá trị bí mật được chuyển vào dòng lệnh trong khi bắt đầu cổng vào 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 hiển thị trong đối số dòng lệnh của trình khám phá quy trình.

178341593 Con rệp Khắc phục một lỗi tài liệu về trình bổ trợ apikeys.

Tệp README cho trình bổ trợ apikeys chứa không chính xác một thuộc tính gracePeriod. Chúng tôi đã xoá tài sản này và nội dung mô tả 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 dùng trình bổ trợ oauth.

179366445 Con rệp Đã giải quyết một vấn đề khiến tải trọng bị giảm đối với 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 tham số cấu hình mới là edgemicro: enable_GET_req_body. Khi bạn đặ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à một tải trọng GET (nếu có) sẽ được gửi đến mục tiêu. Nếu false (mặc định), tải trọng sẽ tự động bị xoá trước khi gửi yêu cầu đế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 xác định nên 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à 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.2.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.2.0 3.2.0 3.2.0 3.2.0 3.2.0

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

ID vấn đề Loại Nội dung mô tả
152640618 Con rệp Bật trình bổ trợ extauth để đặt tiêu đề x-api-key nhằm 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 có sẵn cho các trình bổ trợ phụ.
168836123, 172295489, 176462355, 176462872 Tính năng Thêm tính năng hỗ trợ cho Node.js 14.
172376835 Con rệp Sử dụng đúng đơn vị thời gian cho điểm cuối /token trong proxy edgemicro-auth.

Chúng tôi đã khắc phục sự cố điểm cuối /token trong proxy edgemicro-auth trả về expires_in trong mili giây. Tuy nhiên, theo Thông số kỹ thuật của OAuth, điểm cuối phải nhất quán với đơn vị thời gian của refresh_token_expires_in (tính bằng giây).

Việc sửa lỗi không thay đổi khoảng thời gian hết hạn mà chỉ thay đổi đơn vị thời gian. Giá trị này chỉ áp dụng cho trường expires_in trong tải trọng phản hồi mã 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. Các trường này được tạo chính xác và luôn sử dụ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ẽ dẫn đến việc làm mới thường xuyên và không cần thiết hơn nhiều. Những ứng dụng này sẽ cần được sửa đổi để tính đến việc thay đổi đơ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á thời gian làm mới mã thông báo, thì ứng dụng không cần thay đổi.

173064680 Con rệp Đã khắc phục một vấn đề trong đó cổng vi dữ liệu kết thúc yêu cầu mục tiêu trước khi tất cả các phần dữ liệu được xử lý.

Đây là một vấn đề không liên tục được quan sát thấy trong các yêu cầu kích thước tải trọng cao và được xuất hiện trong bản phát hành 3.1.7.

174640712 Con rệp Thêm cách xử lý dữ liệu đúng cách vào trình bổ trợ.

Chúng tôi đã thêm cách xử lý dữ liệu đúng cách 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 phần trình bổ trợ cổng micro.

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

microgateway core cấu hình trình bổ trợ edgeauth
3.1.8 3.1.9 3.1.7 3.1.3 3.1.2

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

ID vấn đề Loại Nội dung mô tả
169201295 Con rệp Giá trị số và giá trị boolean được phân tích cú pháp không chính xác trong các thẻ biến môi trường.

Việc thay thế biến môi trường xử lý tất cả các giá trị được phân tích cú pháp 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 yêu cầu và cần có một giá trị số. Sửa lỗi để hỗ trợ các giá trị boolean và số. Xem phần Đặt thuộc tính cấu hình bằng các giá trị biến môi trường để biết thông tin chi tiết về cấu hình.

169202749 Con rệp 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.

Quy trình 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. Xem phần Đặt thuộc tính cấu hình bằng các giá trị biến môi trường để biết thông tin về các giới hạn.

168732942 Con rệp Đã khắc phục sự cố khi 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) một phạm vi không hợp lệ đã được chuyển trong tải trọng yêu cầu đến luồng /token. Chúng tôi đã khắc phục vấn đề để trả về tất cả phạm vi được xác định trong các sản phẩm API trên Apigee Edge.

170609716 Con rệp Đã khắc phục sự cố, trong đó luồng /refresh trong proxy edgemicro-auth đã tạo một JWT không có apiProductList.

170708611 Con rệp Các trình bổ trợ tuỳ chỉnh khô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ợ để xem cách các trình bổ trợ có thể truy cập vào thông tin chi tiết về phạm vi.

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

Khoá và bí mật của Edge Microgateway đã được lưu trong tệp yaml cấu hình bộ nhớ đệm mỗi lần tải lại/bắt đầu. 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ếu khoá và khoá bí mật đã được ghi trước đó trong tệp cấu hình bộ nhớ đệm, thì các giá trị này sẽ bị xoá.

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

Trong các phiên bản cổng nhỏ 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, một tham số cấu hình mới, enableAnalytics, được giới thiệu để bật hoặc tắt trình bổ trợ phân tích. Xem Tài liệu tham khảo về cấu hình để biết thông tin chi tiết.

159571119 Con rệp Nhận được lỗi rỗng trong hook onerror_request trong trình bổ trợ tuỳ chỉnh cho thời gian chờ phản hồi/cổng.

Chúng tôi đã khắc phục các lỗi để điền đúng mã trạng thái HTTP và thông báo lỗi cho các sự kiện onerror_request và thông báo lỗi chính xác 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à 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.1.7. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.1.7 3.1.8 3.1.6 3.1.2 3.1.1

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

ID vấn đề Loại Nội dung mô tả
131708105 Con rệp Trình bổ trợ analytics đã xử lý sai phản hồi rỗng từ các lệnh gọi axpublisher và khiến trình thực thi (worker) thoát ra.

133162200 Con rệp Thông tin về ứng dụng của nhà phát triển không được điền sẵn trong Analytics bằng 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ệ gây ra.

132194290 Con rệp Các bản ghi Analytics sẽ bị loại bỏ khi Apigee Edge từ chối một số bản ghi phân tích.

158618994 Con rệp Kết nối với ứng dụng Redis quá nhiều lần.

161404373 Con rệp Trong trường hợp có phản hồi trạng thái 404, thì thông báo phản hồi sẽ có URI proxy đầy đủ.
166356972 Con rệp

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 đây khi thực thi các trình bổ trợ biến đổi tải trọng yêu cầu:

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

168681746 Con rệp Việc tải lại thủ công Edge Microgateway bằng redisBasedConfigCache:true không hoạt động.

149256174 Con rệp Các lỗi trình bổ trợ OAuth không được ghi lại do lỗi mạng.

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

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

142808699 Con rệp Trình bổ trợ kiểm soát quyền truy cập không xử lý đúng cách các phần "cho phép" và "từ chối".

Cổng vi mô hiện xử lý phần từ chối đúng cách và tuân theo thứ tự của phần "cho phép" và "từ chối". Một thuộc tính noRuleMatchAction mới đã được thêm vào tệp cấu hình vi cổng để cung cấp tính năng tương đương với chính sách AccessControl của Apigee Edge. Xem thêm phần Access Control Plugin README 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à 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.1.6. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.1.6 3.1.7 3.1.5 3.1.1 3.1.1

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

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

Để 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 các phím.

154838259 Con rệp Khắc phục sự 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 các phím.

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

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

159396879 Con rệp Xoá Trình trợ giúp gói không dùng đến
161092943 Con rệp 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ở proxy bị 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 3.1.6):

Giả sử một proxy được định cấu hình bằng đường dẫn cơ sở: /hello/v1 và một đường dẫn mục tiêu đế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 đã giải quyết 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 đã giải quyết 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à chuỗi con của /hello/v1json. Do /hello/v1json không phải là một đường dẫn hợp lệ nên Edge Microgateway đáng ra đã trả về một lỗi 404. Từ phiên bản 3.1.6 trở lên, lỗi 404 sẽ được tạo ra trong trường hợp này.
160431789 Con rệp Trình bổ trợ tuỳ chỉnh – đối tượng cấu hình được truyền vào lệnh khởi tạo 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 phần config.

162758808 Con rệp Cấu hình hạn mức mới cho cửa hàng sao lưu Redis

Bạn có thể sử dụng cấu hình sau để chỉ định kho lưu trữ sao lưu của Redis cho hạn mức. Để biết chi tiết, hãy xem phần Sử dụng kho lưu trữ sao lưu của 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à 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 của 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 chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.1.5 3.1.6 3.1.4 3.1.0 3.1.0

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

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

Một tính năng cấu hình mới đã được thêm vào để bỏ qua việc xử lý trình bổ trợ cho các URL được 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 Con rệp Đã khắc phục các vấn đề với trình bổ trợ json2xml

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

156560067, 159688634 Tính năng

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

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

155077210 Con rệp Đã khắc phục vấn đề định dạng nhật ký.

Đã khắc phục một sự cố khiến máy chủ đích xuất hiện trong nhật ký có thêm dấu hai chấm không liên quan.

153673257 Con rệp

(Edge for Private Cloud only) Các sản phẩm nhận biết vi cổng không kéo được

Đã khắc phục sự cố trong đó các sản phẩm nhận biết cổng vào không được kéo. Vấn đề này chỉ có trên Edge đối với các bản cài đặt trên Đám mây riêng tư.

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 Con rệp Đã khắc phục một vấn đề khiến quy trình Edge Microgateway gặp sự cố khi tệp đích đến 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 ra bảng điều khiển.

155499600 Con rệp 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 phím 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 đề 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. Ngược lại, 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 của phiên bản 3.1.3 đều áp dụng cho bản phát hành này.

3.1.3

Vào thứ Tư, ngày 15 tháng 4 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.1.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.1.3 3.1.3 3.1.3 3.0.14 3.0.9

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

  • 153509313 – Đã khắc phục sự cố khiến mô-đun gỡ lỗi Node.js dẫn đến rò rỉ bộ nhớ. Sự cố này tồn tại trong các phiên bản v3.1.0, 3.1.1 và 3.1.2.
  • 153509313 – Đã khắc phục sự cố trong đó 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 sự cố, trong đó Edge Microgateway không được cập nhật để sử dụng các API Apigee KVM mới. Edge Microgateway hiện sử dụng các lệnh mới để thêm và cập nhật các giá trị KVM.
  • 152822846 – Trong các bản phát hành trước, Edge Microgateway đã được cập nhật để quá trình xử lý ánh xạ đường dẫn tài nguyên khớp với quá trình xử lý của Apigee Edge. Trong bản phát hành này, chúng tôi đã khắc phục một vấn đề trong đó mẫu /literal_string/* không được xử lý chính xác. Ví dụ: /*/2/* Xem thêm phần Định cấu hình hành vi của đường dẫn tài nguyên của "/", "/*" và "/**'.
  • 152005003 – Các thay đổi được thực hiện để bật giá trị nhận dạng trong phạm vi tổ chức và môi trường cho hạn mức.
  • 152005003 – Các thay đổi được thực hiện để bật 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" sẽ được dùng làm giá trị nhận dạng hạn mức.

3.1.2

Vào thứ Hai, ngày 16 tháng 3 năm 2020, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.1.3. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.1.2 3.1.2 3.1.2 3.0.13 3.0.9

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

  • 151285018 – 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, chúng tôi cũng khắc phục các sự cố liên quan đến việc hỗ trợ proxy HTTP hiện có giữa Edge Microgateway và Apigee Edge. Để biết thông tin chi tiết, hãy xem các bài viết sau:
  • 149101890 – Mã thông báo nhật ký trong 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ừ ERROR thành INFO.
  • 150746985 – Đã khắc phục sự cố khiến 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 – Một tính năng nâng cao được thực hiện để đóng kết nối máy chủ nhanh hơn khi trình thực thi đượ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 được dùng để chạy Edge Microgateway trong vùng chứa Docker lên 12, vì Node.js v8 không còn được dùng nữa.
  • 151306049 – Một bản cập nhật tài liệu đã được cập nhật để liệt kê các API quản lý Apigee Edge mà các lệnh CLI của Edge Microgateway sử dụng. Hãy xem phần 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 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.1.1. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.1.1 3.1.1 3.1.1 3.0.13 3.0.9

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 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á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 URL proxy với 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 sau:

    HTTP_PROXY=http://10.128.0.20:3128
  • 146320620 – Thêm thông 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 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 sẽ đặt thuộc tính Node.js Server.headersTimeout theo các yêu cầu. (Mặc định: Nhiều hơn 5 giây so với thời gian đã đặt bằng edgemicro.keep_alive_timeout. Chế độ cài đặt mặc định này giúp ngăn trình cân bằng tải hoặc proxy xoá kết nối nhầm.)

  • 149278885 – Một tính năng mới được thêm vào, cho phép bạn đặt thời gian chờ của 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, thì 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 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 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.1.0. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.1.0 3.1.0 3.1.0 3.0.12 3.0.9

Sửa lỗi và 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" đối với Edge không cập nhật được bộ đếm hạn mức từ xa. Trong trường hợp này, hạn mức sẽ được xử lý dựa trên số lượng cục bộ cho đến khi lần đồng bộ hoá từ xa thành công tiếp theo xảy 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 (Gỡ lỗi).

    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ố khi giao dịch đang thực hiện hoặc giao dịch mới bị ảnh hưởng bất cứ khi nào Edge Microgateway phát hiện thấy thay đổi đối với proxy API. Giờ đây, khi có thay đổi đối với một proxy, Edge Microgateway sẽ làm mới bộ nhớ đệm và các nút trình chạy sẽ khởi động lại. Với thay đổi này, các giao dịch đang diễn ra và các lệnh gọi API mới được gửi tới 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 – Chúng tôi đã khắc phục sự khác biệt giữa độ trễ được tính cho "Hiệu suất proxy API" trong công cụ phân tích Edge và các sự kiện trong nhật ký SourceResponse/targetResponse của Edge Microgateway. Giờ đây, độ trễ trong các sự kiện trong nhật ký của Edge và Microgateway đã được điều chỉnh.
  • 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ợ các mẫu so khớp đường dẫn tài nguyên sau đây như được chỉ định trong Sản phẩm API:
      • /{literal}**
      • /{literal}*
      • 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 cùng một phương thức so khớp như Apigee Edge, như đã giải thích trong phần Định cấu hình hành vi của đường dẫn tài nguyên là '/', '/*' 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 sự cố khi dấu cách ở đầu hoặc cuối trong tham số mã ứng dụng khách khiến việc tạo danh sách sản phẩm JWT bị trống đối với mã thông báo OAuth và các 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 thực thể đặc biệt của Edge Microgateway 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 một cơ sở dữ liệu Redis cục bộ. Sau đó, các thực thể cổng nhỏ khác có thể được định cấu hình để đọc dữ liệu cấu hình của các thực thể đó từ cơ sở dữ liệu. Tính năng này giúp tăng khả năng thích ứng cho Edge Microgateway. Thư viện này cho phép các thực thể cổng vào nhỏ 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 syncrhonizer 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à 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.0.10. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.0.10 3.0.8 3.0.8 3.0.11 3.0.8

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 để việc so khớp mẫu cho các đường dẫn tài nguyên dùng trong các sản phẩm API cho Edge Microgateway nay phù hợp với việc so khớp mẫu đường dẫn tài nguyên mà Apigee Edge sử dụng như mô tả trong phần Định cấu hình hành vi của đường dẫn tài nguyên "/", "/*" và "/**".

    Lưu ý: Nếu sử dụng mẫu tài nguyên phức hợp như /*/2/**, bạn phải đảm bảo thêm proxy edgemicro_auth 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 đây:

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

  • 143740696 – Cấu hình quotas đã thay đổi (xem thêm ghi chú phát hành cho phiên bản 3.0.9). Thuộc tính quotas được dùng để định cấu hình trình bổ trợ hạn mức. Thay đổi về cấu trúc được thực hiện để cải thiện mức độ 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. 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 bài viết Các 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 – Một tính năng mới được thêm vào, cho phép bạn sử dụng Redis làm kho lưu trữ sao lưu hạn mức. Nếu useRedis là true (đúng) thì mô-đun volos-quota-redis sẽ được sử dụng. Khi đúng, hạn mức chỉ giới hạn ở các thực thể Edge Microgateway kết nối với Redis. Nếu giá trị là false, thì mô-đun volos-quota-apigee sẽ được dùng làm kho lưu trữ sao lưu và bộ đếm hạn mức là bộ đếm chung. Để biết thông tin chi tiết, hãy xem phần Các 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 đã thay đổi từ 108.000 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ập nhật để có tham số ‑‑token. Tham số này cho phép bạn sử dụng mã thông báo OAuth để xác thực thay vì tên người dùng/mật khẩu. Để biết thông tin chi tiết, hãy xem phần Tạo khoá.

3.0.9

Vào thứ Sáu, ngày 11 tháng 10, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.0.9. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.0.9 3.0.7 3.0.7 3.0.10 3.0.7

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

  • 141989374 – Một tính năng "chưa báo lỗi" mới được thêm vào 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" tới 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 đồng bộ hoá hạn mức từ xa thành công tiếp theo. Trong cả hai trường hợp này, một cờ quota-failed-open sẽ được đặt trong đối tượng yêu cầu.

    Để bật tính năng "không mở được hạn 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 – Đã thay đổi cấu hình đối với proxy edgemicro-auth để ngăn việc vượt quá hạn mức. Việ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 lên phiên bản 3.0.7 trở lên.
  • 142520568 – Một tính năng mới đã được thêm vào để cho phép ghi nhật ký mã MP (trình xử lý tin nhắn) trong 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 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 về hạn mức từ Edge sẽ chứa mã MP và sẽ được Edge Microgateway ghi lại. Ví dụ:

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

3.0.8

Vào thứ Năm, ngày 26 tháng 9, chúng tôi đã phát hành các bản sửa lỗi và 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.0.8. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.0.8 3.0.6 3.0.6 3.0.9 3.0.6

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

  • 140025210 – Thêm một tính năng mới có tên là "Failed open" (mở thông báo lỗi). 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 ngăn lệnh gọi xác minh khoá API thành công đến proxy edgemicro-auth.

    Tính năng này cho phép bạn đặt thời gian ân hạn, trong đó mã thông báo cũ vẫn còn trong bộ nhớ đệm và được dùng lại cho đến khi thời gian ân hạn kết thúc. 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. Khi khả năng kết nối tiếp tục và lệnh gọi Xác minh khoá API thành công diễn ra, 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 "mở thông báo thất bại" mới, hãy làm như sau:

    1. Đặt các thuộc tính sau trong khổ oauth của tệp cấu hình Edge Microgateway:
      oauth:
        failOpen: true
        failopenGraceInterval: time_in_seconds
        cacheKey: true
        ...

      Ví dụ:

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

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

  • 141168968 – Một bản cập nhật đã được thực hiện để đưa correlation_id vào tất cả đầu ra nhật ký của trình bổ trợ. Ngoài ra, cấp độ nhật ký của một số nhật ký đã được thay đổi thành error theo yêu cầu.
  • 140193349 – Một bản cập nhật đã được thực hiện cho proxy edgemicro-auth để yêu cầu xác minh khoá và khoá bí mật Edge Microgateway trong mọi yêu cầu Xác minh khoá API. Edge Microgateway đã được cập nhật để luôn gửi khoá và khoá bí mật cho 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 khoá API.
  • 140090250 – Chúng tôi đã cập nhật tính năng ghi nhật ký chẩn đoán để 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 phần còn lại của nhật ký Edge Microgateway.

3.0.7

Vào thứ Năm, ngày 12 tháng 9, chúng tôi đã phát hành các bản sửa lỗi và cải tiến sau đây cho 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 của từng dự án thành phần được liên kết với Edge Microgateway 3.0.7. Xin lưu ý rằng vì mỗi thành phần là một dự án riêng biệt nên số bản phát hành có thể không khớp với phiên bản chính của sản phẩm:

microgateway core cấu hình trình bổ trợ edgeauth
3.0.7 3.0.5 3.0.5 3.0.8 3.0.5

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

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

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

    oauth:
      allowNoAuthorization: false
      allowInvalidAuthorization: false
      gracePeriod: 10
      useUpstreamResponse: true
  • 140090623 – Trong bản phát hành 3.0.6, một thuộc tính cấu hình mới được thêm 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, thì điểm cuối hạn mức sẽ mặc định là điểm cuối Edge Microgateway nội bộ. Ví dụ:
    edge_config:
      quotaUri: https://%s-%s.apigee.net/edgemicro-auth

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

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

    đã được ghi lại 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 xảy ra số lượng hạn mức không chính xác nếu một ứ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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

  • 138633700 – Thêm 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 thuộc tính cấu hình mới, quotaUri. Đặt thuộc tính cấu hình này nếu bạn muốn quản lý hạn mức thông qua proxy edgemicro-auth được triển khai cho tổ chức của bạn. Nếu bạn không đặt thuộc tính này, thì điểm cuối hạn mức sẽ mặc định là điểm cuối Edge Microgateway nội bộ. Ví dụ:
    edge_config:
      quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
    

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

  • 138722809 – Thêm 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 chính sách này thành false, dấu vết ngăn xếp sẽ không được in trong nhật ký.

3.0.5

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

Sửa lỗi
  • 139005279 – Đã khắc phục sự cố trong đó lệnh edgemicro status không trả về số lượng quy trình thực thi phù hợp.
  • 138437710 – Đã khắc phục sự cố trong lớp ExitCounter khiến bạn không ghi được nhật ký thích hợp.
Những điểm cải tiến chung về thông điệp nhật ký
  • 139064652 – Thêm chức năng thêm các cấp độ ghi nhật ký tracedebug cho nhật ký sự kiện và nhật ký hệ thống. Hiện tại, chúng tôi chỉ thêm khả năng thêm các cấp độ nhật ký này. Hiện tại, các cấp độ nhật ký có sẵn là info, warnerror.
  • 139064616 – Đầu ra nhật ký đã được chuẩn hoá cho tất cả câu lệnh nhật ký bảng điều khiển. Câu lệnh ghi nhật ký trên bảng điều khiển nay 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 khoá JWT và thông điệp nhật ký bí mật
  • 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 lệnh CLI sau: Chứng chỉ, xác minh, nâng cấpkvm, mã thông báo, genkeys, khoá thu hồi, khoá xoay và định cấu hình.
Cải thiện thông báo lỗi 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ờ của dịch vụ phụ trợ.
  • 138413303 – Thêm và cải thiện khả năng xử lý lỗi đối với thời gian chờ phản hồi và thời gian chờ của ổ cắm.
  • 138414116 – Thêm và cải thiện khả năng xử lý lỗi cho lỗ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à tính năng nâng cao sau đây cho Cổng vi mô Edge.

  • 134445926 - Cải tiến tính năng xác thực cổng vi cổng nội bộ của Edge.
  • 137582169 – Giải quyết sự cố khi các quá trình không mong muốn khởi động. Các quy trình bổ sung này đã khiến các trình bổ trợ phải 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 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ừ đầu ra bảng điều khiển sang tệp nhật ký có liên quan.
    • 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ơ sở đối với vùng đệm hạn mức để cho phép các tính năng nâng cao hạn mức trong tương lai.

3.0.3

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

  • 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() mới có thể 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 trong tiêu đề của yêu cầu.
    • Mã quy trình – Nếu bạn đang chạy một cụm các quy trình Node.js, thì đây là mã 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.
    • 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 chuyển đến thuộc tính lỗi này.
    • Phương thức yêu cầu (nếu yêu cầu HTTP).
    • Mã trạng thái phản hồi (nếu có yêu cầu HTTP).
    • Thông báo lỗi.
    • Mã lỗi – Nếu đối tượng có mã lỗi, thì mã đó 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 dẫn đến các dấu ngoặc vuông trống, [].

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

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

    (137770055)

  • Hiệu suất: Các sản phẩm API không được lọc theo môi trường. Vấn đề này đã được khắc phục. (135038879)
  • 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à tính năng nâng cao sau đây cho Edge Microgateway.

Chất lượng mã – Mã đã được xem xét về chất lượng. Các thay đổi về mã đã được thực hiện để đáp ứng các tiêu chuẩn chất lượng mà người dùng yêu cầu. Chúng tôi đã 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 mã thực tế đã được xác định và sửa chữa. Tất cả mô-đun Apigee Edge Microgateway đều được trải qua quy trình này. Xem thay đổi đối với microgateway-config, microgateway-core, microgateway-pluginsmicrogateway vào ngày 28 tháng 6 và ngày 2 tháng 7. Tất 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ộ giúp xác minh việc thực thi Edge Microgateway cho các trường hợp sử dụng của khách hàng.

3.0.1

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

  • 134834551 – Thay đổi các phiên bản Node.js được hỗ trợ cho Edge Microgateway
    (Các phiên bản Node.js hỗ trợ: 8 và 12; phiên bản 7, 9 và 11 là thử nghiệm)
  • 134751883 - Edge Microgateway gặp sự cố khi tải lại khi tải
  • 134518428 – Điểm cuối của sản phẩm cho Edge Microgateway sẽ trả về 5XX nếu mẫu bộ lọc không chính xác
  • 135113408 - Trình chạy phải khởi động lại nếu họ 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 trình bổ trợ OAuth
  • 135445171 – phép tính dạng GIAI ĐOẠN trong OAuth không chính xác
  • Sử dụng mô-đun đã ghi nhớ được cung cấp khi lắp đặt Edge Microgateway
  • 135367906 – Kiểm tra bảo mật

Phiên bản 2.5.x

Tính năng mới và tính năng nâng cao phiên bản 2.5.x

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

JWT có định dạng không đúng có thể khiến trình thực thi 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 micro của 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 API quản lý. Xem thêm bài viết Quản lý chứng chỉ.

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

Bạn có thể sử dụng cờ mgdebug với edgemicroctl. Hãy xem thêm tác vụ tích hợp với Ubernetes.

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

(Đã thêm 2.5.31) API Edgemicro-auth/mã thông báo mới

Thêm một API Edgemicro-auth/token mới cho phép bạn chuyển ứng dụng khách/mật khẩu dưới dạng tiêu đề Uỷ quyền cơ bản được mã hoá Base64 và Grants_type dưới dạng tham số biểu mẫu. Xem Trực tiếp nhận mã thông báo người nhận.

(Đã 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 đang sử dụng một Tổ chức phát hành chứng chỉ (CA) không được Node.js mặc định tin cậy, thì bạn có thể sử dụng tham số NODE_EXTRA_CA_CERTS khi chạy vùng chứa Docker với 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

(Bổ sung 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 tới máy chủ Edge Microgateway (các yêu cầu phía bắc) và các yêu cầu gửi đi từ Edge Microgateway đến một ứng dụng mục tiêu (các yêu cầu 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:

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

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

(Bổ sung 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 cổng vi cổng chạy phía 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ợ

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

Hỗ trợ mới về mã thông báo OAuth 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.

Tách biệt API trong Analytics Edge

(Bổ sung phiên bản 2.5.26) Các cờ trình bổ trợ phân tích 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 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 các API này 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 Analytics.

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

(Bổ sung 2.5.25) Với một proxy cục bộ, bạn không cần phải tự tạo một proxy nhận biết cổng vào 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 phiên bản 2.5.25) Bạn có thể chạy Edge Microgateway đã bị ngắt kết nối hoàn toàn khỏi mọi phần phụ thuộc Apigee Edge. Trường hợp 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.

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à thông tin bí mật đối với cấu hình Edge Microgateway.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]
Để biết thêm thông tin, hãy xem bài viết Thu hồi khoá.

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

Nhóm hỗ trợ của Ubernetes

(Đã thêm 2.5.19) Bạn có thể triển khai Edge Microgateway dưới dạng dịch vụ hoặc dưới dạng cổng phụ trước các dịch vụ được triển khai trong cụm Kubernetes. Xem bài viết: Tích hợp Edge Microgateway với thông tin tổng quan về Kubernetes.

Hỗ trợ tuỳ chọn sắp xếp nút TCP

(Đã thêm 2.5.16) Một 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 thuật toán Nagle để lưu dữ liệu vào vùng đệm trước khi gửi đi. Việc đặt nodelay thành true sẽ vô hiệu hoá hành vi này (dữ liệu sẽ kích hoạt dữ liệu ngay lập tức mỗi khi socket.write() được gọi). 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 vĩnh viễn

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

Thông sốNội dung mô tả
-f, --fileChỉ định vị trí của tệp forever.json.
-a, --actionstart hoặc stop. Tuỳ chọn mặc định là bắt đầu.

Ví dụ:

Cách bắt đầu vĩnh viễn:

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

Cách dừng vĩnh viễn:

edgemicro forever -a stop

Xoay khoá JWT

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 cho hoạt động bảo mật OAuth trên Edge Microgateway. Xem phần Xoay khoá JWT.

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

Theo mặc định, Edge Microgateway sẽ tải xuống tất cả các proxy trong tổ chức Edge của bạn 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 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ợ 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 mà Edge Microgateway nên được khởi động lại. Tệp này định cấu hình một dịch vụ có tên là forever-monitor. Dịch vụ này sẽ quản lý Forever theo phương thức lập trình. Xem phần Giám sát vĩnh viễn.

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

Nếu chạy nhiều thực thể Edge Microgateway, bạn nên quản lý các cấu hình đó từ một vị trí duy nhất. Bạn có thể thực hiện việc này bằng cách chỉ định một điểm cuối HTTP nơi Edge Micro có thể tải tệp cấu hình xuống. Hãy xem phần 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 2.5.8) 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

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

(Bổ sung 2.5.8) Giờ đây, bạn có thể sử dụng tuỳ chọn --configUrl hoặc -u bằng lệnh edgemicro reload.

Thời gian ân hạn cho các trường hợp chênh lệch thời gian JWT

(Thêm phiên bản 2.5.7) Thuộc tính gracePeriod trong cấu hình OAuth giúp ngăn chặn các lỗi gây ra do sự chênh lệch nhỏ giữa đồng hồ hệ thống và thời điểm Không được trước (nbf) hoặc được phát hành vào (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 phần thuộc tính OAuth.

(Thêm phiên bản 2.5.7) Thuộc tính gracePeriod trong cấu hình OAuth giúp ngăn chặn các lỗi gây ra do sự chênh lệch nhỏ giữa đồng hồ hệ thống và thời điểm Không được trước (nbf) hoặc được phát hành vào (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 phần 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ả trong xoá bộ nhớ đệm.
  • (Vấn đề #234) Tải lại sự cố cho Edge Microgateway 2.5.35.
  • (Vấn đề #135) Lỗi "bảo mật" trong 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 xác thực Edgemicro trước khi triển khai để đảm bảo các 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 theo mặc định và bảo mật).
  • (Vấn đề #141) Lệnh edgemicro reload không hỗ trợ tuỳ chọn tệp cấu hình -c. Đã khắc phục sự cố này.
  • (Vấn đề #142) Edge Microgateway khiếu nại về loại tiền mã hoá không dùng nữa tại thời điểm cài đặt. Đã khắc phục sự cố này.
  • (Vấn đề #145) Hạn mức không hoạt động với Edge Microgateway. Đã khắc phục sự cố này.
  • (Vấn đề về Cộng đồng API: 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ả Proxies API và URI tài nguyên trong OAUTH. Vấn đề này đã được khắc phục.
  • (Vấn đề về Cộng đồng API: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html)) Microgateway không hoạt động với OAuth. Đã khắc phục sự cố này.
  • Sửa pidPath trên Windows.
  • (Vấn đề #157) Sự cố gây ra thông báo lỗi sau đây đã được khắc phục: ReferenceError: deployProxyWithPassword chưa được xác định.
  • (Vấn đề #169) Cập nhật 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 Edge JWT. Proxy không còn phụ thuộc vào Node.js để cung cấp khả năng hỗ trợ JWT.

Phiên bản 2.4.x

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

1. Đặt bí danh tuỳ chỉnh cho proxy xác thực Edgemicro (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 trên lệnh edgemicro configuration (Cấu hình cạnh nhỏ).

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 proxy edgemicro_*. Ví dụ: đường dẫn cơ sở là /team/*/members cho phép khách hàng gọi https://[host]/team/blue/membershttps://[host]/team/green/members mà 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 thành phần đầu tiên của đường dẫn cơ sở. Ví dụ: mã nà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 Đám mây riêng tư (PR 99)

Theo mặc định, tệp cấu hình cổng vào nằm trong ./config/config.yaml. Giờ đây, trên các lệnh init, cấu hình và bắt đầu, bạn có thể chỉ định một đường dẫn cấu hình tuỳ chỉnh trên dòng lệnh bằng cách sử dụng cờ -c hoặc --configDir. Khắc phục vấn đề không nhận dạng được thư mục cấu hình tuỳ chỉnh cho các 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 Edge trong đám mây công cộng, thì bạn nên cân nhắc hai phương án sau đây:

Cách 1:

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

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

Khi proxy_tunneltrue, Edge Microgateway sẽ sử dụng phương thức HTTP CONNECT để tạo đường hầm các yêu cầu HTTP qua một kết nối TCP. (Điều này cũng xảy ra nếu các biến môi trường dùng để định cấu hình proxy đều đượ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ổ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ủ cho mỗi proxy HTTP mà bạn muốn sử dụng hoặc các máy chủ không được phép xử lý các proxy Microgateway của Edge: 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à Edge Microgateway không nên 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ã trạng thái 504.

6. Tuân thủ các thông báo trạng thái HTTP tuỳ chỉnh đối với 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 gửi từ mục tiêu sẽ bị ghi đè bằng các giá trị mặc định của Node.js.

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

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

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

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

Trình bổ trợ OAuth bổ sung 2 cờ mới:

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

  • allowAPIKeyOnly – Nếu đặt thành true, mọi API phải mang một tiêu đề x-api-key (hoặc một vị trí tuỳ chỉnh) cùng với một 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 tiến proxy xác thực Edgemicro (PR 40)

Chúng tôi đã cải tiến proxy edgemicro-auth. Trước khi có những thay đổi này, proxy lưu trữ khoá trong Edge Secure Store (một kho lưu trữ được 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 đích, rồi 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 true, hãy xem chuỗi thảo luận này để biết thêm thông tin.

11. Hỗ trợ ban đầu cho 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 cho việc 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 trong lệnh edgemicro Configure:

-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 vấn đề trong đó tổ chức có trả phí cần phải chạy proxy xác thực Edgemicro đúng cách. Giờ đây, bạn cũng có thể sử dụng Edge Microgateway với các tổ chức thử nghiệm. (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. Lỗi 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 Đám mây riêng tư. (PR 110)
  • Khắc phục vấn đề về SSL hai chiều giữa ứng dụng khách và Edge Microgateway. (Puerto Rico 70)
  • Khắc phục vấn đề bắt buộc phải có dấu gạch chéo ở cuối trên đường dẫn cơ sở proxy để quy trình xác minh khoá API hoạt động đúng cách. Hiện tại, không cần thêm dấu gạch chéo ở cuối đường cơ sở. (Puerto Rico)

Phiên bản 2.3.5

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

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

Ẩn giấu dữ liệu của 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 Edge. Thêm phần sau vào cấu hình cổng vào nhỏ để 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à các phần đường dẫn của yêu cầu.

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

Phiên bản 2.3.3

Tính năng mới và cải tiến 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 trong bản phát hành này.

Tắt tính năng kiểm tra sự thay đổi tự động

Bạn có thể tắt tính năng kiểm tra sự thay đổi tự động bằng cách thiết lập thuộc tính này trong cấu hình cổng vào:

disabled_config_poll_interval: true

Theo mặc định, tính năng thăm dò định kỳ sẽ chọ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ổng vào nhỏ, 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).

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

Bạn có thể ghi đè URL mục tiêu 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 sau trong mã trình bổ trợ: req.targetHostnamereq.targetPath.

Chữ ký 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ố. Việc bổ sung này giúp các 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á kết quả ghi nhật ký mặc định

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

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

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

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

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

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ợ. Quy trình này hiện đang hoạt động theo cách giải thích trong tài liệu.
  • Trình bổ trợ yêu cầu tích luỹ trình bổ trợ không còn bị treo cho các yêu cầu GET.
  • Khắc phục sự cố trong trình bổ trợ phản hồi tích luỹ, trong đó việc thiếu nội dung phản hồi đã gây ra lỗi.

Bản phát hành 2.3.1

Ghi chú 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 để biết thêm chi tiết.

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 trong 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, vi cổng đã tải tất cả các proxy nhận biết cổng vi cổng (các proxy có tên là Edgemicro_*) được lấy từ tổ chức/môi trường Edge mà bạn đã chỉ định trong lệ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 để Edge Microgateway chỉ tải những proxy mà bạn chỉ định. Chỉ cần thêm phần tử proxy vào tệp cấu hình 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ả những 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 hành động cố gắng gọi các proxy nhận biết cổng vào 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ó 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 đề của yêu cầu mục tiêu: một mẫu khi yêu cầu đến chứa dữ liệu (như trong yêu cầu POST) và một mẫu không chứa dữ liệu (như trong 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 đặt tiêu đề của yêu cầu cho yêu cầu mục tiêu. Trong các phiên bản trước của Edge Microgateway, bạn không thể đặt tiêu đề mục tiêu một cách chính xác trong trường hợp này.

Chìa khoá cho mẫu này là trước tiên cần tích luỹ tất cả dữ liệu nhận được từ ứng dụng khách. Sau đó, trong hàm onend_request(), 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. 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 chứa 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 – đã được ghi lại trước đó và được sử dụng trong các trình bổ trợ mẫu do Edge Microgateway cung cấp.

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 khi không hoạt động

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

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

  • edgemicro status – Kiểm tra xem Edge Microgateway có đang chạy hay không.
  • edgemicro stop – Dừng cụm Edge Microgateway.
  • edgemicro reload – Tải lại cấu hình Edge Microgateway mà không 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 cấu hình mới theo định kỳ và thực thi tải lại nếu có thay đổi. Cuộc thăm dò ý kiến này chọn ra 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ổng vào vi mô, 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 cổng vào nhỏ như sau:

edgemicro:
    config_change_poll_interval: [seconds]

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

Một cờ --version đã được thêm vào CLI. Để tải phiên bản Edge Microgateway hiện tại, hãy sử dụng:

edgemicro --version

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

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

Lựa chọn Nội dung 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 chứng chỉ đáng tin cậy ở định dạng PEM.
ciphers Một chuỗi mô tả thuật toán mật mã cần sử dụng và phân tách bằng dấu ":".
rejectUnauthorized Nếu đúng, chứng chỉ máy chủ được xác minh dựa trên danh sách CA được cung cấp. Nếu xác minh không thành công, hệ thống sẽ trả về lỗi.
secureProtocol Phương pháp SSL mà bạn nê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 (Chỉ báo tên máy chủ) DEX.

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

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

edgemicro:
  logging:
    to_console: true  

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

Phiên bản 2.1.2

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

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

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

  • edgeconfig:verify_api_key_url
  • edgeconfig:products

Để biết 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à tính năng nâng cao trong 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 proxy uỷ quyền Edge Microgateway cho Edge sẽ tương thích trên các hệ thống Windows.

Phiên bản 2.1.0

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 của ứng dụng khách

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

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 để biết thêm chi tiết.

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 một 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. Hãy xem phần lệnh bắt đầu để biết thông tin chi tiết.

Không bắt buộc giữ lại các tiêu đề xác thực

Chế độ cài đặt cấu hình mới, keepAuthHeader, cho phép bạn giữ lại tiêu đề Uỷ quyền được gửi trong yêu cầu. Nếu bạn đặt chính sách này thành true (đúng), thì tiêu đề Xác thực sẽ được chuyển đến mục tiêu. 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. Để 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 v.2.0.4 được phát hành vào ngày 25 tháng 5 năm 2016.

Tính năng mới và cải tiến phiên bản 2.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. Các đườ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ố của đườ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 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 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 v2.0.0 được phát hành vào ngày 18 tháng 4 năm 2016.

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ủ xử lý đơn

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

Tệp cấu hình được giãn cách tên

Các tệp cấu hình hiện được đặt không gian tên bằng cách sử dụng tổ chức và môi trường để nhiều 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 chạy lệnh config của Edge Microgateway.

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

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

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

Edge Microgateway sẽ sử dụng tệp cấu hình đã lưu vào bộ nhớ đệm nếu khởi động lại mà không có kết nối nào 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 lõi. 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

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

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ổng hợp kết nối tốt hơn. Tính năng nâng cao này giúp cải thiện hiệu suất và độ ổn định tổng thể trong tình trạng 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 bằng một trình gỡ lỗi từ xa, chẳng hạn như node-Inspector.

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 hiện sẽ được sao chép vào ~./edgemicro/config.yaml.

Xoay vòng tệp nhật ký

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

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

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

Nội dung mô tả
Chú thích Java cho proxy nội bộ Edgemicro dùng với Edge trên cơ sở hạ tầng riêng hiện sử dụng máy chủ MGMT phù hợp.
Xoá các phần phụ thuộc tập lệnh máy chủ (typescript) khỏi tác nhân.
Sửa lỗi CLI khi sử dụng tuỳ chọn triển khai tinh gọn.
Sửa tệp tham chiếu phần phụ thuộc logic chứng chỉ.