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 2 tháng 6 năm 2015, chúng tôi đã phát hành một phiên bản đám mây mới của Apigee Edge.
Nếu bạn có câu hỏi, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.
Để xem danh sách tất cả ghi chú phát hành của Apigee Edge, hãy xem Ghi chú phát hành của Apigee.
Tính năng mới và điểm cải tiến
Sau đây là các tính năng mới và điểm cải tiến trong bản phát hành này.
Phát hành rộng rãi SmartDocs
SmartDocs sẽ chuyển từ giai đoạn thử nghiệm beta sang giai đoạn phát hành rộng rãi. Các bản cập nhật và tính năng mới bao gồm:
- Hỗ trợ Swagger 2.0, bao gồm cả việc nhập theo tệp hoặc URL, bao gồm cả việc hỗ trợ các đối tượng bảo mật có tên tuỳ chỉnh.
- Cải tiến về thiết kế trực quan trong các mẫu tạo SmartDocs.
- Cải thiện khả năng sử dụng và quy trình làm việc trong Cổng thông tin dành cho nhà phát triển, có trong trình đơn Nội dung > SmartDocs trong Drupal.
- Phương thức xác thực "Mã thông báo tuỳ chỉnh" hiện được gọi là "Khoá API".
- Các đối tượng "bảo mật" xác thực được xác định ở cấp bản sửa đổi.
- Cấu hình xác thực máy khách ở cấp mẫu. Các bản sửa đổi mới sẽ không còn đặt lại bất kỳ thông tin xác thực ứng dụng khách SmartDocs nào được định cấu hình trước.
Để biết thêm nội dung mô tả về tính năng, hãy xem bài đăng này trên blog.
Để biết tài liệu về SmartDocs, hãy xem phần Sử dụng SmartDocs để ghi lại API.
Trình chỉnh sửa proxy API mới (bản thử nghiệm)
Đã có phiên bản beta mới của trình chỉnh sửa proxy API. Để truy cập, hãy nhấp vào đường liên kết "Truy cập vào phiên bản beta" khi chỉnh sửa một proxy API hiện có. Bạn có thể chuyển đổi qua lại giữa trình chỉnh sửa "cũ" và "thử nghiệm".
Chính sách OAuthV2 mới
Chính sách DeleteOAuthV2Info mới cho phép bạn xoá mã uỷ quyền và mã truy cập. Để biết thêm thông tin, hãy xem Chính sách xoá thông tin OAuthV2.
Các thực thể mới trong chính sách Access Entity
Chính sách Access Entity (Thực thể truy cập) cấp quyền truy cập vào các thực thể mới sau đây: consumerkey-scopes, authorizationcode, requesttoken và verifier. Để biết thêm thông tin, hãy xem Chính sách về thực thể truy cập.
Hiển thị các chứng chỉ SSL sắp hết hạn
Trang Chứng chỉ SSL trong giao diện người dùng quản lý (Quản trị > Chứng chỉ SSL) cho biết thời điểm chứng chỉ SSL hết hạn trong vòng 10, 15, 30 hoặc 90 ngày, tuỳ thuộc vào lựa chọn của bạn trong trường trình đơn thả xuống mới về thời gian hết hạn.
Tên ứng dụng của nhà phát triển xuất hiện trong giao diện người dùng quản lý
Các ứng dụng dành cho nhà phát triển trong Edge có cả Tên nội bộ (không thay đổi) và Tên hiển thị (bạn có thể thay đổi). Trên trang Ứng dụng của nhà phát triển trong giao diện người dùng quản lý (Xuất bản > Ứng dụng của nhà phát triển > tên ứng dụng), "Tên" nội bộ của ứng dụng sẽ xuất hiện cùng với "Tên hiển thị", giúp bạn dễ dàng xác định ứng dụng bằng tên nội bộ để khắc phục sự cố và quản lý API.
Phiên bản cũ của báo cáo tuỳ chỉnh sẽ bị xoá khỏi giao diện người dùng quản lý
Phiên bản cũ không bắt buộc của báo cáo phân tích tuỳ chỉnh hiện không còn trong giao diện người dùng quản lý nữa.
Quy trình nâng cấp SmartDocs
Nếu bạn đã sử dụng SmartDocs trong giai đoạn thử nghiệm, thì các tính năng và chức năng mới trong phiên bản phát hành công khai yêu cầu bạn nâng cấp SmartDocs trong cổng thông tin dành cho nhà phát triển.
Mọi trang SmartDocs đã được xuất bản trong cổng thông tin dành cho nhà phát triển sẽ tiếp tục hoạt động, nhưng bạn phải làm theo quy trình cập nhật trước khi chỉnh sửa hoặc xuất bản mọi thay đổi đối với các trang hiện có hoặc trang mới.
Xin lưu ý rằng mặc dù bạn có thể kết xuất và xuất bản SmartDocs trong cổng dành cho nhà phát triển, nhưng SmartDocs được tạo từ mô hình API nằm trong Dịch vụ quản lý API Edge của Apigee. Mọi thay đổi mà bạn thực hiện đối với một mô hình API trong Edge sẽ giống nhau trên tất cả các môi trường Pantheon của bạn (tương tự như cách các nhà phát triển tồn tại trên các môi trường Pantheon).
Cách nâng cấp từ phiên bản beta của SmartDocs lên phiên bản phát hành công khai
- Cập nhật và kiểm thử bản phát hành 15.05.27 trong môi trường dev hoặc test trên Pantheon.
- Tạo một mô hình mới để thay thế mọi mô hình API hiện có mà bạn đang sử dụng.
- Nếu bạn đã nhập tài liệu Swagger hoặc WADL, hãy nhập lại các tài liệu đó vào một bản sửa đổi mới.
- Nếu bạn đang duy trì mô hình API thông qua mô-đun SmartDocs, hãy xuất dưới dạng SmartDocs JSON và nhập vào mô hình mới bằng cách sử dụng tệp đính kèm.
- Đặt các thuộc tính bảo mật cho bản sửa đổi của mô hình. Trên trang Nội dung > SmartDocs > model, hãy chọn Security Settings (Chế độ cài đặt bảo mật).
- Kiểm tra mọi hoạt động xác thực được định cấu hình sẵn trong trang cài đặt mô hình (Nội dung > SmartDocs) bằng cách nhấp vào Cài đặt trong cột Thao tác.
- Cập nhật mọi mẫu tuỳ chỉnh để sử dụng phiên bản 6 của thành phần CSS và JS, đồng thời thực hiện các thay đổi để phản ánh mọi tên đối tượng mới, chẳng hạn như authSchemes và apiSchema. Để biết thông tin về cách cập nhật mẫu SmartDocs, hãy xem bài viết Sử dụng SmartDocs để lập tài liệu về API.
- Kết xuất lại và xuất bản bản sửa đổi mô hình.
- Sau khi xác thực tài liệu mới, hãy cập nhật cổng sản xuất của bạn lên bản phát hành ngày 27/5/15.
Nếu bạn là khách hàng doanh nghiệp của Edge và có thắc mắc hoặc lo ngại về quy trình nâng cấp, vui lòng gửi email đến marsh@apigee.com và cnovak@apigee.com. Nếu không, vui lòng sử dụng Cộng đồng Apigee để nhận được câu trả lời tốt nhất.
Các lỗi đã được khắc phục
Các lỗi sau đây đã được khắc phục trong bản phát hành này.
| ID vấn đề | Mô tả |
|---|---|
| TBD-72 | Vấn đề về chính sách ghi nhật ký tin nhắn |
| MGMT-2124 | Quyền của vai trò khách hàng sẽ được đặt lại khi bạn lưu quyền trong giao diện người dùng |
| MGMT-2048 | Người dùng có vai trò tuỳ chỉnh giới hạn quyền triển khai đối với một môi trường có thể triển khai ở những môi trường khác |
| MGMT-2041 | Xoá phần tử FaultRules khỏi mẫu tệp đính kèm mặc định Phần tử FaultRules (không được dùng trong các bước của chính sách hoặc proxy API) sẽ không còn được tự động thêm khi bạn tạo proxy API hoặc thêm chính sách nữa. |
| MGMT-2034 | Tìm nạp WSDL trả về lỗi: "Lỗi tìm nạp WSDL: Lỗi xử lý WSDL." |
| MGMT-1812 | Thêm quy trình xác thực TargetEndpoint trong quá trình nhập Tương tự như ProxyEndpoint, TargetEndpoint sẽ được xác thực theo giản đồ và biểu thức phù hợp được dùng trong các điều kiện trong quá trình nhập proxy API. |
| MGMT-1345 | Việc nhập WSDL có nhiều không gian tên dẫn đến Bước tạo SOAP không chính xác |
| MGMT-800 | Việc tạo tài nguyên có tên "default" sẽ dẫn đến giao diện người dùng bị hỏng |
| MGMT-602 | Chế độ xem Phát triển của API Proxy: Thêm chính sách Bộ nhớ đệm phản hồi khi điểm cuối không có PreFlow/PostFlow gây ra lỗi |
| MGMT-460 | Việc đổi tên chính sách dẫn đến hành vi trục trặc, chính sách trùng lặp không thể xoá |
| DEVRT-1565 | Khoảng thời gian 15 phút cho PHÍ |
| AXAPP-1728 | Bỏ qua các biến về hoạt động kiếm tiền trong số liệu phân tích |
| AXAPP-1690 | "Lỗi API không hợp lệ" trên báo cáo tuỳ chỉnh |
| AXAPP-1533 | Geomap của Analytics gặp lỗi Lệnh gọi API không hợp lệ |
| APIRT-52 | Báo cáo tuỳ chỉnh: Mã trạng thái phản hồi của nhiều API là giá trị rỗng |