For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/web/security.md (or send Accept: text/markdown).
보안과 프라이버시
레이트 리밋, 시크릿, 데이터보내기, 감사 추적.
초보자 연습
전제 조건: 아래 두 개의 초보자 가이드를 읽고, 웹 로컬 설정을 완료하고, 편집기의 루트에서 이 모노레포를 엽니다. 웹 설정은 apps/web/.env.local에 속합니다. Next.js는 루트 .env를 읽지 않습니다. 기본 가짜 모드의 /dashboard는 데이터베이스가 없는 데모입니다. /auth에는 마이그레이션된 데이터베이스가 필요합니다.
빠른 용어: 작업 영역은 한 팀의 별도 사용자, 데이터 및 설정입니다. 서버는 신뢰할 수 있는 백엔드입니다. 제공업체 키를 브라우저 및 전화 코드에 보관하세요. 마이그레이션은 테이블을 생성하거나 업데이트하는 버전이 지정된 데이터베이스 변경입니다. AI 모델은 응답하는 엔진입니다. 모델 카탈로그는 서버의 사용 가능한 모델 ID 및 가격 목록입니다. 공급자는 AI, 이메일, 청구 서비스와 같은 외부 서비스입니다. 자격은 작업 영역에서 기능을 사용할 수 있도록 하는 부여입니다. 웹훅은 한 서비스가 다른 서비스의 URL에 보내는 메시지입니다.
1. 사용자 소유 레코드를 읽는 서버 작업 또는 경로에서 쿼리하기 전에 로그인한 사용자의 멤버십과 활성 workspaceId를 확인합니다.
2. 정확한 기록 경로에 대해 구성원 허용 사례 1개와 외부 작업 공간 거부 사례 1개를 추가하도록 대리인에게 요청하세요. 관련된 역할과 필드를 제공합니다.
3. 첫 번째 요청은 성공해야 하며 두 번째 요청은 기록 없음/액세스 거부를 반환해야 합니다. 버튼만 변경하면 액세스가 숨겨지지만 직접 요청이 계속 작동하는 경우 서버 경계가 누락된 것입니다.
사용자 정의 코드의 경우 제공된 prompts/README.md로 시작하고 가장 가까운 프롬프트(앱 화면의 경우 prompts/new-app-screen.md, 공개 페이지의 경우 prompts/new-landing-page.md)를 복사합니다. 서버, 데이터베이스 또는 공급자 작업의 경우 코딩 에이전트에게 이 가이드의 작업을 제공하고 AGENTS.md, .ai/PROJECT_CONTEXT.md 및 일치하는 .ai/ 미러를 읽도록 요청하세요. 여기에 이름이 지정된 정확한 소스 파일을 검사하십시오. 편집하기 전에 파일을 나열하고 확인합니다. 작업 공간 소유권과 서버 전용 비밀을 보존합니다. 차이점을 보여주세요. 원하는 동작, 입력 및 출력 필드, 허용된 역할, 예상되는 성공 및 오류, 테스트 계정, 공급자 또는 장치를 알려주십시오. 샘플 값을 사용하십시오. 절대 진짜 비밀을 붙여넣지 마세요.
데이터보다 먼저 멤버십 확인
세션은 ID를 선택합니다. 서버는 활성 작업공간을 확인하고 멤버십/역할을 확인합니다. 모든 사용자 소유 레코드는 workspaceId를 사용합니다. 클라이언트 필드, URL ID 또는 모델 선택 인수는 해당 소유권 확인을 대체할 수 없습니다.
플랫폼 마케팅 자산 및 플랫폼 관리자 기록에는 명시적인 플랫폼 범위가 있습니다. 익명의 대기자 명단 항목을 위한 작업 공간을 만들지 마십시오.
비동기 작업을 통해 경계를 넘나들다
작업, 도구 컨텍스트, API 키, 콘텐츠, 스토리지 및 아웃바운드 이벤트는 인증된 작업 공간을 상속합니다. 소유권과 함께 리소스 ID를 확인하세요. 다른 워크스페이스에서 유효한 ID를 허용하면 여전히 인증 실패입니다.
거부 테스트를 먼저 작성하세요.
모든 성공적인 변이/읽기를 익명의 외부 작업 공간 및 불충분한 역할 테스트와 결합합니다. 금지된 결과를 진단하는 동안 비밀을 노출하지 마십시오.
설치 및 설정
rate-limit-runtime은 auth, checkout, API, 서브미션 라우트에 연결된 공유 리미터를 제공합니다 — 라우트별 카운터를 만들지 말고 남용에 민감한 새 엔드포인트에 이를 확장하세요. 세션 구성, HTTPS 전용 쿠키, 프로바이더 시크릿은 서버 사이드에 둡니다.
워크스페이스 감사 레코드(audit-runtime.ts)는 보안 관련 변경(프로바이더 설정, 멤버·역할 업데이트)을 포착하며 /settings/audit에서 읽을 수 있습니다.
# Data subject export
src/data-export.ts — assembles a member's
workspace-owned records for account export구현 워크플로
자격 증명을 로그, 오류 페이로드, 애널리틱스 프로퍼티, 감사 값 밖에 두세요 — 옵저버빌리티 계층은 알려진 키를 마스킹하지만 자유 텍스트는 작성자 책임입니다. 모든 읽기와 쓰기에서 인가를 서버에서 해석하세요. UI 상태는 표현이지 증거가 아닙니다.
계정 데이터보내기와 삭제 요청은 계정 경계를 통과해 동일한 소유권 규칙이 적용됩니다. 프로덕트가 필요로 하는 데이터만 저장하세요.
검증 및 문제 해결
리미터가 재시도 가능한 429를 반환할 때까지 시행하고, 감사 행이 이를 생성해야 할 뮤테이션에서 나타나는지 확인하고, 테스트 멤버의 데이터를보냅니다. 릴리스마다 워크스페이스 간 읽기를 하나 프로브하세요 — 가장 저렴하고 중요한 회귀입니다.