ESP32-CAM 세션 카메라
ESP32-CAM 사진을 remocon.kr 카드 하나만 열 수 있게 보냅니다. 카드와 장치가 E2E 키로 서로 확인하고 X25519로 세션 키를 새로 정하므로, 나중에 E2E 키가 새어도 지난 사진은 풀리지 않습니다. 공식 타입 camera-session.1을 씁니다.
장치ESP32-CAM (AI Thinker)실물 확인 예제
사진 · 회로도
준비물
- 보드 ESP32-CAM (AI Thinker) (2026-11-19 ESP32-CAM에서 세션 시작(X25519 약 55ms), 사진 해독, 다른 수신기의 가져가기, 틀린 키 거부, 세션 만료 뒤 자동 갱신(시험용 15초 빌드)을 확인. remocon.kr 카드(로컬 개발 서버)에서 사진, '다른 브라우저' 표시와 '이 브라우저로 받기'를 확인.)
esp32:esp32:esp32cam - 네트워크 Wi-Fi 2.4GHz 공유기
- 앱 https://remocon.kr 장치 카드 (camera-session.1)
배선 · 핀맵
따로 배선할 부품이 없습니다.
펌웨어 설치
미리 빌드한 이 예제의 펌웨어를 USB로 연결한 보드에 브라우저에서 바로 설치합니다. 설치가 끝나면 Wi-Fi 입력 창이 이어집니다.
ESP32-CAM (AI Thinker) · ESP32버전 9.23.1+esp32cam-session.e5b971e
- 이미 IOSignal 보드 설정을 쓰는 펌웨어가 있으면 업데이트로 설치되고 저장된 Wi-Fi가 그대로 남습니다.
- 다른 펌웨어가 있으면 “Erase device” 확인 창이 나옵니다. 체크하지 않으면 칩에 저장된 Wi-Fi를 지우지 않습니다. 체크하면 모두 지우고 Wi-Fi를 다시 넣습니다.
- Wi-Fi·서버·장치 키나 스케치 설정만 바꾸려면 보드 설정 페이지를 쓰세요. 시리얼 모니터가 포트를 쓰고 있으면 먼저 닫습니다.
- 펌웨어에는 Wi-Fi 비밀번호나 장치 키가 들어 있지 않습니다. 익명 CID로 접속합니다.
보드 설정
이 예제는 USB로 연결한 뒤 보드 설정 페이지에서 Wi-Fi, IOSignal 서버(호스트:포트)와 장치 키, 그리고 아래 설정 항목을 바꿀 수 있습니다. 스케치를 다시 빌드하지 않아도 되고, 보드가 값을 저장합니다.
| 이름 | 설명 | 형식 | 기본값 | 참고 |
|---|---|---|---|---|
name | 장치 이름과 앱(remocon.kr 등)의 분류 탭을 이름:분류로 함께 정합니다. 장치는 이 값을 그대로 $name으로 보냅니다. 기본값은 ESP32-CAM:HOME입니다. :가 없으면 분류 없이 이름만 보내 앱의 미분류 탭에 나옵니다. 64바이트까지, 바꾸면 바로 다시 보냅니다.보드 설정 화면 표시: Name & category (name:category) | 글자, 64바이트까지 | ESP32-CAM:HOME | |
e2e_key | 카드와 장치가 서로를 확인하는 키입니다(필수). 사진은 이 키가 아니라 세션 키로 암호화합니다. 카드에도 같은 키를 넣어야 세션이 맺어집니다. 바꾸면 지금 세션이 끝나고 카드가 새 키로 다시 맺어야 합니다. 저장한 뒤에는 보드 설정 화면에 값을 다시 보여 주지 않습니다. 보드 설정 화면 표시: E2E key (required) | 글자, 64바이트까지 | 없음 | 값을 보여 주지 않음 |
interval | 사진을 보내는 간격(밀리초)입니다. 100~60000. 앱 카드나 원격 명령 interval=2000으로도 바뀝니다.보드 설정 화면 표시: Interval ms (100-60000) | 정수, 100~60000 | 1000 | 원격 명령으로도 바뀜 |
이 페이지에서 바로 설정
펌웨어를 설치한 뒤 이어서, 또는 이미 이 예제가 올라간 보드를 USB로 연결해 Wi-Fi, 서버와 장치 키, 위 설정 항목을 여기서 바로 바꿉니다. 설치 창은 먼저 닫으세요(포트를 함께 쓸 수 없습니다). 데스크톱 Chrome·Edge에서 됩니다. 보드 설정 페이지와 같은 기능입니다.
01 보드 연결
이 브라우저는 Web Serial을 지원하지 않습니다. 데스크톱 Chrome이나 Edge에서 여세요. iOS는 지원하지 않습니다.
- 상태
- Not connected
- 장치
- —
- 칩
- —
- 펌웨어
- —
보드에 IOSignalConfig를 쓰는 스케치가 올라가 있어야 합니다(Improv Wi-Fi Serial, 115200bps). 시리얼 모니터가 열려 있으면 포트를 쓸 수 없으니 먼저 닫으세요.
02 Wi-Fi 입력
비밀번호는 USB 시리얼로 보드에만 전달됩니다. 이 페이지는 저장하거나 서버로 보내지 않습니다. 보드는 2.4GHz Wi-Fi만 접속합니다. 연결에 실패하면 보드는 이전 Wi-Fi 설정을 되돌립니다.03 IOSignal 서버 · 장치 키 (선택)
- 서버
- —
- 장치 키
- —
이 보드는 설정을 저장할 곳이 없습니다. ESP8266은 보드 설정의 Flash Size에서 파일 시스템(FS)이 있는 항목을 골라 다시 올려야 합니다.
값은 USB로 보드에만 전달됩니다. 보드는 키를 다시 보내지 않고 점(.) 앞의 id만 알려 줍니다. 장치 키는 서버마다 따로 발급되므로 서버를 바꾸면 그 서버에 등록된 키를 함께 넣으세요. 키 칸을 비워 두면 키는 바뀌지 않습니다. 보드가 쓰는 키는 저장한 키(또는 익명 설정), 스케치의 키, 익명 순입니다. 바꾸면 보드가 재시작합니다.04 스케치 설정
이 스케치가 정한 설정 항목입니다. 보드가 알려 준 목록과 규칙대로 입력칸을 만듭니다.
비밀 항목은 보드가 값을 돌려보내지 않습니다. “스케치 기본값으로”는 저장된 값을 지웁니다.05 시리얼 로그
보드가 출력하는 글입니다. READY CID 줄에서 장치 CID를 확인할 수 있습니다.
사용 순서
- 스케치를 업로드합니다. ESP32-CAM은 USB-TTL 어댑터로 올리고, 올릴 때만 GPIO0을 GND에 연결합니다. 같은 폴더의 E2ESession.h도 함께 올라갑니다. Crypto 라이브러리(rweather)가 필요합니다(IOSignal과 함께 설치됨).
- USB로 연결해 https://arduino.iosignal.net/wifi/ (보드 설정)에서 Wi-Fi를 넣습니다(데스크톱 Chrome·Edge, 보드가 저장). 같은 페이지에서 다른 IOSignal 서버와 장치 키도 넣을 수 있습니다.
- 같은 페이지의 스케치 설정 e2e_key에 키를 넣습니다. 꼭 필요합니다: 비어 있으면 사진을 보내지 않습니다. 보드가 저장하고 다시 보여 주지 않습니다.
- 같은 공유기에 연결한 브라우저로 https://remocon.kr 을 열고, ESP32-CAM 카드에 같은 E2E 키를 넣습니다(그 브라우저에만 저장). 카드가 장치와 세션을 맺고 사진을 보여 줍니다.
- 다른 브라우저에서 같은 카드를 열면 '다른 브라우저가 받고 있다'고 나옵니다. '이 브라우저로 받기'를 누르면 세션을 가져오고, 먼저 브라우저는 사진을 더 열지 못합니다.
- 카드의 전송 스위치로 멈추거나 다시 보내고, 간격으로 사진 사이 시간을 바꿉니다.
시그널 흐름
| 보내는 쪽 | 받는 쪽 | 태그 | 값 | 설명 |
|---|---|---|---|---|
| 장치 | 서버 | @$ui | t=camera-session.1 | 공식 타입 camera-session.1입니다. 앱이 세션으로 사진을 여는 화면을 그립니다. 서버에 보관됩니다. $name(보드 설정 name), #search·#notify는 esp32cam과 같습니다. |
| 장치 | 서버 | @$state | on=1;interval=1000;session=0 | 전송 중인지, 사진 간격(ms), 사진을 받는 카드가 있는지(session)입니다. 서버에 보관됩니다. |
| 장치 | 앱 | @e2e-challenge | [1][이유][nonce 16][holder 8] (바이너리) | 세션을 맺을 때 서명할 nonce입니다. 접속할 때(이유 0, 누구나 답함), 요청에 답할 때(1), 세션이 10분 지났을 때(2, 세션을 가진 카드가 답함) 보냅니다. 틀린 키(3)와 늦은 hello(4)에는 그 hello를 보낸 카드를 holder 자리에 적어 답합니다. |
| 앱 | 장치 | <cid>@e2e-hello | [1] 또는 [1][A 32][HMAC 32] (바이너리) | 1바이트는 challenge 요청입니다. 65바이트는 카드의 X25519 공개키 A와 HMAC-SHA256(E2E 키, "e2e-hello" 1 nonce A)입니다. 장치는 키가 맞을 때만 받아들이고, 받아들이면 nonce를 바꿔 같은 hello를 다시 못 쓰게 합니다. |
| 장치 | 앱 | @e2e-ready | [1][B 32][HMAC 32] (바이너리) | 장치의 X25519 공개키 B와 HMAC(E2E 키, "e2e-ready" 1 nonce A B)입니다. 양쪽이 HKDF-SHA256(X25519 공유값, salt=E2E 키, info="iosignal-e2e-session/1" nonce A B)으로 같은 세션 키를 만듭니다. 비밀값은 메모리에서 한 번 쓰고 지웁니다. |
| 장치 | 앱 | @image | JPEG (세션 키로 암호화, 바이너리) | 세션이 있을 때만 간격마다 보냅니다. 세션 키(64자 hex)를 signal_e2e의 키로 씁니다. 평문 사진은 보내지 않습니다. 세션을 맺은 카드만 열 수 있습니다. |
| 앱 | 장치 | <cid>@ | off / on / interval=2000 | interval은 100~60000ms만 받고 보드에 저장합니다. 처리 뒤(거부해도) 상태를 보냅니다. |
참고
- esp32cam과 같은 보드와 카메라 설정입니다. 다른 점은 사진을 E2E 키로 바로 암호화하지 않고, 카드마다 새로 정한 세션 키로 암호화한다는 것입니다.
- 보드의 NVS에서 E2E 키를 읽어 내고 지난 통신을 모두 녹화해 두어도, 세션 키를 만든 X25519 비밀값이 남아 있지 않아 지난 사진은 풀 수 없습니다(전방향 안전성). E2E 키를 아는 사람은 새 세션을 맺을 수는 있으므로, 키가 새면 보드와 카드의 키를 바꿉니다.
- 세션은 한 번에 카드 하나입니다. 재부팅, 서버 재접속, e2e_key 변경, 10분 경과로 세션이 끝나고, 카드가 알아서 새로 맺습니다. 세션이 없는 동안 장치는 사진을 보내지 않습니다.
- 장치는 challenge 요청을 0.3초에 한 번, 서명된 hello를 0.1초에 한 번까지만 처리합니다. 키 추측과 세션 빼앗기를 늦춥니다.
- 카드는 브라우저의 WebCrypto X25519가 필요합니다(최신 Chrome, Edge, Firefox, Safari). IOSignal Desktop과 안드로이드 앱은 아직 이 타입의 사진을 보여 주지 않습니다.
- 키 교환은 E2ESession.h에 있습니다. 같은 입력에서 Node(웹 브라우저와 같은 WebCrypto 계산)의 X25519·HMAC·HKDF와 같은 결과를 내는지 시험했습니다.
관련 문서
이 예제가 쓰는 개념과 규칙을 iosignal.net에서 자세히 볼 수 있습니다.
