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 19 tháng 5 năm 2015, chúng tôi đã phát hành một phiên bản hằng quý của Apigee Edge dành cho đám mây riêng tư.
Tên sản phẩm cũ là "Apigee Edge On-sites" hay "OPDK" nay là "Apigee Edge for Private Cloud".
Nếu bạn có câu hỏi, hãy truy cập vào Apigee Customer Support.
Để biết 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à tính năng nâng cao
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.
OpenLDAP – cài đặt và nâng cấp
Open LDAP hiện là máy chủ LDAP duy nhất được Edge hỗ trợ cho các bản cài đặt mới và nâng cấp.
Dịch vụ API
Sau đây là các tính năng mới và tính năng nâng cao trong Dịch vụ API Edge.
WebSockets
Để cho phép giao tiếp web theo thời gian thực giữa ứng dụng web và máy chủ, Edge hỗ trợ giao thức WebSocket. Edge có thể đóng vai trò của ứng dụng khách hoặc máy chủ trong hoạt động giao tiếp WebSocket. Để biết thông tin về cách thiết lập và sử dụng WebSockets trong Edge, hãy xem hướng dẫn Apigee Edge for Private Cloud Using WebSockets.
Hỗ trợ nhà cung cấp dịch vụ xác thực bên ngoài cho việc quản lý API
Edge tích hợp với Active Directory và các nhà cung cấp dịch vụ xác thực/hệ thống LDAP khác có chứa người dùng quản trị API của bạn. Để biết thêm thông tin, hãy xem hướng dẫn Edge cho cấu hình xác thực bên ngoài của đám mây riêng tư.
Hợp tác xây dựng thương hiệu trong giao diện người dùng quản lý
Bạn có thể xây dựng thương hiệu cho giao diện người dùng quản lý Edge bằng biểu trưng tuỳ chỉnh của riêng mình, biểu trưng này xuất hiện bên cạnh biểu trưng Apigee. Để biết thêm thông tin, hãy xem phần "Thêm biểu trưng tuỳ chỉnh vào trình đơn Giao diện người dùng Apigee" trong Hướng dẫn về cách vận hành của Apigee Edge for Private Cloud.
Nhật ký Node.js trong Theo dõi
Khi gỡ lỗi proxy API Node.js, bạn có thể bật tính năng Nhật ký Node.js trong chế độ xem Theo dõi của
trình chỉnh sửa proxy API. Để bật tính năng này, hãy đặt apigee.feature.disableNodeJSLogs="false" trong tệp apigee-base.conf hoặc apigee-oncurrency.conf trong tệp cài đặt. Để biết thêm thông tin về Nhật ký Node.js, hãy xem phần Gỡ lỗi và khắc phục sự cố proxy Node.js.
Hết hạn mật khẩu
Trong Edge 4.15.01.x, mật khẩu Edge tự động hết hạn sau 30 ngày. Điều đó có nghĩa là người dùng bị mất quyền truy cập vào tài khoản, trừ phi họ đổi mật khẩu trước khi mật khẩu hết hạn. Tuy nhiên, điều này cũng khiến mật khẩu của quản trị viên hệ thống hết hạn và khiến quản trị viên hệ thống bị khoá khỏi Edge.
Khi bạn nâng cấp lên 4.15.04.00, chế độ mặc định sẽ thay đổi để mật khẩu không hết hạn. Nếu cần, bạn có thể định cấu hình để các mật khẩu Edge hết hạn bằng cách sử dụng tập lệnh /opt/apigee4/bin/apigee-enable-pwlockout.sh. Để biết thêm thông tin, hãy xem Hướng dẫn về cách hoạt động của API API dành cho đám mây riêng tư.
Giới hạn quyền truy cập của quản trị viên hệ thống vào các miền email cụ thể
Bạn có thể chỉ cho phép người dùng trong các miền email cụ thể có vai trò chỉ có thể đọc trong sysadmin hoặc sysadmin. Để bật tính năng này, hãy thêm các miền được phép vào tệp apigee4/conf/apigee/management-server/security.properties, như mô tả trong Hướng dẫn về cách hoạt động của Apigee Edge dành cho đám mây riêng tư.
Thông báo lỗi về giao diện người dùng trong phần Quản lý
Thông báo lỗi hiển thị trong giao diện người dùng quản lý đã được thiết kế lại để sử dụng không gian màn hình một cách hiệu quả hơn.
Biến lỗi OAuthV2 mới
Các biến mới liên quan đến lỗi được đặt theo chính sách OAuthV2:
- OAuthV2.<policy-name>.failed – Đặt thành true nếu chính sách không thành công.
- oauthv2.<policy_name>.<fault_name> – Tên của lỗi. Ví dụ: invalid_request
- oauthv2.<policy_name>.<fault_cause> – Nguyên nhân lỗi. Ví dụ: Mã thông báo đã hết hạn
Hãy xem http://apigee.com/docs/api-services/content/oauthv2-policy.
Tạo sản phẩm
Giờ đây, khi tạo một sản phẩm mới, bạn có thể chỉ định tên sản phẩm ngoài tên hiển thị.
Hãy xem http://apigee.com/docs/developer-services/content/creating-api-products.
Giao diện người dùng để xoá người dùng khỏi tổ chức
Trên trang Người dùng tổ chức trong giao diện người dùng, nút Xoá đã được thay thế bằng nút Xoá. Việc này giúp làm rõ rằng khi bạn xoá một người dùng khỏi tổ chức, tài khoản Apigee của người dùng đó vẫn hoạt động.
Hãy xem http://apigee.com/docs/api-services/content/managing-organization-users.
Các chế độ lọc trong giao diện người dùng quản lý
Trên các trang Proxy API, Sản phẩm, Nhà phát triển và Ứng dụng trong giao diện người dùng quản lý, có các tuỳ chọn lọc mới cho tìm kiếm.
Công cụ Theo dõi ngoại tuyến
Công cụ Theo dõi ngoại tuyến cho phép bạn xem và phân tích các phiên theo dõi đã lưu trước đó. Về cơ bản, phiên theo dõi đã lưu là bản "ghi lại" phiên theo dõi, và có thể hữu ích cho các trường hợp cần khắc phục sự cố và phân tích thêm. Giao diện người dùng của công cụ Theo dõi ngoại tuyến tương tự như công cụ Theo dõi "trực tiếp".
Để biết thêm thông tin, hãy xem bài viết Sử dụng công cụ Theo dõi ngoại tuyến.
Vai trò của người dùng được hiển thị trong phần Cài đặt người dùng
Trên trang Cài đặt người dùng của giao diện người dùng quản lý (tên người dùng > Cài đặt người dùng), vai trò của người dùng giờ đây được hiển thị.
Các tính năng nâng cao cho giao diện người dùng quản lý cạnh
Bản phát hành này bao gồm một số điểm cải tiến nhỏ về khả năng hữu dụng và tính nhất quán trong giao diện người dùng quản lý Edge.
Dịch vụ Analytics
Sau đây là các tính năng và tính năng nâng cao mới trong Dịch vụ Edge Analytics.
Có sẵn dữ liệu trong 6 tháng
Khi tạo báo cáo phân tích bằng API hoặc giao diện người dùng quản lý, theo mặc định, bạn không thể truy cập vào dữ liệu cũ hơn 6 tháng kể từ ngày hiện tại. Nếu bạn muốn truy cập dữ liệu cũ hơn 6 tháng, hãy liên hệ với Nhóm hỗ trợ API.
Đã thêm biến vào Analytics
Các biến mới sau đây sẽ được chuyển đến số liệu phân tích Edge, hiển thị trong giai đoạn AX của cửa sổ theo dõi proxy API.
- apigee.edge.execution.is_target_error – Cho phép bạn xác định lỗi API là lỗi phía mục tiêu (giá trị "1") hay lỗi không phải mục tiêu đối với phản hồi HTTP không thành công (giá trị "0"). Giá trị là rỗng đối với phản hồi HTTP thành công.
-
apigee.edge.execution.is_policy_error – Cho phép bạn xác định xem có chính sách nào bị lỗi (giá trị "1") hoặc không có chính sách nào bị lỗi trong phản hồi HTTP không thành công (giá trị "0"). Giá trị này là rỗng đối với phản hồi HTTP thành công.
Các biến liên quan sau đây cung cấp thông tin chi tiết về chính sách không đạt trước tiên. Các giá trị sẽ rỗng nếu không có chính sách nào bị lỗi.- apigee.edge.execution.fault_policy_name – Tên của chính sách không thành công.
- apigee.edge.execution.fault_flow_name – Tên của luồng trong chính sách không thành công (chẳng hạn như PreFlow, PostFlow hoặc luồng do người dùng xác định).
- apigee.edge.execution.fault_flow_state – Vị trí mà chính sách được đính kèm trong quy trình. Giá trị có thể là: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Trang tổng quan
- Biểu đồ hiệu suất của API, Nhà phát triển, Sản phẩm và Ứng dụng của nhà phát triển đã di chuyển. Trước đây, những thông tin này xuất hiện ở cuối trang chính của những thực thể này. Giờ đây, bạn có thể truy cập vào các biểu đồ bằng cách chọn thẻ Số liệu phân tích ở đầu mỗi trang.
- Bản phát hành này bao gồm các nhiệm vụ chính sau đây trên các trang tổng quan hiện có hoặc mới sau đây:
- Trang tổng quan API (Đã sửa đổi): Bao gồm ba biểu đồ chỉ số: Lưu lượng truy cập proxy, Mức độ tương tác của nhà phát triển và Ứng dụng của nhà phát triển. Mỗi biểu đồ sẽ có một chế độ xem "chi tiết khác" để bạn có thể xem chi tiết từng chỉ số. Xem Trang tổng quan API.
- Proxy Performance (Hiệu suất proxy mới) (Mới): Cho biết các mẫu lưu lượng truy cập proxy API và thời gian xử lý. Thay thế trang tổng quan API Proxy Performance. Xem bài viết Hiệu suất proxy API.
- Cấu trúc lưu lượng truy cập (Đã sửa đổi): Giao diện và nội dung của trang tổng quan đã được sửa đổi hoàn toàn. Đo lường mức đóng góp tương đối của các API, ứng dụng, nhà phát triển và sản phẩm hàng đầu vào chương trình API tổng thể của bạn. Xem Thành phần lưu lượng truy cập.
- Phân tích lỗi (Đã sửa đổi): Giao diện và nội dung đã được sửa đổi hoàn toàn. Cho thấy tỷ lệ lỗi đối với các proxy và mục tiêu API. Xem Trang tổng quan phân tích mã lỗi.
-
Các trang tổng quan hiện tại này đã được đổi tên:
- Hiệu suất thiết bị đầu cuối đã được đổi tên thành Hiệu suất mục tiêu: Hiển thị các mẫu lưu lượng truy cập và chỉ số hiệu suất cho các mục tiêu phụ trợ proxy API. Hãy xem phần Hiệu suất mục tiêu.
- Mức độ tương tác của đối tác đã được đổi tên thành Tương tác với nhà phát triển: Cho bạn biết nhà phát triển ứng dụng nào đã đăng ký đang tạo ra nhiều lưu lượng truy cập API nhất. Đối với mỗi nhà phát triển, bạn có thể tìm hiểu xem ai đang tạo ra nhiều lưu lượng truy cập API nhất và nhiều lỗi nhất. Xem phần Mức độ tương tác của nhà phát triển.
Các dịch vụ dành cho nhà phát triển
Sau đây là các tính năng và tính năng nâng cao mới trong Dịch vụ dành cho nhà phát triển Edge.
Hỗ trợ Swagger 2.0 cho SmartDocs
SmartDocs hỗ trợ nhập các tài liệu thông số kỹ thuật của Swagger 2.0 và duy trì khả năng tương thích ngược với Swagger 1.2. Chúng tôi sẽ hỗ trợ các đối tượng lược đồ bảo mật và giản đồ tập trung trong bản phát hành trong tương lai.
Kiếm tiền
Sau đây là các tính năng và tính năng nâng cao mới trong hoạt động kiếm tiền trên Edge. Hãy xem thêm phần "Vấn đề đã biết" để biết thêm thông tin về việc kiếm tiền.
Quy trình xử lý riêng cho Công ty và Nhà phát triển
Giờ đây, các công ty và nhà phát triển được xử lý riêng biệt, cho phép bạn linh hoạt hơn trong việc thêm nhiều công ty vào danh sách nhà phát triển và nhiều nhà phát triển vào danh sách công ty. Giao diện người dùng quản lý nay cung cấp các cửa sổ riêng cho "Công ty" và "Nhà phát triển" (có thể truy cập từ trình đơn "Xuất bản").
Hãy xem phần Quản lý các công ty và nhà phát triển.
Trong các báo cáo về hoạt động kiếm tiền, các công ty vẫn là bộ lọc chính, mặc dù nhãn bộ lọc đã thay đổi từ "Nhà phát triển" thành "Công ty".
Đã sửa lỗi
Các lỗi sau đây đã được khắc phục trong bản phát hành này.
| ID vấn đề | Nội dung mô tả |
|---|---|
| OPDK-954 | 4.15.01 Giản đồ Cassandra chưa được nâng cấp |
| MGMT-1986 | Lỗi giao diện người dùng khi thêm nhà phát triển |
| MGMT-1983 | Nhận mã uỷ quyền OAuth 2.0 mà API trả về trạng thái không chính xác |
| MGMT-1962 | Lỗi khi đăng nhập vào giao diện người dùng quản lý bằng mật khẩu mạnh Việc đăng nhập vào giao diện người dùng bằng một số ký tự đặc biệt nhất định (chẳng hạn như ký hiệu phần trăm) sẽ không bị lỗi nữa. |
| MGMT-1894 | Trang Ứng dụng dành cho nhà phát triển không bao giờ tải xong cột dành cho nhà phát triển |
| MGMT-1872 | Không thể tải báo cáo tuỳ chỉnh xuống |
| MGMT-1777 | Không thể thêm người dùng có địa chỉ email có TLD là .acn |
| MGMT-1362 | Tính năng Quên mật khẩu sẽ không hoạt động nếu địa chỉ email có chứa "_" Khắc phục vấn đề đặt lại mật khẩu trong Đám mây riêng tư bằng những địa chỉ email có chứa dấu gạch dưới. |
| CORERT-613 | Lỗi giao thức bắt tay SSL do "unRecognition_name" |
| APIRT-1346 | OAuth2.0 – Giá trị đã băm được trả về trong phản hồi mã truy cập khi hash.OAuth.tokens.enabled là true |
Bản phát hành này cũng chứa các phần sửa lỗi của các bản phát hành sau:
| Mây ở viền | Edge cho đám mây riêng tư |
|---|---|
Vấn đề đã biết
Bản phát hành này gặp một số vấn đề đã biết sau đây.
| ID vấn đề | Nội dung mô tả |
|---|---|
| Không áp dụng |
2 tập lệnh Cassandra mà trình cài đặt sử dụng trong quá trình cài đặt hoặc nâng cấp kiếm tiền không được đưa vào bản phát hành. Để giải quyết vấn đề này, hãy chạy các lệnh sau sau khi cài đặt Cassandra hoặc nâng cấp để hoàn tất quá trình cài đặt/nâng cấp tính năng kiếm tiền:
|
| CORERT-318 | Các lệnh gọi API có tải trọng lớn (100 KB) đôi khi có thể bị treo. Để giải quyết vấn đề này, hãy đặt giá trị thuộc tính sau đây trong tệp client.properties:HTTPServer.streaming.buffer.limit=0 (chế độ cài đặt mặc định là 10) |