Superfid Docs
외부 시스템 연동

인증과 비밀정보

워크스페이스 개발자 키를 발급받고 보관·교체하는 방법입니다.

워크스페이스 관리자는 대시보드 설정 → 개발자 키에서 키를 발급·폐기할 수 있습니다. 관리자 권한이 없으면 워크스페이스 관리자에게 발급을 요청하세요.

연동 서비스의 서버 환경 변수나 비밀정보 관리 도구에 키를 저장하고, 요청마다 다음 헤더로 전달합니다. 브라우저에서 실행되는 코드나 공개 저장소에 키를 넣지 마세요.

Authorization: Bearer <developer-key>

기본 원칙

  • 워크스페이스와 연동 서비스마다 별도의 키를 사용합니다.
  • 로그에 토큰, 전체 Authorization 헤더, 개인정보를 남기지 않습니다.
  • 사용하지 않는 키는 회수합니다.
  • 키를 교체할 때는 새 키로 연결을 확인한 뒤 기존 키를 폐기합니다.
  • 쿼리 문자열이나 URL에 키를 넣지 않습니다. Authorization 헤더만 사용합니다.
  • 키에는 현재 read 권한만 부여되며, 쓰기 작업을 수행하지 않습니다.

개발자 키 값은 대시보드에서 다시 확인·복사할 수 있지만, 키가 노출되었다고 판단되면 즉시 폐기하고 새 키로 교체하세요. 사용하는 시스템마다 키를 나누면 특정 연동만 중단하거나 교체할 수 있습니다.

On this page