ตั้งรหัสผ่านที่ปลอดภัยสำหรับคอนโซลผู้ดูแลระบบ Collabora

ตั้งรหัสผ่านสำหรับ Collabora Online Admin Console ตามวิธีการติดตั้งเซิร์ฟเวอร์ของคุณ: สำหรับอิมเมจ Docker ของ CODE ให้กำหนดค่าusernameตัวแปรpasswordสภาพแวดล้อม สำหรับการติดตั้งแพ็กเกจ Linux ให้รันคำสั่งcoolconfig set-admin-passwordจากนั้นรีสตาร์ทหรือสร้างบริการใหม่ แล้วลงชื่อเข้าใช้หน้าผู้ดูแลระบบเพื่อยืนยันว่าข้อมูลรับรองใหม่ใช้งานได้

รู้ว่าคุณกำลังเปลี่ยนรหัสผ่านใด

คอนโซลผู้ดูแลระบบ (Admin Console) คือหน้าจัดการบริการของ Collabora Online ซึ่งแยกต่างหากจากบัญชีผู้ดูแลระบบของ Nextcloud หรือแพลตฟอร์มจัดเก็บข้อมูลอื่น ๆ และการเปลี่ยนรหัสผ่านของคอนโซลผู้ดูแลระบบจะไม่เปลี่ยนแปลงการเข้าสู่ระบบของผู้ใช้เอกสารหรือข้อมูลประจำตัวที่แพลตฟอร์มของคุณใช้ในการเชื่อมต่อกับ Collabora นอกจากนี้ การติดตั้งแบบ Docker และแบบใช้แพ็กเกจยังใช้เวิร์กโฟลว์การกำหนดค่าที่แตกต่างกัน ดังนั้นโปรดตรวจสอบรูปแบบการใช้งานของคุณก่อนที่จะเปลี่ยนแปลงสิ่งใด ๆ

สำหรับการใช้งาน CODE ใน Docker นั้น Collabora ได้จัดทำเอกสารusernameเกี่ยวpasswordกับการตั้งค่าสภาพแวดล้อมของคอนเทนเนอร์ไว้ สำหรับการติดตั้งแบบแพ็กเกจ เครื่องมือการกำหนดค่าของ Collabora สามารถตั้งรหัสผ่านผู้ดูแลระบบแบบโต้ตอบได้ เอกสารอ้างอิงการกำหนดค่าปัจจุบันระบุว่าการใช้admin_console.passwordการตั้งค่าโดยตรงนั้นล้าสมัยแล้วในแพลตฟอร์มส่วนใหญ่ และแนะนำให้ใช้ PAM หรือcoolconfigวิธีการอื่นแทน โปรดดู เอกสารประกอบ เกี่ยวกับอิมเมจ Docker ของ CODE จาก Collaboraและเอกสารอ้างอิงการกำหนดค่าของ Collabora

เตรียมตัวให้พร้อมก่อนเปลี่ยนข้อมูลประจำตัว

• ตรวจสอบชื่อโฮสต์ ชื่อคอนเทนเนอร์หรือชื่อบริการ และตรวจสอบว่า Collabora ทำงานบน Docker หรือเป็นแพ็กเกจ Linux หากคุณมีหลายอินสแตนซ์ โปรดจดบันทึกว่าอินสแตนซ์ใดให้บริการผู้ใช้ของคุณ
• เลือกใช้รหัสผ่านที่ไม่ซ้ำกันและบันทึกไว้ในโปรแกรมจัดการรหัสผ่านหรือที่เก็บข้อมูลลับสำหรับการใช้งานของคุณ ห้ามใช้รหัสผ่านตัวอย่างจากบทช่วยสอน
• หากคุณจัดการ Docker Compose ให้สำรองข้อมูลหรือคอมมิตไฟล์ Compose โดยไม่ต้องคอมมิตข้อมูลลับใดๆ จำกัดการเข้าถึงไฟล์ที่มีข้อมูลลับนั้น ตัวแปรสภาพแวดล้อมยังคงมองเห็นได้สำหรับผู้ดูแลระบบที่สามารถตรวจสอบคอนเทนเนอร์ได้
• ควรเก็บปลายทางผู้ดูแลระบบไว้หลังการควบคุมการเข้าถึงตามปกติของคุณ รหัสผ่านที่รัดกุมช่วยได้ แต่ไม่สามารถทดแทนการจำกัดผู้ที่สามารถเข้าถึงหน้าผู้ดูแลระบบได้

ตั้งรหัสผ่านสำหรับคอนเทนเนอร์ Docker ของ CODE

ในบริการ Compose สำหรับ Collabora ให้ตั้ง ค่าตัวแปร usernameตาม ที่ระบุไว้ passwordในเอกสาร ตัวอย่างนี้จะอ่านรหัสผ่านจาก.envไฟล์ในเครื่องแทนที่จะใส่รหัสลับลงในไฟล์ Compose โดยตรง:

services:
  collabora:
    image: collabora/code
    environment:
      username: admin
      password: "${COLLABORA_ADMIN_PASSWORD:?Set it in .env}"

ในไดเร็กทอรีโปรเจ็กต์เดียวกัน ให้วางรหัสลับไว้ในตำแหน่งต่อไปนี้.env:

COLLABORA_ADMIN_PASSWORD=replace-with-your-unique-secret

แทนที่ค่าตัวอย่างด้วยรหัสผ่านจริงของคุณ และอย่าทำการบันทึกการเปลี่ยนแปลงลง.envในที่เก็บข้อมูลที่ใช้ร่วมกัน หากบริการ Compose มีอยู่แล้ว การเปลี่ยนแปลงสภาพแวดล้อมบนดิสก์จะไม่เปลี่ยนแปลงสภาพแวดล้อมของคอนเทนเนอร์ที่กำลังทำงานอยู่ สร้างบริการนั้นขึ้นใหม่เพื่อให้การตั้งค่าใหม่มีผล:

docker compose up -d --force-recreate collabora

หากชื่อบริการ Compose ของคุณไม่ใช่ชื่อที่ถูกต้อง ให้ใช้ชื่อcollaboraนั้น การดำเนินการนี้จะรีสตาร์ทคอนเทนเนอร์ Collabora แต่จะไม่ลบเอกสารของคุณ ซึ่งจะถูกจัดเก็บไว้โดยแพลตฟอร์มที่เชื่อมต่ออยู่ หากการปรับใช้ของคุณได้รับการจัดการโดย Kubernetes, Helm หรือ control plane อื่นๆ ให้เปลี่ยน secret หรือค่าที่เกี่ยวข้องในนั้น และใช้กระบวนการ rollout ปกติของการปรับใช้ดังกล่าว แทนที่จะแก้ไขคอนเทนเนอร์ที่กำลังทำงานอยู่ด้วยตนเอง

ตั้งรหัสผ่านสำหรับการติดตั้งแพ็กเกจ Linux

บนเซิร์ฟเวอร์ที่ติดตั้ง Collabora เป็นแพ็กเกจระบบ ให้เรียกใช้เครื่องมือการกำหนดค่าบนเซิร์ฟเวอร์นั้น:

sudo coolconfig set-admin-password

โปรแกรมจะแจ้งให้ป้อนรหัสผ่านใหม่ ดังนั้นคุณไม่จำเป็นต้องใส่รหัสผ่านลงในคำสั่งเชลล์ เพียงป้อนรหัสผ่านที่พร้อมท์ และป้อนซ้ำอีกครั้งหากมีการถาม จากนั้นรีสตาร์ทบริการเพื่อให้โหลดการกำหนดค่าที่อัปเดตแล้ว:

sudo systemctl restart coolwsd

ตัวอย่างการติดตั้ง Nextcloud บน Ubuntu ในปัจจุบันก็ใช้coolconfig set-admin-passwordและรีสตาร์ทcoolwsdหลังจากกำหนดค่าเสร็จสิ้นเช่นกัน ตัวจัดการแพ็กเกจและบริการที่ใช้จริงอาจแตกต่างกันไปในระบบปฏิบัติการอื่นๆ หากไม่พบคำสั่งหรือชื่อบริการ โปรดดูคำแนะนำการติดตั้ง Collabora ของระบบปฏิบัติการนั้นๆ ตัวอย่าง Nextcloud มีเอกสารอธิบายไว้ในคู่มือการตั้งค่า Ubuntu 24.04

ลงชื่อเข้าใช้และตรวจสอบผลลัพธ์

เปิดคอนโซลผู้ดูแลระบบสำหรับโฮสต์ Collabora ซึ่งโดยทั่วไปจะอยู่ที่ โดยhttps://collabora.example.com/browser/dist/admin/admin.htmlแทนที่โฮสต์ตัวอย่างด้วย URL สาธารณะของเซิร์ฟเวอร์ของคุณ เข้าสู่ระบบด้วยชื่อผู้ใช้ผู้ดูแลระบบที่กำหนดค่าไว้และรหัสผ่านใหม่ การเข้าสู่ระบบสำเร็จเป็นการยืนยันว่าคอนโซลยอมรับข้อมูลประจำตัว แต่ไม่ได้ตรวจสอบว่าการแก้ไขเอกสารหรือการเชื่อมต่อ WOPI ทำงานได้อย่างปกติ

1. หากการเข้าสู่ระบบล้มเหลวใน Docker โปรดตรวจสอบให้แน่ใจว่าคุณได้แก้ไขโปรเจ็กต์ Compose ที่ให้บริการ URL นั้นจริง ๆ ว่าชื่อตัวแปรนั้นถูกต้องusernameหรือpasswordและว่าคุณได้สร้างคอนเทนเนอร์ขึ้นใหม่หลังจากทำการเปลี่ยนแปลงแล้ว
2. หากการเข้าสู่ระบบล้มเหลวหลังจากอัปเดตแพ็กเกจ โปรดตรวจสอบว่าcoolwsdได้รีสตาร์ทสำเร็จแล้ว และเบราว์เซอร์สามารถเชื่อมต่อกับเซิร์ฟเวอร์ที่ต้องการได้ ตรวจสอบบันทึกการบริการเพื่อหาข้อผิดพลาดในการกำหนดค่าโดยไม่ต้องคัดลอกข้อมูลลับลงในโพสต์ขอความช่วยเหลือ
3. หากคุณเปิดใช้งานการตรวจสอบสิทธิ์ PAM ค่าที่กำหนดไว้admin_console.usernameจะadmin_console.passwordถูกละเว้น ให้ใช้บัญชี PAM และรหัสผ่านที่กำหนดค่าไว้สำหรับโฮสต์แทน การเปลี่ยนแปลงตัวแปรสภาพแวดล้อมของ CODE Docker จะไม่สามารถแทนที่ PAM ได้
4. หากล็อกอินได้แต่หน้าผู้ดูแลระบบไม่โหลด ให้ตรวจสอบเส้นทาง Collabora และนโยบายการเข้าถึงของพร็อกซีแบบย้อนกลับ ปัญหาพร็อกซีหรือเครือข่ายแตกต่างจากปัญหาการป้อนรหัสผ่านไม่ถูกต้อง

ข้อผิดพลาดทั่วไปที่ควรหลีกเลี่ยง

อย่าสับสนรหัสผ่าน Admin Console กับรหัสผ่านผู้ดูแลระบบ Nextcloud และอย่าคัดลอกรหัสผ่านไปวางในคำสั่งใดๆ เช่น ในdocker run -e password=...กรณีที่ประวัติคำสั่งหรือการตรวจสอบกระบวนการอาจเปิดเผยรหัสผ่านได้ สำหรับการใช้งาน Compose ให้เก็บรหัสผ่านไว้ในไฟล์สภาพแวดล้อมที่ได้รับการป้องกันหรือตัวจัดการรหัสผ่านที่มีอยู่ และจำกัดการเข้าถึงโฮสต์ Docker นอกจากนี้ ควรหลีกเลี่ยงการแก้ไขcoolwsd.xmlโดยตรงเป็นตัวเลือกแรก เนื่องจาก Collabora ระบุว่าการตั้งค่ารหัสผ่านแบบเดิมนั้นล้าสมัยแล้วในแพลตฟอร์มส่วนใหญ่

หากคุณไม่สามารถเข้าสู่ระบบได้หลังจากทำตามขั้นตอนที่ถูกต้องแล้ว ขั้นแรกให้ตรวจสอบอินสแตนซ์และโหมดการตรวจสอบสิทธิ์ จากนั้นตรวจสอบว่าการกำหนดค่าใหม่ถูกนำไปใช้จริงหรือไม่ ลำดับขั้นตอนนี้จะช่วยแยกแยะความแตกต่างระหว่างคอนเทนเนอร์ที่ล้าสมัยหรือโฮสต์ที่ไม่ถูกต้องกับการพิมพ์รหัสผ่านผิด และช่วยให้คุณทราบจุดต่อไปที่จะตรวจสอบได้อย่างชัดเจน