HTTP 8080 그대로 · HTTPS 8443 · 장비마다 로컬 CA(5 년, 이 장비 이름·사설 주소만 서명) · 서버 인증서 397 일 자동 갱신설명
처음 뜰 때 게이트웨이가 장비만의 인증 기관(CA) 하나와 그 CA 가 서명한 서버 인증서를 만듭니다(config/gateway/tls/). 이 CA 는 이 장비의 이름(호스트명·.local·localhost)과 사설 주소(10.x·172.16~31.x·192.168.x·100.64~127.x·127.x·IPv6 ULA)에만 서명할 수 있게 묶여 있습니다 — 휴대폰이 이 CA 를 믿어도 다른 사이트의 인증서는 통하지 않습니다. 휴대폰은 이 CA 를 한 번만 믿게 하면 됩니다. 서버 인증서는 장비 주소가 바뀌거나 만료가 가까우면 게이트웨이가 알아서 새로 만들고, 휴대폰은 다시 할 일이 없습니다.
설정 항목
| 이름 | 값 | 기본 | 설명 |
|---|---|---|---|
| HTTPS 포트 | 게이트웨이 실행 옵션 | 8443 | --https-port <포트>. 0 이면 HTTPS 를 열지 않습니다. |
| HTTP → HTTPS 이동 | 게이트웨이 실행 옵션 | 끔 | --https-redirect. 켜면 HTTP 로 연 화면을 HTTPS 로 보냅니다(API·사이니지 화면은 그대로). 인증서를 믿게 하지 않은 PC·사이니지가 경고 화면에 막히므로 기본은 끔입니다. |
| HTTPS 받을 주소 | 게이트웨이 실행 옵션 | --address 와 같음 | --https-address <IP>. CM4 처럼 HTTP 를 nginx 뒤 127.0.0.1 에 두는 장비는 휴대폰이 닿게 0.0.0.0 을 줍니다. |
| 관리자 인증서 | 파일 | (없음) | config/gateway/tls/custom.crt 와 custom.key(암호 없는 PEM)를 두고 다시 시작하면 그것을 씁니다. 만료 30 일 전부터 이벤트 로그에 경고합니다. |
동작
휴대폰에 인증서 넣기 — 인증서 주소: http://<장비 IP>:8080/api/v1/tls/ca.crt — 카메라 스캔 요소의 인증서 받기 링크와 같습니다.
아이폰·아이패드(사파리)
1. 사파리로 인증서 주소를 엽니다 → '프로파일이 다운로드됨'. 2. 설정 › 일반 › VPN 및 기기 관리 › 받은 프로파일 › 설치. 3. 설정 › 일반 › 정보 › 인증서 신뢰 설정 › 게이트웨이 CA 를 켭니다. 이것을 빼면 계속 경고가 뜹니다. 4. https://<장비 IP>:8443 으로 엽니다.
안드로이드(크롬)
1. 크롬으로 인증서 주소를 엽니다 → 파일을 저장합니다. 2. 설정 › 보안 및 개인정보 보호 › 기타 보안 설정 › 암호화 및 사용자 인증 정보 › 인증서 설치 › CA 인증서(기기마다 메뉴 이름이 조금 다릅니다). 화면 잠금이 없으면 먼저 만들라고 합니다. 3. https://<장비 IP>:8443 으로 엽니다. .local 이름은 안드로이드에서 안 풀리는 기기가 있어 IP 주소를 권합니다.
지문을 맞춰 보세요. 인증서는 HTTP 로 받으므로 중간에서 바꿔칠 수 있습니다 — 같은 HTTP 화면에 함께 보이는 지문은 근거가 되지 못합니다. 휴대폰 인증서 상세의 SHA-256 을 다른 기기(장비에 붙은 PC)에서 연 관리자 화면(시스템 › HTTPS · 인증서)이나 장비 콘솔의 기동 기록에서 확인한 CA 지문과 맞춰 봅니다.
호스트명을 바꾸면 CA 를 새로 만듭니다. 이름 제약이 옛 이름이기 때문입니다. 예전 CA 를 설치한 휴대폰은 지우고 새 인증서로 다시 등록합니다(이벤트 로그에 알림). CA 는 5 년마다 바뀌며 1 년 전부터 이벤트 로그에 알립니다.
처음 HTTPS 로 열면 한 번 더 로그인합니다. 브라우저는 http://장비:8080 과 https://장비:8443 을 다른 사이트로 봅니다 — 로그인·화면 설정이 따로 저장됩니다.
쓰지 않게 된 휴대폰에서는 인증서를 지우세요. 이 CA 를 믿는 휴대폰은 이 CA 로 서명된 것을 모두 믿습니다. CA 개인키(ca.key)는 장비 밖으로 나가지 않게 합니다.
인증서를 믿게 하지 않고 경고만 넘긴 상태에서도 카메라가 켜지는지는 브라우저마다 다릅니다(확인 필요). 현장에서는 인증서를 설치하는 쪽을 권합니다.