← 링크비온 홈페이지로 돌아가기도움말 목록
도움말·운전·표시·운전 / HTTPS 로 열기와 휴대폰 인증서
HTTPS 로 열기와 휴대폰 인증서 운전
휴대폰 카메라(카메라 스캔)는 HTTPS 로 연 화면에서만 켜집니다. 게이트웨이는 HTTP 와 함께 HTTPS 포트(기본 8443)를 엽니다.
필요: 처음 한 번, 휴대폰에 게이트웨이 인증서(CA)를 설치하고 믿게 합니다
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)는 장비 밖으로 나가지 않게 합니다.

인증서를 믿게 하지 않고 경고만 넘긴 상태에서도 카메라가 켜지는지는 브라우저마다 다릅니다(확인 필요). 현장에서는 인증서를 설치하는 쪽을 권합니다.