보안과 개인정보
헬피코드가 무엇을 보호하고, 무엇을 보호하지 않으며, 데이터가 어디에 저장·전송되는지 설명합니다.
보호하는 것
토큰 비노출
- 로그인 액세스 토큰은 호스트 서버에만 있고 화면(Renderer)에는 전달되지 않습니다. 화면은 호스트의 프록시(
/elice/*)로만 엘리스 API를 호출합니다. - 런박스에서 플랫폼이 주입한 토큰 환경 변수는 엔진 시작 전에 제거되어 AI 도구가 읽을 수 없습니다.
- 데스크톱의 세션 정보는 OS 안전 저장소로 암호화되어 저장됩니다.
로컬 접근 제어
- 호스트 서버는
127.0.0.1에서만 열리고, 요청마다 실행별 임의 토큰 헤더, 허용된 호스트(루프백) 검사, 동일 출처 검사를 합니다. 다른 로컬 프로세스나 외부 사이트가 호스트를 호출할 수 없습니다. - 엔진은 실행마다 새로 생성한 비밀번호로 보호되며, 호스트만 이를 압니다.
- 화면에는 CSP가 적용되고, 파일 미리보기는 샌드박스 환경에서 열립니다.
- 로그인(OAuth) 콜백과 MCP 인증 콜백은 별도의 OAuth 상태·PKCE로 보호됩니다.
파일과 명령에 대한 보호
- 파일 편집, 명령 실행, 웹, 프로젝트 밖 접근은 권한에서 사용자 확인을 거칩니다.
- 에이전트 구성과 자동 실행 파일(
AGENTS.md,.opencode,.git, 셸 시작 파일 등)은 모든 수락 모드에서 확인합니다. - 엔진 자체의 설정·데이터·상태 폴더(자격 증명, 세션 기록 포함)에 대한 쓰기와, 데이터·상태 폴더 읽기는 항상 확인합니다.
.env파일 읽기는 수동 수락에서 확인합니다.- Windows 네트워크 경로(
\\host\share)는 접근만으로 자격 증명이 전송될 수 있어, 아무 것도 건드리기 전에 확인합니다. - 엔진은 대화 공유(share) 와 자동 업데이트가 꺼진 상태로 실행됩니다.
보호하지 않는 것
警告
- OS 샌드박스가 없습니다. 허용한 명령은 사용자 계정 권한으로 실행됩니다.
- 프로젝트 밖 경로 검사는 최선의 노력입니다. 모델이 파일 도구와 셸 중 무엇을 쓸지 고르고, 명령 분류가 완벽하지 않습니다.
- "항상 허용" 은 범위를 넓힙니다. 인터프리터(
python3 …)나 호스트 접속을 항상 허용하면 그 범위의 후속 요청은 묻지 않습니다. - 신뢰할 수 없는 MCP 서버와 스킬, 서브에이전트 정의는 AI에게 지시를 전달할 수 있습니다. 출처를 확인하세요.
- 외부에서 받은 프로젝트를 열면, 그 프로젝트의
AGENTS.md,.opencode/, 스킬이 AI에게 영향을 줍니다.
데이터가 어디로 가나요
| 데이터 | 전송·저장 |
|---|---|
| 대화 내용, 도구 결과 | 모델 추론을 위해 엘리스 서버로 전송됩니다. |
| 토큰 사용량 | 대화(세션) 단위로 집계됩니다. |
| PDF(헬피비전 OCR) | document_vision 사용 시 파일 전체가 엘리스 문서 서비스로 전송됩니다. |
| 첨부 파일(PDF·Office) | 내 PC(또는 런박스)의 첨부 폴더에 7일 보관 후 정리됩니다. 외부로 별도 전송하지 않습니다. |
| 대화 기록 | 엔진 데이터 폴더(내 PC/런박스)에 저 장됩니다. |
| 승인 기록, AI 판정 기록 | 엔진 데이터 폴더의 permission/에 저장됩니다. |
| 웹 검색·fetch | 요청한 외부 서비스로 전송됩니다. |
오류 보고
데스크톱 앱과 런박스는 Sentry로 오류를 보고합니다.
- 콘솔 출력과 지역 변수는 수집하지 않습니다(프롬프트·사용자 코드가 들어 있을 수 있기 때문).
- 오류 데이터에서 홈 폴더 경로는 가려서 보냅니다.
권장 사항
- 처음에는 수동 수락으로 시작해 AI가 하는 일을 확인하세요.
- "항상 허용"은 범위가 좁은 항목(예: 특정 호스트, 특정 명령)에 한해 쓰세요.
- 자동 수락을 쓸 때는 AI 판정이 완전하지 않다는 점을 염두에 두세요.
- 중요한 작업 전에는 git 커밋 등으로 되돌릴 수 있게 해 두세요.
- 비밀 정보(
.env, 키 파일)가 든 폴더는 프로젝트로 연결하지 않는 것이 안전합니다.