Synapse에서 Matrix 가입을 종료하거나 초대 토큰을 요구하세요.
자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.
enable_registration: falseSynapse가 설치된 자체 호스팅 Matrix 홈서버에서 공개 회원가입을 중지하려면 homeserver.yamlSynapse 설정을 변경하고 재시작하세요. 초대받은 사용자만 계정을 생성할 수 있도록 하려면 회원가입은 활성화된 상태로 유지하되, 회원가입 토큰을 요구하도록 설정하세요. 별도의 registration_shared_secret설정을 확인해 보세요. 일반 회원가입이 비활성화된 경우에도 서버 관리자를 포함하여 해당 설정을 알고 있는 사람은 누구나 계정을 생성할 수 있습니다.
올바른 설정은 새 계정을 생성하는 방법에 따라 다릅니다.
register_new_matrix_user명령 또는 승인된 다른 관리 절차를 사용하여 사용자를 생성하십시오.이 문서에서는 가장 널리 사용되는 자체 호스팅 Matrix 홈서버 구현인 Synapse에 대해 설명합니다. 다른 홈서버 소프트웨어는 자체적인 구성 방식을 가지고 있습니다. Synapse의 최신 구성 문서에 따르면 등록은 기본적으로 비활성화되어 있으며, 등록 토큰은 등록 자체가 활성화된 경우에만 작동합니다. Matrix Authentication Service(MAS)를 사용하는 경우, 해당 등록 제어에 대한 내용은 MAS 문서를 참조하십시오. Synapse의 등록 토큰 관리 API는 MAS 통합이 활성화된 경우 비활성화됩니다.
/etc/matrix-synapse/homeserver.yaml/etc/config /data/homeserver.yaml...enable_registration: false
이미 해당 키가 존재하는 경우, 중복 항목을 추가하는 대신 기존 항목을 편집하세요. YAML 들여쓰기와 중복 키는 혼란을 야기할 수 있으므로, 설정을 최상위 수준에 유지하고 파일의 기존 구조를 보존하는 것이 좋습니다.registration_shared_secret관리자 registration_shared_secret_path등록 스크립트를 지원합니다. Synapse 설치 가이드에서는 이 암호를 가진 사람은 공개 등록이 비활성화된 경우에도 일반 계정 또는 관리자 계정을 생성할 수 있다고 경고합니다. 암호를 비공개로 유지하고, 암호 파일에 대한 접근을 제한하며, 공개 저장소, 클라이언트 구성 또는 초대 대상에게 보내는 메시지에 암호를 포함시키지 마십시오. 공유 암호를 사용하는 등록 방식을 사용하지 않는 경우, 해당 암호에 의존하는 자동화 기능이 없는지 확인한 후에만 설정을 제거하십시오. 대신 다른 지원되는 관리자 워크플로를 사용하여 계정을 생성할 수 있습니다.matrix-synapse관리자는 다음과 같이 실행할 수 있습니다.
sudo systemctl restart matrix-synapse
sudo systemctl status matrix-synapse --no-pager
패키지 및 컨테이너 배포 환경에 따라 서비스 이름이 다를 수 있습니다. 서비스 시작에 실패하면 로그를 확인하십시오. YAML 또는 구성 오류가 보고되면 해결하지 않고 구성 파일을 반복적으로 수정하지 마십시오.등록을 비활성화해도 기존 계정 및 회의실 접근 권한은 삭제되지 않습니다. 이 설정은 클라이언트 등록 절차를 통한 신규 일반 등록을 방지하는 것이며, 사용자 삭제 또는 서버 비활성화 제어 기능이 아닙니다.
초대받은 사람들이 직접 가입 절차를 완료하도록 하되, 공개된 가입 페이지는 원하지 않을 때 이 옵션을 사용하세요. 설정에서 homeserver.yaml두 가지 설정을 모두 구성하십시오.
enable_registration: true
registration_requires_token: true
저장 후 Synapse를 다시 시작하십시오. 토큰 게이트는 등록 비활성화와는 다릅니다. 유효한 토큰을 가진 사용자는 계정을 생성할 수 있습니다. Synapse 구성 설명서에서는 등록이 활성화된 경우 악용 방지 제어를 권장합니다. 대상 사용자 및 운영 역량에 적합한 정책을 선택하십시오.
Synapse 버전 중 등록 토큰 관리자 API를 지원하는 버전에서는 관리자가 일회용 토큰을 생성할 수 있습니다. 다음 예제는 자리 표시자 URL과 액세스 토큰을 사용합니다. 신뢰할 수 있는 관리 환경에서만 실행하고, 홈서버의 공개 기본 URL과 관리자 액세스 토큰으로 대체하며, 셸 기록 및 로그를 보호하십시오.
curl -X POST "https://matrix.example.com/_synapse/admin/v1/registration_tokens/new" \
-H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"uses_allowed":1}'
응답에는 생성된 토큰이 포함됩니다. 해당 값을 의도한 사용자에게 비공개로 공유하십시오. Synapse API는 Unix epoch 이후 밀리초 단위로 측정되는 만료 시간도 지원합니다. 공식 API 참조를 사용하여 배포 환경에 맞는 만료 시간을 계산하고 설정하십시오. 사용 횟수 제한이나 만료 시간이 설정되지 않은 토큰은 기본적으로 무제한 사용 및 만료 없음으로 처리되므로, 사용 횟수 제한을 신중하게 설정해야 합니다. 관리자는 동일한 API를 통해 토큰 목록을 확인, 업데이트 또는 삭제할 수 있습니다. 공개 이슈나 게시글에 실제 베어러 토큰이나 등록 토큰을 붙여넣지 마십시오.
토큰 관리는 버전 및 배포 제한이 있습니다. 설치된 Synapse 릴리스에 맞는 관리자 API 문서를 참조하십시오. 현재 문서에 따르면 MAS 통합이 활성화된 경우 이 Synapse API는 사용할 수 없으며, 이 경우 MAS 관리자 API 또는 CLI를 사용해야 합니다.
registration_requires_token 단독으로는 등록이 활성화되지 않습니다. 두 플래그 모두 의도한 흐름을 허용해야 합니다.Synapse를 다시 시작한 후, 로그아웃된 세션을 사용하여 Matrix 클라이언트에서 홈서버의 등록 절차를 엽니다. 폐쇄형 서버의 경우, 클라이언트에서 공개 가입이 성공적으로 표시되지 않아야 하지만 기존 사용자는 계속 로그인할 수 있어야 합니다. 토큰 기반 등록의 경우, 토큰 없이 절차를 실행하여 토큰을 요청하는지 확인한 다음, 제어된 테스트 계정에서 테스트 토큰을 사용하여 등록이 성공하는지 확인합니다. 결과가 의도한 정책과 다른 경우 Synapse 로그와 관리자 API 토큰 상태를 확인합니다. 실제 초대 토큰을 사용하여 테스트하면 허용된 사용 횟수를 모두 소진하게 되므로, 해당 토큰을 사용한 테스트는 피하십시오.
자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.
Clear Element는 신뢰할 수 있는 장치 또는 복구 키를 사용하여 미확인 세션 경고를 표시하며, 암호화된 채팅 기록을 보호하는 검사 기능을 제공합니다.
데이터베이스 잠금 경합과 만료된 WebDAV 잠금을 구분한 다음, 적절한 ownCloud 10 해결 방법을 선택하고 구성하십시오.
대상 검사를 통해 빈 ownCloud 웹 화면이 나타나는 원인을 브라우저 캐시, 누락된 웹 자산, 서비스 오류 또는 역방향 프록시 URL 설정으로 추적할 수 있습니다.
ownCloud의 웹 PHP 메모리 제한을 설정하고, 해당 서비스를 재시작한 다음, CLI 설정이나 업로드 제한과 혼동하지 않고 활성 값을 확인하십시오.
MySQL, PHP, 소켓 설정 또는 데이터베이스 권한이 ownCloud 10을 차단하는지 확인한 다음 안전한 해결 방법을 검증하세요.
ownCloud Classic에서 공개 링크 만료를 필수로 설정하고, 최대 유효 기간을 지정하고, 별도의 정리가 필요한 기존 공유를 확인합니다.
Keycloak을 통해 TOTP를 활성화하고, 사용자를 안전하게 등록하고, Infinite Scale의 경로 수준 MFA 설정이 적용되는 시점을 파악하세요.
문제가 OC10과 7.x 버전 간의 호환성 문제인지, 아니면 CSync 저널 손상 때문인지 확인한 후, 동기화된 파일을 삭제하지 않고 적절한 해결 방법을 적용하십시오.
HTTP-01 또는 DNS-01을 선택하고 ownCloud 역방향 프록시를 구성한 다음 Certbot이 HTTPS 인증서를 자동으로 갱신하는지 확인하십시오.