TLS 연결 오류 문제 해결

중요합니다

새 중간 CA 인증서 및 결과 인증서 체인을 업데이트하기 위해 Azure Database for PostgreSQL에 대한 TLS 인증서 회전을 시작했습니다. 루트 CA는 동일하게 유지됩니다.

클라이언트 구성이 TLS에 대한 권장 구성을 구현하는 경우에는 아무 작업도 필요하지 않습니다.

인증서 회전 일정

미국 중서부, 동아시아 및 영국 남부 Azure 지역은 2025년 11월 11일에 TLS 인증서 회전을 시작했습니다.
2026년 1월 19일부터 이 인증서 회전은 Azure Government를 포함한 나머지(중국 제외) 지역으로 확장될 예정입니다.
2026년 봄 축제(중국 설날) 이후 중국 지역도 루트 CA 중 하나에 대한 변경을 포함하는 인증서 회전을 거칩니다.

클라이언트 구성 유효성 검사

계획된 회전 전에 클라이언트 구성의 유효성을 검사하려면 TLS에 대한 권장 구성을 구현해야 합니다.

루트 인증서 저장소 확인

필요한 최소 루트 인증서 또는 클라이언트의 루트 인증서 저장소에 설치된 루트 인증서의 전체 집합이 있어야 합니다.

주의

클라이언트의 루트 인증서 저장소에서 Azure 루트 CA 인증서만 신뢰합니다. Microsoft에서 인증서 체인을 업데이트하거나 개별 서버 인증서를 회전할 때 이러한 사례로 인해 예기치 않은 연결 문제가 발생할 수 있으므로 중간 CA 또는 개별 서버 인증서를 신뢰하지 마세요.

TLS 연결 상태 확인

현재 TLS 연결 상태를 확인하려면 sslinfo 확장을 로드한 다음 함수를 ssl_is_used() 호출하여 TLS가 사용되고 있는지 확인할 수 있습니다. 연결에서 TLS를 사용하는 경우 함수가 반환 t 됩니다. 그 외의 경우 f를 반환합니다. 다음 쿼리를 사용하여 Azure Database for PostgreSQL 유연한 서버 인스턴스의 TLS 사용량에 대한 모든 정보를 프로세스, 클라이언트 및 애플리케이션별로 수집할 수도 있습니다.

SELECT datname as "Database name", usename as "User name", ssl, client_addr, application_name, backend_type
   FROM pg_stat_ssl
   JOIN pg_stat_activity
   ON pg_stat_ssl.pid = pg_stat_activity.pid
   ORDER BY ssl;

OpenSSL을 사용하여 TLS 연결 테스트

테스트를 위해 이 openssl 명령을 사용하여 Azure Database for PostgreSQL에 연결하고 TLS 인증서를 표시할 수 있습니다.

openssl s_client -starttls postgres -showcerts -connect <your-postgresql-server-name>:5432

이 명령은 TLS 버전 및 암호와 같은 낮은 수준 프로토콜 정보를 출력합니다. -starttls postgres 옵션을 사용해야 합니다. 그렇지 않으면 이 명령은 사용 중인 TLS가 없음을 보고합니다. 이 명령을 사용하려면 OpenSSL 1.1.1 이상이 필요합니다.

읽기 복제본

루트 CA를 Microsoft RSA 루트 CA 2017로 마이그레이션하면 새로 만들어진 복제본이 마이그레이션에 만들어진 주 서버보다 최신 루트 CA 인증서에 있을 수 있습니다. sslmode=verify-ca 및 sslmode=verify-full 구성 설정을 사용하는 클라이언트의 경우, 새 서버와 기존 서버에서 전환이 완료될 때까지 새 루트 CA 인증서와 이전 루트 CA 인증서를 모두 수락해야 합니다.

Troubleshoot

먼저 문제를 재현합니다.
진단 데이터 수집(클라이언트 쪽 오류 메시지, psql 출력, OpenSSL s_client 출력 및 서버 로그)
서버 매개 변수 확인(require_secure_transport, ssl_min_protocol_version, ssl_max_protocol_version)
인증서 체인 및 클라이언트 sslmode/sslrootcert 설정을 확인하여 프로토콜 버전, 암호 그룹 또는 누락/회전된 인증서의 불일치를 정확히 파악합니다.