4.17.09 – Ghi chú phát hành Edge for Private Cloud

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

Kể từ Bản phát hành tính năng Edge cho Đám mây riêng tư trước đó, các bản phát hành sau đây đã diễn ra và được đưa vào Bản phát hành tính năng này:

Hãy xem phần Giới thiệu về cách đánh số bản phát hành để biết cách xác định xem một bản phát hành cụ thể trên đám mây có được đưa vào phiên bản Edge cho Đám mây riêng tư của bạn hay không.

Tổng quan về bản phát hành

Tính năng mới quan trọng nhất trong bản phát hành này là việc bổ sung tính năng hỗ trợ Ngôn ngữ đánh dấu xác nhận bảo mật (SAML) 2.0 làm cơ chế xác thực cho Edge, API BaaS và cổng Dịch vụ dành cho nhà phát triển. Bằng cách sử dụng SAML với Edge, bạn có thể hỗ trợ SSO cho Giao diện người dùng và API Edge ngoài mọi dịch vụ khác mà bạn cung cấp và cũng hỗ trợ SAML.

Xác thực SAML mang lại một số lợi ích. Khi sử dụng SAML, bạn có thể:

• Nắm toàn quyền kiểm soát việc quản lý người dùng. Khi người dùng rời khỏi tổ chức của bạn và được huỷ cấp phép tập trung, họ sẽ tự động bị từ chối quyền truy cập vào Edge.
• Kiểm soát cách người dùng xác thực để truy cập vào Edge. Bạn có thể chọn các loại xác thực khác nhau cho các tổ chức Edge khác nhau.
• Kiểm soát các chính sách xác thực. Nhà cung cấp SAML của bạn có thể hỗ trợ các chính sách xác thực phù hợp hơn với các tiêu chuẩn của doanh nghiệp.
• Bạn có thể theo dõi hoạt động đăng nhập, đăng xuất, những lần đăng nhập không thành công và các hoạt động có rủi ro cao trên quá trình triển khai Edge.
• Xin lưu ý rằng SAML chỉ được dùng để xác thực. Quyền uỷ quyền vẫn do các vai trò người dùng Edge kiểm soát.

Hãy xem phần Hỗ trợ SAML trên Edge cho Đám mây riêng để biết thêm thông tin.

Bản phát hành này có một số tính năng đáng chú ý khác, bao gồm:

• Có thể di chuyển cổng Dịch vụ dành cho nhà phát triển từ Apache/MySQL sang Postgres/Nginx
• Lệnh tắt TLS trong giao diện người dùng Edge
• Các thuộc tính mới để định cấu hình quá trình cài đặt Edge
• Quy tắc đặt tên cho khoá và mã bí mật tuỳ chỉnh của người dùng
• Hỗ trợ Red Hat/CentOS phiên bản 7.4

Phần còn lại của chủ đề này chứa thông tin chi tiết về tất cả các tính năng mới, nội dung cập nhật và bản sửa lỗi có trong bản phát hành.

Ngừng sử dụng và ngừng cung cấp

Các tính năng sau đây đã bị ngừng cung cấp hoặc ngừng hoạt động trong bản phát hành này. Hãy xem Chính sách về việc không dùng Edge nữa để biết thêm thông tin.

Ngừng sử dụng

Ngừng sử dụng kho lưu trữ bảo mật (vault) của Apigee

Kho lưu trữ an toàn của Apigee (còn gọi là "kho") sẽ không được dùng nữa và sẽ ngừng hoạt động vào tháng 4 năm 2018. Các kho lưu trữ (cung cấp bộ nhớ được mã hoá cho các cặp khoá/giá trị) được tạo bằng API quản lý và được truy cập trong thời gian chạy bằng các hàm trong mô-đun apigee-access Node.js.

Thay vì sử dụng bộ nhớ an toàn, hãy dùng các bản đồ khoá giá trị (KVM) đã mã hoá, như mô tả trong phần Làm việc với bản đồ khoá giá trị. KVM được mã hoá cũng an toàn như kho lưu trữ và cung cấp nhiều lựa chọn hơn để tạo và truy xuất. (MGMT-3848)

Ngừng thêm đường dẫn trên thẻ Hiệu suất của proxy API

Cho đến bản phát hành này, bạn có thể chuyển đến một API proxy trong giao diện người dùng quản lý, chuyển đến thẻ Hiệu suất và tạo các đường dẫn khác nhau để so sánh dựa trên biểu đồ trên thẻ Hiệu suất của proxy và trong trang tổng quan Giao dịch kinh doanh. Tính năng này hiện đã ngừng hoạt động và không còn xuất hiện trong giao diện người dùng nữa. Để biết giải pháp thay thế cho chức năng này, hãy xem bài viết sau đây trên Cộng đồng Apigee: Giải pháp thay thế cho Business Transactions API. (EDGEUI-902)

Thông tin cập nhật và tính năng 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. Ngoài những điểm cải tiến sau, bản phát hành này còn có nhiều điểm cải tiến về khả năng sử dụng, hiệu suất, tính bảo mật và độ ổn định.

Đám mây riêng tư

Đã thêm tính năng hỗ trợ SAML vào Edge, API BaaS và cổng thông tin Dịch vụ dành cho nhà phát triển

Edge hiện hỗ trợ Ngôn ngữ đánh dấu xác nhận bảo mật (SAML) 2.0 làm cơ chế xác thực cho Edge, API BaaS và cổng Dịch vụ dành cho nhà phát triển. SAML hỗ trợ môi trường đăng nhập một lần (SSO). Bằng cách sử dụng SAML, bạn có thể hỗ trợ SSO cho Edge ngoài mọi dịch vụ khác mà bạn cung cấp và cũng hỗ trợ SAML.

Hãy xem phần Hỗ trợ SAML trên Edge cho Đám mây riêng tư.

Đã thêm tiện ích apigee-ssoadminapi.sh

Sau khi bật SAML, giờ đây, bạn có thể sử dụng apigee-ssoadminapi.sh mới để thực hiện nhiều tác vụ quản trị, chẳng hạn như tạo người dùng và tổ chức.

Xem phần Sử dụng apigee-ssoadminapi.sh.

(DOS-5118)

Giờ đây, bạn có thể di chuyển cổng Dịch vụ dành cho nhà phát triển từ Apache/MySQL/MariaDB sang Nginx/postgres

Việc cài đặt dựa trên .tar của cổng Dịch vụ dành cho nhà phát triển sử dụng Apache và MySQL hoặc MariaDB. Giờ đây, bạn có thể di chuyển chế độ cài đặt hiện có của cổng thông tin để sử dụng Nginx và Postgres. Bạn buộc phải thực hiện quy trình di chuyển này nếu muốn cập nhật lên phiên bản 4.17.09 của cổng thông tin.

Xem phần Chuyển đổi cổng dựa trên tar thành cổng dựa trên RPM.

Thêm khả năng hỗ trợ cho Red Hat/CentOS phiên bản 7.4

Giờ đây, bạn có thể triển khai Edge cho Đám mây riêng, API BaaS và cổng Dịch vụ dành cho nhà phát triển trên Red Hat/CentOS phiên bản 7.4.

Xem Phần mềm được hỗ trợ và các phiên bản được hỗ trợ.

Đã thêm thuộc tính để khiến trình cài đặt kiểm tra các yêu cầu về CPU và bộ nhớ trong quá trình cài đặt

Tệp cấu hình cài đặt Edge hiện hỗ trợ thuộc tính sau:

ENABLE_SYSTEM_CHECK=y 

Nếu là "y", trình cài đặt sẽ kiểm tra để đảm bảo hệ thống đáp ứng các yêu cầu về CPU và bộ nhớ đối với thành phần đang được cài đặt. Hãy xem Yêu cầu về việc cài đặt để biết các yêu cầu đối với từng thành phần. Giá trị mặc định là "n" để tắt chế độ kiểm tra.

Xem Tài liệu tham khảo về tệp cấu hình Edge.

(DOS-4772)

Đã thêm thuộc tính để cho phép bạn chọn địa chỉ IP mà trình cài đặt sử dụng trên một máy chủ có nhiều thẻ giao diện

Nếu một máy chủ có nhiều thẻ giao diện, lệnh "hostname -i" sẽ trả về một danh sách địa chỉ IP được phân tách bằng dấu cách. Theo mặc định, trình cài đặt Edge sẽ sử dụng địa chỉ IP đầu tiên được trả về, có thể không chính xác trong mọi trường hợp. Ngoài ra, bạn có thể thiết lập thuộc tính sau trong tệp cấu hình cài đặt:

ENABLE_DYNAMIC_HOSTIP=y

Khi bạn đặt thuộc tính đó thành "y", trình cài đặt sẽ nhắc bạn chọn địa chỉ IP để sử dụng làm một phần của quá trình cài đặt. Giá trị mặc định là "n".

Xem Tài liệu tham khảo về tệp cấu hình Edge.

(DOS-5117)

Các lựa chọn và API mới về giao diện người dùng để định cấu hình TLS

Bản phát hành Beta của tính năng TLS/SSL tự phục vụ mới cho Cloud hiện có trong Đám mây riêng tư dưới dạng một tính năng Beta. Khi sử dụng phiên bản Beta này, bạn có thể:

• Tạo, sửa đổi và xoá kho khoá cũng như kho tin cậy trong giao diện người dùng và API
• Tải chứng chỉ TLS lên dưới dạng PKCS12/PFX
• Tạo chứng chỉ tự ký từ giao diện người dùng hoặc API
• Kiểm thử tính hợp lệ của kho khoá hoặc kho tin cậy trong giao diện người dùng

Bạn có thể xem tài liệu Beta (PDF) cho các tính năng này tại:

• Sử dụng giao diện người dùng Edge Cloud để tạo Kho khoá và Kho tin cậy
• Sử dụng Edge API để tạo Keystore và Truststore

Để biết thông tin đầy đủ, hãy tham khảo tài liệu bổ sung (PDF):

• Các lựa chọn để định cấu hình TLS
• Định cấu hình quyền truy cập TLS vào một API cho Đám mây
• Định cấu hình TLS từ Edge đến phần phụ trợ
• Cập nhật chứng chỉ TLS cho Cloud

(EDGEUI-1058)

Đã thêm lệnh mật khẩu bị làm rối

Thêm một lệnh để tạo mật khẩu bị làm rối mã nguồn để mọi thành phần đều có thể tạo mật khẩu được mã hoá. Bạn có thể tạo mật khẩu bị làm rối bằng cách sử dụng lệnh sau trên Máy chủ quản lý Edge:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

Nhập mật khẩu mới, sau đó xác nhận mật khẩu đó khi được nhắc. Vì lý do bảo mật, văn bản của mật khẩu sẽ không xuất hiện. Lệnh này trả về mật khẩu ở dạng:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

Xem phần Định cấu hình TLS/SSL cho Edge On Premises.

(TBD-250)

Thêm lệnh mới để làm rối mật khẩu mới khi thay đổi mật khẩu của người dùng trong tổ chức

Để đặt lại mật khẩu cho người dùng trong tổ chức, giờ đây, bạn có thể sử dụng tiện ích apigee-service để gọi apigee-openldap:

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

Bạn sẽ được nhắc nhập mật khẩu của quản trị viên hệ thống, sau đó nhập mật khẩu mới của người dùng. Vì lý do bảo mật, văn bản của mật khẩu sẽ không xuất hiện khi bạn nhập.

Xem phần Đặt lại mật khẩu trên Edge.

(DBS-1733)

Thêm lệnh để tắt TLS trong giao diện người dùng Edge

Giờ đây, bạn có thể dùng lệnh sau để tắt TLS trong giao diện người dùng Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

Xem phần Định cấu hình TLS cho giao diện người dùng quản lý.

(EDGEUI-1114)

Đã thêm thuộc tính để kiểm soát định dạng của dấu thời gian trong thông báo nhật ký

Theo mặc định, dấu thời gian trong thông điệp nhật ký do chính sách Ghi nhật ký thông điệp tạo ra có định dạng:

yyyy-MM-dd'T'HH:mm:ss.sssZ

Ví dụ:

2017-05-08T13:33:00.000+0000

Bạn có thể sử dụng thuộc tính conf_system_apigee.syslogger.dateFormat trên Trình xử lý thông báo Edge để kiểm soát định dạng đó.

Xem Chính sách ghi nhật ký tin nhắn.

(APIRT-4196)

Đã thêm tham số cấu hình SMTP bắt buộc mới vào quá trình cài đặt BaaS API

Giờ đây, bạn phải sử dụng tham số SMTPMAILFROM trong tệp cấu hình cài đặt API BaaS. Tham số này chỉ định địa chỉ email được dùng khi API BaaS gửi email tự động, chẳng hạn như khi người dùng yêu cầu đặt lại mật khẩu.

Xem Tài liệu tham khảo về tệp cấu hình BaaS.

(APIBAAS-2103)

Thêm chế độ hỗ trợ để cho phép Bộ định tuyến Edge và máy chủ web Nginx cho cổng truy cập vào các cổng dưới 1000

Giờ đây, bạn có thể sử dụng Router và máy chủ web Nginx cho cổng để truy cập vào các cổng dưới 1000 mà không cần chạy các cổng đó với tư cách là một người dùng khác. Trong các bản phát hành trước, Router và máy chủ web Nginx không thể truy cập vào các cổng dưới 1000 nếu không chạy các cổng đó với tư cách là một người dùng đặc biệt.

Thay đổi cách định cấu hình cấp độ ghi nhật ký cho giao diện người dùng Edge

Các thuộc tính dùng để định cấu hình cấp độ ghi nhật ký cho Giao diện người dùng Edge đã thay đổi. Hãy xem phần Đặt cấp độ nhật ký cho một thành phần Edge để biết các thuộc tính và quy trình mới.

(EDGEUI-886)

Dịch vụ API

Quy tắc đặt tên cho khoá và mã bí mật tuỳ chỉnh của người dùng

Chúng tôi đã cập nhật các quy tắc đặt tên và xác thực cho việc tạo khoá và thông tin bí mật tuỳ chỉnh của người dùng cho một ứng dụng của nhà phát triển. Khoá và thông tin bí mật của người dùng có thể chứa chữ cái, số, dấu gạch dưới và dấu gạch ngang. Không được dùng các ký tự đặc biệt khác.

Quy trình tạo khoá/bí mật tuỳ chỉnh được ghi lại đầy đủ hơn trong phần Nhập khoá và bí mật hiện có của người dùng. (MGMT-3916)

Xác thực tên Keystore và Target Server

Tên của kho khoá và Máy chủ đích có thể có tối đa 255 ký tự và có thể chứa chữ cái, số, dấu cách, dấu gạch ngang, dấu gạch dưới và dấu chấm. Edge hiện xác thực điều này tại thời điểm tạo. (MGMT-4098)

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. Danh sách này chủ yếu dành cho những người dùng kiểm tra xem phiếu yêu cầu hỗ trợ của họ đã được giải quyết hay chưa. Báo cáo này không được thiết kế để cung cấp thông tin chi tiết cho tất cả người dùng.

Private Cloud 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (UI)

Cloud 17.08.14 (Quản lý API và thời gian chạy)

Cloud 17.07.31 (Quản lý API)

Cloud 17.07.17 (Quản lý API và thời gian chạy)

Cloud 17.06.20 (Giao diện người dùng)

Cloud 17.06.14 (UI)

Cloud 17.05.22.01 (Kiếm tiền)

Cloud 17.05.22 (UI)

Cloud 17.05.22 (Quản lý API)

Cloud 17.05.08 (Giao diện người dùng)

Cloud 17.04.22 (Quản lý API)

Vấn đề đã biết

Bản phát hành này có các vấn đề đã biết sau đây: