외부 시스템 연동
인증과 비밀정보
워크스페이스 개발자 키를 발급받고 보관·교체하는 방법입니다.
워크스페이스 관리자는 대시보드 설정 → 개발자 키에서 키를 발급·폐기할 수 있습니다. 관리자 권한이 없으면 워크스페이스 관리자에게 발급을 요청하세요.
연동 서비스의 서버 환경 변수나 비밀정보 관리 도구에 키를 저장하고, 요청마다 다음 헤더로 전달합니다. 브라우저에서 실행되는 코드나 공개 저장소에 키를 넣지 마세요.
Authorization: Bearer <developer-key>기본 원칙
- 워크스페이스와 연동 서비스마다 별도의 키를 사용합니다.
- 로그에 토큰, 전체
Authorization헤더, 개인정보를 남기지 않습니다. - 사용하지 않는 키는 회수합니다.
- 키를 교체할 때는 새 키로 연결을 확인한 뒤 기존 키를 폐기합니다.
- 쿼리 문자열이나 URL에 키를 넣지 않습니다.
Authorization헤더만 사용합니다. - 키에는 현재
read권한만 부여되며, 쓰기 작업을 수행하지 않습니다.
개발자 키 값은 대시보드에서 다시 확인·복사할 수 있지만, 키가 노출되었다고 판단되면 즉시 폐기하고 새 키로 교체하세요. 사용하는 시스템마다 키를 나누면 특정 연동만 중단하거나 교체할 수 있습니다.