รีเซ็ตรหัสผ่าน Edge

หลังจากติดตั้งเสร็จแล้ว คุณจะรีเซ็ตรหัสผ่านต่อไปนี้ได้

• SymasLDAP
• ผู้ดูแลระบบ Apigee Edge
• ผู้ใช้ในองค์กร Edge
• Cassandra

วิธีการรีเซ็ตรหัสผ่านแต่ละรายการเหล่านี้จะอยู่ในส่วนถัดไป

รีเซ็ตรหัสผ่าน SymasLDAP

วิธีรีเซ็ตรหัสผ่าน SymasLDAP จะขึ้นอยู่กับการกำหนดค่าของคุณ SymasLDAP สามารถติดตั้งได้ดังนี้ ทั้งนี้ขึ้นอยู่กับการกำหนดค่า Edge

• อินสแตนซ์เดียวของ SymasLDAP ที่ติดตั้งในโหนดเซิร์ฟเวอร์การจัดการ เช่น ในการกำหนดค่า Edge แบบ 2 โหนด, 5 โหนด หรือ 9 โหนด
• อินสแตนซ์ SymasLDAP หลายรายการที่ติดตั้งในโหนดเซิร์ฟเวอร์การจัดการ ซึ่งกำหนดค่าด้วยการจำลอง SymasLDAP เช่น ในการกำหนดค่า Edge แบบ 12 โหนด
• ติดตั้งอินสแตนซ์ SymasLDAP หลายรายการในโหนดของตนเอง ซึ่งกำหนดค่าด้วยการจำลองแบบ SymasLDAP เช่น ในการกำหนดค่า Edge แบบ 13 โหนด

สำหรับอินสแตนซ์เดียวของ SymasLDAP ที่ติดตั้งในเซิร์ฟเวอร์การจัดการ ให้ทำดังนี้

1. ในโหนด Management Server ให้เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างรหัสผ่าน SymasLDAP ใหม่

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

2. เรียกใช้คำสั่งต่อไปนี้เพื่อจัดเก็บรหัสผ่านใหม่สำหรับการเข้าถึงโดยเซิร์ฟเวอร์การจัดการ

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

   คำสั่งนี้จะรีสตาร์ทเซิร์ฟเวอร์การจัดการ

ในการตั้งค่าการจำลอง SymasLDAP ที่ติดตั้ง SymasLDAP ไว้ในโหนด Management Server ให้ทำตามขั้นตอนข้างต้นในโหนด Management Server ทั้ง 2 โหนดเพื่ออัปเดตรหัสผ่าน

ในการตั้งค่าการจำลองแบบ SymasLDAP โดยที่ SymasLDAP อยู่ในโหนดอื่นที่ไม่ใช่เซิร์ฟเวอร์การจัดการ ให้ตรวจสอบว่าคุณได้เปลี่ยนรหัสผ่านในโหนด SymasLDAP ทั้ง 2 โหนดก่อน แล้วจึงเปลี่ยนในโหนดเซิร์ฟเวอร์การจัดการทั้ง 2 โหนด

รีเซ็ตรหัสผ่านผู้ดูแลระบบ

การรีเซ็ตรหัสผ่านของผู้ดูแลระบบจำเป็นต้องรีเซ็ตรหัสผ่านใน 2 ตำแหน่ง ดังนี้

• เซิร์ฟเวอร์การจัดการ
• UI ใหม่ของ Edge

วิธีรีเซ็ตรหัสผ่านของผู้ดูแลระบบ

1. แก้ไขไฟล์การกำหนดค่าแบบเงียบที่คุณใช้ติดตั้ง UI ของ Edge ใหม่เพื่อตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้

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

   โปรดทราบว่าคุณต้องรวมพร็อพเพอร์ตี้ SMTP เมื่อส่งรหัสผ่านใหม่ เนื่องจากระบบจะรีเซ็ตพร็อพเพอร์ตี้ทั้งหมดใน UI ของ Edge เวอร์ชันใหม่

2. ในโหนด New Edge UI ให้หยุด New Edge UI โดยทำดังนี้

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

3. ใช้ยูทิลิตี apigee-setup เพื่อรีเซ็ตรหัสผ่านใน UI ใหม่ของ Edge จากไฟล์การกำหนดค่า ดังนี้

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

4. (เฉพาะในกรณีที่เปิดใช้ TLS ใน Edge UI ใหม่) เปิดใช้ TLS อีกครั้งใน Edge UI ใหม่ตามที่อธิบายไว้ในหัวข้อการกำหนดค่า TLS สำหรับ Edge UI ใหม่
5. สร้างไฟล์ XML ใหม่ในเซิร์ฟเวอร์การจัดการ ในไฟล์นี้ ให้ตั้งค่ารหัสผู้ใช้เป็น "admin" และกำหนดรหัสผ่าน ชื่อ นามสกุล และอีเมลโดยใช้รูปแบบต่อไปนี้

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

6. ในเซิร์ฟเวอร์การจัดการ ให้เรียกใช้คำสั่งต่อไปนี้

   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
   

   โดย your_data_file คือไฟล์ที่คุณสร้างในขั้นตอนก่อนหน้า

   Edge จะอัปเดตรหัสผ่านของผู้ดูแลระบบในเซิร์ฟเวอร์การจัดการ

7. ลบไฟล์ XML ที่คุณสร้างขึ้น ไม่ควรจัดเก็บรหัสผ่านเป็นข้อความธรรมดาอย่างถาวร

ในสภาพแวดล้อมการจำลอง SymasLDAP ที่มีเซิร์ฟเวอร์การจัดการหลายเครื่อง การรีเซ็ตรหัสผ่านในเซิร์ฟเวอร์การจัดการเครื่องหนึ่งจะอัปเดตเซิร์ฟเวอร์การจัดการเครื่องอื่นๆ โดยอัตโนมัติ อย่างไรก็ตาม คุณต้องอัปเดตโหนด UI ของ Edge ใหม่ทั้งหมดแยกกัน

รีเซ็ตรหัสผ่านของผู้ใช้ในองค์กร

หากต้องการรีเซ็ตรหัสผ่านสำหรับผู้ใช้ในองค์กร ให้ใช้ยูทิลิตี apigee-servce เพื่อ เรียกใช้ apigee-setup ดังตัวอย่างต่อไปนี้

/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]

เช่น

/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

ตัวอย่างไฟล์การกำหนดค่าที่คุณใช้กับตัวเลือก "-f" ได้มีดังนี้

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

นอกจากนี้ คุณยังใช้ API Update user เพื่อเปลี่ยนรหัสผ่านของผู้ใช้ได้ด้วย

กฎรหัสผ่านของผู้ดูแลระบบและผู้ใช้ในองค์กร

ใช้ส่วนนี้เพื่อบังคับใช้ความยาวและระดับความปลอดภัยของรหัสผ่านที่ต้องการสำหรับผู้ใช้การจัดการ API การตั้งค่าจะใช้นิพจน์ทั่วไปที่กำหนดค่าไว้ล่วงหน้า (และมีหมายเลขเฉพาะ) เพื่อตรวจสอบเนื้อหาของรหัสผ่าน (เช่น ตัวพิมพ์ใหญ่ ตัวพิมพ์เล็ก ตัวเลข และสัญลักษณ์พิเศษ) เขียนการตั้งค่าเหล่านี้ลงในไฟล์ /opt/apigee/customer/application/management-server.properties หากไม่มีไฟล์ดังกล่าว ให้สร้างไฟล์

หลังจากแก้ไข management-server.properties แล้ว ให้รีสตาร์ทเซิร์ฟเวอร์การจัดการโดยทำดังนี้

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

จากนั้นคุณจะตั้งค่าระดับความปลอดภัยของรหัสผ่านได้โดยจัดกลุ่มชุดค่าผสมต่างๆ ของนิพจน์ทั่วไป เช่น คุณอาจกำหนดว่ารหัสผ่านที่มีตัวอักษรพิมพ์ใหญ่อย่างน้อย 1 ตัวและตัวอักษรพิมพ์เล็ก 1 ตัวจะได้รับคะแนนความรัดกุมเป็น "3" แต่รหัสผ่านที่มีตัวอักษรพิมพ์เล็กอย่างน้อย 1 ตัวและตัวเลข 1 ตัวจะได้รับคะแนนความรัดกุมที่สูงกว่าเป็น "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

รีเซ็ตรหัสผ่าน Cassandra

โดยค่าเริ่มต้น Cassandra จะปิดใช้การตรวจสอบสิทธิ์ไว้ หากเปิดใช้การตรวจสอบสิทธิ์ ระบบจะใช้ผู้ใช้ที่กำหนดไว้ล่วงหน้าชื่อ cassandra พร้อมรหัสผ่าน cassandra คุณสามารถใช้บัญชีนี้ ตั้งรหัสผ่านอื่นสำหรับบัญชีนี้ หรือสร้างผู้ใช้ Cassandra ใหม่ก็ได้ เพิ่ม นำออก และแก้ไขผู้ใช้โดยใช้คำสั่ง CREATE/ALTER/DROP USER ของ Cassandra

ดูข้อมูลเกี่ยวกับวิธีเปิดใช้การตรวจสอบสิทธิ์ Cassandra ได้ที่เปิดใช้การตรวจสอบสิทธิ์ Cassandra

หากต้องการรีเซ็ตรหัสผ่าน Cassandra คุณต้องทำดังนี้

• ตั้งรหัสผ่านในโหนด Cassandra โหนดใดก็ได้ แล้วระบบจะออกอากาศรหัสผ่านไปยังโหนด Cassandra ทั้งหมดในวงแหวน
• อัปเดตเซิร์ฟเวอร์การจัดการ, Message Processor, เราเตอร์, เซิร์ฟเวอร์ Qpid และเซิร์ฟเวอร์ Postgres ในแต่ละโหนดด้วยรหัสผ่านใหม่

ดูข้อมูลเพิ่มเติมได้ที่คำสั่ง CQL

วิธีรีเซ็ตรหัสผ่าน Cassandra

1. เข้าสู่ระบบโหนด Cassandra ใดก็ได้โดยใช้เครื่องมือ cqlsh และข้อมูลเข้าสู่ระบบเริ่มต้น คุณเพียงแค่ต้องเปลี่ยนรหัสผ่านในโหนด Cassandra โหนดเดียว แล้วระบบจะเผยแพร่ไปยังโหนด Cassandra ทั้งหมดในวงแหวน

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

   สถานที่:

   • cassIP คือที่อยู่ IP ของโหนด Cassandra
   • 9042 คือพอร์ต Cassandra
   • ผู้ใช้เริ่มต้นคือ cassandra
   • รหัสผ่านเริ่มต้นคือ "cassandra" หากคุณเปลี่ยนรหัสผ่านก่อนหน้านี้ ให้ใช้รหัสผ่านปัจจุบัน หากรหัสผ่านมีสัญลักษณ์พิเศษ คุณต้องใส่รหัสผ่านไว้ในเครื่องหมายคำพูดเดี่ยว
2. เรียกใช้คำสั่งต่อไปนี้ที่พรอมต์ cqlsh> เพื่ออัปเดตรหัสผ่าน

   ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';

   หากรหัสผ่านใหม่มีอักขระเครื่องหมายคำพูดเดี่ยว ให้หลีกเลี่ยงโดยใส่อักขระเครื่องหมายคำพูดเดี่ยวไว้ข้างหน้า

3. ออกจากเครื่องมือ cqlsh

   exit

4. ในโหนด Management Server ให้เรียกใช้คำสั่งต่อไปนี้

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

   หรือจะส่งไฟล์ไปยังคำสั่งที่มีชื่อผู้ใช้และรหัสผ่านใหม่ก็ได้ ดังนี้

   apigee-service edge-management-server store_cassandra_credentials -f configFile

   โดยที่ configFile มีข้อมูลต่อไปนี้

   CASS_USERNAME=CASS_USERNAME
   CASS_PASSWORD='CASS_PASSWROD'

   คำสั่งนี้จะรีสตาร์ทเซิร์ฟเวอร์การจัดการโดยอัตโนมัติ

5. ทำขั้นตอนที่ 4 ซ้ำในอุปกรณ์ต่อไปนี้
   • Message Processor ทั้งหมด
   • เราเตอร์ทั้งหมด
   • เซิร์ฟเวอร์ Qpid ทั้งหมด (edge-qpid-server)
   • เซิร์ฟเวอร์ Postgres (edge-postgres-server)

เปลี่ยนรหัสผ่าน Cassandra แล้ว

รีเซ็ตรหัสผ่าน PostgreSQL

โดยค่าเริ่มต้น ฐานข้อมูล PostgreSQL จะมีผู้ใช้ที่กำหนดไว้ 2 ราย ได้แก่ postgres และ apigee ผู้ใช้ทั้ง 2 รายมีรหัสผ่านเริ่มต้นเป็น postgres ใช้ขั้นตอนต่อไปนี้เพื่อเปลี่ยนรหัสผ่านเริ่มต้น

เปลี่ยนรหัสผ่านในโหนดหลักของ Postgres ทั้งหมด หากคุณกำหนดค่าเซิร์ฟเวอร์ Postgres 2 เครื่อง ในโหมดหลัก/สแตนด์บาย คุณจะต้องเปลี่ยนรหัสผ่านในโหนดหลักเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าการจำลองแบบ Master-Standby สำหรับ Postgres

1. ในโหนด Postgres หลัก ให้เปลี่ยนไดเรกทอรีเป็น /opt/apigee/apigee-postgresql/pgsql/bin
2. ตั้งรหัสผ่านผู้ใช้ postgres PostgreSQL ดังนี้
   1. เข้าสู่ระบบฐานข้อมูล PostgreSQL โดยใช้คำสั่งต่อไปนี้

      psql -h localhost -d apigee -U postgres

   2. เมื่อได้รับข้อความแจ้ง ให้ป้อนรหัสผ่านของผู้ใช้ postgres ที่มีอยู่เป็น postgres
   3. ที่ Command Prompt ของ PostgreSQL ให้ป้อนคำสั่งต่อไปนี้เพื่อเปลี่ยนรหัสผ่านเริ่มต้น

      ALTER USER postgres WITH PASSWORD 'new_password';

      เมื่อดำเนินการสำเร็จ PostgreSQL จะตอบกลับด้วยข้อความต่อไปนี้

      ALTER ROLE

   4. ออกจากฐานข้อมูล PostgreSQL โดยใช้คำสั่งต่อไปนี้

      \q

3. ตั้งรหัสผ่านผู้ใช้ apigee ของ PostgreSQL โดยทำดังนี้
   1. เข้าสู่ระบบฐานข้อมูล PostgreSQL โดยใช้คำสั่งต่อไปนี้

      psql -h localhost -d apigee -U apigee

   2. เมื่อได้รับข้อความแจ้ง ให้ป้อนรหัสผ่านของผู้ใช้ apigee เป็น postgres
   3. ที่ Command Prompt ของ PostgreSQL ให้ป้อนคำสั่งต่อไปนี้เพื่อเปลี่ยนรหัสผ่านเริ่มต้น

      ALTER USER apigee WITH PASSWORD 'new_password';

   4. ออกจากฐานข้อมูล PostgreSQL โดยใช้คำสั่งต่อไปนี้

      \q

   คุณสามารถตั้งรหัสผ่านของผู้ใช้ postgres และ apigee เป็นค่าเดียวกันหรือค่าที่ต่างกันก็ได้

4. ตั้งค่า APIGEE_HOME

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

5. เข้ารหัสรหัสผ่านใหม่

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

   คำสั่งนี้จะแสดงรหัสผ่านที่เข้ารหัส รหัสผ่านที่เข้ารหัสจะเริ่มต้นหลังอักขระ ":" และไม่รวม ":" เช่น รหัสผ่านที่เข้ารหัสสำหรับ "apigee1234" คือ

   Encrypted string:WheaR8U4OeMEM11erxA3Cw==

6. อัปเดตโหนดเซิร์ฟเวอร์การจัดการด้วยรหัสผ่านที่เข้ารหัสใหม่สำหรับผู้ใช้ postgres และ apigee
   1. ใน Management Server ให้เปลี่ยนไดเรกทอรีเป็น /opt/apigee/customer/application
   2. แก้ไขไฟล์ management-server.properties เพื่อตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ หากไม่มีไฟล์นี้ ให้สร้างขึ้นมา
   3. ตรวจสอบว่าไฟล์เป็นของผู้ใช้ apigee โดยทำดังนี้

      chown apigee:apigee management-server.properties

7. อัปเดตโหนดเซิร์ฟเวอร์ Postgres และเซิร์ฟเวอร์ Qpid ทั้งหมดด้วยรหัสผ่านที่เข้ารหัสใหม่
   1. ในโหนดเซิร์ฟเวอร์ Postgres หรือเซิร์ฟเวอร์ Qpid ให้เปลี่ยนไปที่ไดเรกทอรีต่อไปนี้

      /opt/apigee/customer/application

   2. เปิดไฟล์ต่อไปนี้เพื่อแก้ไข
      • postgres-server.properties
      • qpid-server.properties

      หากไม่มีไฟล์เหล่านี้ ให้สร้างขึ้น

   3. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์
      • 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. ตรวจสอบว่าไฟล์เป็นของผู้ใช้ apigee โดยทำดังนี้

      chown apigee:apigee postgres-server.properties
      chown apigee:apigee qpid-server.properties

8. รีสตาร์ทคอมโพเนนต์ต่อไปนี้ตามลำดับต่อไปนี้
   1. ฐานข้อมูล PostgreSQL:

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

   2. เซิร์ฟเวอร์ Qpid:

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

   3. เซิร์ฟเวอร์ Postgres:

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

   4. เซิร์ฟเวอร์การจัดการ:

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