회의실 기록을 삭제하지 않고 비활성 Matrix 사용자 비활성화
기기 활동을 검토하고, 관리자 API를 통해 비활성으로 확인된 Synapse 계정을 비활성화하고, 선택적 삭제 플래그가 실제로 무엇을 제거하는지 알아보세요.
사용하지 않는 로컬 Matrix 계정을 서비스에서 제거하려면 POST /_synapse/admin/v1/deactivate/<user_id>계정과 연결된 장치를 검토한 후 Synapse 엔드포인트를 사용하십시오. Synapse에서는 이를 비활성화라고 부릅니다. 비활성화하면 자격 증명이 취소되고 사용자가 채팅방에서 제거되지만 계정 기록이나 사용자의 메시지는 영구적으로 삭제되지 않습니다. 현재 Synapse v1.157 문서에서는 비활성화와 선택적 erase플래그를 구분하고 있는데, 이 플래그는 많은 관리자가 예상하는 것보다 효과가 제한적입니다. Synapse 사용자 관리 API 문서를 참조하십시오. 이 단계는 2026년 10월 10일에 확인한 Synapse v1.157 API 참조를 따릅니다. 배포된 버전의 문서를 참조하여 동작을 확인하십시오.
아니요. 관리자 API에서 지원하는 작업은 비활성화입니다. 이 작업을 수행하면 활성 액세스 토큰, 장치 및 종단 간 암호화 키, 푸셔, 비밀번호 해시, 타사 ID, 사용자의 채팅방 멤버십이 제거됩니다. 대기 중인 초대 요청은 거부되고 계정 데이터가 삭제됩니다. 이는 해당 설정이 erasefalse인 경우에도 발생하는 중대한 변경 사항입니다.
이 설정을 "erase": true사용하면 사용자의 표시 이름, 아바타 URL 및 사용자 지정 프로필 필드가 추가로 제거되고 계정이 삭제된 것으로 표시됩니다. 하지만 전송 또는 수신된 메시지, 업로드된 미디어, SSO ID 매핑 또는 개인 데이터가 포함될 수 있는 기타 모든 기록은 삭제되지 않습니다 . 기존 채팅방 구성원은 해당 사용자의 메시지를 계속 볼 수 있으며, 문서에 따르면 해당 메시지는 나중에 채팅방에 참여하는 사람들에게는 숨겨집니다. 이 API 플래그를 완전한 법적 삭제 절차로 간주하지 마십시오. 사용하기 전에 조직의 데이터 보존 및 개인정보 보호 절차를 따르십시오. 계정 비활성화 및 삭제의 정확한 효과를 검토하십시오 .
계정 조사가 진행되는 동안 복구 가능한 제한이 필요한 경우 Synapse의 계정 일시 정지 기능을 고려해 보세요. 계정 일시 정지는 메시지 전송, 채팅방 참여, 초대 전송 등의 작업을 차단하면서도 계정 일시 정지를 해제할 수 있는 경로를 제공합니다. 계정 비활성화는 계정 퇴출 정책 또는 비활성 정책에 부합하는 계정에 더 적합합니다.
보편적인 비활성 계정 기준은 없습니다. 조직 정책에 따라 기준을 설정한 다음, 오래된 등록 날짜를 증거로 삼지 말고 실제 기기 활동을 확인하세요. 휴면 계정은 서비스, 사용 빈도가 낮은 클라이언트 또는 휴가 중인 사용자의 계정일 수 있습니다. 서비스 계정 및 홈서버 관리자는 소유자가 삭제를 승인하지 않은 경우 정리 대상에서 제외해야 합니다.
/_synapse/admin/가능한 한 공용 리버스 프록시 접근을 피하고 Synapse 호스트에서 관리자 API 요청을 수행할 것을 권장합니다. 토큰은 Authorization 헤더에 포함하여 전송하십시오. 공유 스크립트에 붙여넣거나 로그에 게시하지 마십시오. Synapse 관리자 API 인증 및 접근 지침을 참조하십시오 .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필드를 검사하십시오. 기본적으로 비활성화된 계정은 목록에서 제외됩니다. 아래 예시는 단일 후보를 보여주는 것이며, 실제 서버는 여러 페이지를 반환할 수 있습니다.

GET /_synapse/admin/v2/users/<user_id>/devices. 모든 기기의 last_seen_ts타임스탬프를 정책 마감일과 비교하십시오. 이 타임스탬프는 밀리초 단위의 유닉스 에포크 시간이며 몇 분 정도 차이가 날 수 있습니다. 이를 검토 대상 증거로 활용하고 자동 삭제 결정의 근거로 삼지 마십시오.curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
"$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"
샘플 Matrix ID를 검토한 로컬 사용자 ID로 바꾸세요. 최근에 사용된 기기라면 작업을 중지하고 소유자에게 확인하세요. 타임스탬프가 오래되었지만 계정이 관리자, 봇, 지원 담당자 또는 SSO 연결 사용자라면 계속하기 전에 소유권과 종속성을 확인하세요. 기기 API 문서 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 루프로 사용하지 마세요.

해당 계정을 다시 조회하십시오 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의 삭제 표시 및 프로필 필드 제거가 명시적으로 요구되는 경우 에만 사용하십시오. 이 설정은 메시지 기록이나 업로드된 미디어를 삭제하지는 않습니다. 이러한 항목을 처리해야 하는 경우, 별도로 제공되는 이벤트 수정 및 미디어 관리 절차를 사용하고 그 효과를 개별적으로 확인하십시오. 또한 계정 비활성화 전에 신중하게 계획하십시오. 로컬 암호 계정의 경우 재활성화 시 새 암호를 설정해야 할 수 있으며, 삭제된 기기 암호화 키는 계정을 재활성화하는 것만으로는 복원할 수 없습니다.

목표로 삼은 계정에 대해 후속 쿼리 결과가 제대로 반환되는지 확인하십시오 "deactivated": true. 결과가 다르거나 요청에 오류가 발생하면, POST 요청을 다시 실행하기 전에 중단하고 응답을 조사하십시오.
기기 활동을 검토하고, 관리자 API를 통해 비활성으로 확인된 Synapse 계정을 비활성화하고, 선택적 삭제 플래그가 실제로 무엇을 제거하는지 알아보세요.
PostgreSQL 메모리 사용량이 쿼리 작업, 공유 버퍼, 연결 또는 유지 관리 작업 중 어느 것에서 발생하는지 확인한 다음 Synapse에서 안전하게 적용할 수 있는 변경 사항을 적용하세요.
Synapse 설정을 변경하기 전에 Matrix 룸이 원격 홈서버에 느리게 참여하는 원인, 페더레이션 백오프, 로컬 데이터베이스 부하 또는 아웃바운드 발신자 대기열 등을 추적해 보세요.
자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.
Clear Element는 신뢰할 수 있는 장치 또는 복구 키를 사용하여 미확인 세션 경고를 표시하며, 암호화된 채팅 기록을 보호하는 검사 기능을 제공합니다.
데이터베이스 잠금 경합과 만료된 WebDAV 잠금을 구분한 다음, 적절한 ownCloud 10 해결 방법을 선택하고 구성하십시오.
대상 검사를 통해 빈 ownCloud 웹 화면이 나타나는 원인을 브라우저 캐시, 누락된 웹 자산, 서비스 오류 또는 역방향 프록시 URL 설정으로 추적할 수 있습니다.
ownCloud의 웹 PHP 메모리 제한을 설정하고, 해당 서비스를 재시작한 다음, CLI 설정이나 업로드 제한과 혼동하지 않고 활성 값을 확인하십시오.
MySQL, PHP, 소켓 설정 또는 데이터베이스 권한이 ownCloud 10을 차단하는지 확인한 다음 안전한 해결 방법을 검증하세요.
ownCloud Classic에서 공개 링크 만료를 필수로 설정하고, 최대 유효 기간을 지정하고, 별도의 정리가 필요한 기존 공유를 확인합니다.