연동과 키 관리
키, 브라우저 origin, 웹훅, AI 에이전트 인계를 안전하게 관리합니다.
연동과 키 관리
자격 증명을 공유하거나, 브라우저 origin을 승인하거나, AI 에이전트에 워크스페이스 작업을 맡기기 전에 이 페이지를 사용합니다.
이 페이지는 운영 인계 hub입니다. 앱 설정은 인증과 키를 사용합니다. 구현과 참조 영역의 전문 문서는 Payments, Membership, Embedded Admin, External Effects입니다. P0 앱 작업 완료가 자격 증명 공유나 출시 승인을 대신하지 않습니다.
자격 증명 소유권
선택한 워크스페이스의 tenant-admin 또는 플랫폼 super-admin이 워크스페이스 Secret Key와 연동 설정을 관리합니다. tenant-editor와 tenant-viewer는 이 설정을 관리할 수 없습니다. 고객 세션은 별개의 최종 사용자 신원입니다.
| 항목 | 권한과 경계 | 운영 인계 |
|---|---|---|
Publishable Key (pk01_) | 허용된 공개 읽기와 명시적인 고객·capability 권한 작업의 공개 워크스페이스 식별자. 운영자 권한 없음 | 브라우저 origin을 승인하며, 비공개 쓰기 권한 증명으로 사용하지 않음 |
Secret Key (sk01_) | 부여된 scope의 워크스페이스 서비스 자격 증명. 사용자·고객 신원 없음 | 신뢰된 서버에만 보관하고 담당자·만료·교체·철회 계획을 기록 |
개인 액세스 토큰 (pat01_) | 발급 시 한 워크스페이스에 고정된 운영자 신원. 현재 멤버십·역할 적용 | 운영자 도구용이며 앱 서비스 자격 증명이 아님. X-Tenant-Id로 대상 변경 불가 |
| AI 에이전트 인계 | 운영자의 기존 권한 안에서 한정된 작업 | 필요한 맥락만 전달하고 프롬프트·공개 산출물에 자격 증명을 넣지 않음 |
Secret Key와 개인 액세스 토큰의 원문은 발급 시 한 번만 표시됩니다. 발급할 때 안전하게 보관하며 이후에는 다시 조회할 수 없습니다. Secret Key를 잃어버렸거나 침해되면 교체 키를 발급해 사용하는 곳에 반영한 뒤 이전 키를 철회합니다. 노출이 의심되면 즉시 확산을 막고 철회합니다. Publishable Key는 서버에서 생성되며 현재 rotation 기능은 없습니다. 식별자 관련 문제는 직접 수정하지 말고 지원팀에 문의합니다.
브라우저 origin 점검
- 공개 browser 호출이 워크스페이스에 의존하기 전에 승인된 browser origin만 추가합니다. 운영·staging·preview를 각각 검토하고 오래된 origin을 제거합니다.
- API CORS origin, preview 대상, 고객 OAuth 클라이언트 origin·redirect는 별도 설정이며 하나를 설정해도 나머지가 구성되지는 않습니다.
- 외부 웹 분석 도구는 직접 운영하는 프런트엔드와 해당 업체에서 설정합니다.
웹훅과 인계 소유권
- 웹훅 delivery 실패를 누가 담당하는지 정합니다.
- 업체 종료 후 자격 증명을 누가 교체할 수 있는지 정합니다.
- AI 에이전트 작업은 검토 중인 워크스페이스와 기능 영역으로 제한합니다.
- 기술 담당자에게는 필요한 자격 증명과 맥락만 전달합니다.
Secret Key rotation은 관리자 책임입니다. 노출 의심, 업체 종료, 소유권 불명확 상황에서는 즉시 교체하세요.