세션 카메라 camera-session.1
사진을 카드 하나만 열 수 있게 보내는 카메라. 카드와 장치가 세션 키를 새로 정해 사진마다 씁니다.
쓰임
사진을 보는 브라우저를 한 곳으로 정하고, 나중에 장치나 브라우저에서 E2E 키가 새어도 지난 사진이 풀리지 않아야 할 때 씁니다.
장치 쪽 설정
장치는 접속하면 @$ui에 t=로 이 타입을 알리고, 상태가 바뀔 때마다 @$state를 보냅니다. 앱은 명령을 <cid>@로 보냅니다.
@$name 내 세션 카메라:거실
@$ui t=camera-session.1
@$state on=1;interval=100
상태 키 @$state
| 키 | 값 | 뜻 |
|---|---|---|
on | 0 / 1 | 1이면 사진을 보내는 중, 0이면 멈춤 |
interval | 100 / 200 / 500 / 1000 / 2000 / 5000 | 사진 사이 간격 (ms) |
session | 1이면 사진을 받는 카드가 있음, 0이면 없음(사진을 보내지 않음) |
명령 <cid>@
| 명령 | 뜻 |
|---|---|
on | 보내기 시작 |
off | 보내기 멈춤 |
interval={v} | 간격을 {v}ms로 |
{v}는 슬라이더·색상 값입니다. 모르는 명령을 받아도 장치는 현재 상태를 보내야 앱이 기다리지 않습니다.
구현 메모
- 장치와 카드에 같은 E2E 키를 넣습니다. 이 키는 서로를 확인하는 데만 쓰고, 사진은 세션 키로 암호화합니다(
io.signal_e2e("@image", buf, len, sessionKey)). 장치는 평문 사진을 보내지 않습니다. - 세션 키는 X25519로 정합니다. 카드가
<cid>@e2e-hello를 보내면 장치가<cid>@e2e-challenge(nonce)로 답하고, 카드가 공개키와 HMAC(E2E 키)을 담은 hello를, 장치가 공개키와 HMAC을 담은<cid>@e2e-ready를 보냅니다. 양쪽이 HKDF-SHA256으로 같은 키를 만들고, 회선에는 공개값만 오갑니다. - 양쪽의 비밀값은 메모리에만 있다가 한 번 쓰고 버립니다. 그래서 나중에 E2E 키를 알아내도 녹화해 둔 지난 사진은 풀 수 없습니다.
- 세션은 한 번에 카드 하나입니다. 다른 카드는 '이 브라우저로 받기'로 가져올 수 있고, 그러면 먼저 카드는 사진을 더 열지 못합니다.
- 장치가 재부팅되거나, E2E 키가 바뀌거나, 세션이 10분 지나면 세션이 끝나고 카드가 새로 만듭니다.
- WebCrypto의 X25519가 필요합니다(최신 Chrome, Edge, Firefox, Safari).
- 익명 연결 한도와 간격 권장은 camera.1과 같습니다.
기본 그림
이 타입에는 기본 그림이 없습니다.
예제
- esp32cam-session — arduino.iosignal.net 예제 페이지
타입 파일
iosignal/devices/types/camera-session.1.json(rev 1) · CDN
JSON 보기
{
"schema": 1,
"type": "camera-session.1",
"rev": 1,
"title": "세션 카메라",
"icon": "photo_camera",
"traits": [
"camera"
],
"controls": [
{
"widget": "image",
"label": "사진",
"tag": "image",
"e2e": "session"
},
{
"widget": "switch",
"label": "전송",
"key": "on",
"cmdOn": "on",
"cmdOff": "off"
},
{
"widget": "select",
"label": "간격",
"key": "interval",
"options": [
{
"label": "0.1초",
"value": "100"
},
{
"label": "0.2초",
"value": "200"
},
{
"label": "0.5초",
"value": "500"
},
{
"label": "1초",
"value": "1000"
},
{
"label": "2초",
"value": "2000"
},
{
"label": "5초",
"value": "5000"
}
],
"cmd": "interval={v}"
}
]
}