SK(Secret Key) 발급 가이드
에이전트와 API가 특정 프로젝트(CSN)에 접근할 때 사용하는 비밀키 SK(Secret Key)를 서비스 목록 화면에서 발급하는 절차를 안내합니다.
📋 개요
SK(Secret Key) 는 giipAgent, giip-fde-agent 스케줄러, 각종 API가 "이 요청은 해당 프로젝트의 것이다"를 증명할 때 쓰는 비밀키입니다. 프로젝트를 만든 직후, 에이전트를 설치하기 전에 이 키를 먼저 발급해 두어야 합니다.
- SK는 프로젝트(CSN)와 그 프로젝트 안의 그룹 조합 단위로 발급됩니다.
- 발급된 SK는 그 프로젝트 범위에서만 유효하며, 다른 프로젝트에는 접근할 수 없습니다.
🛠️ 발급 절차
- GIIP에 로그인한 뒤, 상단에서 SK를 발급할 프로젝트를 선택합니다.
- 서비스 목록 화면으로 이동합니다. 현재 프로젝트에 속한 그룹 목록이 표시됩니다.
- SK를 발급할 그룹 행의 [SK生成] 버튼을 누릅니다. 그 그룹의 SK가 발급되고, 행에 SKEY 값이 표시됩니다.
- 발급된 SK를 사용할 곳에 안전하게 전달합니다. 예를 들어 giip-fde-agent 스케줄러는 PC의
giipAgent.cnf(또는giipAgent.cfg) 파일에서sk=값으로 이 키를 읽습니다.
⚠️ 주의 사항
- 재발급하면 기존 SK는 즉시 무효가 됩니다. 이미 SK가 있는 그룹에서 [SK生成]을 다시 누르면 새 SK가 발급되고, 이전 SK는 그 순간부터 인증에 실패합니다(401 Invalid session). 이미 에이전트가 돌고 있는 그룹에서 재발급할 때는 사용처의 키도 함께 교체하세요.
- SK 값을 채팅·문서·로그에 남기지 마세요. SK가 유출되면 그 프로젝트에 대한 접근 권한이 그대로 넘어갑니다.
- 발급 권한이 없으면 해당 프로젝트의 관리자에게 SK 발급을 요청하세요.
➡️ 다음 단계
SK를 발급했으면, 이제 작업 PC에 giip-fde-agent를 설치하고 gissue 스케줄러를 등록해 이슈가 자동으로 처리되게 합니다.
버전: 1.0
최종 업데이트: 2026-11-14
소스 파일: giipv3/public/help/secret-key.ko.md