แก้ไขข้อผิดพลาดการตรวจสอบ WOPI โดยตรวจสอบคีย์ การค้นหา และ URL

เมื่อโฮสต์ WOPI รายงานว่า “การตรวจสอบหลักฐานล้มเหลว” หรือ “หลักฐาน WOPI ไม่ถูกต้อง” ให้ตรวจสอบก่อนว่าระบบใดบันทึกการปฏิเสธนั้น หากโฮสต์จัดเก็บข้อมูลปฏิเสธคำขอที่ลงนามของ Collabora ให้ตรวจสอบคู่คีย์หลักฐานและการตอบสนองการค้นหาก่อนที่จะเปลี่ยนแปลงรายการอนุญาตของโฮสต์ WOPI หรือปิดใช้งานการตรวจสอบหลักฐาน สำหรับการติดตั้งแพ็กเกจ Collabora จะสร้างคู่คีย์โดยอัตโนมัติ สำหรับ Docker, Kubernetes และการปรับใช้แบบหลายสำเนา คู่คีย์จะต้องถูกจัดเตรียมและจัดเก็บอย่างสม่ำเสมอ

ระบุการตรวจสอบที่ล้มเหลวก่อนทำการเปลี่ยนคีย์

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

บันทึกของระบบจัดเก็บข้อมูลบันทึกคำขอ CheckFileInfo ที่ถูกปฏิเสธพร้อมหลักฐาน WOPI ที่ไม่ถูกต้อง
ข้อความพิสูจน์ว่าไม่ถูกต้องจากฝั่งโฮสต์ ชี้ให้เห็นถึงสาเหตุหลักประการแรกคือ การค้นหาคีย์ การสร้างลายเซ็น หรือเวลาการร้องขอ
หลักฐานในบันทึกพื้นที่น่าตรวจสอบ
โฮสต์จัดเก็บข้อมูลแสดงข้อความ “หลักฐาน WOPI ไม่ถูกต้อง” ขณะรับคำขอ CheckFileInfo หรือคำขอ WOPI อื่นๆรหัสยืนยันของ Collabora, ข้อมูลการค้นพบของโฮสต์, การสร้าง URL ขึ้นใหม่ หรือการประทับเวลา
Collabora แสดงข้อความว่า “โฮสต์ WOPI ที่ไม่ได้รับอนุญาต” หรือ “ไม่มีโฮสต์ WOPI ที่ยอมรับได้”การกำหนดค่ารายการอนุญาตโฮสต์/โดเมนของ WOPI ไม่ใช่รหัสพิสูจน์อักษร
โทเค็นไม่ถูกต้อง หมดอายุ หรือถูกปฏิเสธการเข้าถึงโดยไม่มีหลักฐานยืนยันโทเค็นการเข้าถึงที่ออกโดยโฮสต์ สิทธิ์ หรือการหมดอายุของโทเค็น

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

เลือกวิธีการซ่อมแซมที่เหมาะสมกับการใช้งาน

เริ่มต้นด้วยตัวเลือกที่ก่อให้เกิดผลกระทบน้อยที่สุด ในการติดตั้งแบบแพ็กเกจ ให้ตรวจสอบไฟล์คีย์และบันทึกการบริการที่มีอยู่ก่อน เอกสารของ Collabora ในปัจจุบันระบุว่า การติดตั้งแพ็กเกจ RPM และ Debian จะสร้างคู่คีย์ที่ผ่านการรับรอง WOPI โดยอัตโนมัติ หากไฟล์เหล่านั้นมีอยู่และเสถียร การเปลี่ยนไฟล์เหล่านั้นมักไม่จำเป็น

รายการไฟล์ในเทอร์มินัลแสดงให้เห็นไฟล์ proof_key และ proof_key.pub แยกกัน
Collabora ใช้คีย์พิสูจน์ส่วนตัวและเผยแพร่คีย์สาธารณะที่ตรงกันผ่านการค้นหาด้วย WOPI
การปรับใช้การดำเนินการที่แนะนำการแลกเปลี่ยน
เซิร์ฟเวอร์ที่จัดการด้วยแพ็กเกจเดียวเก็บคู่คีย์ที่สร้างขึ้นไว้ ซ่อมแซมสิทธิ์การเข้าถึงหรือสร้างใหม่เฉพาะในกรณีที่คีย์หายไปหรือไม่ตรงกันเท่านั้นมีการเปลี่ยนแปลงเพียงเล็กน้อย แต่โปรดตรวจสอบเวอร์ชันแพ็กเกจและเส้นทางที่กำหนดค่าไว้
คอนเทนเนอร์ Docker เดี่ยวสร้างคู่ข้อมูลเพียงครั้งเดียวและติดตั้งลงในคอนเทนเนอร์อย่างถาวรจำเป็นต้องมีไดรฟ์จัดเก็บข้อมูลถาวรและสิทธิ์การอ่านที่ถูกต้องสำหรับ coolwsd
คูเบอร์เน็ตส์หรือสำเนาหลายชุดติดตั้งชุดรหัสลับ/คีย์ที่ใช้ร่วมกันหนึ่งชุดในทุกอินสแตนซ์ของ Collaboraลายเซ็นต้องสอดคล้องกันในทุกสำเนา การหมุนเวียนต้องอัปเดตมุมมองการค้นหาของโฮสต์ด้วย
URL โฮสต์เปลี่ยนไปเนื่องจากใช้พร็อกซีตรวจสอบรูปแบบสาธารณะ โฮสต์ เส้นทาง และสตริงคำค้นหาที่ใช้ในการตรวจสอบลายเซ็นวิธีนี้ซับซ้อนกว่าการหมุนเวียนคีย์ แต่ช่วยหลีกเลี่ยงการเปลี่ยนแปลงข้อมูลประจำตัวที่ไม่จำเป็น

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

ตรวจสอบและซ่อมแซมกุญแจคู่ได้อย่างปลอดภัย

  1. ค้นหาเส้นทางคีย์ที่กำหนดค่าไว้บนโฮสต์ Collabora หรือภายในคอนเทนเนอร์ ตรวจสอบcoolwsd.xmlการตั้งค่าสำหรับเส้นทางคีย์พิสูจน์ และตรวจสอบว่ามีทั้งคีย์ส่วนตัวและคีย์สาธารณะหรือไม่ ตำแหน่งทั่วไปจะอยู่ภายใต้/etc/coolwsd/แต่โครงสร้างของแพ็กเกจและคอนเทนเนอร์อาจแตกต่างกันไป ห้ามวางคีย์ส่วนตัวลงในบันทึก ตั๋ว หรือแชทเด็ดขาด
  2. ตรวจสอบว่าคีย์ตรงกันสำหรับเส้นทางเริ่มต้นทั่วไป ให้เปรียบเทียบลายนิ้วมือโดยไม่ต้องแสดงคีย์ส่วนตัว: sudo openssl pkey -in /etc/coolwsd/proof_key -pubout -outform DER | sha256sumและopenssl pkey -pubin -in /etc/coolwsd/proof_key.pub -outform DER | sha256sumแฮชที่ได้ควรตรงกัน หากเส้นทางของคุณแตกต่างกัน ให้แทนที่ด้วยเส้นทางที่กำหนดค่าไว้จริง หากไม่สามารถอ่านคีย์ส่วนตัวได้ ให้แก้ไขความเป็นเจ้าของและสิทธิ์การเข้าถึงตามแบบจำลองความปลอดภัยของบริการ อย่าทำให้ทุกคนสามารถอ่านได้
  3. สร้างคีย์ส่วนตัวใหม่เฉพาะเมื่อจำเป็นเท่านั้นหากคีย์ส่วนตัวหายไปหรือคู่คีย์ไม่ตรงกัน ให้ใช้sudo coolconfig generate-proof-keyยูทิลิตี้ที่ติดตั้งไว้ สำหรับ Docker ให้สร้างคู่คีย์ในตำแหน่งถาวรที่เหมาะสม จากนั้นเมานต์ไฟล์ทั้งสองไปยังตำแหน่งที่ Collabora คาดหวัง และตรวจสอบให้แน่ใจว่ากระบวนการ coolwsd สามารถอ่านคีย์ส่วนตัวได้ บนแพลตฟอร์มที่มีการจัดการ ให้ใช้กลไก Secret ที่รองรับแทนการแก้ไข pod ที่กำลังทำงานอยู่ด้วยตนเอง
  4. ทำให้ทุกอินสแตนซ์มีความสอดคล้องกันสำหรับสำเนา ให้ปรับใช้คู่คีย์เดียวกันกับแต่ละอินสแตนซ์ แล้วรีสตาร์ทหรือปรับใช้ Collabora เพื่อให้สามารถอ่านไฟล์ได้ จากนั้นรีเฟรชหรือดึงข้อมูลการค้นหา WOPI ใหม่บนโฮสต์จัดเก็บข้อมูลโดยใช้กลไกที่โฮสต์นั้นรองรับ การหมุนเวียนคีย์จะเปลี่ยนคีย์สาธารณะ แคชหรือสำเนาอื่นที่ยังคงให้บริการคีย์เดิมอาจทำให้ความล้มเหลวยังคงอยู่ได้
แผงวอลุ่มของ Kubernetes แสดงให้เห็นว่าคีย์ลับ WOPI เดียวกันถูกเมานต์อยู่ในพอด Collabora ที่กำลังทำงานอยู่สองตัว
สำเนาควรใช้คู่รหัสพิสูจน์ถาวรชุดเดียวร่วมกัน เพื่อให้แต่ละอินสแตนซ์ลงนามคำขอได้อย่างสม่ำเสมอ

เมื่อคีย์ตรงกัน แต่การตรวจสอบหลักฐานยังคงล้มเหลว

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

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

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

ตรวจสอบการซ่อมแซม

  1. ดึงข้อมูลปลายทางการค้นหา Collabora จากเครือข่ายของโฮสต์จัดเก็บข้อมูล และยืนยันว่าได้ส่งคืนข้อมูลเมตาคีย์พิสูจน์ปัจจุบันแล้ว
  2. เปิดเอกสารทดสอบและตรวจสอบว่าโฮสต์จัดเก็บข้อมูลยอมรับคำขอ CheckFileInfo และคำขอเอกสารอื่นๆ ที่ตามมาโดยไม่มีข้อผิดพลาดเกี่ยวกับการตรวจสอบไฟล์ที่ไม่ถูกต้องหรือไม่
  3. ทำซ้ำขั้นตอนนี้กับเส้นทางพร็อกซีหรือสำเนาแต่ละรายการ จากนั้นตรวจสอบว่าคู่คีย์ยังคงถูกติดตั้งอยู่หลังจากรีสตาร์ทคอนเทนเนอร์หรือเปลี่ยนพอด
เบราว์เซอร์แสดงเอกสารที่เปิดอยู่ใน Collabora โดยมีการตรวจสอบข้อมูลไฟล์และการร้องขอเนื้อหาที่สำเร็จ
ยืนยันการซ่อมแซมโดยการเปิดเอกสารและตรวจสอบว่าโฮสต์ยอมรับคำขอ WOPI หรือไม่

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

ข้อมูลอ้างอิงอย่างเป็นทางการ

ฝากความเห็น

ล้างคำเตือนหน่วยความจำ PHP ของ Nextcloud บนเว็บเซิร์ฟเวอร์

ตั้งค่าขีดจำกัดหน่วยความจำ PHP ที่ Nextcloud ใช้จริง รีสตาร์ทบริการที่ถูกต้อง และยืนยันการตั้งค่า 512 MB ในภาพรวมผู้ดูแลระบบ

เชื่อมต่อ Bucket ที่เข้ากันได้กับ S3 กับพื้นที่จัดเก็บข้อมูลภายนอกของ Nextcloud

เชื่อมต่อบัคเก็ตจัดเก็บข้อมูลแบบอ็อบเจ็กต์ที่เข้ากันได้ใน Nextcloud โดยใช้แบ็กเอนด์ S3 พร้อมด้วยเอนด์พอยต์ ข้อมูลรับรอง ขอบเขตการเข้าถึง และขั้นตอนการตรวจสอบที่ถูกต้อง

ย้ายข้อมูล Nextcloud ไปยังไดรฟ์ภายนอกโดยไม่ทำให้พื้นที่จัดเก็บข้อมูลเสียหาย

ย้ายข้อมูล Nextcloud ไปยังไดรฟ์ภายนอกโดยไม่ทำให้พื้นที่จัดเก็บข้อมูลเสียหาย

ย้ายไดเร็กทอรีข้อมูล Nextcloud บน Linux ไปยังไดรฟ์ภายนอกอย่างปลอดภัย โดยใช้การเมานต์ UUID แบบถาวร โหมดบำรุงรักษา สำเนาที่ตรวจสอบแล้ว และซิมลิงก์เส้นทางเดิม

ข้อผิดพลาดฐานข้อมูล Nextcloud หลังจากการอัปเดต: ควรตรวจสอบอะไรก่อน

กู้คืนการเข้าถึง Nextcloud หลังจากการอัปเดตโดยการวินิจฉัยข้อผิดพลาด SQL ตรวจสอบการเชื่อมต่อฐานข้อมูล และดำเนินการย้ายข้อมูลที่หยุดชะงักให้เสร็จสมบูรณ์อย่างปลอดภัย

รีเซ็ตรหัสผ่านผู้ดูแลระบบ Nextcloud ที่ลืมไปโดยใช้ OCC

ใช้คำสั่ง OCC ของ Nextcloud เพื่อรีเซ็ตรหัสผ่านผู้ดูแลระบบจากเชลล์เซิร์ฟเวอร์ พร้อมคำแนะนำสำหรับชื่อผู้ใช้ สิทธิ์ และผู้ให้บริการเข้าสู่ระบบภายนอก

เพิ่มส่วนหัว HSTS ที่ปลายทาง HTTPS ที่ให้บริการ Nextcloud

ล้างคำเตือน HSTS ของ Nextcloud โดยการตั้งค่าส่วนหัวที่ Apache, NGINX หรือพร็อกซี TLS ของคุณ จากนั้นตรวจสอบการตอบสนอง HTTPS สาธารณะอย่างปลอดภัย

แก้ไขปัญหาการติดตั้งแอป Nextcloud ที่แจ้งว่าไม่มีการเชื่อมต่ออินเทอร์เน็ต

แก้ไขปัญหาการติดตั้งแอป Nextcloud ที่แจ้งว่าไม่มีการเชื่อมต่ออินเทอร์เน็ต

ตรวจสอบหาสาเหตุของการติดตั้งแอปจาก App Store ที่ล้มเหลว ไม่ว่าจะเป็นปัญหาจาก DNS, HTTPS, พร็อกซี, TLS หรือปัญหาการตั้งค่าจากเซิร์ฟเวอร์ Nextcloud เอง

แก้ปัญหา CPU กระชากเร็วใน Nextcloud Preview ด้วยคิวที่กำหนดเวลาไว้

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

รับการซิงค์ข้อมูลบนเดสก์ท็อป Nextcloud โดยไม่ต้องแสดงสถานะ “กำลังประมวลผลไฟล์” อีกต่อไป

ค้นหาไฟล์ กฎการยกเว้น ปัญหาการเชื่อมต่อ หรือสถานะฐานข้อมูลไคลเอ็นต์ที่ทำให้การซิงค์ Nextcloud หยุดชะงัก จากนั้นตรวจสอบการอัปโหลดและดาวน์โหลดอย่างปลอดภัย

ล้างคำเตือน Nextcloud OPcache โดยการปรับขีดจำกัดให้ถูกต้อง

ค้นหาข้อจำกัดของ PHP OPcache ที่ทำให้เกิดคำเตือนของ Nextcloud อัปเดตการตั้งค่า PHP สำหรับเว็บให้ถูกต้อง รีสตาร์ทอย่างปลอดภัย และตรวจสอบผลลัพธ์