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 phiên bản Apigee Edge cho Private Cloud theo quý.
Tên sản phẩm cũ "Apigee Edge On-premises" (Apigee Edge tại chỗ) hoặc "OPDK" hiện là "Apigee Edge for Private Cloud" (Apigee Edge cho đám mây riêng).
Nếu bạn có câu hỏi, hãy truy cập vào Nhóm hỗ trợ khách hàng của Apigee.
Để 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.
Các tính năng và điểm cải tiến mới
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.
OpenLDAP – cài đặt và nâng cấp
OpenLDAP hiện là máy chủ LDAP duy nhất được Edge hỗ trợ cho các lượt 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à điểm cải tiến 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ò là ứng dụng khách hoặc máy chủ trong giao tiếp WebSocket. Để biết thông tin về cách thiết lập và sử dụng WebSocket trong Edge, hãy xem hướng dẫn Apigee Edge cho đám mây riêng bằng WebSocket.
Hỗ trợ nhà cung cấp xác thực bên ngoài để quản lý API
Edge tích hợp với Active Directory và các nhà cung cấp xác thực bên ngoài/hệ thống LDAP khá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 Cấu hình xác thực bên ngoài của Edge cho đám mây riêng.
Hợp tác thương hiệu trong giao diện người dùng quản lý
Bạn có thể đồng thương hiệu 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 sẽ 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ận hành Apigee Edge cho đám mây riêng.
Nhật ký Node.js trong tính năng 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-onpremise.conf trong quá trình 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ố về 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 sẽ bị khoá tài khoản trừ phi họ thay đổi mật khẩu trước khi mật khẩu hết hạn. Tuy nhiên, việc này cũng khiến mật khẩu của quản trị viên hệ thống hết hạn nên quản trị viên hệ thống bị khoá khỏi Edge.
Khi bạn nâng cấp lên phiên bả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 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 hoạt động của Apigee Edge cho đám mây riêng.
Hạn chế quyền truy cập của quản trị viên hệ thống vào một số miền email cụ thể
Bạn có thể hạn chế tư cách thành viên trong vai trò quản trị viên hệ thống hoặc quản trị viên hệ thống chỉ có quyền đọc đối với người dùng trong các miền email cụ thể. Để 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ề hoạt động của Apigee Edge cho đám mây riêng.
Thông báo lỗi trên giao diện người dùng quản lý
Giao diện hiển thị thông báo lỗi 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 hiệu quả hơn.
Biến lỗi OAuthV2 mới
Các biến mới liên quan đến lỗi này do chính sách OAuthV2 đặt:
- 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 lỗi. Ví dụ: invalid_request
- oauthv2.<policy_name>.<fault_cause> – Lý do lỗi. Ví dụ: Mã thông báo đã hết hạn
Xem http://apigee.com/docs/api-services/content/oauthv2-policy.
Tạo sản phẩm
Giờ đây, khi tạo 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ị.
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 trong tổ chức trong giao diện người dùng, nút Xoá đã được thay thế bằng nút Xoá. Điều này giúp làm rõ rằng khi bạn xoá một người dùng khỏi một tổ chức, tài khoản Apigee của người dùng đó vẫn hoạt động.
Xem http://apigee.com/docs/api-services/content/managing-organization-users.
Các tuỳ chọn 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ý, bạn có thể sử dụng các tuỳ chọn lọc mới để 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" của một phiên theo dõi và có thể hữu ích trong 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 phần Sử dụng công cụ Theo dõi ngoại tuyến.
Vai trò của người dùng xuất hiện 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), các vai trò của người dùng hiện đã hiển thị.
Cải tiến 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 sử 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 mới và điểm cải tiến trong Dịch vụ phân tích Edge.
Dữ liệu trong 6 tháng
Theo mặc định, khi tạo báo cáo phân tích bằng giao diện người dùng hoặc API quản lý, bạn sẽ không truy cập được 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 vào dữ liệu cũ hơn 6 tháng, hãy liên hệ với Nhóm hỗ trợ Apigee.
Các biến đã được thêm vào số liệu phân tích
Các biến mới sau đây được truyền đến công cụ 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 xem 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 các 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.
-
apigee.edge.execution.is_policy_error – Cho phép bạn xác định xem một chính sách có lỗi hay không (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 sẽ 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 hợp lệ trước tiên. Các giá trị sẽ bằng rỗng nếu không có chính sách nào không thành công.- 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í đính kèm chính sách trong luồng. Các giá trị có thể có: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Trang tổng quan
- Các biểu đồ hiệu suất cho API, Nhà phát triển, Sản phẩm và Ứng dụng của nhà phát triển đã được di chuyển. Các giá trị này từng xuất hiện ở cuối các trang chính của các 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ẻ Analytics ở đầu mỗi trang.
- Bản phát hành này bao gồm các công việc chính trên các trang tổng quan hiện có hoặc mới này:
- Trang tổng quan Apigee (Bản sửa đổi): Bao gồm 3 biểu đồ chỉ số: Lưu lượng truy cập qua 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 đồ cung cấp chế độ xem "thêm thông tin chi tiết" để bạn có thể xem chi tiết từng chỉ số. Xem trang tổng quan Apigee.
- Hiệu suất proxy (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 về Hiệu suất của proxy API. Xem phần Hiệu suất của Proxy API.
- Thành phần lưu lượng truy cập (Đã sửa đổi): Nội dung và giao diện 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 đối với chương trình API tổng thể của bạn. Xem phần Thành phần lưu lượng truy cập.
- Phân tích lỗi (Bản sửa đổi): Nội dung và giao diện được sửa đổi hoàn toàn. Cho biết tỷ lệ lỗi cho các proxy và mục tiêu API. Xem Trang tổng quan về phân tích mã lỗi.
-
Các trang tổng quan hiện có này đã được đổi tên:
- Đổi tên Hiệu suất điểm cuối thành Hiệu suất mục tiêu: Cho thấy 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. Xem phần Mục tiêu hiệu suất.
- Mức độ tương tác của đối tác được đổi tên thành Mức độ tương tác của nhà phát triển: Cho bạn biết nhà phát triển ứng dụng đã đăng ký nào đ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 mới và điểm cải tiến 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 tài liệu quy cách Swagger 2.0 và duy trì khả năng tương thích ngược với Swagger 1.2. Hỗ trợ đối tượng lược đồ bảo mật và lược đồ tập trung sẽ có trong bản phát hành sau này.
Kiếm tiền
Sau đây là các tính năng mới và điểm cải tiến trong tính năng kiếm tiền trên Edge. Ngoài ra, hãy xem phần "Các vấn đề đã biết" để biết thêm thông tin về việc kiếm tiền.
Xử lý riêng Công ty và Nhà phát triển
Giờ đây, 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 nhà phát triển và nhiều nhà phát triển vào công ty. Giờ đây, giao diện người dùng quản lý cung cấp các cửa sổ riêng biệt cho "Công ty" và "Nhà phát triển" (có thể truy cập từ trình đơn "Xuất bản").
Xem bài viết Quản lý công ty và nhà phát triển.
Trong các báo cáo về việc kiếm tiền, 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 đề | Mô tả |
|---|---|
| OPDK-954 | 4.15.01 Không nâng cấp giản đồ Cassandra |
| MGMT-1986 | Lỗi giao diện người dùng khi thêm nhà phát triển |
| MGMT-1983 | API Get an OAuth 2.0 authorization code trả về trạng thái không chính xác |
| MGMT-1962 | Lỗi đă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, chẳng hạn như dấu phần trăm, không còn 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 nhà phát triển |
| MGMT-1872 | Không tải được 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 | Email Quên mật khẩu không hoạt động nếu Địa chỉ email chứa dấu "_" Khắc phục vấn đề đặt lại mật khẩu trong Private Cloud với địa chỉ email chứa dấu gạch dưới. |
| CORERT-613 | Lỗi bắt tay giao thức SSL do "unrecognized_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 bản sửa lỗi trong các bản phát hành sau:
| Đám mây cạnh | Edge cho đám mây riêng |
|---|---|
Vấn đề đã biết
Bản phát hành này có các vấn đề đã biết sau đây.
| ID vấn đề | Mô tả |
|---|---|
| Không áp dụng |
Hai 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 tính năng kiếm tiền không có trong bản phát hành này. Để giải quyết vấn đề này, hãy chạy các lệnh sau sau khi cài đặt hoặc nâng cấp Cassandra để hoàn tất quá trình cài đặt/nâng cấp tính năng kiếm tiền:
|
| CORERT-318 | Đôi khi, các lệnh gọi API có tải trọng lớn (hàng trăm KB) có thể bị treo. Để giải quyết vấn đề này, hãy đặt giá trị thuộc tính sau trong tệp router.properties:HTTPServer.streaming.buffer.limit=0 (chế độ cài đặt mặc định là 10) |