HTTPS 환경에서 OpenVidu 기반 화상 회의 서비스를 구축하는 과정에서

토큰 검증 실패(401), WebSocket 연결 실패, ICE Candidate 연결 실패(검은 화면) 문제가 연쇄적으로 발생했다.

본 문서는 각 문제의 근본 원인과 구조적인 해결 방법을 정리한다.

<aside> 💡

</aside>

1. Nginx → OpenVidu 프록시 프로토콜 불일치 (502 Bad Gateway)

증상

• /openvidu 접근 시 502 Bad Gateway
• Nginx 로그에서 SSL handshake 오류 발생

원인

• OpenVidu Dev 컨테이너는 HTTP(4443) 로 동작
• Nginx에서 proxy_pass https://openvidu-dev:4443로 설정하여 프로토콜 불일치

해결

proxy_pass <http://openvidu-dev:4443>;

2. ws → wss 문자열 치환 후 401 token not valid

증상

• HTTPS 환경에서 WebSocket 연결 시도 시 401 Unauthorized
• OpenVidu 로그:

ERROR: token not validOpenViduException: Token wss://... is not valid

원인

• OpenVidu 토큰은 URL(호스트·포트·파라미터 포함) 을 기반으로 암호학적으로 서명됨
• Backend에서 ws:// → wss:// 문자열 치환 시 서명 검증 실패