개요
사이트 키는 당신의 위젯을 Caputchin에 연결하는 자격 증명입니다. 팀 안에서 하나를 만들며, 각 키는 한 쌍의 값에 더해 자체 설정, 통계, 이력을 가집니다.
키 하나, 아니면 여럿?
대부분의 사이트는 하나면 됩니다. 어떤 표면을 따로 측정하거나 조정하고 싶을 때 별도의 키를 만드세요:
- 환경마다 하나(스테이징과 프로덕션), 테스트 트래픽이 진짜 통계를 흐리지 않도록.
- 폼이나 제품마다 하나, 각각에 독립된 통계나 다른 보안 설정을 원할 때.
같은 팀의 키들은 기본적으로 하나의 게임 맞춤화 묶음을 공유하니(키는 자체 설정에서 그것을 재정의할 수 있습니다), 나누기는 보통 설정과 통계를 분리하는 일입니다. 망설여지면, 하나로 시작하고 나중에 나누세요.
키 만들기
- 팀을 열고 사이트 키로 가세요.
- 사이트 키 만들기를 클릭하고, 이름을 주고, 만들기를 클릭하세요. 이름 말고는 요구하지 않습니다.
그것이 다른 모든 곳에서 쓸 두 값을 돌려줍니다:
| 값 | 생김새 | 들어가는 곳 |
|---|---|---|
| 공개 키 | cpt_pub_... | 페이지의 위젯 sitekey 속성. 브라우저에서 안전. |
| 시크릿 | cpt_sec_... | 당신의 서버, /siteverify 호출에서. 절대 브라우저로 보내지 마세요. |
시크릿은 한 번, 생성 시 표시되니, 그때 복사하세요. 공개 키는 이후 늘 키의 연동 페이지에서 볼 수 있으며, 거기에는 붙여넣을 준비가 된 임베드 스니펫도 보입니다.
이름
키의 이름은 당신 자신이 쓰는 라벨로, 키의 설정 페이지의 식별 아래에 있습니다. 위젯에 나타나지 않고 검증에 영향을 주지 않으니, 언제든 이름을 바꾸세요.
상태: 활성화와 비활성화
각 키에는 설정 페이지에 켜짐 토글이 있습니다. 비활성화된 키는 모든 /siteverify 호출을 거부하니, 아무것도 삭제하지 않고 검증이 즉시 멈춥니다. 유출된 배포에서 교체해 벗어나는 중일 때 키를 비활성화하고, 준비가 되면 다시 활성화하세요.
시크릿 교체
유출됐을 수 있다고 여겨질 때마다 설정 페이지에서 시크릿을 교체하세요. 교체는 즉시입니다: 새 시크릿이 곧장 동작하고 기존 것은 바로 검증을 멈추며, 겹치는 창이 없습니다. 공개 키는 그대로이니, 새 값이 필요한 것은 당신의 백엔드뿐입니다. 진행 중인 검증이 계속 성공하도록 그것을 신속히 배포하세요.
키 삭제
삭제는 영구적입니다. 설정 페이지에서 사이트 키 삭제는 키와 그 검증 구성을 제거하고, 검증이 즉시 멈춥니다. 확인을 위해 키의 이름(또는 그 공개 키)을 입력하며, 되돌릴 수 없습니다. 키를 잠시 멈추고 싶을 뿐이라면, 대신 비활성화하세요.
자체 페이지가 있는 설정
- 보안: CORS 오리진, 필수 헤더, proof-of-work 난이도, 봇 차단, 그리고 속도 제한.
- 통계와 세션: 검증 깔때기와 세션별 로그.
- 감사 로그: 키에 가해진 변경의 기록.