19.03.01 – Ghi chú phát hành Apigee Edge về Đám mây công khai

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

Vào thứ Ba, ngày 3 tháng 12 năm 2019, chúng tôi bắt đầu phát hành bản cập nhật cho phiên bản Apigee Edge này cho Đám mây công cộng. (Bản phát hành ban đầu là vào thứ Năm, ngày 18 tháng 4 năm 2019.)

Thông tin cập nhật và tính năng mới

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

ID vấn đề Tên thành phần Mô tả
Apigee bắt đầu phát hành các bản cập nhật sau đây từ ngày 1 tháng 10 năm 2019
110995050 Thời gian chạy API

Cân bằng tải – kiểm soát tốt hơn việc loại bỏ các máy chủ gặp sự cố

Khi định cấu hình bộ cân bằng tải cho một proxy API, bạn có thể xác định số lần phản hồi không thành công xảy ra trước khi một máy chủ bị xoá khỏi vòng cân bằng tải. Lỗi phản hồi có nghĩa là Apigee không nhận được phản hồi nào từ máy chủ đích. Khi điều này xảy ra, bộ đếm lỗi sẽ tăng thêm một. Khi Apigee nhận được phản hồi từ một đích đến, ngay cả khi phản hồi đó là lỗi HTTP (chẳng hạn như 500), thì phản hồi đó vẫn được tính là phản hồi từ máy chủ đích và bộ đếm lỗi sẽ được đặt lại. Để đảm bảo rằng các phản hồi HTTP không hợp lệ (chẳng hạn như 500) cũng làm tăng bộ đếm lỗi để loại bỏ máy chủ không hoạt động khỏi vòng cân bằng tải càng sớm càng tốt, bạn có thể thêm một phần tử <ServerUnhealthyResponse> mới có các phần tử con <ResponseCode> vào cấu hình trình cân bằng tải. Edge cũng sẽ coi những phản hồi có mã đó là phản hồi không thành công.

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  
130416715 Bảo mật

Các điểm cải tiến về chính sách AccessControl

Chính sách AccessControl xác định những địa chỉ IP có thể gọi đến một proxy API. Một phần tử mới trong chính sách đó giúp nhà phát triển API có thêm quyền kiểm soát trong việc xác định địa chỉ IP cần đánh giá.

<IgnoreTrueClientIPHeader>: Không bắt buộc (mặc định là false). Khi bạn đặt chính sách này thành true, chính sách sẽ bỏ qua tiêu đề True-Client-IP và đánh giá địa chỉ IP trong tiêu đề X-Forwarded-For, theo hành vi đánh giá X-Forwarded-For mà bạn đã định cấu hình.

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
Apigee đã phát hành những nội dung cập nhật sau đây vào ngày 18 tháng 4 năm 2019
117558815,
119856499,
110548137,
79526748,
72989449,
70712859,
69049041
Thời gian chạy API JWS và JWT
Chúng tôi đã bổ sung các chính sách mới để hỗ trợ JWS và cải thiện các chính sách hiện có về JWT.

Để biết thông tin chi tiết, hãy xem bài đăng này trên Cộng đồng.

122610025 Thời gian chạy API Cho phép RaiseFault đặt lý do lỗi và các biến tuỳ ý như trong AssignMessage

Hai phần tử mới có trong chính sách RaiseFault giúp việc xử lý FaultRules trở nên gọn gàng và mạnh mẽ hơn.

  • ShortFaultReason là một giá trị boolean. Khi được đặt thành true, giá trị này sẽ đặt tên chính sách vào biến fault.reason.
  • AssignVariable (có trong FaultResponse) cho phép bạn chỉ định phản hồi lỗi cho một biến để các chính sách khác sử dụng trong luồng proxy API.
121149811 Mục tiêu được lưu trữ Giới hạn được áp dụng cho Mục tiêu được lưu trữ

Hiện tại, chúng tôi đang áp dụng các giới hạn cho Mục tiêu được lưu trữ. Xem phần Giới hạn để biết thông tin chi tiết về các giới hạn.

117659213 Thời gian chạy API Tham số hoá dải IP trong chính sách AccessControl

Giờ đây, bạn có thể sử dụng các biến mẫu thông báo để đặt địa chỉ IP và mặt nạ CIDR trên chính sách AccessControl. Ví dụ: nếu muốn lưu trữ địa chỉ IP và mặt nạ trong bản đồ khoá giá trị (KVM), bạn có thể truy xuất các giá trị đó từ một biến mà bạn đặt trong luồng proxy API. Điều này giúp bạn thay đổi các giá trị IP dễ dàng hơn trong thời gian chạy mà không cần phải thay đổi cấu hình chính sách.

Ví dụ: thay vì:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

Bạn có thể định cấu hình chính sách như sau, giả sử các giá trị được lưu trữ trong KVM và bạn sử dụng chính sách KeyValueMapOperations để truy xuất các giá trị và chỉ định các giá trị đó cho các biến xuất hiện ở đây:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     
113599885 Giám sát API Các vai trò Giám sát API

Tính năng Giám sát API cung cấp 2 vai trò: Quản trị viên giám sát API và Người dùng giám sát API, như mô tả trong phần Truy cập vào tính năng Giám sát API. Các tính năng này được cung cấp từ tháng 12 năm 2018.

132256772 Thời gian chạy API Tiêu đề X-Apigee.Message-Timeout được thêm vào yêu cầu

Giờ đây, Edge sẽ thêm tiêu đề X-Apigee.Message-Timeout vào mỗi yêu cầu. Tiêu đề này được Edge sử dụng nội bộ. Đừng dựa vào các giá trị trong tiêu đề X-Apigee.* trong các proxy API của bạn vì các tiêu đề này không dành cho khách hàng sử dụng và Apigee có thể xoá hoặc thay đổi bất cứ lúc nào.

78575018 Đám mây riêng tư / OPDK Bỏ qua máy chủ quản lý để bỏ qua quy trình đăng ký kho dữ liệu của cổng khi có nhiều nhóm cổng

Lỗi đã khắc phục

Các lỗi sau đây đã được khắc phục trong bản phát hành này. Danh sách này chủ yếu dành cho những người dùng kiểm tra xem phiếu yêu cầu hỗ trợ của họ đã được giải quyết hay chưa. Báo cáo này không được thiết kế để cung cấp thông tin chi tiết cho tất cả người dùng.

ID vấn đề Tên thành phần Mô tả
Apigee bắt đầu phát hành các bản sửa lỗi sau đây từ ngày 3 tháng 12 năm 2019
Bản sửa lỗi bảo mật.
Apigee bắt đầu phát hành các bản sửa lỗi sau đây từ ngày 29 tháng 10 năm 2019
139381794 Máy chủ quản lý

Xử lý lỗi xoá kho khoá để lệnh gọi API không bị lỗi

Apigee bắt đầu phát hành các bản sửa lỗi sau đây từ ngày 1 tháng 10 năm 2019
140761319 Thời gian chạy API

x-apigee.edge.execution.sense.action luôn được đặt thành giá trị rỗng

139091614 Thời gian chạy API

Trong chính sách ResponseCache, NIOTheread đang thực thi mà không bị từ chối từ nhóm luồng

131331305 Các dịch vụ cốt lõi

Nhiều trình xuất nhật ký trên các bộ định tuyến Apigee gây ra mức sử dụng CPU cao

136690640 Thời gian chạy API

Lỗi 404 không liên tục ở một số tổ chức cụ thể

140948100 Thời gian chạy API

Luồng dùng chung đã triển khai không thực thi trên một số trình xử lý thông báo

Apigee đã phát hành các bản sửa lỗi sau vào ngày 13 tháng 9 năm 2019
132654321 Máy chủ quản lý Nhật ký kiểm tra không hiển thị dữ liệu
131246911 Máy chủ quản lý Đối với email của nhà phát triển trong một cổng thông tin, hãy bật tính năng hỗ trợ cho các miền mới hơn như *.games, *.asia
Apigee đã phát hành các bản sửa lỗi sau vào ngày 18 tháng 4 năm 2019
123844598 Máy chủ quản lý Bạn không thể nhập lại các khoá ứng dụng đã xoá sau 24 giờ
123588156 Thời gian chạy API Việc xoá tiêu đề Content-Length khỏi phản hồi sẽ không thành công với mã 304
122732400 Thời gian chạy API Setting api.timeout overrides io.timeout.millis
122545281 Thời gian chạy API Mặt nạ dữ liệu DebugSession cho JSON nên xem xét trường hợp jsonPayload là một mảng
122355807 Máy chủ quản lý Hành vi cấp quyền không chính xác đối với người dùng có nhiều vai trò
121393556 Thời gian chạy API x_apigee_fault_code được đặt thành "org/codehaus/jackson/map/ObjectMapper"
120998548 Giao diện người dùng Edge Lỗi chính tả trong thông báo lỗi: Chứng chỉ không hợp lệ hoặc không đáng tin cậy
120990929 Thời gian chạy API Phản hồi HTTP-413 từ Nginx/Apigee-Router cho thấy loại máy chủ
120799489 Thời gian chạy API Khi sử dụng httpClient với lệnh gọi lại JavaScript không đồng bộ httpComplete(), đầu ra debugsession (trace) sẽ bị tắt
120794339 Thời gian chạy API Các điểm đánh dấu bị trôi cho tổ chức
120277011 Máy chủ quản lý Cần xác thực dữ liệu đầu vào: Không thể triển khai proxy nếu tên máy chủ đích có **
119976417 Giám sát API Tính năng Giám sát API cho thấy thời gian phản hồi của proxy cao, trong khi số liệu phân tích cho thấy thời gian phản hồi của mục tiêu cao
119947481 Thời gian chạy API Trong trường hợp ngoại lệ, trọng tải cần che sẽ được ghi lại dưới dạng văn bản thuần tuý
119877164 Đám mây riêng tư / OPDK Bộ định tuyến tạo ra lỗi, bộ xử lý thông báo chuyển sang chế độ ngoại tuyến khi bật TLS

Bản sửa lỗi này sẽ có trong bản phát hành Edge cho Đám mây riêng tư tiếp theo.

119816218 Thời gian chạy API Bộ nhớ đệm phản hồi bỏ qua tiêu đề Hết hạn nếu tiêu đề này phân giải thành 0 hoặc số âm
119770242 Thời gian chạy API Không giao tiếp được giữa bộ định tuyến và MP, dẫn đến thời gian ngừng hoạt động hoàn toàn: Lỗi trong PostClientFlow gây ra vòng lặp vô hạn
119443145 Máy chủ quản lý API proxy trả về 404 khi ProxyEndpoint được đổi tên và triển khai lại
119260281 Thời gian chạy API Lỗi nhật ký "Không thể phân tích cú pháp thành string3000.0"
118743407 Máy chủ quản lý Thời gian triển khai proxy Apigee
118447966 Thời gian chạy API Lỗi chú thích JavaScript trong MP Release 180608_07
117549719 Thời gian chạy API URI yêu cầu và đường dẫn cơ sở của proxy không khớp
117219520 Thời gian chạy API MessageLogging: Trình ghi nhật ký Syslog sử dụng định dạng ngày không chính xác theo mặc định, hiển thị sai số mili giây
117116435 Thời gian chạy API Lỗi không liên tục từ tệp JavaScript
117091520 Thời gian chạy API JavaCallout không hoạt động sau khi phát hành trình xử lý thông báo 18.06.08
116165318 Thời gian chạy API Việc triển khai đồng thời cùng một gói gây ra RepositoryException
116055025 Dịch vụ Configstore Bộ xử lý tin nhắn bị thiếu máy chủ ảo và ứng dụng sau khi khởi động
115614498 Thời gian chạy API Cần được hỗ trợ về ILB trong OPDK

Bản sửa lỗi này sẽ có trong bản phát hành Edge cho Đám mây riêng tư tiếp theo.

113972537 Thời gian chạy API Nhiều P1 – NullPointerException được tạo từ mã Node.js trong các proxy Trireme – 500 Lỗi máy chủ nội bộ
113904969 Dịch vụ hỗ trợ Apigee Vấn đề khi xoá các proxy API trong tổ chức minh hoạ
113554802 Thời gian chạy API Xác thực câu khẳng định SAML không thành công với NullPointerException
113315737 Máy chủ quản lý Không triển khai được proxy do thiếu bản ghi triển khai trong Zookeeper
112767195 Thời gian chạy API Lỗi DataStore không liên tục khi truy cập vào chính sách KVM
112162179 Thời gian chạy API Việc lưu một đối tượng JavaScript vào bộ nhớ đệm mà không chuyển đổi đối tượng đó thành chuỗi có thể dẫn đến tình trạng bế tắc
111860576 Thời gian chạy API Lỗi thiếu thông tin trong Chính sách về hạn mức
111671525 Mục tiêu được lưu trữ Mã phản hồi không thành công từ các mục tiêu được lưu trữ sẽ kích hoạt quy trình lỗi trong proxy
111523933 Tiện ích(Trình kết nối) Vấn đề về lưu vào bộ nhớ đệm chính sách ExtensionCallout
111420263 Thời gian chạy API Ngoại lệ ConcurrentModification trong MessageLogging
110843526 Máy chủ quản lý Management API để tạo/cập nhật lệnh gọi flow phải xác thực flow dùng chung
110805739 Thời gian chạy API TTL không được đặt thành -1 trong quy trình CPS khi Reuserefreshtoken là true và thời gian hết hạn của mã làm mới không được đặt một cách rõ ràng
110429629 Thời gian chạy API Chính sách BasicAuthentication phát ra biến request.headers.Authorization vào DebugSession
110425503 Thời gian chạy API Việc tải lại Nginx gây ra vấn đề về tình trạng còn hàng của MP
110311540 Thời gian chạy API NPE khi MP đang tắt
110161455 Thời gian chạy API AccessEntity nên sử dụng phương thức tìm nạp theo tên ứng dụng thay vì tìm nạp tất cả ứng dụng cho các tổ chức CPS
90695522 Thời gian chạy API context.proxyRequest.asForm generates java.lang.ArrayIndexOutOfBoundsException: 1
79734096 Máy chủ quản lý Nhật ký kiểm tra cho các proxy không còn lọc trên các proxy nữa
78105568 Máy chủ quản lý Các hoạt động triển khai luồng dùng chung không xuất hiện trong các lệnh gọi API quản lý /org/{org}/sharedflows/{sharedflow}/deployments sau khi cập nhật một luồng dùng chung đã triển khai
77528868 Trireme Trireme regression: Script server.js exited with status code -1: Property 0 not found
73766568 Thời gian chạy API Việc nâng cấp 170213_02 lên 171117_01 đã làm tăng đáng kể độ trễ cho proxy có đích đến Trireme/Node
72710481 Thời gian chạy API CacheServiceImpl/CacheMemoryLimiter NullPointerException
68861063 Thời gian chạy API Xử lý NPE trong quá trình tắt bộ định tuyến
68833699 Thời gian chạy API Thông tin về proxy API đôi khi không bị xoá khỏi Cây phân loại API
67377575 Mục tiêu được lưu trữ Dữ liệu phân tích không khớp với dữ liệu được gửi cho khách hàng trong một proxy Node.js
112481174 Mục tiêu được lưu trữ Không thất bại khi huỷ triển khai proxy do lỗi Turbo
117171470 Mục tiêu được lưu trữ Khắc phục thông báo lỗi app.yaml không hợp lệ
67169139 Thời gian chạy API Định dạng dấu thời gian syslog của chính sách MessageLogging không chính xác
67165418 Thời gian chạy API Lỗi cấp phép về việc sử dụng nhiều trình xử lý thông báo hơn ngay cả khi sử dụng ít hơn số lượng được cấp phép

Bản sửa lỗi này sẽ có trong bản phát hành Edge cho Đám mây riêng tư tiếp theo.

67165195 Thời gian chạy API ValidateSAMLAssertion không xác minh chữ ký trên một Xác nhận được nhúng trong Phản hồi đã ký
66214414 Thời gian chạy API Biến currentstep.flowstate luôn trả về "SHARED_FLOW" khi được tham chiếu từ một quy trình dùng chung
65731656 Thời gian chạy API API bảo vệ khỏi mối đe doạ thỉnh thoảng không hoạt động đối với cùng một yêu cầu
133197060 Thời gian chạy API Nhận được lỗi 57 Hết thời gian chờ cổng từ MP đến mục tiêu
110535186 Thời gian chạy API ServiceCallout không có phần tử Phản hồi và HTTPTargetConnection trỏ đến proxy: ĐÔI KHI không có lệnh gọi
132443137 Thời gian chạy API Thay đổi hành vi của Trình xử lý thông báo để bỏ qua các tiêu đề bắt đầu bằng X-Apigee-*. Do đó, bạn phải tái cấu trúc mọi mã sử dụng tiêu đề X-Apigee-* và thay thế các tiêu đề đó bằng những tiêu đề được hỗ trợ.
125709964 Thời gian chạy API Invalidate Cache with purgeChildEntries không hoạt động như mong đợi