เมื่อ Element แสดงข้อความM_FORBIDDEN: You do not have permissionผิดพลาด ให้ระบุการกระทำที่ล้มเหลวอย่างแม่นยำก่อน ความล้มเหลวในการจัดการห้องส่วนใหญ่เกิดจากระดับพลังของห้องหรือสถานะสมาชิกของบัญชี แต่หากเกิดความล้มเหลวกับ Synapse Admin API จะต้องอาศัยบัญชีผู้ดูแลระบบเซิร์ฟเวอร์ของโฮมเซิร์ฟเวอร์ ขอให้ผู้ดูแลระบบห้องปัจจุบันให้สิทธิ์เฉพาะที่จำเป็น หรือใช้ Synapse Admin API เฉพาะเมื่อการดำเนินการที่ถูกปฏิเสธนั้นเป็นงานของผู้ดูแลระบบเซิร์ฟเวอร์จริงๆ
ตัวอย่างสมมติ:อเล็กซ์ช่วยดูแลห้องสนทนาใน Matrix และสามารถลบสแปมได้ แต่มีปัญหาM_FORBIDDENเมื่อต้องเปลี่ยนสิทธิ์ในการเชิญคนเข้าร่วมห้อง อเล็กซ์เป็นเพียงผู้ดูแลห้อง ไม่ใช่ผู้ดูแลระบบห้อง ตัวอย่างนี้เป็นเพียงตัวอย่างประกอบ ไม่ใช่การยืนยันเกี่ยวกับบัญชีหรือเซิร์ฟเวอร์ที่ได้รับการทดสอบแล้ว
ระบุว่าระบบการอนุญาตใดปฏิเสธคำขอ
Matrix แสดงM_FORBIDDENข้อผิดพลาดทั่วไปเกี่ยวกับการเข้าถึงที่ถูกห้าม รหัสข้อผิดพลาดเพียงอย่างเดียวไม่ได้ระบุว่าปัญหาเกิดจากระดับพลังงานในห้อง การเป็นสมาชิกห้อง ข้อจำกัดของบัญชี หรือการอนุญาตสำหรับ API การดูแลระบบ โปรดอ่านข้อผิดพลาดทั้งหมดและสังเกตว่า Alex กำลังทำอะไรอยู่: แก้ไขการตั้งค่าห้อง เชิญหรือแบนใครบางคน เข้าร่วมห้อง หรือเปิดเครื่องมือการดูแลระบบ Synapse
สิทธิ์การเข้าถึงห้องจะถูกเก็บไว้ในm.room.power_levelsเหตุการณ์สถานะของห้อง บทบาทขององค์ประกอบ เช่น Default, Moderator และ Admin เป็นวิธีที่ผู้ใช้สามารถตรวจสอบค่าเหล่านี้ได้ แต่ห้องสามารถตั้งค่าระดับที่กำหนดเองได้ ผู้ดูแลระบบเซิร์ฟเวอร์โฮมเซิร์ฟเวอร์เป็นบทบาทที่แยกต่างหาก และไม่ได้ทำให้ผู้ใช้นั้นเป็นผู้ดูแลระบบห้องโดยอัตโนมัติการดำเนินการ:จำแนกประเภทการกระทำที่ล้มเหลวก่อนที่จะเปลี่ยนบทบาท และตรวจสอบว่าข้อผิดพลาดมาจาก การตั้งค่าห้องขององค์ประกอบ หรือจาก/_synapse/admin/ปลายทาง
แก้ไขการทำงานของห้องโดยใช้ระดับพลังงานของห้องนั้น
หาก Alex ไม่สามารถเปลี่ยนการตั้งค่าใน Element ได้ โปรดขอให้ผู้ดูแลระบบห้องที่มีอยู่ตรวจสอบบทบาทและสิทธิ์ของห้องนั้น ใน Element เวอร์ชันเว็บหรือเดสก์ท็อป ให้เปิดห้อง เปิดข้อมูลห้องหรือเมนูห้อง เลือก การตั้งค่าห้อง แล้วไปที่ บทบาทและสิทธิ์ ตรวจสอบรายการของ Alex ภายใต้ผู้ใช้ที่มีสิทธิ์พิเศษและบทบาทที่จำเป็นสำหรับการดำเนินการเฉพาะนั้น ป้ายกำกับและรูปแบบอาจแตกต่างกันไปตามเวอร์ชันของไคลเอ็นต์
สำหรับงานการเชิญผู้ใช้ของอเล็กซ์ ผู้ดูแลระบบควรตรวจสอบทั้งระดับอำนาจของอเล็กซ์เองและระดับที่จำเป็นในการเปลี่ยนแปลงสิทธิ์นั้น ข้อกำหนดของเมทริกซ์กำหนดสิ่งเหล่านี้แยกจากกัน: inviteเกณฑ์ควบคุมการเชิญ ในขณะที่การเปลี่ยนแปลงระดับอำนาจเองนั้นต้องมีสิทธิ์ในการส่งเหตุการณ์สถานะนั้น สมาชิกอาจได้รับอนุญาตให้เชิญผู้ใช้ได้ แต่ไม่มีสิทธิ์ในการเปลี่ยนแปลงเกณฑ์การเชิญ ผู้ดูแลระบบปัจจุบันสามารถเลื่อนระดับอเล็กซ์ไปยังระดับที่เหมาะสมที่สุด หรือทำการเปลี่ยนแปลงสิทธิ์เฉพาะนั้นด้วยตนเองได้
ในการตั้งค่าเริ่มต้นที่ระบุไว้ในเอกสารของ Element โดยทั่วไปแล้วผู้ดูแลระบบ (Admin) จะมีระดับ 100 และผู้ดูแล (Moderator) จะมีระดับ 50 แต่ห้องต่างๆ สามารถปรับแต่งข้อกำหนดได้ อย่าคิดว่าทุกห้องใช้ค่าเริ่มต้นเหล่านั้น นอกจากนี้ควรหลีกเลี่ยงการลดระดับผู้ดูแลระบบเพียงคนเดียว: Element เตือนว่าการทำเช่นนั้นอาจทำให้ห้องไม่มีใครสามารถจัดการได้การดำเนินการ:ให้ผู้ดูแลระบบปัจจุบันยืนยันว่ายังมีผู้ดูแลระบบที่เชื่อถือได้คนอื่นอยู่ก่อนที่จะบันทึกการเปลี่ยนแปลงบทบาท
หากไม่มีใครในทีมสามารถจัดการห้องได้ ให้ตรวจสอบว่ามีผู้ดูแลห้องคนปัจจุบันที่พร้อมใช้งานในบัญชีหรืออุปกรณ์อื่นหรือไม่ สำหรับห้องที่โฮสต์บน Synapse ผู้ดูแลเซิร์ฟเวอร์โฮมเซิร์ฟเวอร์อาจสามารถใช้ API Make Room Admin ของ Synapse เพื่อมอบสิทธิ์สูงสุดที่มีอยู่ให้กับผู้ใช้ภายในเครื่องที่อยู่ในห้องนั้นได้ นี่เป็นวิธีการแก้ไขปัญหาสำหรับผู้ดูแลโฮมเซิร์ฟเวอร์ ไม่ใช่การข้ามการอนุญาตฝั่งไคลเอ็นต์ทั่วไป ปลายทางนี้ต้องการข้อมูลรับรองของผู้ดูแลเซิร์ฟเวอร์และอาจใช้ไม่ได้กับห้องที่โฮสต์ที่อื่น ใช้เอกสารประกอบปลายทาง Synapse ปัจจุบันและเก็บรักษา API Admin ให้เป็นส่วนตัวจากการเข้าถึงของสาธารณะ
หากข้อผิดพลาดเกิดจาก Synapse Admin API
หากคำขอที่ล้มเหลวมีเป้าหมาย/_synapse/admin/...เป็นผู้ดูแลระบบห้องใน Element นั้นไม่เพียงพอ Synapse ต้องการโทเค็นการเข้าถึงที่ถูกต้องซึ่งเป็นของผู้ดูแลระบบเซิร์ฟเวอร์สำหรับการเรียกใช้ API ของผู้ดูแลระบบหลายรายการ ตรวจสอบให้แน่ใจว่าโทเค็นนั้นเป็นของบัญชีที่ต้องการ ไม่ได้ถูกยกเลิกหรือพิมพ์ผิด และส่งโดยใช้ส่วนหัวการอนุญาตตามที่ระบุไว้ อย่าคัดลอกโทเค็นการเข้าถึงไปวางในประเด็นสาธารณะ ภาพหน้าจอเบราว์เซอร์ หรือบันทึกที่แชร์ โปรดปฏิบัติต่อโทเค็นเหล่านั้นเหมือนรหัสผ่าน
Synapse แนะนำให้ซ่อน Admin API จากการมองเห็นของสาธารณะโดยใช้ reverse proxy และโดยทั่วไปควรทำการร้องขอจากเครื่องที่ใช้งาน Synapse ผู้ดูแลระบบควรใช้ API ที่ตรงกับเวอร์ชัน Synapse ที่ติดตั้งไว้ หลีกเลี่ยงการแก้ไขฐานข้อมูลโดยตรงเพื่อยกระดับสิทธิ์ผู้ใช้เป็นการตอบสนองครั้งแรก: คำแนะนำปัจจุบันของ Synapse ชี้ให้ผู้ใช้งานใช้คำสั่งและ API ของผู้ดูแลระบบเมื่อพวกเขามีบัญชีผู้ดูแลระบบเซิร์ฟเวอร์แล้ว
ตรวจสอบสถานะสมาชิก สถานะบัญชี และผลลัพธ์
หากการกระทำที่ล้มเหลวคือการเข้าร่วมหรือส่งกิจกรรม โปรดยืนยันว่า Alex ได้เข้าร่วมห้องนั้นจริง ๆ และไม่ได้ถูกแบน การได้รับเชิญไม่เหมือนกับการเข้าร่วม และกฎการเป็นสมาชิกอาจบล็อกการเข้าถึงได้แม้ว่าบัญชีจะมีระดับพลังสูงก็ตาม หากข้อผิดพลาดปรากฏขึ้นในห้องอื่นที่ไม่เกี่ยวข้องหรือระหว่างการเข้าสู่ระบบ อาจไม่ใช่ปัญหาของผู้ดูแลห้อง โปรดตรวจสอบข้อความแสดงข้อผิดพลาดทั้งหมดและตรวจสอบว่าบัญชีถูกล็อก ระงับ หรือถูกจำกัดโดยเซิร์ฟเวอร์หลักหรือไม่
หลังจากผู้ดูแลระบบที่ถูกต้องเปลี่ยนสิทธิ์แล้ว ให้ Alex ลองทำซ้ำการกระทำเดียวกันในห้องเดียวกัน ยืนยันผลลัพธ์ที่คาดหวัง เช่น การเชิญหรือการเปลี่ยนแปลงการตั้งค่าสำเร็จ และตรวจสอบมุมมองบทบาทและสิทธิ์ของห้องเพื่อให้แน่ใจว่ามีระดับที่ต้องการอยู่ หากยังคงล้มเหลว ให้บันทึกการกระทำที่แน่นอน รหัสห้อง เวลา สถานะ HTTP และข้อความแสดงข้อผิดพลาดที่ตัดทอนแล้ว เพื่อส่งให้ผู้ดูแลระบบโฮมเซิร์ฟเวอร์ อย่ารวมโทเค็นการเข้าถึง
โปรดใช้ข้อกำหนด API ไคลเอ็นต์-เซิร์ฟเวอร์ของ Matrixเพื่อทำความเข้าใจความหมายของรหัสข้อผิดพลาดมาตรฐานและกฎระดับพลังงานของห้อง หน้าช่วยเหลือและการสนับสนุนของ Elementสำหรับขั้นตอนการตั้งค่าห้อง และเอกสารประกอบ API ผู้ดูแลระบบของ Synapseสำหรับการตรวจสอบสิทธิ์ผู้ดูแลระบบเซิร์ฟเวอร์และการกู้คืนห้อง ข้อความและตัวควบคุมที่แน่นอนจะขึ้นอยู่กับไคลเอ็นต์ โฮมเซิร์ฟเวอร์ เวอร์ชันห้อง และระดับพลังงานที่กำหนดเอง