Element Key 백업 및 교차 서명을 안전하게 설정하는 방법
복구 키를 저장하고, Element 세션을 확인하고, 암호화된 메시지 키를 백업과 계정 암호를 혼동하지 않고 복원할 수 있는지 확인하십시오.
Matrix Synapse 로그에 SSL: CERTIFICATE_VERIFY_FAILED페더레이션 중에 연결이 지연되거나, 원격 서버에서 연결이 거부되거나, 메시지가 수신되지 않는 문제가 발생할 수 있다는 메시지가 표시될 수 있습니다. 먼저 어떤 인증서에 문제가 있는지 확인하십시오. 발신 요청 시 원격 서버의 인증서 문제인지, 아니면 다른 서버가 연결할 때 자체 페더레이션 엔드포인트의 인증서 문제인지 파악해야 합니다. 그런 다음 로그와 페더레이션 테스트에서 확인된 인증서 체인, 호스트 이름 또는 신뢰 구성을 복구하십시오. 일반적인 해결 방법으로 TLS 검증을 비활성화하지 마십시오.
Matrix 서버 간 트래픽은 HTTPS를 사용하며, Matrix 사양에 따르면 대상 서버는 공인 인증 기관(CA)에서 서명한 TLS 인증서를 제공해야 합니다. 인증서 검증 오류는 일반적으로 제공된 인증서가 만료되었거나, 불완전하거나, 다른 호스트 이름으로 발급되었거나, 연결하는 서버가 신뢰하지 않는 CA에서 서명했음을 의미합니다. 또한 Synapse 자체 구성이 올바르게 보이더라도 리버스 프록시가 잘못된 인증서를 제공할 수도 있습니다.
Synapse 로그에서 오류 발생 시점 주변의 항목을 확인하고 원격 서버 이름과 정확한 인증서 오류를 기록해 두십시오. Synapse가 다른 홈서버에 요청하는 동안 오류를 보고하는 경우, 원격 서버의 인증서 또는 Synapse 프로세스에서 사용하는 CA 신뢰에 문제가 있을 수 있습니다. 다른 서버가 도메인과 페더레이션할 수 없는 경우, 공용 TLS 엔드포인트 및 서버 검색을 점검하십시오.
homeserver.yaml특히, 서버 이름을 확인하십시오 server_name. 이는 로컬 Matrix ID의 도메인 부분이며 다른 홈서버에서 사용자에게 연결하는 방법을 결정합니다. 머신이나 컨테이너의 내부 호스트 이름과 혼동하지 마십시오. 최신 Synapse 설치 설명서에서는 서버 이름이 페더레이션 ID이며 설치 전에 선택할 것을 권장한다고 설명합니다.
Matrix 서버 이름을 사용하여 Matrix Federation Tester를 실행하십시오. 이 도구는 페더레이션 검색 및 연결 상태를 확인하고 외부에서 볼 수 있는 인증서 또는 라우팅에 문제가 있는지 여부를 알려줍니다. Synapse의 아웃바운드 트러스트 설정을 조정하기 전에 테스트에서 발견된 문제를 해결하십시오.
페더레이션 엔드포인트에 접근할 수 있는 컴퓨터에서 TLS 인증서를 검사하십시오. < matrix.example.org호스트 이름> 부분을 인증서를 제공할 호스트 이름으로 바꾸고, 실제 페더레이션 포트를 사용하십시오. 일반적으로 8448 포트가 사용되지만, 리버스 프록시 또는 위임된 서버는 다른 포트를 사용할 수 있습니다.
openssl s_client -connect matrix.example.org:8448 \
-servername matrix.example.org -showcerts </dev/null
이 -servername옵션은 SNI(서버 이름 표시)를 전송하므로 가상 호스팅 프록시가 요청된 이름에 대한 인증서를 선택할 수 있습니다. 출력에서 검증이 성공적으로 완료되었는지 확인한 다음 인증서의 주체와 유효 기간을 검사하십시오.
openssl s_client -connect matrix.example.org:8448 \
-servername matrix.example.org </dev/null 2>/dev/null | \
openssl x509 -noout -subject -issuer -dates -ext subjectAltName
Matrix 페더레이션에서 사용하는 이름은 인증서의 주체 대체 이름(Subject Alternative Name)에 있는 DNS 이름과 일치해야 합니다. 또한 인증서가 현재 유효한지, 엔드포인트에서 중간 인증서를 전송하는지 확인하십시오. 리버스 프록시를 사용하는 경우 공용 프록시 주소를 테스트하십시오. Synapse 호스트에 올바른 인증서 파일이 있더라도 프록시에서 오래되었거나 관련 없는 인증서를 제공하는 경우에는 문제가 해결되지 않습니다.
테스터가 서버 인증서 문제를 보고하면 페더레이션 호스트 이름에 대한 인증서를 갱신하거나 재발급하고 전체 TLS 인증서 체인을 제공하도록 공용 TLS 엔드포인트를 구성하십시오. Synapse의 최신 구성 설명서에 따르면 tls_certificate_path중간 인증서가 포함된 PEM 인증서를 가리켜야 합니다. Certbot의 경우 `<PEM>`이 fullchain.pem아닌 `<PEM>`을 사용하십시오 cert.pem. 개인 키는 별도의 파일에 보관 tls_private_key_path하고 공개 액세스로부터 보호하십시오.
TLS 연결이 Nginx, Caddy 또는 다른 리버스 프록시에서 종료되면 해당 프록시 구성에서 인증서와 인증서 체인을 업데이트한 다음 설치 환경에 맞는 방법으로 프록시를 다시 로드하십시오. 이 구성에서는 Synapse 자체의 TLS 인증서 경로가 페더레이션 피어에서 볼 수 있는 인증서를 제어하지 않을 수 있습니다. 사용 중인 리스너 및 프록시 설정에 대한 자세한 내용은 Synapse 공식 리버스 프록시 설명서를 참조하십시오.
DNS 및 Matrix 서버 검색도 확인하십시오. 페더레이션은 서버 이름을 직접 확인하거나 /.well-known/matrix/server다른 호스트 이름과 포트로 위임하여 확인할 수 있습니다. 인증서는 해당 검색 경로를 통해 연결된 호스트 이름에 대해 유효해야 합니다. 오래된 DNS 레코드 또는 잘못된 위임으로 인해 피어가 관련 없는 인증서를 제시하는 엔드포인트로 연결될 수 있습니다.
오류가 발생하는 인증서가 사설 네트워크의 원격 홈서버에 속하는 경우, 먼저 해당 인증서가 사용자의 개인 인증 기관(CA)에서 의도적으로 발급된 것인지 확인하십시오. 가능하면 Synapse 호스트에 해당 CA를 설치하고 관리하십시오. Synapse는 federation_custom_ca_list페더레이션에 사용되는 사용자 지정 CA 인증서도 제공합니다. 이 옵션은 PEM 파일을 사용하며 운영 체제에서 제공하는 CA 목록을 대체하므로, 배포에 필요한 모든 CA를 포함해야 하며, 단순히 하나의 개인 CA만 추가하는 것은 바람직하지 않습니다.
federation_custom_ca_list:
- /etc/matrix-synapse/certs/private-root-ca.pem
서버의 개인 키가 아닌 CA 인증서의 경로를 설정하십시오. Synapse 프로세스가 해당 인증서를 읽을 수 있는지 확인하고, YAML 들여쓰기를 검증한 다음, 배포 방법에 따라 Synapse를 다시 시작하거나 재로드하십시오. Synapse 구성 설명서 에 따르면 이 옵션은 일반적으로 개인 홈서버 네트워크에 사용하도록 설계되었습니다.
공개 페더레이션 오류를 무시하도록 설정하지 마십시오 federation_verify_certificates: false. 기본값은 활성화되어 있으며, true이 기능을 끄면 아웃바운드 페더레이션에 대한 인증서 검증이 제거되어 가장 공격에 대한 보호 기능이 약화됩니다. 별도의 federation_certificate_verification_whitelist설정은 Tor 숨겨진 서비스 또는 제어된 개인 설정과 같은 특정 경우에만 사용되며, 공개 인증서 복구를 대체하는 용도로 사용되어서는 안 됩니다. 개인 인프라의 경우 일반적으로 신뢰할 수 있는 개인 CA를 사용하는 것이 더 좋습니다.
인증서가 최신 상태임에도 불구하고 인증서 날짜가 유효하지 않은 것으로 표시되는 경우, Synapse 호스트와 프록시의 시스템 시계 및 시간 동기화를 확인하십시오. 시계가 크게 잘못된 경우 유효한 인증서가 아직 유효하지 않거나 만료된 것으로 표시될 수 있습니다. 또한 갱신 자동화 기능이 공개적으로 제공되는 파일을 실제로 업데이트했는지 확인하십시오. 디스크에 저장된 인증서 갱신은 프록시가 해당 파일을 다시 로드했음을 보장하지 않습니다.
수정 후 페더레이션 테스터를 다시 실행하고 실패했던 연결을 다시 시도하십시오. 테스터에서 예상되는 호스트 이름, 유효 기간 및 신뢰 체인이 표시되는지 확인하고, Synapse 로그에서 인증서 확인 오류 없이 새로운 페더레이션 시도가 있는지 확인하십시오. 테스터는 통과했지만 원격 서버 중 하나라도 여전히 실패하는 경우, 해당 서버 이름, 타임스탬프 및 관련 로그 항목을 익명 처리하여 캡처하십시오. 해당 서버의 인증서 또는 신뢰 환경에 문제가 있을 수 있습니다. 문제 해결 중에는 개인 키, 액세스 토큰 또는 사용자 메시지 내용을 공유하지 마십시오.
복구 키를 저장하고, Element 세션을 확인하고, 암호화된 메시지 키를 백업과 계정 암호를 혼동하지 않고 복원할 수 있는지 확인하십시오.
Synapse 동기화 중 메모리 부족 오류를 진단하고, 캐싱을 안전하게 조정하고, 요청 백로그를 식별하고, 안정적인 메모리 사용을 확인합니다.
보안 검사를 비활성화하지 않고 매트릭스 페더레이션 인증서 오류를 올바른 서버로 추적하고, TLS 체인 또는 CA 신뢰를 복구하고, 수정 사항을 확인합니다.
Cloudflare의 HTTPS 443 포트를 통해 Matrix 클라이언트와 페더레이션을 라우팅하여 Synapse 검색 기능을 유지하고 API 트래픽 캐싱이나 미디어 업로드 오류를 방지합니다.
pg_dump를 사용하여 Synapse를 백업하고, 서명 키와 미디어를 보호하고, 오래된 일회용 키를 재사용하지 않고 깨끗한 PostgreSQL 데이터베이스에 복원하세요.
Mjölnir를 전용 Matrix 계정, 암호화된 관리실, Docker Compose, 정책 목록 및 권한 검사와 함께 설정하십시오.
기존 프록시를 건너뛰고 Synapse에 내장된 슬라이딩 동기화 기능을 구성하십시오. 클라이언트 검색을 확인한 다음 호환되는 전화기에서 회의실 목록 로딩 및 재연결 동작을 측정하십시오.
Element Web을 정적 사이트로 배포하고, Matrix 홈서버를 가리키도록 설정하고, HTTPS를 추가하고, Nginx를 구성하여 오래된 파일 없이 업데이트를 제공하도록 하십시오.
64비트 라즈베리 파이 4에 Conduit를 설치하여 영구 데이터 저장, HTTPS 연동, 보호된 회원가입, 그리고 홈서버 작동 여부 확인 기능을 구성합니다.
Element 또는 Matrix API를 사용하여 권한, Synapse 명명 및 연동을 확인하고 Matrix 회의실에 도메인에서 쉽게 공유할 수 있는 주소를 부여하세요.