Synapse에서 Matrix 가입을 종료하거나 초대 토큰을 요구하세요.

enable_registration: falseSynapse가 설치된 자체 호스팅 Matrix 홈서버에서 공개 회원가입을 중지하려면 homeserver.yamlSynapse 설정을 변경하고 재시작하세요. 초대받은 사용자만 계정을 생성할 수 있도록 하려면 회원가입은 활성화된 상태로 유지하되, 회원가입 토큰을 요구하도록 설정하세요. 별도의 registration_shared_secret설정을 확인해 보세요. 일반 회원가입이 비활성화된 경우에도 서버 관리자를 포함하여 해당 설정을 알고 있는 사람은 누구나 계정을 생성할 수 있습니다.

올바른 등록 정책을 선택하세요

올바른 설정은 새 계정을 생성하는 방법에 따라 다릅니다.

  • 개인 서버, 관리자가 생성한 계정: 공개 등록을 비활성화하십시오. Synapse register_new_matrix_user명령 또는 승인된 다른 관리 절차를 사용하여 사용자를 생성하십시오.
  • 초대 전용 서버이며, 사용자는 Element 또는 다른 클라이언트를 통해 등록합니다. 등록을 활성화하고 토큰을 요구하세요. 각 사용자에게 비공개 채널을 통해 사용 횟수가 제한된 토큰을 제공합니다.
  • 공용 서버: 등록 토큰, CAPTCHA 또는 인증된 이메일/전화번호를 통해 자동화된 악용을 줄일 수 있지만, 모든 계정이 신뢰할 수 있다고 보장하는 것은 아닙니다.

이 문서에서는 가장 널리 사용되는 자체 호스팅 Matrix 홈서버 구현인 Synapse에 대해 설명합니다. 다른 홈서버 소프트웨어는 자체적인 구성 방식을 가지고 있습니다. Synapse의 최신 구성 문서에 따르면 등록은 기본적으로 비활성화되어 있으며, 등록 토큰은 등록 자체가 활성화된 경우에만 작동합니다. Matrix Authentication Service(MAS)를 사용하는 경우, 해당 등록 제어에 대한 내용은 MAS 문서를 참조하십시오. Synapse의 등록 토큰 관리 API는 MAS 통합이 활성화된 경우 비활성화됩니다.

Synapse에서 공개 등록을 비활성화합니다.

  1. 활성화된 구성 파일을 찾으십시오. 일반적인 패키지 설치에서는 ` /etc/matrix-synapse/homeserver.yaml/etc/config /data/homeserver.yaml...
  2. 파일을 백업한 다음 등록 플래그를 설정합니다. 최상위 YAML 구성에서 설정을 다음과 같이 추가하거나 변경합니다.
    enable_registration: false
    이미 해당 키가 존재하는 경우, 중복 항목을 추가하는 대신 기존 항목을 편집하세요. YAML 들여쓰기와 중복 키는 혼란을 야기할 수 있으므로, 설정을 최상위 수준에 유지하고 파일의 기존 구조를 보존하는 것이 좋습니다.
  3. 공유 등록 암호를 검토하십시오. Synapse는 registration_shared_secret관리자 registration_shared_secret_path등록 스크립트를 지원합니다. Synapse 설치 가이드에서는 이 암호를 가진 사람은 공개 등록이 비활성화된 경우에도 일반 계정 또는 관리자 계정을 생성할 수 있다고 경고합니다. 암호를 비공개로 유지하고, 암호 파일에 대한 접근을 제한하며, 공개 저장소, 클라이언트 구성 또는 초대 대상에게 보내는 메시지에 암호를 포함시키지 마십시오. 공유 암호를 사용하는 등록 방식을 사용하지 않는 경우, 해당 암호에 의존하는 자동화 기능이 없는지 확인한 후에만 설정을 제거하십시오. 대신 다른 지원되는 관리자 워크플로를 사용하여 계정을 생성할 수 있습니다.
  4. Synapse를 검증하고 다시 시작하십시오. 서버를 실행하는 서비스 관리자, 컨테이너 오케스트레이션 또는 배포 방법을 사용하십시오. 일반적으로 `systemd`로 명명된 서비스의 경우 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를 사용해야 합니다.

일반적인 구성 오류

  • 잘못된 파일을 변경하는 경우: 컨테이너가 마운트된 파일을 읽는 반면 호스트에는 별도의 복사본이 있을 수 있습니다. 실행 중인 Synapse 프로세스에서 사용하는 경로를 확인하십시오.
  • 재시작을 잊어버리세요: 구성 변경 사항은 서비스에서 읽어오기 때문에 텍스트 편집이 성공했다고 해서 새 정책이 활성화되었다고 볼 수는 없습니다.
  • 등록 기능이 비활성화되어 모든 경로가 차단된다고 가정하면, 구성된 공유 암호는 계정 생성 경로로 남아 있게 됩니다. 관리 자동화에 필요한지 여부에 따라 해당 암호를 보호하거나 제거하십시오.
  • 토큰은 활성화하되 등록은 비활성화하는 경우, registration_requires_token 단독으로는 등록이 활성화되지 않습니다. 두 플래그 모두 의도한 흐름을 허용해야 합니다.
  • 초대 전용 토큰이 모든 악용을 방지한다고 가정하더라도, 유출된 재사용 가능 토큰은 의도치 않은 사람들에게 사용될 수 있습니다. 사용 횟수를 제한하고, 가능한 경우 만료일을 설정하며, 토큰을 비공개로 배포하십시오.

결과를 ​​확인하세요

Synapse를 다시 시작한 후, 로그아웃된 세션을 사용하여 Matrix 클라이언트에서 홈서버의 등록 절차를 엽니다. 폐쇄형 서버의 경우, 클라이언트에서 공개 가입이 성공적으로 표시되지 않아야 하지만 기존 사용자는 계속 로그인할 수 있어야 합니다. 토큰 기반 등록의 경우, 토큰 없이 절차를 실행하여 토큰을 요청하는지 확인한 다음, 제어된 테스트 계정에서 테스트 토큰을 사용하여 등록이 성공하는지 확인합니다. 결과가 의도한 정책과 다른 경우 Synapse 로그와 관리자 API 토큰 상태를 확인합니다. 실제 초대 토큰을 사용하여 테스트하면 허용된 사용 횟수를 모두 소진하게 되므로, 해당 토큰을 사용한 테스트는 피하십시오.

공식 참조

댓글 남기기

Synapse에서 Matrix 가입을 종료하거나 초대 토큰을 요구하세요.

자체 호스팅 Synapse 서버에서 계정 생성을 중단하거나, 제한된 사용 횟수의 등록 토큰을 사용하여 초대 전용으로 가입을 유지하세요.

요소 세션 ID 경고: 안전하게 로그인을 확인하세요

Clear Element는 신뢰할 수 있는 장치 또는 복구 키를 사용하여 미확인 세션 경고를 표시하며, 암호화된 채팅 기록을 보호하는 검사 기능을 제공합니다.

적절한 백엔드를 사용하여 ownCloud 파일 잠금 시간 초과 문제를 해결하세요

데이터베이스 잠금 경합과 만료된 WebDAV 잠금을 구분한 다음, 적절한 ownCloud 10 해결 방법을 선택하고 구성하십시오.

ownCloud 웹 페이지를 열었을 때 빈 페이지가 나타나는 경우 확인해야 할 사항

ownCloud 웹 페이지를 열었을 때 빈 페이지가 나타나는 경우 확인해야 할 사항

대상 검사를 통해 빈 ownCloud 웹 화면이 나타나는 원인을 브라우저 캐시, 누락된 웹 자산, 서비스 오류 또는 역방향 프록시 URL 설정으로 추적할 수 있습니다.

ownCloud PHP 메모리 경고를 올바른 런타임에 해결하세요

ownCloud의 웹 PHP 메모리 제한을 설정하고, 해당 서비스를 재시작한 다음, CLI 설정이나 업로드 제한과 혼동하지 않고 활성 값을 확인하십시오.

ownCloud 10 MySQL 연결 실패 문제 해결

MySQL, PHP, 소켓 설정 또는 데이터베이스 권한이 ownCloud 10을 차단하는지 확인한 다음 안전한 해결 방법을 검증하세요.

ownCloud 공개 링크에 대한 확실한 만료 기한을 설정하세요

ownCloud 공개 링크에 대한 확실한 만료 기한을 설정하세요

ownCloud Classic에서 공개 링크 만료를 필수로 설정하고, 최대 유효 기간을 지정하고, 별도의 정리가 필요한 기존 공유를 확인합니다.

Keycloak을 사용하여 ownCloud Infinite Scale에 TOTP 2단계 인증 로그인을 추가하세요.

Keycloak을 사용하여 ownCloud Infinite Scale에 TOTP 2단계 인증 로그인을 추가하세요.

Keycloak을 통해 TOTP를 활성화하고, 사용자를 안전하게 등록하고, Infinite Scale의 경로 수준 MFA 설정이 적용되는 시점을 파악하세요.

클라이언트와 서버를 일치시켜 ownCloud 동기화를 복원하세요.

문제가 OC10과 7.x 버전 간의 호환성 문제인지, 아니면 CSync 저널 손상 때문인지 확인한 후, 동기화된 파일을 삭제하지 않고 적절한 해결 방법을 적용하십시오.

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

Let's Encrypt와 Nginx를 사용하여 ownCloud를 HTTPS에 연결하세요.

HTTP-01 또는 DNS-01을 선택하고 ownCloud 역방향 프록시를 구성한 다음 Certbot이 HTTPS 인증서를 자동으로 갱신하는지 확인하십시오.