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

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X. thông tin

Kể từ Bản phát hành tính năng Edge cho đám mây riêng 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ề việc đánh số bản phát hành để tìm hiểu 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à bổ sung tính năng hỗ trợ cho 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. Khi sử dụng SAML với Edge, bạn có thể hỗ trợ SSO cho API và giao diện người dùng Edge, ngoài mọi dịch vụ khác mà bạn cung cấp và cũng hỗ trợ SAML.

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

• 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à bị gỡ bỏ quyền truy cậ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 nhiều loại xác thực 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 doanh nghiệp của bạn.
• Bạn có thể theo dõi các lượt đăng nhập, đăng xuất, các lần đăng nhập không thành công và các hoạt động có rủi ro cao trên bản 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 trên Edge kiểm soát.

Hãy xem bài viết Hỗ trợ SAML trên Edge cho Đám mây riêng tư để 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 thông tin 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 khoá người dùng tuỳ chỉnh và khoá bí mật
• Hỗ trợ Red Hat/CentOS phiên bản 7.4

Phần còn lại của chủ đề này trình bày thông tin chi tiết về tất 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 đã ngừng hoạt động hoặc bị gỡ bỏ trong bản phát hành này. Vui lòng xem Chính sách về việc ngừng sử dụng Edge để 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 Apigee (kho tiền)

Kho lưu trữ bảo mật của Apigee, còn gọi là "kho tiền", không còn đượ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á của các cặp khoá/giá trị được tạo bằng API quản lý và truy cập trong thời gian chạy bằng các hàm trong mô-đun Node.js apigee-access.

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

Ngừng sử dụng tính năng thêm đường dẫn trên thẻ Hiệu suất proxy API

Cho đến bản phát hành này, bạn có thể chuyển đến một proxy API trong giao diện người dùng quản lý, chuyển đến thẻ Hiệu suất và tạo nhiều đường dẫn để 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. Để tìm 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: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html. (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 các điểm cải tiến sau, bản phát hành này còn chứa nhiều điểm cải tiến về khả năng hữu dụng, hiệu suất, bảo mật và độ ổn định.

Đám mây riêng

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

Edge hiện hỗ trợ Ngôn ngữ đánh dấu xác thực 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). Khi sử dụng SAML, bạn có thể hỗ trợ SSO cho Edge, cùng với mọi dịch vụ khác mà bạn cung cấp và cũng hỗ trợ SAML.

Xem phần Hỗ trợ SAML trên Edge cho đám mây riêng.

Thêm tiện ích apigee-ssoadminapi.sh

Sau khi bật SAML, bạn có thể sử dụng apigee-ssoadminapi.sh mới để thực hiện nhiều nhiệm 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 thông tin Dịch vụ dành cho nhà phát triển từ Apache/MySQL/MariaDB sang Nginx/postgres

Cài đặt dựa trên tệp .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 cổng thông tin hiện tại để sử dụng Nginx và Postgres. Bạn bắt buộc phải di chuyển nếu muốn cập nhật lên phiên bản cổng thông tin 4.17.09.

Hãy xem phần Chuyển đổi cổng thông tin dựa trên tar sang cổng thông tin dựa trên RPM.

Thêm tính 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 Phần mềm và phiên bản được hỗ trợ.

Thêm thuộc tính để yêu cầu 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 "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ớ cho thành phần đang được cài đặt. Hãy xem mục 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 tính năng 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á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ử dụng địa chỉ IP đầu tiên được trả về. Địa chỉ này có thể không chính xác trong một số trường hợp. Ngoài ra, bạn có thể đặt thuộc tính sau trong tệp cấu hình cài đặt:

ENABLE_DYNAMIC_HOSTIP=y

Khi thuộc tính đó được đặt thành "y", trình cài đặt sẽ nhắc bạn chọn địa chỉ IP để sử dụng trong 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 tuỳ chọn giao diện người dùng và API mới để đị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 dành cho Đám mây hiện đã có trong Đám mây riêng tư dưới dạng 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á và kho tin cậy trong giao diện người dùng cũng như 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

Tài liệu Beta (PDF) cho các tính năng này có sẵn 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 Kho khoá và Kho tin cậy

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

• Các cách định cấu hình TLS
• Định cấu hình quyền truy cập TLS vào 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 đám mây

(EDGEUI-1058)

Thêm lệnh mật khẩu được làm rối

Thêm một lệnh để tạo mật khẩu được 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 được làm rối mã nguồn 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 rồi 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 hiển thị. Lệnh này trả về mật khẩu ở dạng:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

Xem bài viết Định cấu hình TLS/SSL cho Edge On Premises.

(TBD-250)

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

Để đặt lại mật khẩu cho người dùng 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 đó là mật khẩu của người dùng mới. 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 bài viết Đặ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ể sử 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 dấu thời gian trong thông điệp 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 báo 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ý thông báo.

(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 API BaaS

Giờ đây, bạn phải sử dụng thông 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 tính năng hỗ trợ để cho phép Edge Router 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 Trình định tuyến 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 đó dưới dạng một người dùng khác. Trong các bản phát hành trước, Trình định tuyến và máy chủ web Nginx không thể truy cập vào các cổng dưới 1000 mà không chạy các cổng đó dưới dạng 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 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 bí mật và khoá người dùng tuỳ chỉnh

Chúng tôi đã cập nhật quy tắc đặt tên và quy trình xác thực để tạo khoá và thông tin bí mật tuỳ chỉnh của người dùng cho ứng dụng dành cho 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 nối. Không được sử dụng ký tự đặc biệt nào khác.

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

Xác thực tên Kho khoá và Máy chủ mục tiêu

Tên của kho khoá và Máy chủ mục tiêu 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 thông tin này tại thời điểm tạo. (MGMT-4098)

Sửa lỗi

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 người dùng kiểm tra xem phiếu yêu cầu hỗ trợ của họ đã được khắc phục hay chưa. Tính năng này không nhằm 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 (Giao diện người dùng)

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 (Giao diện người dùng)

Cloud 17.05.22.01 (Kiếm tiền)

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

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: