본문으로 건너뛰기

세션 카메라 camera-session.1

사진을 카드 하나만 열 수 있게 보내는 카메라. 카드와 장치가 세션 키를 새로 정해 사진마다 씁니다.

← 장치 타입 목록

쓰임​

사진을 보는 브라우저를 한 곳으로 정하고, 나중에 장치나 브라우저에서 E2E 키가 새어도 지난 사진이 풀리지 않아야 할 때 씁니다.

장치 쪽 설정​

장치는 접속하면 @$ui에 t=로 이 타입을 알리고, 상태가 바뀔 때마다 @$state를 보냅니다. 앱은 명령을 <cid>@로 보냅니다.

@$name 내 세션 카메라:거실
@$ui t=camera-session.1
@$state on=1;interval=100

상태 키 @$state​

키값뜻
on0 / 11이면 사진을 보내는 중, 0이면 멈춤
interval100 / 200 / 500 / 1000 / 2000 / 5000사진 사이 간격 (ms)
session1이면 사진을 받는 카드가 있음, 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과 같습니다.

기본 그림​

이 타입에는 기본 그림이 없습니다.

예제​

타입 파일​

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}"
}
]
}