ปิดใช้งานผู้ใช้ Matrix ที่ไม่ได้ใช้งานโดยไม่ต้องลบประวัติห้อง

ในการลบบัญชี Matrix ที่ไม่ได้ใช้งานออกจากระบบ ให้ใช้POST /_synapse/admin/v1/deactivate/<user_id>เอนด์พอยต์ของ Synapse หลังจากตรวจสอบบัญชีและอุปกรณ์ต่างๆ แล้ว Synapse เรียกกระบวนการนี้ว่าการปิดใช้งาน: มันจะเพิกถอนข้อมูลประจำตัวและลบผู้ใช้ออกจากห้อง แต่จะไม่ลบข้อมูลบัญชีหรือข้อความของผู้ใช้อย่างถาวร เอกสารประกอบ Synapse v1.157 ปัจจุบันยังแยกความแตกต่างระหว่างการปิดใช้งานกับeraseแฟล็กเสริม ซึ่งมีผลกระทบน้อยกว่าที่ผู้ดูแลระบบหลายคนคาดหวังเอกสารประกอบ API การจัดการผู้ใช้ของ Synapseขั้นตอนเหล่านี้เป็นไปตามเอกสารอ้างอิง API ของ Synapse v1.157 ที่ตรวจสอบเมื่อวันที่ 10 ตุลาคม 2026 โปรดยืนยันพฤติกรรมกับเอกสารประกอบสำหรับเวอร์ชันที่คุณใช้งานอยู่

คำว่า “ลบ” หมายถึงการลบบัญชีผู้ใช้แบบถาวรใช่หรือไม่?

ไม่ การดำเนินการที่รองรับโดย Admin API คือการปิดใช้งาน ซึ่งจะลบโทเค็นการเข้าถึงที่ใช้งานอยู่ อุปกรณ์ และคีย์การเข้ารหัสแบบ end-to-end ตัวส่งข้อมูล รหัสผ่านที่เข้ารหัส รหัสประจำตัวของบุคคลที่สาม และการเป็นสมาชิกห้องของผู้ใช้ คำเชิญที่รอดดำเนินการจะถูกปฏิเสธ และข้อมูลบัญชีจะถูกลบออก นี่เป็นการเปลี่ยนแปลงที่มีผลกระทบ แม้ว่าeraseจะเป็นเท็จก็ตาม

การตั้งค่านี้"erase": trueจะลบชื่อที่แสดง URL รูปประจำตัว และฟิลด์โปรไฟล์ที่กำหนดเองของผู้ใช้ และทำเครื่องหมายบัญชีว่าถูกลบแล้ว อย่างไรก็ตาม การตั้งค่านี้จะไม่ลบข้อความที่ส่งหรือรับ สื่อที่อัปโหลด การแมป SSO ID หรือบันทึกอื่นๆ ที่อาจมีข้อมูลส่วนบุคคล สมาชิกห้องสนทนาที่มีอยู่แล้วยังคงสามารถเห็นข้อความของผู้ใช้ได้ เอกสารระบุว่าข้อความเหล่านั้นจะถูกซ่อนจากผู้ที่เข้าร่วมห้องสนทนาในภายหลัง อย่าใช้การตั้งค่า API นี้เป็นกระบวนการลบข้อมูลทางกฎหมายที่สมบูรณ์ โปรดปฏิบัติตามกระบวนการเก็บรักษาและคุ้มครองความเป็นส่วนตัวขององค์กรของคุณก่อนใช้งาน โปรด ตรวจ สอบผลกระทบของการปิดใช้งานและการลบข้อมูลอย่างละเอียด

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

คุณจะยืนยันได้อย่างไรว่าบัญชีนั้นไม่ได้ใช้งานแล้วจริง ๆ?

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

  1. ใช้โทเค็นผู้ดูแลระบบเซิร์ฟเวอร์จากโฮสต์ที่เชื่อถือได้ผู้ดูแลห้องอย่างเดียวไม่เพียงพอ Synapse แนะนำให้หลีก/_synapse/admin/เลี่ยงการเข้าถึงผ่านพร็อกซีแบบย้อนกลับสาธารณะ และทำการร้องขอ Admin API จากโฮสต์ Synapse เมื่อทำได้ ส่งโทเค็นในส่วนหัว Authorization อย่าวางโทเค็นลงในสคริปต์ที่แชร์ หรือเผยแพร่ในบันทึก ดูคำแนะนำเกี่ยวกับการตรวจสอบสิทธิ์และการเข้าถึง Synapse Admin APIได้ที่นี่
  2. แสดงรายการบัญชีภายในเครื่องและตรวจสอบผู้สมัครปลายทางรายการ v2 จะแบ่งผลลัพธ์เป็นหน้าๆ โดยnext_tokenใช้ค่าที่ส่งคืนเป็นค่าสำหรับคำขอถัดไป ตัวกรอง fromเสริมguests=falseจะยกเว้นแขก แต่ Synapse ระบุว่าพารามิเตอร์นี้ไม่ได้รับการสนับสนุนเมื่อเปิดใช้งานการผสานรวมบริการตรวจสอบสิทธิ์ Matrix ให้ลบออกในการตั้งค่าดังกล่าว
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

ตรวจสอบฟิลด์ที่ส่งคืนname, admin, user_type, และdeactivatedโดยค่าเริ่มต้น รายการจะไม่รวมบัญชีที่ถูกปิดใช้งาน ตัวอย่างด้านล่างแสดงผู้สมัครเพียงรายเดียว เซิร์ฟเวอร์จริงอาจส่งคืนหลายหน้า

ตัวอย่างการตอบกลับรายการผู้ใช้ Synapse Admin API ที่แสดงว่า @inactive:example.org เป็นบัญชีที่ไม่ใช่ผู้ดูแลระบบและไม่ได้ถูกปิดใช้งาน
ตัวอย่างรายการผู้ใช้: โปรดตรวจสอบ Matrix ID ที่ถูกต้อง สถานะผู้ดูแลระบบ และสถานะการปิดใช้งานปัจจุบันก่อนดำเนินการต่อ
  1. ตรวจสอบอุปกรณ์ของผู้สมัครร้องขอGET /_synapse/admin/v2/users/<user_id>/devicesและเปรียบเทียบเวลาของอุปกรณ์แต่ละชิ้นlast_seen_tsกับเวลาที่กำหนดไว้ในนโยบายของคุณ ซึ่งเป็นเวลาประทับแบบ Unix-epoch ในหน่วยมิลลิวินาที และอาจคลาดเคลื่อนไปบ้างไม่กี่นาที ให้ใช้เป็นเพียงหลักฐานในการตรวจสอบ ไม่ใช่การตัดสินใจลบข้อมูลโดยอัตโนมัติ
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

แทนที่ Matrix ID ตัวอย่างด้วยชื่อผู้ใช้ในเครื่องที่คุณตรวจสอบ หากอุปกรณ์ถูกใช้งานเมื่อเร็ว ๆ นี้ ให้หยุดและยืนยันกับเจ้าของ หากเวลาประทับเก่า แต่บัญชีเป็นผู้ดูแลระบบ บอท บัญชีผู้ใช้ฝ่ายสนับสนุน หรือผู้ใช้ที่เชื่อมโยงกับ SSO ให้ตรวจสอบความเป็นเจ้าของและการพึ่งพาอาศัยกันก่อนดำเนินการต่อเอกสาร API ของอุปกรณ์last_seen_tsและหน่วยวัด

ตัวอย่างการตอบกลับ device-list สำหรับ @inactive:example.org ที่มีอุปกรณ์เว็บและเวลาประทับ last_seen_ts ของอุปกรณ์นั้น
ตัวอย่างผลลัพธ์จากอุปกรณ์: ตรวจสอบค่า last_seen_ts ล่าสุดจากอุปกรณ์ต่างๆ ในบัญชี เทียบกับระยะเวลาที่ไม่ใช้งานที่ได้รับอนุมัติ

จะปิดใช้งานบัญชีที่ได้รับอนุมัติแล้วได้อย่างไร?

ใช้รหัส Matrix ID ท้องถิ่นแบบเต็ม ไม่ใช่ชื่อที่แสดง จุดสิ้นสุดการปิดใช้งานยอมรับออบเจ็กต์ JSON ที่เป็นตัวเลือก โดยค่าเริ่มeraseต้นจะเป็น false การปล่อยให้ค่าเริ่มต้นเป็นการรักษาฟิลด์โปรไฟล์ไว้ ในขณะที่ยังคงลบเซสชัน อุปกรณ์ การเป็นสมาชิกห้อง และข้อมูลการปิดใช้งานอื่นๆ ที่อธิบายไว้ข้างต้น

curl -sS -X POST \
  -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"erase": false}' \
  "$SYNAPSE_URL/_synapse/admin/v1/deactivate/%40inactive%3Aexample.org"

เรียกใช้คำสั่งนี้กับผู้ใช้ที่ได้รับการตรวจสอบทีละราย การตอบกลับที่สำเร็จไม่ได้ทดแทนการตรวจสอบว่าคุณได้กำหนดเป้าหมายไปยังบัญชีที่ต้องการแล้ว อย่าเปลี่ยนรายการเวลาเก่าๆ ให้เป็นลูป POST จำนวนมากจนกว่าแต่ละบัญชีจะผ่านการตรวจสอบและการรักษาสิทธิ์ของคุณแล้ว

ตัวอย่างคำขอ curl POST ไปยังเอนด์พอยต์ deactivate ของ Synapse โดยตั้งค่า erase เป็น false
ตัวอย่างเนื้อหาคำขอใช้ erase=false ซึ่งจะช่วยหลีกเลี่ยงการดำเนินการลบโปรไฟล์และเครื่องหมายลบเพิ่มเติม

คุณตรวจสอบผลลัพธ์และเลือกวิธีลบได้อย่างไร?

สอบถามบัญชีอีกครั้งด้วยGET /_synapse/admin/v2/users/<user_id>ยืนยันว่าการตอบกลับระบุ Matrix ID ที่คาดหวังและรายงาน"deactivated": trueบัญชีดังกล่าวไม่ควรมีโทเค็นการเข้าถึง อุปกรณ์ หรือการเป็นสมาชิกห้องที่ใช้งานอยู่แล้ว เก็บเวลาที่ร้องขอและ ID บัญชีไว้ในบันทึกการดูแลระบบของคุณ แต่ห้ามเก็บโทเค็นผู้ถือไว้ในบันทึกนั้นเด็ดขาด

curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org"

ตั้งค่านี้เฉพาะ"erase": trueเมื่อการตัดสินใจเกี่ยวกับการเก็บรักษาข้อมูลหรือความเป็นส่วนตัวของคุณระบุอย่างชัดเจนว่าต้องการให้ Synapse ลบเครื่องหมายที่ถูกลบและข้อมูลโปรไฟล์ การตั้งค่านี้จะไม่ลบประวัติข้อความหรือสื่อที่อัปโหลด หากคุณต้องการจัดการสิ่งเหล่านั้น ให้ใช้ ขั้นตอน การปกปิดเหตุการณ์และการจัดการสื่อ ที่ระบุไว้ในเอกสารแยก ต่างหาก และตรวจสอบผลลัพธ์ด้วยตนเอง นอกจากนี้ ควรวางแผนอย่างรอบคอบก่อนปิดใช้งาน: การเปิดใช้งานใหม่อาจต้องตั้งรหัสผ่านใหม่สำหรับบัญชีรหัสผ่านในเครื่อง และคีย์การเข้ารหัสอุปกรณ์ที่ถูกลบจะไม่สามารถกู้คืนได้โดยการเปิดใช้งานบัญชีใหม่เพียงอย่างเดียว

ตัวอย่างการตอบสนองการสอบถามผู้ใช้ Synapse โดยตั้งค่า deactivated เป็น true สำหรับ @inactive:example.org
ตัวอย่างการตอบกลับการตรวจสอบ: ยืนยันว่าสถานะถูกปิดใช้งานเป็นจริงสำหรับรหัสผู้ใช้ที่ระบุหลังจากส่งคำขอ POST

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

ฝากความเห็น

ปิดใช้งานผู้ใช้ Matrix ที่ไม่ได้ใช้งานโดยไม่ต้องลบประวัติห้อง

ปิดใช้งานผู้ใช้ Matrix ที่ไม่ได้ใช้งานโดยไม่ต้องลบประวัติห้อง

ตรวจสอบกิจกรรมของอุปกรณ์ ปิดใช้งานบัญชี Synapse ที่ได้รับการยืนยันว่าไม่ได้ใช้งานผ่านทาง Admin API และเรียนรู้ว่าตัวเลือก "ลบข้อมูล" นั้นลบอะไรออกไปบ้าง

ลดภาระการใช้หน่วยความจำของ PostgreSQL ใน Matrix Synapse

ตรวจสอบว่าหน่วยความจำของ PostgreSQL มาจากงานประมวลผลคำสั่งค้นหา บัฟเฟอร์ที่ใช้ร่วมกัน การเชื่อมต่อ หรือการบำรุงรักษา จากนั้นทำการเปลี่ยนแปลงที่ปลอดภัยต่อการใช้งาน Synapse ตามเป้าหมาย

เหตุใดการเข้าร่วมห้องสนทนา Matrix Synapse จึงช้า และควรตรวจสอบอะไรบ้าง

เหตุใดการเข้าร่วมห้องสนทนา Matrix Synapse จึงช้า และควรตรวจสอบอะไรบ้าง

ตรวจสอบการเข้าร่วมห้อง Matrix ที่ช้าไปยังโฮมเซิร์ฟเวอร์ระยะไกลเครื่องใดเครื่องหนึ่ง การหน่วงเวลาของเฟเดอเรชัน การโหลดฐานข้อมูลภายใน หรือคิวผู้ส่งขาออก ก่อนที่จะเปลี่ยนการตั้งค่า Synapse

ปิดการลงทะเบียนผ่าน Matrix หรือกำหนดให้ต้องใช้โทเค็นเชิญบน Synapse

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

คำเตือนเกี่ยวกับข้อมูลประจำตัวเซสชันขององค์ประกอบ: ยืนยันการเข้าสู่ระบบของคุณอย่างปลอดภัย

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

หยุดปัญหาการหมดเวลาการล็อกไฟล์ ownCloud ด้วยระบบแบ็กเอนด์ที่เหมาะสม

แยกแยะปัญหาการแย่งชิงการล็อกฐานข้อมูลออกจากปัญหาการล็อก WebDAV ที่หมดอายุ จากนั้นเลือกและกำหนดค่าวิธีแก้ไข ownCloud 10 ที่ถูกต้อง

สิ่งที่ควรตรวจสอบเมื่อ ownCloud Web เปิดขึ้นมาเป็นหน้าว่างเปล่า

สิ่งที่ควรตรวจสอบเมื่อ ownCloud Web เปิดขึ้นมาเป็นหน้าว่างเปล่า

ตรวจสอบหาสาเหตุของหน้าจอ ownCloud Web ว่างเปล่าว่าเกิดจากแคชของเบราว์เซอร์ ไฟล์เว็บหายไป ข้อผิดพลาดของบริการ หรือการตั้งค่า URL ของพร็อกซีแบบย้อนกลับ ด้วยการตรวจสอบแบบเจาะจง

ล้างคำเตือนหน่วยความจำ PHP ของ ownCloud ในรันไทม์ที่ถูกต้อง

ตั้งค่าขีดจำกัดหน่วยความจำ PHP ของเว็บ ownCloud รีสตาร์ทบริการที่เกี่ยวข้อง และตรวจสอบค่าที่ใช้งานอยู่โดยไม่ต้องสับสนกับค่าการตั้งค่า CLI หรือขีดจำกัดการอัปโหลด

แก้ไขปัญหาการเชื่อมต่อ MySQL ล้มเหลวใน ownCloud 10

ตรวจสอบว่า MySQL, PHP, การตั้งค่าซ็อกเก็ต หรือสิทธิ์การเข้าถึงฐานข้อมูลกำลังขัดขวางการทำงานของ ownCloud 10 หรือไม่ จากนั้นตรวจสอบวิธีการแก้ไขที่ปลอดภัย

กำหนดวันหมดอายุที่แน่นอนสำหรับลิงก์สาธารณะของ ownCloud

กำหนดวันหมดอายุที่แน่นอนสำหรับลิงก์สาธารณะของ ownCloud

กำหนดให้การหมดอายุของลิงก์สาธารณะเป็นข้อบังคับใน ownCloud Classic กำหนดอายุการใช้งานสูงสุด และตรวจสอบการแชร์ที่มีอยู่ซึ่งอาจต้องมีการล้างข้อมูลแยกต่างหาก