Đặt lại mật khẩu Edge

Edge cho đám mây riêng tư phiên bản 4.19.01

Sau khi hoàn tất quá trình cài đặt, bạn có thể đặt lại các mật khẩu sau:

• OpenLDAP
• Quản trị viên hệ thống Apigee về Edge
• Người dùng tổ chức Edge
• Cassandra

Hướng dẫn đặt lại từng mật khẩu này được trình bày trong các phần tiếp theo.

Đặt lại mật khẩu Open LDAP

Cách đặt lại mật khẩu Open LDAP tuỳ thuộc vào cấu hình của bạn. Tuỳ thuộc vào cấu hình Edge, bạn có thể cài đặt Open LDAP dưới dạng:

• Một bản sao Open LDAP đượ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 thực thể OpenLDAP được cài đặt trên nút Máy chủ quản lý, được định cấu hình bằng bản sao chép Open LDAP. Ví dụ: trong cấu hình Edge 12 nút.
• Nhiều thực thể Open LDAP được cài đặt trên các nút riêng, được định cấu hình bằng bản sao chép Open LDAP. Ví dụ: trong cấu hình Edge 13 nút.

Đối với một thực thể OpenLDAP được cài đặt trên Máy chủ quản lý, hãy thực hiện như sau:

1. Trên nút Máy chủ quản lý, chạy lệnh sau để tạo mật khẩu OpenLDAP mới:

   /opt/apigee/apigee‑service/bin/apigee‑service apigee‑openldap 
     change‑ldap‑password ‑o OLD_PASSWORD ‑n NEW_PASSWORD

2. Chạy lệnh sau để lưu trữ mật khẩu mới để Máy chủ quản lý truy cập:

   /opt/apigee/apigee‑service/bin/apigee‑service edge‑management‑server 
     store_ldap_credentials ‑p NEW_PASSWORD

   Lệnh này sẽ khởi động lại Máy chủ quản lý.

Trong phần Thiết lập sao chép OpenLDAP với OpenLDAP đã cài đặt trên nút Máy chủ quản lý, hãy làm theo các bước ở trên trên cả hai nút Máy chủ quản lý để cập nhật mật khẩu.

Trong phần Thiết lập sao chép Open LDAP với OpenLDAP nằm trên một nút không phải Máy chủ quản lý, hãy đảm bảo trước tiên bạn thay đổi mật khẩu trên cả hai nút OpenLDAP, sau đó trên cả hai nút Máy chủ quản lý.

Đặt lại mật khẩu 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ách đặt lại mật khẩu của quản trị viên hệ thống:

1. 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 để đặt các thuộc tính sau:

   APIGEE_ADMINPW=NEW_PASSWORD
   SMTPHOST=smtp.gmail.com
   SMTPPORT=465
   SMTPUSER=foo@gmail.com
   SMTPPASSWORD=bar
   SMTPSSL=y
   SMTPMAILFROM="My Company <myco@company.com>"

   Lưu ý rằng bạn phải thêm các thuộc tính SMTP khi chuyể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.

2. Trên nút giao diện người dùng, dừng giao diện người dùng Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

3. 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 qua tệp cấu hình:

   /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

4. (Chỉ khi TLS được bật trên giao diện người dùng) Bật lại TLS trên giao diện người dùng Edge như mô tả trong bài viết Định cấu hình TLS cho giao diện người dùng quản lý.
5. Trên Máy chủ quản lý, hãy tạo một tệp XML mới. Trong tệp này, hãy đặt mã nhận dạng người dùng thành "admin" và xác định mật khẩu, họ, tên và địa chỉ email theo định dạng sau:

   <User id="admin">
     <Password><![CDATA[password]]></Password>
     <FirstName>first_name</FirstName>
     <LastName>last_name</LastName>
     <EmailId>email_address</EmailId>
   </User>

6. Trên Máy chủ quản lý, hãy thực thi lệnh sau:

   curl ‑u "admin_email_address:admin_password" ‑H \ 
     "Content‑Type: application/xml" ‑H "Accept: application/json" ‑X POST \ 
     "http://localhost:8080/v1/users/admin_email_address" ‑d @your_data_file

   Trong đó your_data_file là tệp bạn đã tạo ở bước trước.

   Edge sẽ cập nhật mật khẩu quản trị viên của bạn trên Máy chủ quản lý.

7. Xoá tệp XML bạn đã tạo. Tuyệt đối không lưu trữ mật khẩu ở dạng văn bản rõ ràng.

Trong môi trường sao chép Open LDAP 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 người dùng của 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, như trong ví dụ dưới đây:

/opt/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ụ:

/opt/apigee/apigee‑service/bin/apigee‑service apigee‑setup reset_user_password 
  ‑u user@myCo.com ‑p Foo12345 ‑a admin@myCo.com ‑P adminPword

cp ~/Documents/tmp/hybrid_root/apigeectl_beta2_a00ae58_linux_64/README.md 
  ~/Documents/utilities/README.md

Dưới đây là tệp cấu hình mẫu mà bạn có thể sử dụng với tuỳ chọn "-f":

USER_NAME=user@myCo.com
USER_PWD="Foo12345"
APIGEE_ADMINPW=ADMIN_PASSWORD

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 cho quản trị viên và người dùng của tổ chức

Sử dụng phần này để áp dụng độ dài và độ mạnh của mật khẩu mong muốn cho người dùng quản lý API. 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) để 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 /opt/apigee/customer/application/management-server.properties. Hãy tạo tệp nếu chưa có.

Sau khi chỉnh sửa management-server.properties, hãy khởi động lại máy chủ quản lý:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Sau đó, bạn có thể đặt điểm xếp hạng độ mạnh mật khẩu bằng cách nhóm các tổ hợp biểu thức chính quy khác nhau. Ví dụ: bạn có thể xác định rằng một mật khẩu chứa ít nhất một chữ hoa và một chữ cái viết thường sẽ có điểm xếp hạng độ 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 chữ số sẽ có điểm xếp hạng mạnh hơn là "4".

conf_security_password.validation.minimum.password.length=8
conf_security_password.validation.default.rating=2
conf_security_password.validation.minimum.rating.required=3

conf_security_password.validation.regex.1=^(.)\\1+$

conf_security_password.validation.regex.2=^.*[a-z]+.*$

conf_security_password.validation.regex.3=^.*[A-Z]+.*$

conf_security_password.validation.regex.4=^.*[0-9]+.*$

conf_security_password.validation.regex.5=^.*[^a-zA-z0-9]+.*$

conf_security_password.validation.regex.6=^.*[_]+.*$

conf_security_password.validation.regex.7=^.*[a-z]{2,}.*$

conf_security_password.validation.regex.8=^.*[A-Z]{2,}.*$

conf_security_password.validation.regex.9=^.*[0-9]{2,}.*$

conf_security_password.validation.regex.10=^.*[^a-zA-z0-9]{2,}.*$

conf_security_password.validation.regex.11=^.*[_]{2,}.*$

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

regex-index-list,[AND|OR],rating

conf_security_rbac.password.validation.enabled=true

Đặt lại mật khẩu Cassandra

Theo mặc định, Cassandra giao hàng 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 mật khẩu khác cho tài khoản này hoặc tạo một 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â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 phần 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 một nút Cassandra bất kỳ và mật khẩu đó sẽ được thông báo đến tất cả các nút Cassandra trong vòng tròn
• 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 và máy chủ Postgres trên mỗi nút bằng 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:

1. Đăng nhập vào một nút Cassandra bất kỳ 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à nút này sẽ được thông báo đến tất cả các nút Cassandra trong vòng tròn:

   /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

   Trong trường hợp:

   • 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 trước đây bạn đã đổi mật khẩu, hãy sử dụng mật khẩu hiện tại.
2. Chạy lệnh sau dưới dạng lời nhắc của cqlsh> để cập nhật mật khẩu:

   ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

   Nếu mật khẩu mới chứa một ký tự dấu ngoặc đơn, hãy thoát mật khẩu đó bằng cách thêm một ký tự dấu ngoặc đơn trước đó.

3. Thoát khỏi công cụ cqlsh:

   exit

4. Trên nút Máy chủ quản lý, hãy chạy lệnh sau:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD

   Bạn có thể tuỳ ý chuyển tệp vào 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:

   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ý.

5. Lặp lại bước 4 với:
   • Tất cả các bộ xử lý thư
   • Tất cả bộ định tuyến
   • Tất cả máy chủ Qpid (edge-qpid-server)
   • Máy chủ Postgres (edge-postgres-server)

Mật khẩu Cassandra hiện đã thay đổi.

Đặt lại mật khẩu PostgreSQL

Theo mặc định, cơ sở dữ liệu PostgreSQL có 2 người dùng được định nghĩa: "postgres" và "apigee". Cả hai người dùng đều có mật khẩu mặc định là "postgres". Hãy sử dụng quy trình sau đây để 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 có hai máy chủ Postgres đã định cấu hình ở chế độ chính/chế độ chờ, thì bạn chỉ phải 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 dự phòng chính cho Postgres để biết thêm thông tin.

1. Trên nút Master Postgres, hãy thay đổi các thư mục thành /opt/apigee/apigee-postgresql/pgsql/bin.
2. Đặt mật khẩu người dùng "postgres" PostgreSQL:
   1. Đăng nhập vào cơ sở dữ liệu PostgreSQL bằng lệnh:

      psql -h localhost -d apigee -U postgres

   2. Khi được nhắc, hãy nhập mật khẩu người dùng "postgres" hiện tại là "postgres".
   3. Tại lời nhắc lệnh PostgreSQL, hãy nhập lệnh sau để thay đổi mật khẩu mặc định:

      ALTER USER postgres WITH PASSWORD 'new_password';

      Khi thành công, PostgreSQL sẽ phản hồi như sau:

      ALTER ROLE

   4. Thoát khỏi cơ sở dữ liệu PostgreSQL bằng lệnh sau:

      \q

3. Đặt mật khẩu người dùng "apigee" PostgreSQL:
   1. Đăng nhập vào cơ sở dữ liệu PostgreSQL bằng lệnh:

      psql -h localhost -d apigee -U apigee

   2. Khi được nhắc, hãy nhập mật khẩu người dùng "apigee" là "postgres".
   3. Tại lời nhắc lệnh PostgreSQL, hãy nhập lệnh sau để thay đổi mật khẩu mặc định:

      ALTER USER apigee WITH PASSWORD 'new_password';

   4. Thoát khỏi cơ sở dữ liệu PostgreSQL bằng lệnh:

      \q

   Bạn có thể đặt mật khẩu của người dùng "postgres" và "apigee" thành cùng một giá trị hoặc khác giá trị.

4. Đặt APIGEE_HOME:

   export APIGEE_HOME=/opt/apigee/edge-postgres-server

5. Mã hoá mật khẩu mới:

   sh /opt/apigee/edge-postgres-server/utils/scripts/utilities/passwordgen.sh new_password

   Lệnh này trả về một mật khẩu đã mã hoá. Mật khẩu đã mã hoá bắt đầu sau ký tự ":" và không bao gồm ":"; ví dụ: mật khẩu đã mã hoá cho "apigee1234" là:

   Encrypted string:WheaR8U4OeMEM11erxA3Cw==

6. Cập nhật nút Máy chủ quản lý bằng mật khẩu đã mã hoá mới cho người dùng "postgres" và "apigee".
   1. Trên Máy chủ quản lý, hãy thay đổi thư mục thành /opt/apigee/customer/application.
   2. Chỉnh sửa tệp management-server.properties để thiết lập 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.
   3. Đảm bảo tệp thuộc sở hữu của người dùng "apigee":

      chown apigee:apigee management-server.properties

7. 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.
   1. Trên nút Máy chủ Postgres hoặc nút Máy chủ Qpid, hãy đổi sang thư mục sau:

      /opt/apigee/customer/application

   2. Mở các tệp sau để chỉnh sửa:
      • postgres-server.properties
      • qpid-server.properties

      Nếu các tệp này chưa có, hãy tạo tệp.

   3. Thêm các thuộc tính sau vào tệp:
      • 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
   4. Đả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

8. Cập nhật thành phần SSO (nếu tính năng SSO đã bật):

   1. Kết nối hoặc đăng nhập vào nút mà thành phần apigee-sso đang chạy. Đây còn được gọi là máy chủ SSO.

      Trong quá trình cài đặt AIO hoặc 3 nút, nút này giống với Máy chủ quản lý.

      Nếu có nhiều nút đang chạy thành phần apigee-sso, bạn phải thực hiện các bước này trên từng nút.

   2. Mở tệp sau để chỉnh sửa:

      /opt/apigee/customer/application/sso.properties 

      Hãy tạo tệp nếu chưa có.

   3. Thêm dòng sau vào tệp:

      conf_uaa_database_password=new_password_in_plain_text

      Ví dụ:

      conf_uaa_database_password=apigee1234

   4. Thực thi lệnh sau để áp dụng các thay đổi về cấu hình cho thành phần apigee-sso:

      /opt/apigee/apigee-service/bin/apigee-service apigee-sso configure

   5. Lặp lại các bước này cho từng máy chủ SSO.
9. Khởi động lại các thành phần sau theo thứ tự sau:
   1. Cơ sở dữ liệu PostgreSQL:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

   2. Máy chủ Qpid:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

   3. Máy chủ Postgres:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

   4. Máy chủ quản lý:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

   5. Máy chủ SSO:

      /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart