한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
안전·권리 · 판정 관망
그림을 글로 풀면
원본 키와 단기 토큰
서버에서 발급한 단기 토큰으로 클라이언트의 음성 연결을 인증합니다.
- 대상
- 브라우저·모바일 음성 기능을 만드는 개발자
- 무엇이 바뀜
- 원본 API 키 보관과 클라이언트 인증을 분리합니다.
- 왜 중요한가
- 클라이언트 코드에 원본 키를 넣는 설계를 피할 수 있습니다.
- 지금 할 일
- 서버에서 발급하고 클라이언트에는 단기 토큰만 전달하세요.
- 한계·미확인
- 개념 비유. 연결·침투 시험 및 보안 안전 보증 없음.
- 확인일
- 2026-10-07
음성 부스에 원본 열쇠까지 넘겨야 할까
가상의 음성 앱에서 브라우저가 직접 연결을 시작한다고 생각해 봅니다. 편의를 위해 원본 API 키를 클라이언트 코드에 넣는 대신, 발급 역할과 연결 역할을 나눌 수 있습니다. 그림의 직원은 서버, 출입증을 든 방문자는 클라이언트입니다. 원본 열쇠가 서버 쪽에 남는 관계가 핵심입니다.
공식 문서가 안내하는 인증 흐름
xAI의 Speech to Speech 문서는 서버가 API 키로 단기 토큰을 요청하고, 이를 클라이언트에 전달해 WebSocket 연결 인증에 쓰는 흐름을 안내합니다. 토큰은 설정된 기간 뒤 만료됩니다. 원본 키를 브라우저나 모바일 코드에 노출하지 않기 위한 방식이며, 기존 연결의 종료 시점까지 여기서 검증한 것은 아닙니다.
발급 경로도 점검 대상이다
AINOW는 발급 요청을 누가 할 수 있는지, 토큰을 어디에 남기는지, 만료 뒤 새 연결을 어떻게 처리할지 먼저 적어 보도록 제안합니다. 단기 토큰도 보유자가 사용할 수 있는 자격 정보이므로 공개 기록에 남길 대상으로 삼지 마세요. 이 글은 구조 설명이며 앱 구현, 실제 연결, 악용 방지 시험을 수행하지 않았습니다.
참고 원문: xAI 공식 문서 — Ephemeral Tokens · 원문 게시일 2026-09-29 (문서 갱신일) · 확인일 2026-10-07
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- Speech to Speech 단기 토큰 인증 문서 2026-10-07 확인. 서버 발급→클라이언트 전달→WebSocket 인증. 서비스 연결 시험 없음
- 확인일
- 2026-10-07
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. 연결·침투 시험 및 보안 안전 보증 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.