본문으로 건너뛰기

boho 설계와 기술 상세

boho는 직접 관리하는 장치와 애플리케이션 사이에 인증과 암호화를 적용하는 공유 키 기반 라이브러리입니다. 이름은 ‘보호’에서 왔습니다. Arduino C/C++와 Node.js·브라우저 JavaScript 구현이 서로 호환되는 메시지 형식을 사용합니다.

양쪽 프로그램을 직접 관리하고 키를 미리 넣을 수 있다면, 공개키 기반의 신뢰 체계 없이 사전 공유 대칭키로 통신을 구성할 수 있습니다. boho는 SHA-256 기반 키스트림, XOR, 공유 키 인증, 바이너리 패킷 형식을 조합합니다.

대칭키 배포 모델을 고르는 것과 boho 구성의 안전성을 평가하는 것은 별개입니다. 표준 SHA-256을 쓴다고 해서 자체 프로토콜 전체가 표준 인증 암호화(AEAD)나 TLS와 같은 보장을 얻지는 않습니다.

IOSignal의 접속 인증 설정은 인증과 암호화, 메서드는 클라이언트 API를 참고하세요.

왜 만들었나​

작은 장치의 암호통신에는 암호 알고리즘 외에도 상대 인증, 키 설정, 메시지 형식, 메모리 사용, 전송 수단 연동, 키 관리가 필요합니다.

boho는 미리 키를 설정한 상대를 확인하고 데이터를 보호하는 일을 Arduino, Node.js, 브라우저에서 같은 방식으로 처리하는 데 초점을 둡니다. 암호화는 전송 수단과 분리되어 TCP, WebSocket, 직렬 통신, MQTT 페이로드에도 쓸 수 있으며, IOSignal은 그 주변의 연결 관리와 메시지 전달을 맡습니다.

키는 이미 신뢰하는 경로로 설정한다​

환경키 설정 방법의 예
직접 만드는 임베디드 장치USB·직렬 연결이나 신뢰할 수 있는 설정 도구로 장치별 키 주입
직접 개발한 웹앱과 개인 장치별도 경로로 받은 장치 키를 사용자가 입력하거나 신뢰할 수 있는 페어링 절차로 등록
관리 주체가 같은 서버 사이SSH, 기존 TLS 연결, 비밀 관리 시스템
정해진 장치·사용자 그룹상대별 키 발급과 교체·폐기 절차 운영

신뢰는 사라지는 것이 아니라 키 설정 경로와 양쪽 소프트웨어로 옮겨갑니다. 여러 장치가 키 하나를 나눠 쓰면 송신자를 구분하기 어렵고 유출 시 피해가 커집니다. 공개 JavaScript 번들에 넣은 공통 키는 방문자가 읽을 수 있으므로, 코드를 직접 작성했다는 사실만으로 키가 비밀이 되지는 않습니다.

보호 범위와 한계​

연결 키는 클라이언트–서버 구간을, 별도 E2E 데이터 키는 최종 송수신자 사이의 본문을 보호합니다. 현재 구성은 TLS나 표준 AEAD의 보장을 자동으로 갖지 않으며 전방 보안(forward secrecy)을 제공하지 않습니다. 실제 응용에서 nonce 재사용, 재전송 처리, 키 관리를 검토하세요.

아래 내용은 boho JS 2.2.0과 boho Arduino 1.0.0 구현을 기준으로 합니다. boho는 IOSignal과 별도로 버전을 관리합니다.

XOR, 해시, 일회용 패드​

평문 P와 키스트림 S에 대해 암호문은 C = P XOR S이고, 같은 S로 한 번 더 XOR하면 P가 복원됩니다. 진짜 일회용 패드(OTP)는 메시지만큼 긴 예측 불가능한 비밀 키스트림을 한 번만 사용해야 합니다. 재사용하면 C1 XOR C2 = P1 XOR P2로 두 평문의 관계가 드러납니다.

SHA-256은 32바이트를 출력하는 해시이며 암호화가 아닙니다. 공개된 nonce만 해시해서는 비밀 키스트림이 되지 않고, 약한 비밀번호를 해시해도 엔트로피가 늘지 않습니다. boho의 ‘가상 OTP’는 결정적인 의사난수 구성이며 정보이론적으로 안전한 OTP가 아닙니다. ChaCha20도 비밀 값을 키스트림으로 늘리지만 구성과 분석 수준이 다릅니다.

키스트림 생성​

K = SHA256(입력 키)
B = SHA256(K || salt12)
S_i = SHA256(B || LE32(i)), i = 1, 2, ...

||는 바이트열 연결입니다. salt12는 초(4바이트), 밀리초(2), 카운터(2), nonce(4)로 구성되며 비밀이 아닙니다. 블록 번호는 little-endian으로 붙입니다. 70바이트 평문은 32 + 32 + 6바이트의 키스트림을 씁니다. 소스에서는 resetOTP, getIndexOTP(JS)·generateIndexOTP(Arduino), xotp가 블록 생성과 XOR을 담당합니다. Arduino는 32바이트 블록을 하나씩 만들지만 패킷과 응용 버퍼의 메모리는 여전히 필요합니다.

같은 키와 salt가 반복되면 같은 키스트림이 나옵니다. 고유성은 한 메시지 루프 안이 아니라 장치, 방향, 재부팅, 카운터 재사용 전체에 걸쳐 지켜져야 합니다.

무결성과 인증​

패킷의 무결성 값은 다음 결과의 앞 8바이트입니다.

SHA256(K || salt12 || 평문)

수신자는 복호화한 뒤 이 값을 확인하고 통과한 메시지만 사용합니다. 소스의 generateHMAC, hmac 같은 이름은 기존 명칭일 뿐 표준 HMAC(내부·외부 패드 구성)이 아니므로 HMAC의 보장을 그대로 적용할 수 없습니다.

연결 인증은 다음 순서로 진행합니다.

인증 값은 패킷의 8바이트가 아닌 32바이트 값을 사용합니다. 키 자체는 전송하지 않으며, 양쪽은 설정된 키를 알고 있음을 증명합니다. 공인 인증기관의 신원 확인이나 새 공개키 기반 키 교환은 아닙니다.

패킷 형식​

기능API평문 외 추가 크기
독립 데이터 암호화encryptPack / decryptPack25바이트
인증된 연결의 메시지encrypt_488 / decrypt_48821바이트 (인증에서 얻은 nonce를 쓰므로 시간·카운터 8바이트만 전송)
별도 데이터 키(E2E)encrypt_e2e / decrypt_e2e내부 ENC_PACK 25바이트 + 바깥 전달 정보

이 크기는 패킷 필드 기준이며 Ethernet·TCP·WebSocket 전체 오버헤드나 성능 비교가 아닙니다.

TLS와 종단간 암호화​

TLS는 전송 구간의 상대 인증·키 합의와 대칭 암호화를 처리합니다. 인증서 기반 TLS가 일반적이지만 TLS 1.3에도 PSK 방식(임시 키 교환 포함)이 있습니다. CPU·메모리·대역폭 비용은 하드웨어와 설정에 따라 다릅니다.

비교인증서 기반 TLSboho
최초 신뢰인증서·신뢰 루트·이름 검증별도 경로로 공유 키 설정
보호 단위전송 연결응용 패킷과 연결 인증
불특정 웹 사용자사전 비밀 없이 서버 인증 가능먼저 키를 설정하는 절차 필요
구현 기반표준 프로토콜·암호 구성SHA-256을 조합한 자체 프로토콜

IOSignal의 AUTO 모드는 TLS가 없고 boho 인증이 완료된 연결에 boho 암호화를 적용합니다. 익명 연결까지 암호화되는 것은 아니므로 실제 연결의 암호화 모드를 확인하세요.

연결 키와 E2E 데이터 키는 목적이 다릅니다. 연결 키는 각 클라이언트가 서버에 접속할 자격을 확인하고, E2E 키는 서버가 갖지 않은 키로 최종 송수신자 사이의 본문을 보호합니다.

E2E에서도 태그 같은 라우팅 정보는 서버에 보입니다. 브라우저에서는 키를 다루는 코드 자체를 HTTPS로 안전하게 전달해야 하므로 boho가 HTTPS를 대신하지 않습니다.

적용 전에 확인할 조건​

  • 충분히 무작위인 키를 사용합니다. set_key의 SHA-256 한 번은 느린 비밀번호 KDF가 아닙니다.
  • JS는 crypto.getRandomValues()를 쓰지만 Arduino의 nonce는 암호학적 난수가 아닌 micros() 기반입니다. 재부팅과 장치 사이의 nonce·salt 재사용을 평가하세요.
  • boho 자체는 challenge 만료나 완전한 재전송 캐시를 강제하지 않습니다. 시각·유효기간·중복 수신 규칙은 IOSignal·서버·응용에서 정합니다.
  • 전방 보안이 없고 표준 AEAD의 보장을 주장할 수 없습니다.
  • 키가 노출되면 그 키로 보호한 통신이 영향을 받습니다. 연결 키와 E2E 키를 분리하고 교체 절차를 정해 두세요.

구현과 참고 자료​

구현 검토에는 위 버전의 boho JS와 boho Arduino 소스를 사용하세요. IOSignal 쪽 연결 인증과 E2E 전달은 iosignal의 src/auth/BohoAuth.js, src/client/IOCore.js, src/server/RemoteCore.js와 iosignal-arduino의 src/IOSignal.cpp에 있습니다.

관련 표준: SHA-256, FIPS 180-4, ChaCha20/Poly1305, RFC 8439, HMAC, RFC 2104, TLS 1.3, RFC 8446. 이 자료는 표준을 설명할 뿐 boho가 해당 구성을 구현했다고 인증하지 않습니다.