SSL_ERROR_PROTOCOL_VERSION_ALERT

의미

SSL_ERROR_PROTOCOL_VERSION_ALERT는 피어가 호환되지 않거나 지원하지 않는 보안 프로토콜 버전을 보고했음을 나타냅니다.

확인

1. 현재 화면 또는 로그에 표시된 오류 코드를 확인합니다.
2. 오류 코드가 정확히 SSL_ERROR_PROTOCOL_VERSION_ALERT인지 비교합니다.
3. 일치하면 Mozilla NSS 원문의 의미인 "Peer reports incompatible or unsupported protocol version."에 해당하는 오류로 식별합니다.

출처

Mozilla NSS 오류 문자열 (새 창에서 열림)

진단 기록

먼저 문제가 발생한 URL 또는 화면, 표시 시각, 사용한 플랫폼과 배포 버전을 기록합니다. 화면과 로그에서 오류 문자열이 일부만 보이면 앞뒤 문장을 포함해 원문을 보존하고, 민감한 값은 가립니다.

다음 순서로 관찰값을 대조합니다.

1. 현재 화면 또는 로그의 오류 코드가 SSL_ERROR_PROTOCOL_VERSION_ALERT와 정확히 일치하는지 확인합니다.
2. 일치하는 경우 원문의 메시지 "Peer reports incompatible or unsupported protocol version."과 대조합니다.

각 항목은 확인한 값과 확인하지 못한 이유를 함께 기록해야 합니다. 이 문서의 조건과 실제 관찰값이 다르면 원인을 단정하지 말고, 문제 해결 시작 가이드에서 더 넓은 분기를 선택하십시오.

판정 기준

오류 문자열이 일치한다는 사실만으로 원인이 확정되지는 않습니다. 같은 문구가 여러 환경에서 나타날 수 있으므로 웹서버·런타임·운영체제·최근 변경 사항을 함께 비교합니다. 한 단계에서 기대한 값이 나오지 않으면 다음 단계로 넘어가지 말고 해당 환경의 공식 문서를 우선 확인합니다.

안전한 다음 단계

검사 전에 백업과 변경 이력을 확인하고, 비밀번호·세션 쿠키·인증 토큰·개인정보를 공개 로그나 문의 내용에 넣지 않습니다. 설정·권한·데이터를 변경해야 한다면 영향 범위와 되돌리는 방법을 먼저 기록한 뒤 운영 시간과 승인 절차에 맞춰 진행합니다.

원인 분포

[Observation] 입력된 3건에서는 다음 원인이 각각 1건씩 관측됐습니다.

• 0-RTT early data와 TLS 가로채기 장비의 호환성 문제: 1건
• TLS 1.3 draft 버전 불일치: 1건
• Firefox의 TLS 버전 설정 변경: 1건

[Observation] 위 분포는 관측된 사례 기준이며 실제 발생 빈도를 의미하지 않습니다.

오진 함정

• [Observation] TLS 가로채기 장비가 있는 네트워크에서 발생한 사례가 있지만, 모든 사례가 가로채기 장비 때문인 것은 아닙니다. 다른 사례에서는 TLS 1.3 draft 버전 불일치와 클라이언트 TLS 설정 변경이 확인됐습니다.
• [Observation] 기존에 접속되던 사이트에서도 클라이언트의 security.tls.version.max 변경으로 오류가 발생할 수 있습니다.
• [Hypothesis] 오류 코드만으로 서버 문제와 클라이언트 설정 문제를 구분하기는 어렵기 때문에 양쪽 설정을 함께 확인해야 합니다.

환경 매트릭스

환경	관측된 조건	확인된 조치 또는 결과
Ubuntu 회사·학교 네트워크	TLS 가로채기 장비와 0-RTT early data 호환성 문제	security.tls.enable_0rtt_data=false 설정 후 복구됐으며 Firefox 94에서 재시도 수정이 반영됐습니다.
Windows Firefox 60 및 TLS 1.3 시험 서버	서버 draft -26과 Firefox가 기대한 draft -28 불일치	서버를 draft -28로 갱신했습니다.
Windows 10 Firefox 60.0.2	security.tls.version.max가 기본값 4가 아닌 1로 변경됨	관련 TLS 설정을 기본값으로 되돌려 확인하도록 안내됐습니다.

진단 순서

1. [Observation] Firefox의 security.tls.version.fallback-limit, security.tls.version.max, security.tls.version.min이 기본값에서 변경됐는지 확인합니다.
2. [Observation] security.tls.version.max가 기본값 4가 아닌 1로 변경된 사례가 있으므로, 변경된 값이 있으면 기본값으로 되돌린 뒤 재현 여부를 확인합니다.
3. [Observation] 회사·학교 네트워크처럼 TLS 가로채기 장비가 사용될 수 있는 환경인지 확인합니다.
4. [Observation] TLS 1.3 시험 서버라면 서버가 사용하는 draft 버전과 클라이언트가 기대하는 버전이 일치하는지 확인합니다.
5. [Observation] 0-RTT early data와 가로채기 장비의 호환성이 의심되면 security.tls.enable_0rtt_data를 false로 설정한 뒤 재시도합니다.