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 19 tháng 5 năm 2015, chúng tôi đã phát hành phiên bản hằng quý của Apigee Edge cho Private Cloud.
Tên sản phẩm cũ "Apigee Edge tại cơ sở" hoặc "OPDK" hiện là "Apigee Edge cho Đám mây riêng tư".
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.
OpenLDAP – cài đặt và nâng cấp
Giờ đây, OpenLDAP là máy chủ LDAP duy nhất được Edge hỗ trợ cho các bản cài đặt mới và bản 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 Edge API Services.
WebSockets
Để cho phép giao tiếp web theo thời gian thực giữa máy khách và máy chủ web, Edge hỗ trợ giao thức WebSocket. Edge có thể đóng vai trò là ứng dụng 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 cách sử dụng WebSocket.
Hỗ trợ nhà cung cấp dịch vụ xác thực bên ngoài cho hoạt động 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 bên ngoài/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 Cấu hình xác thực bên ngoài cho Edge for Private Cloud.
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 dấu vết
Khi gỡ lỗi các proxy API Node.js, bạn có thể bật tính năng Nhật ký Node.js trong chế độ xem Dấu vết 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ố cho cá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 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, do đó, quản trị viên hệ thống không thể truy cập vào 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 trên 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ận hành 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 đối với các miền email cụ thể
Bạn có thể hạn chế quyền 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 cho 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ận hành Apigee Edge cho Đám mây riêng tư.
Thông báo lỗi trên giao diện người dùng 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 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 đượ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> – Lý do xảy ra 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
Khi tạo một sản phẩm mới, giờ đây, 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 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 nhằm giúp bạn hiểu 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 lựa chọn lọc trong giao diện người dùng quản lý
Trên các trang API Proxies, Products, Developers và Apps trong giao diện người dùng quản lý, bạn có thể dùng các lựa chọn lọc mới để tìm kiếm.
Công cụ Offline Trace
Công cụ Dấu vết ngoại tuyến cho phép bạn xem và phân tích các phiên dấu vết đã được lưu trước đó. Về cơ bản, phiên theo dõi đã lưu là một "bản ghi" của 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ụ Dấu vết ngoại tuyến tương tự như công cụ Dấu vết "trực tiếp".
Để biết thêm thông tin, hãy xem bài viết Sử dụng công cụ Dấu vết ngoại tuyến.
Vai trò 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), vai trò của người dùng hiện đã xuất hiện.
Các điểm cải tiến trong giao diện người dùng quản lý Edge
Bản phát hành này có một số điểm cải thiện nhỏ về tính nhất quán và khả năng sử dụng 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 trên thiết bị.
Có dữ liệu trong 6 tháng
Khi tạo báo cáo phân tích bằng giao diện người dùng quản lý hoặc API, theo mặc định, bạn sẽ không truy cập được dữ liệu cũ hơn 6 tháng so với 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 Edge.
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 số liệu phân tích Edge, xuất hiện trong giai đoạn AX của cửa sổ theo dõi proxy API.
- apigee.edge.execution.is_target_error – Giúp bạn xác định xem lỗi API có phải là lỗi phía đích (giá trị "1") hay lỗi không phải phía đích đố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 – Giúp bạn xác định xem một chính sách có thất bại (giá trị "1") hay không có chính sách nào thất bại trong một phản hồi HTTP không thành công (giá trị "0"). Giá trị này là giá trị 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 bị lỗi đầu tiên. Các giá trị 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í mà chính sách được đính kèm trong luồng. Các giá trị có thể sử dụng: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Trang tổng quan
- Biểu đồ hiệu suất cho API, Nhà phát triển, Sản phẩm và Ứng dụng nhà phát triển đã được di chuyển. Trước đây, các mục 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 những thay đổi lớn đối với các trang tổng quan hiện có hoặc mới sau đây:
- Trang tổng quan Apigee (Đã sửa đổi): Bao gồm 3 biểu đồ chỉ số: Lưu lượng truy cập của 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 đồ đều cung cấp chế độ xem "thêm chi tiết" cho phép bạn xem chi tiết từng chỉ số. Xem trang tổng quan Apigee.
- Hiệu suất của proxy (Mới): Cho biết các mẫu lưu lượng truy cập của proxy API và thời gian xử lý. Thay thế trang tổng quan về Hiệu suất của API Proxy. Xem phần Hiệu suất của Proxy API.
- Thành phần lưu lượng truy cập (Mới): Trang tổng quan được thiết kế lại hoàn toàn về giao diện và nội dung. Đ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 biết tỷ lệ lỗi cho các đích đến và proxy 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:
- Hiệu suất của điểm cuối được đổi tên thành Hiệu suất mục tiêu: Cho biết 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ợ của proxy API. Xem 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 Mức độ tương tác của nhà phát triển: Cho 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ể biết được ai đang tạo ra lưu lượng truy cập API nhiều nhất và số lỗi nhiều 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 Edge Developer Services.
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ợ cho các đố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. Bạn cũng có thể 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 biệt đối với 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, giúp bạn linh hoạt hơn khi 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 phần Quản lý công ty và nhà phát triển.
Trong báo cáo 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".
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ả |
|---|---|
| OPDK-954 | Giản đồ Cassandra 4.15.01 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 | API Nhận mã uỷ quyền OAuth 2.0 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, chẳng hạn như dấu phần trăm, sẽ không còn thất bại nữa. |
| MGMT-1894 | Trang Ứng dụng của nhà phát triển không bao giờ tải xong cho 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ó miền cấp cao nhất là .acn |
| MGMT-1362 | Email Quên mật khẩu không hoạt động nếu Địa chỉ email chứa "_" Khắc phục vấn đề đặt lại mật khẩu trong Đám mây riêng với địa chỉ email có chứa dấu gạch dưới. |
| CORERT-613 | Lỗi bắt tay 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:
| Edge Cloud | Edge for Private Cloud |
|---|---|
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 kiếm tiền không có trong 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 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 | Các lệnh gọi API có tải trọng lớn (hàng trăm 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 router.properties:HTTPServer.streaming.buffer.limit=0 (chế độ cài đặt mặc định là 10) |