새로 연동한 단지의 단말기 조회가 안 돼요

증상

새로 연동을 시작한 단지에서 세대 단말기 조회가 되지 않음. 다른 단지는 똑같이 등록했는데 잘 되고 이 단지만 안 됨.

단지 관리 > 홈넷 서버 관리에서 연동 시험 시작(홈넷 서버 연동 시작) 을 눌렀는지 확인할 것. 이걸 안 누르면 토큰 발급 자체가 실패함.
홈넷사에 Client ID, Client Secret, sbd ID, TLS 인증서를 모두 전달했는지 확인할 것.
WAS 로그에 응답이 아예 없는지, 오류 응답이라도 오는지 확인할 것. 이 둘은 원인이 다름.

WAS 로그 확인. 절차는 기본매뉴얼/운영/WAS 로그 확인을 따를 것.
로그에서 다음 문구를 찾을 것.
- PKIX path building failed 또는 SSL 핸드셰이크 실패 → 홈넷사가 우리 TLS 인증서를 자기 서버에 등록하지 않은 것임. 방화벽 문제가 아님. 홈넷사에 인증서 등록을 요청할 것.
- Connection timed out → 응답 자체가 오지 않는 경우임. 단지 내 홈넷 서버 방화벽 설정과 포트 개방을 요청할 것.
- Could not find hnsver_sn ... hnet_lnkg_ss_cd(ON) → 우리 쪽에서 연동 시험 시작을 안 누른 것임. 홈넷 서버 연동 시작을 누르고 다시 시도할 것.
응답이 오느냐 안 오느냐로 방화벽 문제와 인증서 문제를 가름. 방화벽이 막혀 있으면 응답값이 아예 오지 않음. 응답이 오는데 SSL 오류면 인증서 쪽임.
판정 결과에 맞춰 홈넷사에 메일을 보낼 것. 로그의 오류 문구를 그대로 인용할 것.

홈넷사에 단지명, 단지 아이디, 오류 발생 시각, 로그의 오류 문구를 전달하고 회신을 받음. 2026-07-16 사례는 홈넷사가 SSL 인증서를 등록하지 않아 생긴 문제였음.

tags	홈넷, 연동, 인증서, 관리사무소
aliases	새 단지 단말기 조회 안 됨, 신규 단지 연동 실패, 연동 시험 실패, PKIX 오류, SSL 핸드셰이크 실패, 인증서 등록 안 됨