Edge cho đám mây riêng tư phiên bản 4.16.05
Bạn có thể đặt lại mật khẩu OpenLDAP, quản trị viên hệ thống Apigee Edge, người dùng tổ chức Edge và Cassandra sau khi quá trình cài đặt hoàn tất.
Đặt lại mật khẩu OpenLDAP
Tuỳ thuộc vào cấu hình Edge, bạn có thể cài đặt OpenLDAP dưới dạng:
- Một phiên bản OpenLDAP duy nhất được cài đặt trên nút Máy chủ quản lý. Ví dụ: trong cấu hình Edge 2 nút, 5 nút hoặc 9 nút.
- Nhiều phiên bản OpenLDAP được cài đặt trên các nút Máy chủ quản lý, được định cấu hình bằng tính năng sao chép OpenLDAP. Ví dụ: trong cấu hình Edge 12 nút.
- Nhiều phiên bản OpenLDAP được cài đặt trên các nút riêng, được định cấu hình bằng tính năng sao chép OpenLDAP. Ví dụ: trong cấu hình Edge 13 nút.
Cách đặt lại mật khẩu OpenLDAP phụ thuộc vào cấu hình của bạn.
Đối với một phiên bản OpenLDAP duy nhất được cài đặt trên Máy chủ quản lý, hãy thực hiện sau:
- Trên nút Máy chủ quản lý, hãy chạy lệnh sau để tạo mật khẩu OpenLDAP mới:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword - Chạy lệnh sau để lưu trữ mật khẩu mới cho quyền truy cập của Máy chủ quản lý:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPword
Lệnh này sẽ khởi động lại Máy chủ quản lý.
Trong quy trình thiết lập sao chép OpenLDAP có cài đặt OpenLDAP trên các nút Máy chủ quản lý, hãy làm theo các bước nêu trên trên cả hai nút Máy chủ quản lý để cập nhật mật khẩu.
Trong quy trình thiết lập sao chép OpenLDAP với OpenLDAP nằm trên một nút không phải là Máy chủ quản lý, hãy đảm bảo rằng trước tiên bạn thay đổi mật khẩu trên cả hai nút OpenLDAP, sau đó thay đổi mật khẩu trên cả hai nút Máy chủ quản lý.
Đặt lại mật khẩu của quản trị viên hệ thống
Để đặt lại mật khẩu quản trị viên hệ thống, bạn cần đặt lại mật khẩu ở hai nơi:
- Máy chủ quản lý
- Giao diện người dùng
Cảnh báo: Bạn nên dừng giao diện người dùng Edge trước khi đặt lại mật khẩu quản trị viên hệ thống. Vì bạn đặt lại mật khẩu trước trên Máy chủ quản lý, nên có thể có một khoảng thời gian ngắn khi giao diện người dùng vẫn sử dụng mật khẩu cũ. Nếu giao diện người dùng thực hiện hơn ba lệnh gọi bằng mật khẩu cũ, thì máy chủ OpenLDAP sẽ khoá tài khoản quản trị viên hệ thống trong ba phút.
Cách đặt lại mật khẩu quản trị viên hệ thống:
- Trên nút giao diện người dùng, hãy dừng giao diện người dùng Edge:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui stop - Trên Máy chủ quản lý, hãy chạy lệnh sau để đặt lại mật khẩu:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server change_sysadmin_password -o currentPW -n newPW - Chỉnh sửa tệp cấu hình im lặng mà bạn đã dùng để cài đặt giao diện người dùng Edge nhằm đặt các thuộc tính sau:
APIGEE_ADMINPW=newPW
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=foo@gmail.com
SMTPPASSWORD=bar
SMTPSSL=y
Xin lưu ý rằng bạn phải thêm các thuộc tính SMTP khi truyền mật khẩu mới vì tất cả thuộc tính trên giao diện người dùng đều được đặt lại. - Sử dụng tiện ích apigee-setup để đặt lại mật khẩu trên giao diện người dùng Edge từ tệp cấu hình:
> /<inst_root>/apigee/apigee-setup/bin/setup.sh -p ui -f configFile - Bắt đầu giao diện người dùng Edge trên nút giao diện người dùng:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-ui start
Trong môi trường Sao chép OpenLDAP có nhiều Máy chủ quản lý, việc đặt lại mật khẩu trên một Máy chủ quản lý sẽ tự động cập nhật Máy chủ quản lý khác. Tuy nhiên, bạn phải cập nhật riêng tất cả các nút giao diện người dùng Edge.
Đặt lạ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, hãy sử dụng tiện ích apigee-servce để gọi apigee-setup:
/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password [-h] [-u USER_EMAIL] [-p USER_PWD] [-a ADMIN_EMAIL] [-P APIGEE_ADMINPW] [-f configFile]
Ví dụ:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-setup reset_user_password -u user@myCo.com -p foo12345 -a admin@myCo.com -P adminPword
Dưới đây là ví dụ về tệp cấu hình mà bạn có thể sử dụng với tuỳ chọn "-f":
USER_NAME= user@myCo.com USER_PWD= "foo12345" APIGEE_ADMINPW= adminPword
Bạn cũng có thể sử dụng API Cập nhật người dùng để thay đổi mật khẩu của người dùng.
Quy tắc về mật khẩu của quản trị viên hệ thống và người dùng trong tổ chức
Sử dụng phần này để thực thi độ dài và độ mạnh mật khẩu mong muốn cho người dùng quản lý API của bạn. Chế độ cài đặt này sử dụng một loạt biểu thức chính quy được định cấu hình sẵn (và được đánh số riêng biệt) để kiểm tra nội dung mật khẩu (chẳng hạn như chữ hoa, chữ thường, số và ký tự đặc biệt). Ghi các chế độ cài đặt này vào tệp /<inst_root>/apigee/customer/application/management-server.properties. Nếu tệp đó không tồn tại, hãy tạo tệp.
Sau khi chỉnh sửa management-server.properties, hãy khởi động lại máy chủ quản lý:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart
Sau đó, bạn có thể đặt mức xếp hạng độ mạnh mật khẩu bằng cách nhóm nhiều kiểu kết hợp biểu thức chính quy. Ví dụ: bạn có thể xác định rằng mật khẩu có ít nhất một chữ cái viết hoa và một chữ cái viết thường sẽ có mức độ mạnh là "3", nhưng mật khẩu có ít nhất một chữ cái viết thường và một số sẽ có mức độ mạnh hơn là "4".
|
Thuộc tính |
Nội dung mô tả |
|---|---|
|
conf_security_password.validation.minimum. conf_security_password.validation.default.rating=2 conf_security_password.validation.minimum. |
Hãy sử dụng các thuộc tính này để xác định các đặc điểm chung của mật khẩu hợp lệ. Mức xếp hạng tối thiểu mặc định cho độ mạnh mật khẩu (được mô tả ở phần sau trong bảng) là 3. Lưu ý rằng password.validation.default.rating=2 thấp hơn mức xếp hạng tối thiểu bắt buộc, nghĩa là nếu mật khẩu đã nhập không tuân theo các quy tắc bạn định cấu hình, thì mật khẩu đó sẽ được xếp hạng 2 và do đó không hợp lệ (dưới mức xếp hạng tối thiểu là 3). |
|
Sau đây là các biểu thức chính quy xác định đặc điểm của mật khẩu. Lưu ý rằng mỗi mục đều được đánh số. Ví dụ: "password.validation.regex.5=…" là biểu thức số 5. Bạn sẽ sử dụng những con số này trong phần sau của tệp để đặt các tổ hợp khác nhau nhằm xác định độ mạnh mật khẩu tổng thể. |
|
|
conf_security_password.validation.regex.1=^(.)\\1+$ |
1 – Lặp lại tất cả ký tự |
|
conf_security_password.validation.regex.2=^.*[a-z]+.*$ |
2 – Ít nhất một chữ cái viết thường |
|
conf_security_password.validation.regex.3=^.*[A-Z]+.*$ |
3 – Ít nhất một chữ cái viết hoa |
|
conf_security_password.validation.regex.4=^.*[0-9]+.*$ |
4 – Ít nhất một chữ số |
|
conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$ |
5 – Ít nhất một ký tự đặc biệt (không bao gồm dấu gạch dưới _) |
|
conf_security_password.validation.regex.6=^.*[_]+.*$ |
6 – Ít nhất một dấu gạch dưới |
|
conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$ |
7 – Có nhiều hơn một chữ cái viết thường |
|
conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$ |
8 – Có nhiều hơn một chữ cái viết hoa |
|
conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$ |
9 – Nhiều hơn một chữ số |
|
conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$ |
10 – Có nhiều ký tự đặc biệt (không bao gồm dấu gạch dưới) |
|
conf_security_password.validation.regex.11=^.*[_]{2,}.*$ |
11 – Nhiều hơn một dấu gạch dưới |
|
Các quy tắc sau đây xác định độ mạnh mật khẩu dựa trên nội dung mật khẩu. Mỗi quy tắc bao gồm một hoặc nhiều biểu thức chính quy từ phần trước và chỉ định một độ mạnh bằng số cho quy tắc đó. Độ mạnh của mật khẩu (dưới dạng số) được so sánh với số conf_security_password.validation.minimum.rating.required ở đầu tệp này để xác định xem mật khẩu có hợp lệ hay không. |
|
|
conf_security_password.validation.rule.1=1,AND,0 conf_security_password.validation.rule.2=2,3,4,AND,4 conf_security_password.validation.rule.3=2,9,AND,4 conf_security_password.validation.rule.4=3,9,AND,4 conf_security_password.validation.rule.5=5,6,OR,4 conf_security_password.validation.rule.6=3,2,AND,3 conf_security_password.validation.rule.7=2,9,AND,3 conf_security_password.validation.rule.8=3,9,AND,3 |
Mỗi quy tắc đều được đánh số. Ví dụ: "password.validation.rule.3=…" là quy tắc số 3. Mỗi quy tắc sử dụng định dạng sau (bên phải dấu bằng): <regex-index-list>,<AND|OR>,<rating> regex-index-list là danh sách các biểu thức chính quy (theo số từ phần trước), cùng với toán tử AND|OR (nghĩa là xem xét tất cả hoặc bất kỳ biểu thức nào được liệt kê). rating là điểm xếp hạng độ mạnh bằng số được gán cho mỗi quy tắc. Ví dụ: quy tắc 5 có nghĩa là bất kỳ mật khẩu nào có ít nhất một ký tự đặc biệt HOẶC một dấu gạch dưới đều được xếp hạng độ mạnh là 4. Với password.validation.minimum. |
|
conf_security_rbac.password.validation.enabled=true |
Đặt chế độ xác thực mật khẩu kiểm soát quyền truy cập dựa trên vai trò thành false khi bật tính năng đăng nhập một lần (SSO). Mặc định là đúng. |
Đặt lại mật khẩu Cassandra
Theo mặc định, Cassandra được cung cấp khi tính năng xác thực bị tắt. Nếu bạn bật tính năng xác thực, tính năng này sẽ sử dụng một người dùng được xác định trước có tên là "cassandra" với mật khẩu là "cassandra". Bạn có thể sử dụng tài khoản này, đặt mật khẩu khác cho tài khoản này hoặc tạo người dùng Cassandra mới. Thêm, xoá và sửa đổi người dùng bằng cách sử dụng các câu lệnh CREATE/ALTER/DROP USER của Cassandra.
Để biết thông tin về cách bật tính năng xác thực Cassandra, hãy xem bài viết Bật tính năng xác thực Cassandra.
Để đặt lại mật khẩu Cassandra, bạn phải:
- Đặt mật khẩu trên bất kỳ nút Cassandra nào và mật khẩu đó sẽ được truyền đến tất cả các nút Cassandra trong vòng
- Cập nhật Máy chủ quản lý, Bộ xử lý thông báo, Bộ định tuyến, máy chủ Qpid, máy chủ Postgres, và Ngăn xếp BaaS trên mỗi nút có mật khẩu mới
Để biết thêm thông tin, hãy xem http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html.
Cách đặt lại mật khẩu Cassandra:
- Đăng nhập vào bất kỳ nút Cassandra nào bằng công cụ cqlsh và thông tin đăng nhập mặc định. Bạn chỉ phải thay đổi mật khẩu trên một nút Cassandra và mật khẩu đó sẽ được
phát đến tất cả các nút Cassandra trong vòng:
> /<inst_root>/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
Trong đó:- cassIP là địa chỉ IP của nút Cassandra.
- 9042 là cổng Cassandra.
- Người dùng mặc định là cassandra.
- Mật khẩu mặc định là cassandra. Nếu bạn đã thay đổi mật khẩu trước đó, hãy sử dụng mật khẩu hiện tại.
- Chạy lệnh sau tại dấu nhắc cqlsh> để cập nhật mật khẩu:
cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
Nếu mật khẩu mới chứa một ký tự dấu nháy đơn, hãy thoát ký tự đó bằng cách thêm một ký tự dấu nháy đơn vào trước ký tự đó. - Thoát khỏi công cụ cqlsh:
cqlsh> exit - Trên nút Máy chủ quản lý, hãy chạy lệnh sau:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD
Nếu muốn, bạn có thể truyền một tệp đến lệnh chứa tên người dùng và mật khẩu mới:
> apigee-service edge-management-server store_cassandra_credentials -f configFile
Trong đó configFile chứa thông tin sau:
CASS_USERNAME=CASS_USERNAME
CASS_PASSWORD=CASS_PASSWROD
Lệnh này tự động khởi động lại Máy chủ quản lý. - Lặp lại bước 4 trên:
- Tất cả bộ xử lý thông báo
- Tất cả bộ định tuyến
- Tất cả máy chủ Qpid (edge-qpid-server)
- Máy chủ Postgres (edge-postgres-server)
- Trên nút BaaS Stack cho phiên bản 4.16.05.04 trở lên:
- Chạy lệnh sau để tạo mật khẩu đã mã hoá:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password
Lệnh này sẽ nhắc bạn nhập mật khẩu dạng văn bản thuần túy và trả về mật khẩu đã mã hoá ở dạng:
SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050 - Đặt các mã thông báo sau trong /opt/apigee/customer/application/usergrid.properties.
Nếu tệp đó không tồn tại, hãy tạo tệp:
usergrid-deployment_cassandra.username=cassandra
usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
Ví dụ này sử dụng tên người dùng mặc định cho Cassandra. Nếu bạn đã thay đổi tên người dùng, hãy đặt giá trị của usergrid-deployment_cassandra.username cho phù hợp.
Đảm bảo rằng bạn thêm tiền tố "SECURE:" vào mật khẩu. Nếu không, BaaS Stack sẽ diễn giải giá trị là không được mã hoá.
Lưu ý: Mỗi nút BaaS Stack đều có khoá riêng biệt dùng để mã hoá mật khẩu. Do đó, bạn phải tạo giá trị đã mã hoá trên từng nút BaaS Stack riêng biệt. - Thay đổi quyền sở hữu tệp usergrid.properties thành
người dùng "apigee":
> chown apigee:apigee /opt/apigee/customer/application/usergrid.properties - Định cấu hình nút Ngăn xếp:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid configure - Khởi động lại BaaS Stack:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart - Lặp lại các bước này cho tất cả các nút BaaS Stack.
- Chạy lệnh sau để tạo mật khẩu đã mã hoá:
Mật khẩu Cassandra hiện đã được thay đổi.
Đang đặt lại mật khẩu PostgreSQL
Theo mặc định, cơ sở dữ liệu PostgreSQL có hai người dùng được xác định: "postgres" và "apigee". Cả hai người dùng đều có mật khẩu mặc định là "postgres". Hãy làm theo quy trình sau để thay đổi mật khẩu mặc định.
Thay đổi mật khẩu trên tất cả các nút chính của Postgres. Nếu đã định cấu hình hai máy chủ Postgres ở chế độ chính/chờ, thì bạn chỉ cần thay đổi Mật khẩu trên nút chính. Hãy xem bài viết Thiết lập tính năng sao chép chính-phụ cho Postgres để biết thêm thông tin.
- Trên nút Postgres chính, hãy thay đổi thư mục thành /<inst_root>/apigee/apigee-postgresql/pgsql/bin, trong đó /<inst_root> mặc định là /opt.
- Đặt mật khẩu cho người dùng "postgres" của PostgreSQL:
- Đăng nhập vào cơ sở dữ liệu PostgreSQL bằng lệnh:
> psql -h localhost -d apigee -U postgres - Khi được nhắc, hãy nhập mật khẩu người dùng "postgres" là "postgres".
- Tại dấu nhắc lệnh PostgreSQL, hãy nhập lệnh sau để thay đổi mật khẩu mặc định:
apigee=> ALTER USER postgres WITH PASSWORD 'apigee1234'; - Thoát khỏi cơ sở dữ liệu PostgreSQL bằng lệnh:
apigee=> \q
- Đăng nhập vào cơ sở dữ liệu PostgreSQL bằng lệnh:
- Đặt mật khẩu người dùng "apigee" của PostgreSQL:
- Đăng nhập vào cơ sở dữ liệu PostgreSQL bằng lệnh:
> psql -h localhost -d apigee -U apigee - Khi được nhắc, hãy nhập mật khẩu người dùng "apigee" là "postgres".
- Tại dấu nhắc lệnh PostgreSQL, hãy nhập lệnh sau để thay đổi mật khẩu mặc định:
apigee=> ALTER USER apigee WITH PASSWORD 'apigee1234'; - Thoát khỏi cơ sở dữ liệu PostgreSQL bằng lệnh:
apigee=> \q
- Đăng nhập vào cơ sở dữ liệu PostgreSQL bằng lệnh:
- Đặt APIGEE_HOME:
> export APIGEE_HOME=/<inst_root>/apigee/edge-postgres-server - Mã hoá mật khẩu mới:
> sh /<inst_root>/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh apigee1234
Lệnh này trả về mật khẩu đã mã hoá như dưới đây. Mật khẩu đã mã hoá bắt đầu sau ký tự ":" và không bao gồm ký tự ":".
Chuỗi đã mã hoá :WheaR8U4OeMEM11erxA3Cw== - Cập nhật nút Máy chủ quản lý bằng mật khẩu mới đã mã hoá cho người dùng "postgres" và "apigee".
- Trên Máy chủ quản lý, hãy thay đổi thư mục thành /<inst_root>/apigee/customer/application.
- Chỉnh sửa tệp management-server.properties để đặt các thuộc tính sau. Nếu tệp này không tồn tại, hãy tạo tệp:
Lưu ý: Một số thuộc tính lấy mật khẩu người dùng "postgres" đã mã hoá và một số thuộc tính lấy mật khẩu người dùng "apigee" đã mã hoá.- conf_pg-agent_password=newEncryptedPasswordForPostgresUser
- conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
- conf_query-service_pgDefaultPwd=newEncryptedPasswordForApigeeUser
- conf_query-service_dwDefaultPwd=newEncryptedPasswordForApigeeUser
- conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- Đảm bảo tệp thuộc sở hữu của người dùng "apigee":
> chown apigee:apigee management-server.properties
- Cập nhật tất cả các nút Máy chủ Postgres và Máy chủ Qpid bằng mật khẩu đã mã hoá mới.
- Trên nút Máy chủ Postgres hoặc Máy chủ Qpid, hãy thay đổi thư mục thành /<inst_root>/apigee/customer/application.
- Chỉnh sửa các tệp sau. Nếu các tệp này không tồn tại, hãy tạo chúng:
- postgres-server.properties
- qpid-server.properties
- Thêm các thuộc tính sau vào tệp:
Lưu ý: Tất cả các thuộc tính này đều lấy mật khẩu người dùng "postgres" đã mã hoá.- conf_pg-agent_password=newEncryptedPasswordForPostgresUser
- conf_pg-ingest_password=newEncryptedPasswordForPostgresUser
- conf_query-service_pgDefaultPwd=newEncryptedPasswordForPostgresUser
- conf_query-service_dwDefaultPwd=newEncryptedPasswordForPostgresUser
- conf_analytics_aries.pg.password=newEncryptedPasswordForPostgresUser
- Đảm bảo các tệp thuộc sở hữu của người dùng "apigee":
> chown apigee:apigee postgres-server.properties
> chown apigee:apigee qpid-server.properties
- Khởi động lại các thành phần sau theo thứ tự này:
- Cơ sở dữ liệu PostgreSQL:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Máy chủ Qpid:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-qpid-server restart - Máy chủ Postgres:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-postgres-server restart - Máy chủ quản lý:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart
- Cơ sở dữ liệu PostgreSQL: