단지 연동 점검

목적

홈넷사가 패치를 적용한 뒤, 연동된 단지들의 단말기 ID와 디바이스 ID 패턴이 규격대로 바뀌었는지 확인함.

사전 준비

• 점검 대상 단지 목록과 단지 ID
• 홈넷 서버 access token. 홈넷서버연동토큰상세 테이블에 저장된 토큰을 씀. 1시간마다 바뀌므로 새로 발급받지 않음
• 클라우드 서버 접속 권한. 홈넷 서버는 방화벽으로 막혀 있어 클라우드에서만 호출됨

절차

1. 홈넷사가 공유한 대상 단지 목록을 받을 것. 목록에 없는 연동 단지가 더 있는지 함께 확인 요청할 것.
2. 단지별로 전체 세대 단말기 정보 조회 API를 호출해 단말기 ID 패턴을 볼 것.
   • 변경 전: w99999999-0101-0302-00
   • 변경 후: {단지ID}-0101-0302-00
3. 조회된 세대 중 하나를 골라 기기 목록 API를 호출해 디바이스 ID 패턴을 볼 것.
   • 변경 전: 101_607_Sc00_power
   • 변경 후: {단지ID}_101_607_Sc00_power
4. 호출은 cURL이나 Postman으로 할 것. 서버 내부에서 access token, 단지 ID, 동, 호수를 넣어 게이트웨이를 조회한 뒤 패턴을 대조할 것.
5. 단지별로 패치 적용 여부, 단말기 ID, 디바이스 ID를 표로 정리할 것.
6. 실패한 단지는 응답 내용을 그대로 떠서 홈넷사에 전달할 것.

확인

응답 코드로 상태를 가름.

• 2000 → 정상
• 2999 → 게이트웨이/기기 목록 조회 시 정보 없음
• 503 Service Unavailable (프록시 ERR_CONNECT_FAIL) → 홈넷 서버에 연결 자체가 안 됨
• 연결 안 됨 → 해당 단지 홈넷 서버 상태를 홈넷사에 확인 요청. 회복되지 않으면 회선 단절로 처리함

2026-04-14 코콤 점검 결과: 해남해리2, 완주황운1BL1공구, 익산 제3일반산단, 김제지평선, 전북 장수, 목포 상락, 대구 죽전, 세종 조치원역, 강화신문2단지는 패치 적용 확인. 경주황성 고령자 복지주택과 세종 산울마을은 503, 강동천호는 연결 안 됨으로 미확인. 김제지평선은 기기 ID 조회에서 2999가 나옴.

503·연결 안 됨으로 남았던 경주황성 고령자 복지주택, 세종 산울마을, 강동천호, 대구 죽전은 이후 회선 단절 처리됨. 회선이 단절된 단지는 홈넷을 쓸 수 없고, 따라서 홈즈 앱도 사용할 수 없음.

토큰과 내부 IP는 점검 기록에 남기지 않음. 남겨야 하면 단지 ID와 결과 코드만 남김.

점검 이력

기간	단지	홈넷사	내용
2026-01-19	목포상락 행복주택	코콤	서비스 오픈(1/16) 전후 연동 점검. 정상
2026-01-19 ~ 01-30	청주지북 A4B, A5B	코맥스	연동 확인. 정상
2026-01-19 ~ 01-30	완주황운 1BL 1공구, 전북 장수 1공구, 김제지평선 공동1-2BL, 익산 제3일반산단 행복주택 1공구	코콤	연동 확인. 정상
2026-01-30	시흥정왕 1BL	-	서비스 오픈
2026-04-14	코콤 9개 단지	코콤	ID 패턴 패치 확인 (위 결과)
2026-08-12	현대HT 단지	현대통신	연동 테스트. 현대HT

관련

코맥스 코콤 현대HT 공개노트/기능/홈넷 서버 연동 기본매뉴얼/운영/홈넷 서버 연동 (인증서 발급) 기본매뉴얼/관리사무소/세대 단말기 조회가 안 돼요