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".
Nếu bạn có thắc mắc, 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
OpenLDAP 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à bản nâng cấp.
Các 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 chủ và ứng dụng web, 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 tư 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 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 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ố về 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ế 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 đối với người dùng thuộc 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ý
Chúng tôi đã thiết kế lại cách hiển thị thông báo lỗi trong giao diện người dùng quản lý để sử dụng không gian màn hình hiệu quả hơn.
Các 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 Loại bỏ. Đ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), các vai trò của người dùng hiện đã xuất hiện.
Cải tiến giao diện người dùng quản lý cạnh
Bản phát hành này có một số điểm cải tiế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 vào 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 – Cho phé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à 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ị này 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í 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 thẻ 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 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 những thay đổi lớn đối với các trang tổng quan hiện có hoặc trang tổng quan 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ông tin chi tiết khác" cho phép bạn truy sâu vào 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. Hiển thị tỷ lệ lỗi cho các đích đến và proxy API. Xem Trang tổng quan phân tích mã lỗi.
-
Chúng tôi đã đổi tên các trang tổng quan hiện có này:
- Hiệu suất đ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 đặc tả 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à lược đồ tập trung 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.
| Mã vấn đề | 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 | 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 gặp lỗ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 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:
| Đám mây biên | Edge cho Đám mây riêng tư |
|---|---|
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) |