16.08.17 – 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.
Chuyển đến Tài liệu về Apigee X.
thông tin

Vào thứ Ba, ngày 30 tháng 8 năm 2016, chúng tôi đã phát hành phiên bản Apigee Edge mới cho Public Cloud.

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

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

Tải trọng JSON trong Chỉ định Thông báo và báo cáo lỗi

Khi đặt tải trọng JSON bằng chính sách Chỉ định thông báo hoặc "Tăng lỗi", đôi khi người dùng bắt buộc phải sử dụng giải pháp nhằm đảm bảo thông báo JSON được định dạng đúng trong thời gian chạy, chẳng hạn như bắt đầu tải trọng bằng dấu gạch chéo ngược "\" hoặc chỉ định một VariablePrefix vàvariableSuffix trên phần tử Tải trọng, ngay cả khi không có biến nào được sử dụng trong thông báo.

Với tính năng nâng cao này, bạn không cần giải quyết vấn đề gì để đảm bảo định dạng thông báo JSON đúng cách và có thể chỉ định biến bằng dấu ngoặc nhọn mà không tạo JSON không hợp lệ. Ví dụ: sau đây sẽ chèn giá trị của message.content trong thông báo JSON:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

Nếu bạn đã áp dụng một giải pháp, mã của bạn sẽ tiếp tục hoạt động như cũ. Bạn cũng có thể sử dụng BiếnPrefix và VariableSuffix thay vì dấu ngoặc nhọn để biểu thị các biến.

Hãy xem phần <Set><Payload> trong Chính sách gán tin nhắnChính sách về lỗi lớn hơn tài liệu tham khảo. (APIRT-1160)

Cải tiến chính sách từ XML sang JSON

Chúng tôi đã cải thiện chính sách XML thành JSON với các chức năng sau. Bạn có thể định cấu hình chính sách nhằm:

  • Coi một số phần tử XML như các mảng trong quá trình chuyển đổi, các phần tử này đặt các giá trị ở dạng hình vuông dấu ngoặc vuông '[ ]' trong tài liệu JSON.
  • Xoá hoặc loại bỏ các cấp của hệ phân cấp tài liệu XML trong tài liệu JSON cuối cùng.

Để biết thêm thông tin, xem phần XML chính sách JSON. (APIRT-1144)

Nhiều ký tự đại diện trong Đường dẫn tài nguyên sản phẩm API

Khi xác định đường dẫn tài nguyên trong Sản phẩm API, bạn có thể đưa ký tự đại diện vào nhiều vị trí trong một đường dẫn tài nguyên. Ví dụ: /team/*/invoices/** cho phép gọi API bằng bất kỳ một giá trị sau /team và mọi đường dẫn tài nguyên sau invoices/. URI được phép trên lệnh gọi API sẽ là proxyBasePath/team/finance/invoices/company/a.

Nếu sau bản phát hành này, đường dẫn tài nguyên sản phẩm API hiện có không hoạt động như mong đợi, hãy đặt thuộc tính sau trên tổ chức của bạn để chuyển về thuộc tính trước hành vi: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Hàm mã hoá trong JavaScript

Đã có một bộ hàm crypto JavaScript mới, hiệu suất cao để tạo, tải và cập nhật các đối tượng sau đây có các đối tượng: MD5, SHA-1, SHA256, SHA512. Đối tượng Crypto cũng cho phép bạn lấy ngày ở nhiều định dạng. Để biết thêm thông tin, hãy xem bài viết Mô hình đối tượng JavaScript. (APIRT-2886)

Phiên bản JAR của chú thích Java đang kiểm tra

Khi tải tài nguyên Java JAR lên proxy API, mã trạng thái HTTP 400 sẽ được trả về (thay vì 500) nếu phiên bản của tài nguyên Java không tương thích với phiên bản Edge được hỗ trợ phiên bản Java, được liệt kê trong Phần mềm được hỗ trợ và phiên bản được hỗ trợ. (MGMT-3420)

Xác thực tài nguyên proxy API

Khi bạn có các tệp tài nguyên proxy API (chẳng hạn như JavaScript hoặc JAR Java) được lưu trữ tại môi trường hoặc tổ chức, khung xác thực không còn yêu cầu bạn cũng đưa các tài nguyên đó ở cấp độ proxy API vào gói proxy để nhập nhằm vượt qua quá trình xác thực. Việc xác thực tài nguyên hiện diễn ra tại thời điểm triển khai, chứ không phải tại thời điểm nhập. (MGMT-1430)

Định cấu hình thời gian chờ cho các proxy API riêng lẻ

Bạn có thể định cấu hình proxy API để hết thời gian chờ sau một khoảng thời gian được chỉ định (với thời gian chờ cổng vào 504 trạng thái). Trường hợp sử dụng chính là dành cho những khách hàng sử dụng Cloud riêng tư có proxy API cần thời gian thực thi lâu hơn. Ví dụ: giả sử bạn cần các proxy cụ thể để hết thời gian chờ ở 3 phút. Bạn có thể sử dụng một thuộc tính api.timeout mới trong cấu hình cho proxy API. Dưới đây là cách thực hiện bạn sẽ làm điều đó với ví dụ 3 phút:

  1. Trước tiên, hãy nhớ định cấu hình trình cân bằng tải, bộ định tuyến và trình xử lý thông báo để hết thời gian chờ sau 3 phút.
  2. Sau đó, hãy định cấu hình các proxy có liên quan để hết thời gian chờ sau 3 phút. Chỉ định giá trị trong mili giây. Ví dụ:
    <ProxyEndpoint name="default">
      <HTTPProxyConnection>
        <BasePath>/v1/weather</BasePath> 
        <Properties> 
          <!-- api.timeout is in milliseconeds -->
          <Property name="api.timeout">180000</Property>
        </Properties>
        ...
  3. Tuy nhiên, lưu ý rằng việc tăng thời gian chờ của hệ thống có thể dẫn đến các vấn đề về hiệu suất, vì tất cả các proxy không có chế độ cài đặt api.timeout sẽ dùng trình cân bằng tải, bộ định tuyến và trình xử lý thư hết thời gian chờ. Vì vậy, hãy định cấu hình các proxy API khác không yêu cầu thời gian chờ lâu hơn để sử dụng thời gian chờ thấp hơn. Ví dụ: lệnh sau đây đặt một proxy API hết thời gian chờ sau 1 phút:
    <Property name="api.timeout">60000</Property>

Khách hàng Cloud (những người không thể sửa đổi thời gian chờ của Edge cũng có thể định cấu hình thời gian chờ proxy API, miễn là thời gian chờ ngắn hơn thời gian chờ tiêu chuẩn của trình xử lý tin nhắn Edge là 57 giây.

Bạn không thể điền giá trị bằng biến. Cơ sở lưu trú này thuộc phạm vi điều chỉnh của Tài liệu tham khảo về thuộc tính điểm cuối. (APIRT-1778)

TLS/SSL để ghi nhật ký thư Chính sách

Bạn có thể đặt <KeyStore><TrustStore> trong Cấu hình SSLInfo trên chính sách Ghi nhật ký tin nhắn, cho phép TLS/SSL một và hai chiều bằng dịch vụ ghi nhật ký. Bạn định cấu hình SSLInfo trong chính sách Ghi nhật ký thư giống như cách bạn sẽ trên proxy Điểm cuối mục tiêu. Tuy nhiên, TLS/SSL để ghi nhật ký thư chỉ hỗ trợ giao thức TCP. (APIRT-1858)

Đã khắc phục lỗi

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 đang kiểm tra để xem nếu phiếu yêu cầu hỗ trợ của họ đã được khắc phục. Tính năng này không được thiết kế nhằm cung cấp thông tin chi tiết về tất cả người dùng.

ID vấn đề Mô tả
SECENG-609 Các lệnh gọi trong thời gian chạy không gặp lỗi trong quá trình xoá kho tin cậy đã liên kết hoặc khi chứng chỉ hợp lệ trong kho tin cậy bị xoá
MGMT-3404 Việc xem/truy xuất nhật ký Node.js và triển khai proxy rất chậm
MGMT-3400 Không gọi được API quản lý /userroles nếu người dùng thực hiện lệnh gọi có "+" đăng nhập vào tên
MGMT-3368 java.lang.ArrayIndexOutOfBoundsException: 1, khi nhập gói Proxy API có chứa thư mục tài nguyên/nút/tài nguyên
MGMT-3364 OAuthV2: kiểm tra Redirect_uri
MGMT-3319 Liệt kê các mục trong kho lưu trữ có giá trị rỗng ở một trong các mục nhập không hoạt động dành cho tổ chức (CPS và không phải CPS)
MGMT-3226 Truy vấn ở cấp tổ chức/môi trường không lấy được tất cả dữ liệu gây ra API không thành công
Release_160302 có lỗi khiến danh sách tài nguyên ở cấp tổ chức/môi trường không thành công nếu kích thước tích luỹ của các tài nguyên lớn hơn 16MB, bản sửa lỗi này sẽ xử lý nó.
AXAPP-2429 API Analytics sử dụng response_status_code trả về quyền truy cập dữ liệu lỗi
AXAPP-2386 Khắc phục nội dung báo cáo trống trong báo cáo email hằng ngày của Analytics
AXAPP-2347 Không nhận được email tóm tắt về số liệu phân tích hằng ngày
APIRT-3141 Chú thích Java không thành công khi gọi ExecutionResult() mới vì hàm khởi tạo đã được chuyển sang chế độ riêng tư
APIRT-3140 Chính sách ServiceAnnotation không hoạt động trong các lệnh gọi API HEAD
APIRT-3131 CreateBy không chính xác xuất hiện cho Proxy API khi sử dụng tính năng kiếm tiền có nhà cung cấp dịch vụ xác thực bên ngoài
APIRT-3121 Việc thay đổi tệp tài nguyên tổ chức không hiệu quả 100%
APIRT-3117 MP đạt mức sử dụng CPU 100% và đã ngừng phân phát lưu lượng truy cập
APIRT-3016 Bộ định tuyến "Cuộc gọi đã hết thời gian chờ" lỗi triển khai
APIRT-2975 Không tải được gói chứng chỉ lên
APIRT-2955 Không thể che giấu một số thuộc tính của dữ liệu phản hồi JSON cho đơn kiện FHIR Tiêu đề Loại nội dung "application/json+fhir"
APIRT-2946 Chính sách OAuthV2-RefreshToken không ẩn các thuộc tính mặc dù màn hình được đặt thành sai
APIRT-2908 Bắt buộc phải thực thi TLS1.2 cho lệnh gọi API nội bộ sau khi cập nhật TLS1.2 máy chủ ảo
APIRT-2901 Phản hồi tệp zip mà hệ thống trả về từ bộ nhớ đệm sẽ được nén hai lần
APIRT-2873 Các MP gửi NullPointerException liên quan đến VerifyAPIKey sau khi xoá products/developers/proxies
APIRT-2871 Chính sách IOIntensive xuất hiện 2 lần trong Theo dõi
APIRT-2825 Lỗi ngữ pháp trong phản hồi lỗi accesstoken
APIRT-2750 Lỗi lưu lượng truy cập ở mức cao trong tổ chức cụ thể
APIRT-2685 Lưu lượng truy cập không thể lưu chuyển khi có lỗi không xác định
APIRT-2647 "Luồng đầu vào cơ bản trả về 0 byte" lỗi với nonprod/dev
APIRT-2630 Vấn đề bị gián đoạn khi tìm cách đọc giá trị từ bộ nhớ đệm
APIRT-2620 Nhóm luồng riêng cho một số bước chặn
APIRT-2610 Chính sách về java.lang.ClassCastException với bộ nhớ đệm phản hồi
APIRT-2608 Lỗi phân tích cú pháp tiêu đề lần sửa đổi gần đây nhất trong chính sách Bộ nhớ đệm phản hồi
APIRT-2605 "tổ chức" và "môi trường" các biến không được phép ghi đè thông qua chính sách
APIRT-2566 Chính sách OAuthV2 trả về tiêu đề WWW-KYC không đúng định dạng
APIRT-2491 Không cập nhật được TargetServer do hết thời gian chờ RPC giữa thời gian quản lý và mili giây
APIRT-2386 Phạm vi chuỗi trống được tạo trong một sản phẩm API có OAuth được phép trống các phạm vi
APIRT-2383 Chính sách Chuyển đổi XSL dường như không ghi lại bất kỳ dữ liệu nào theo lỗi
APIRT-2364 Biến quy trình lỗi của OAuth không được cập nhật khi gặp lỗi
APIRT-2216 Sự kiện do máy chủ gửi – luồng sự kiện gặp vấn đề trong phiên bản chính thức
APIRT-2079 Cuộc gọi cURL gỡ lỗi không dừng sau khi hết thời gian chờ cho buổi tập luyện
APIRT-1495 Tính năng Bảo vệ chống mối đe doạ XML không phát hiện được Content-Type
APIRT-347 Chính sách {8/} không được xác thực đúng khi nhập (không chỉ định kết quả để xuất các biến như trong tài liệu)