본문으로 건너뛰기
hs-sql-agent
2.0.6
문서 2.0.6
문서 참조

업그레이드 안내

2.0.6 관리 API 키 기능과 Admin Store 마이그레이션 준비 사항.

2.0.5 → 2.0.6

2.0.6에서는 기존 /api 엔드포인트를 자동으로 관리하기 위한 API 키가 추가됩니다.

업그레이드 단계

  1. 새 서버 버전을 배포하고 Admin Store 마이그레이션으로 ManagementApiKeys 테이블을 만듭니다.
  2. 관리 화면에서 연동에 필요한 최소 권한만 가진 API 키를 발급합니다.
  3. 한 번만 표시되는 비밀 값을 안전하게 보관하고 X-API-Key로 허용된 API를 호출합니다.
  4. 키 만료·폐기·교체 시의 처리 방식을 확인합니다.

호환성 및 롤백

기존 관리자 로그인 및 MCP 클라이언트 연결 방식은 변경되지 않습니다. 이전 서버 버전에서는 관리 API 키를 검증할 수 없으므로 롤백 전에 연동 사용을 중단하세요.

관리 API 키 사용 안내