브라우저 저장소와 API 키: 서버 없는 페이지에서 AI를 부르는 법
2026-10-14에 “웹 버전에 Claude나 ChatGPT를 쓰는 대화창을 달 수 있나”, “키를 브라우저 스토리지에 저장할 수 있지 않을까”라는 물음에 답한 것을 정리한다. → R-WEB-07
한 줄 요약
서버가 없는 페이지에서는 사용자가 자기 API 키를 넣고, 페이지가 그 키로 AI 회사의 서버를 직접 부른다. 키는 브라우저 저장소에 둘 수 있다. 다만 그 저장소는 같은 페이지에서 도는 모든 스크립트가 읽을 수 있다.
백엔드로 비유하면
백엔드에서는 API 키를 서버의 환경 변수나 비밀 저장소에 둔다. 사용자는 그 키를 볼 수 없다. 서버가 사용자를 대신해 AI를 부르기 때문이다.
정적 페이지에는 그 “서버”가 없다. 페이지의 코드는 모두 사용자의 브라우저로 내려가고, 누구나 “소스 보기”로 읽을 수 있다. 그래서 메인테이너의 키를 페이지에 넣을 수 없다. 넣는 순간 공개된다. 길은 셋이다.
| 길 | 누구의 키 | 서버 | 치르는 값 |
|---|---|---|---|
| 사용자가 자기 키를 넣는다 (고른 것) | 사용자 | 없음 | 키가 있는 사람만 쓴다 |
| 중계 서버를 둔다 | 메인테이너 | 있음 | 사용료와 운영, 남용 막기 |
| 대화창을 달지 않는다 (Claude skill) | 사용자의 Claude | 없음 | 편집기 밖에서 묻고 결과를 가져온다 |
브라우저 저장소란
브라우저가 사이트마다 따로 내주는 작은 저장 공간이다. 백엔드로 치면 클라이언트마다 하나씩 있는 키-값 저장소이고, 서버는 그 안을 볼 수 없다.
| 종류 | 언제까지 남나 | 쓰임 |
|---|---|---|
localStorage | 사용자가 지울 때까지 | 설정, 넣어 둔 키 |
sessionStorage | 그 탭을 닫을 때까지 | 잠깐 쓰는 값 |
| IndexedDB | 사용자가 지울 때까지 | 큰 것(작성 중인 문서의 임시 보관 → R-WEB-03) |
나누는 단위는 **출처(origin)**다. 주소의 앞부분(https:// + 도메인 + 포트)이 같으면 같은 저장소를 본다. 다른 사이트는 읽지 못한다.
무엇이 위험한가
출처가 같으면 읽을 수 있다는 것은, 그 페이지에 실려 도는 스크립트라면 누가 쓴 것이든 읽을 수 있다는 뜻이다.
- 남의 스크립트. 광고, 통계, 외부에서 불러오는 라이브러리. 페이지에
<script>로 실으면 우리 코드와 같은 권한으로 돈다. 웹 버전에는 광고가 예정되어 있다(R-WEB-08). 광고와 키가 한 페이지에 있어도 되는지는 정하지 않았다 → 6. 미결정 사항 - 끼어든 스크립트(XSS). 페이지가 남이 쓴 글을 그대로 화면에 넣으면 그 안의 스크립트가 돈다. AriadneNSD는 남이 준 파일과 공유 URL을 연다. 블록의 글자를 화면에 넣을 때 글자로만 다루어야 한다.
- 같은 컴퓨터를 쓰는 다른 사람.
localStorage의 값은 암호화되지 않고, 개발자 도구에서 그대로 보인다.
줄이는 법: 키를 sessionStorage에 두어 탭을 닫으면 잊게 하기, 광고를 다른 출처의 iframe 안에 가두기, 키를 쓰는 화면에는 남의 스크립트를 싣지 않기, 사용자에게 “쓸 수 있는 금액에 한도를 건 키를 따로 만들어 넣으라”고 안내하기.
브라우저에서 AI 회사의 서버를 직접 부를 수 있나
브라우저는 페이지가 다른 출처의 서버를 부르는 것을 기본으로 막는다. 그 서버가 “다른 출처에서 불러도 된다”고 답해 주어야 통한다(CORS). 백엔드에서는 겪지 않는 제약이다. 서버끼리는 누구나 누구를 부를 수 있다.
AI 회사의 API가 브라우저에서 바로 부르는 것을 받아 주는지는 회사마다, 때마다 다르다. 받아 주지 않으면 “사용자가 자기 키를 넣는다”는 길은 그 회사에 대해 닫힌다.
2026-10-14에 메인테이너가 염두에 둔 세 회사를 확인했다. 브라우저가 본 요청 앞에 보내는 물음(preflight, OPTIONS)과 키 없는 요청을 curl로 흉내 내어, 답에 access-control-allow-origin이 오는지 보았다. 출처는 https://reddiana.github.io로 적었다.
| 회사 | 주소 | 미리 묻기 | 키 없는 요청의 답 | 알아 둘 것 |
|---|---|---|---|---|
| Claude (Anthropic) | api.anthropic.com/v1/messages | 200, 허용 | 401 + 허용 머리 | 요청에 anthropic-dangerous-direct-browser-access: true를 넣어야 한다. 빼면 미리 묻기가 400이고 허용 머리가 오지 않는다 |
| ChatGPT (OpenAI) | api.openai.com/v1/chat/completions, /v1/responses | 200, 허용 | 401 + 허용 머리 | 따로 넣을 머리가 없다 |
| Grok (xAI) | api.x.ai/v1/chat/completions | 200, 허용 | 400 + 허용 머리 | 요청의 모양이 OpenAI와 같다 |
셋 다 받아 준다. 다만 이것은 문이 열려 있는지만 본 것이다. 진짜 키로 진짜 브라우저에서 답이 오는지, 답을 조금씩 흘려 받는 것(스트리밍)이 되는지는 해 보지 않았다. Claude의 머리 이름에 “dangerous”가 든 것은 위의 “무엇이 위험한가” 때문이다. 키가 사용자의 브라우저에 있다는 것을 알고 쓰라는 뜻이다.
문서를 둘 곳: localStorage와 IndexedDB (2026-11-03)
2026-11-03에 “브라우저 storage에 저장하는 기능”(R-WEB-09)을 정하며, 본보기인 SequenceDiagram.org는 메뉴 이름이 localStorage인데 AriadneNSD는 왜 IndexedDB에 두는지 설명한 것이다.
localStorage | IndexedDB | |
|---|---|---|
| 크기 | 출처마다 5 MB 안팎(브라우저마다 다름) | 디스크의 일부까지(대개 수백 MB 넘게) |
| 담는 것 | 문자열만(키 → 문자열) | 객체를 그대로, 색인으로 찾기 |
| 읽고 쓰기 | 동기: 쓰는 동안 화면이 멈춤 | 비동기: 화면을 막지 않음 |
| 백엔드로 치면 | 설정 파일 하나 | 클라이언트마다 있는 작은 데이터베이스 |
- 문서 여러 개를 두면 5 MB는 금방 찬다. 문서마다 썸네일을 함께 두면 더 그렇다. 그래서 문서는 IndexedDB에, 작은 설정만
localStorage에 둔다. AriadneNSD는 로컬 백업 · 최근 파일을 이미 IndexedDB에 두고 있어 같은 곳을 쓴다 → 2. 로컬 백업과 자동 저장 - 둘 다 브라우저가 지울 수 있다. 디스크가 모자라면 오래 안 쓴 사이트의 저장소부터 비우고, 사용자가 “사이트 데이터 삭제”를 누르면 둘이 함께 지워진다.
navigator.storage.persist()로 “지우지 말아 달라”고 청할 수 있지만 브라우저가 거절할 수도 있다. 그래서 함께 지워진다는 경고와 파일로 백업하는 길을 둔다 → BS4 - 같은 출처의 탭 둘은 같은 저장소를 본다. 한 문서를 두 탭에서 고치면 나중에 쓴 쪽이 이긴다
AriadneNSD에서 어디에 쓰나
- 웹 버전의 AI 대화창(#P3) → R-WEB-07
- AI가 다이어그램을 “그린다”는 것은 그림을 그리는 것이 아니라 모델을 글로 써 주는 것이다. 편집기는 그 모델을 읽어 그린다. “반복되는 부분을 Method로 빼 주세요”는 지금 모델을 보내고 고친 모델을 받는 일이다. 어떤 형식으로 주고받을지는 정하지 않았다 → backlog
더 읽을거리
- MDN, “Web Storage API”
- MDN, “Cross-Origin Resource Sharing (CORS)”
- OWASP, “HTML5 Security Cheat Sheet”의 Local Storage 절