배포키

배포키는 외부 Agent, SAPP CLI 또는 애플리케이션이 SAPP 프로젝트의 기능에 접근할 때 사용하는 인증 토큰입니다. 배포키를 발급하면 해당 키에 허용된 범위 안에서 앱, API, 리소스, 회원 등의 프로젝트 기능을 사용할 수 있습니다. 비밀번호와 같은 중요한 정보이므로 사용처별로 구분하여 발급하고 안전하게 관리해야 합니다.

​

배포키 발급하기

프로젝트의 배포키 메뉴에서 배포키 발급을 선택합니다. 발급 화면에서 키를 구분할 수 있는 메모를 입력한 뒤 저장합니다. 메모에는 다음과 같이 실제 사용처를 알아볼 수 있는 이름을 입력하는 것이 좋습니다.

• 팀 아이디어 보드
• 운영 자동화 Agent
• 개발자 노트북
• 테스트 서버
• 배포용 CLI

하나의 키를 여러 환경에서 함께 사용하기보다는 Agent나 실행 환경별로 각각 발급하는 것을 권장합니다. 문제가 발생했을 때 영향을 받는 범위를 줄이고, 어떤 환경에서 사용된 키인지 확인하기 쉽습니다.

​

배포키 확인하기

발급된 배포키 목록에서는 다음 정보를 확인할 수 있습니다.

• ID: 배포키를 구분하는 번호
• Token: 외부 Agent나 CLI에 등록하는 인증 토큰
• Scope: 해당 키가 접근할 수 있는 프로젝트 기능
• Memo: 발급할 때 입력한 사용처
• 마지막 사용: 최근 키를 사용한 실행 환경, IP 주소와 사용 시점
• 생성일: 배포키가 발급된 날짜와 시간

토큰은 기본적으로 일부가 가려져 표시됩니다. 필요한 경우 토큰 표시를 사용해 전체 값을 확인하거나 복사를 선택해 실행 환경에 등록할 수 있습니다.

​

Scope 확인하기

Scope는 배포키가 접근할 수 있는 기능의 범위를 나타냅니다. 배포키마다 다음과 같은 Scope가 표시될 수 있습니다.

• App: 앱 조회 및 배포 관련 기능
• API: 프로젝트에 등록된 API 관련 기능
• Resource: 연결된 리소스 관련 기능
• Member: 회원 관련 기능
• Log: 실행 로그 관련 기능
• Monitoring: 모니터링 관련 기능

외부 Agent나 애플리케이션은 배포키에 표시된 Scope 안에서만 프로젝트 기능에 접근할 수 있습니다. 키를 사용하기 전에 필요한 기능이 Scope에 포함되어 있는지 확인하세요.

​

사용 내역 확인하기

마지막 사용에서는 배포키가 최근 사용된 환경을 확인할 수 있습니다. 사용 기록이 있다면 실행 환경 이름, IP 주소와 마지막 사용 시점이 표시됩니다. 아직 한 번도 사용되지 않은 키는 사용 기록 없음으로 표시됩니다. 예상하지 못한 환경이나 IP 주소가 표시된다면 해당 키의 사용처를 확인하고, 노출 가능성이 있다면 즉시 삭제한 뒤 새 키를 발급하세요.

​

배포키 삭제하기

더 이상 사용하지 않는 키는 목록의 삭제를 선택해 폐기합니다. 배포키를 삭제하면 해당 키를 사용하던 Agent, CLI 또는 애플리케이션의 프로젝트 접근이 즉시 중단됩니다. 삭제하기 전에 어떤 환경에서 사용 중인지 메모와 마지막 사용 정보를 확인하세요. 삭제한 키를 다시 사용해야 한다면 새로운 배포키를 발급하고 해당 실행 환경의 토큰을 교체해야 합니다.

​

안전하게 관리하기

배포키는 프로젝트 기능에 접근할 수 있는 인증 정보입니다. 소스 코드나 공개 저장소에 직접 작성하지 말고, 환경 변수나 사용하는 Agent의 보안 설정에 저장하세요. 채팅, 문서, 화면 캡처 등 여러 사람이 볼 수 있는 공간에도 전체 토큰을 공유하지 않는 것이 좋습니다. 사용처를 알 수 없는 키, 장기간 사용되지 않은 키, 더 이상 운영하지 않는 환경의 키는 정기적으로 삭제하세요. 키가 노출되었다고 의심되는 경우에는 사용 여부와 관계없이 즉시 폐기하고 새 키로 교체해야 합니다.