연동과 키 관리
키, 브라우저 origin, 웹훅, AI 에이전트 인계를 안전하게 관리합니다.
자격 증명을 공유하거나, 브라우저 origin을 승인하거나, AI 에이전트에 워크스페이스 작업을 맡기기 전에 이 페이지를 사용합니다.
이 페이지는 운영 인계의 출발점입니다. 앱 설정은 인증과 키를 사용합니다. 구현과 참조 영역의 전문 문서는 Payments, Membership, Embedded Admin, External Effects입니다. 앱 작업 가이드를 완료했더라도 자격 증명을 공유하기 전에 이 페이지에서 권한과 담당자를 확인하고, 출시 전에는 출시 준비 점검을 실행합니다.
자격 증명 소유권
선택한 워크스페이스의 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를 잃어버렸거나 침해되면 교체 키를 발급해 사용하는 곳에 반영한 뒤 이전 키를 철회합니다. 노출이 의심되면 즉시 확산을 막고 철회합니다.
내 개인 액세스 토큰은 콘솔 오른쪽 위 프로필 아이콘(계정)을 눌러 개인 액세스 토큰에서 직접 폐기합니다. 목록에 표시되는 앞뒤 글자(앞 12자·끝 4자)로 토큰을 찾습니다.
Publishable Key는 서버에서 생성되며 현재 교체 기능은 없습니다. 식별자 관련 문제는 직접 수정하지 말고 지원팀에 문의합니다.
브라우저 origin 점검
- 공개 브라우저 호출이 워크스페이스에 의존하기 전에 승인된 브라우저 origin만 추가합니다. 운영·staging·preview를 각각 검토하고 오래된 origin을 제거합니다.
- API CORS origin, preview 대상, 고객 OAuth 클라이언트 origin·redirect는 별도 설정이며 하나를 설정해도 나머지가 구성되지는 않습니다.
- 외부 웹 분석 도구는 직접 운영하는 프런트엔드와 해당 업체에서 설정합니다.
웹훅과 인계 소유권
- 웹훅 전송 실패를 누가 담당하는지 정합니다.
- 업체 종료 후 자격 증명을 누가 교체할 수 있는지 정합니다.
- AI 에이전트 작업은 검토 중인 워크스페이스와 기능 영역으로 제한합니다.
- 기술 담당자에게는 필요한 자격 증명과 맥락만 전달합니다.
Secret Key 교체는 관리자 책임입니다. 노출 의심, 업체 종료, 소유권 불명확 상황에서는 즉시 교체하세요.