API 키와 Webhook을 안전하게 관리하기
시크릿 키는 서버에만, Webhook은 반드시 검증, 그리고 키 교체는 일상적인 유지보수입니다.
키는 개발자에서 만듭니다. 비밀 키는 bk_test_ 또는 bk_live_로 시작하며 생성할 때 한 번만 표시됩니다. 서버의 시크릿 저장소에 보관하고, 저장소(리포지토리), 모바일 앱, 프런트엔드 코드에는 절대 넣지 마세요.
키는 이를 만든 사람이 워크스페이스의 활성 멤버인 동안에만, 그리고 그 사람의 현재 역할 범위 안에서만 작동합니다. 누군가를 제거하면 그 사람이 만든 모든 키가 폐기되고, 정지하면 복구될 때까지 키가 멈춥니다. 따라서 누군가 떠나기 전에 다른 소유자나 관리자가 대체 키를 만들게 하고 먼저 서버를 전환하세요. 노트북을 분실했거나 키가 로그에 남았을 수 있을 때도 키를 교체하세요. 새 키를 만들고, 서버를 전환한 다음, 이전 키를 폐기합니다.
페이로드를 신뢰하기 전에 모든 Webhook 서명을 검증하고, 이벤트는 멱등하게 처리하세요 — 전달은 최소 한 번 보장이며 순서는 보장되지 않습니다.
개발자에게는 개발자 역할을 부여하세요. 이 역할은 키와 Webhook을 관리할 수 있지만 자금을 이동할 수는 없어, 한 번의 유출이 미치는 범위를 제한해 줍니다.