API 키 탭에서는 API 키를 생성하고 레이블을 지정하여 플랫폼 기능에 프로그램 방식으로 연결할 수 있습니다. 이 키를 사용하여 다른 서비스와의 연결을 설정하고 유지합니다. API 키를 정기적으로 검토하고 더 이상 필요하지 않은 키를 삭제하여 무단 접근으로부터 프로젝트를 보호하는 것을 권장합니다.
API 키는 프로젝트 전용이며 프로젝트 리소스에 대한 접근을 제공합니다. 안전하게 보관하고 정기적으로 교체하십시오.
API 키 목록
API 키 목록에는 이 프로젝트에 생성된 모든 키가 표시됩니다. 이름 또는 키로 검색 필드를 사용하여 특정 키를 검색합니다. 각 항목에는 다음과 같은 열이 표시됩니다:
| 열 | 설명 |
|---|
| 이름 | API 키에 할당된 이름으로, 타입(권한 또는 시스템)을 나타내는 배지가 표시됩니다. |
| API 키 | 키 값의 축약된 미리보기입니다. 복사 아이콘을 사용하여 전체 키를 클립보드에 복사합니다. |
| 생성일 | 키가 생성된 날짜와 시간입니다. |
| 작업 | 사용자가 생성한 키에는 삭제 링크가 있습니다. 시스템 키는 보호됨으로 표시되며 삭제할 수 없습니다. |
키 타입
새 API 키를 생성할 때 다음 키 타입 중 하나를 선택해야 합니다:
| 타입 | 설명 |
|---|
| 권한 키 | 프로젝트에 대한 완전한 접근 권한입니다. 채팅 전송, 프로젝트 리소스/에이전트/워크플로우/설정의 편집 및 삭제가 가능합니다. 신뢰할 수 있는 통합 및 서버 간 자동화에 사용합니다. |
| 제한된 뷰어 키 | 프로젝트에 대한 읽기 전용 접근과 채팅 런타임(봇 상호작용)이 가능합니다. 프로젝트 리소스/에이전트/워크플로우/설정의 편집 및 삭제는 불가능합니다. Teams나 채널 봇 인증과 같이 제한된 범위의 배포를 위한 것입니다. |
새 API 키 생성
API 키 생성 양식 열기
설정 → API 키 탭에서 API 키 생성 버튼을 선택합니다.
키 타입 선택
필요한 접근 수준에 따라 권한 키 또는 제한된 뷰어 키를 선택합니다.
키 이름 지정
키 이름 필드에 키의 목적을 명확하게 나타내는 설명적인 이름을 입력합니다.
키 생성
생성 버튼을 선택합니다. 키가 생성되며 API 키 목록에 표시됩니다.
키를 생성한 직후 바로 복사하여 안전하게 보관하십시오. 전체 키 값이 다시 표시되지 않을 수 있습니다.
API 키 삭제
Automator 키는 모든 프로젝트에 자동으로 생성되는 시스템 키로 삭제할 수 없습니다. 그 외 생성한 모든 API 키는 필요에 따라 삭제할 수 있습니다.
- 설정 → API 키 탭에서 삭제할 키의 삭제 링크를 선택합니다.
- 팝업에서 삭제를 확인합니다.
삭제 확인 메시지가 표시되며 키는 목록에서 사라집니다.
모범 사례
- 적절한 키 타입 사용: 권한 키는 신뢰할 수 있는 서버 측 통합에만 사용합니다. 공개용 또는 채널 봇 배포에는 제한된 뷰어 키를 사용합니다.
- 명확한 명명: 키의 목적과 해당 통합을 명확하게 나타내는 설명적인 이름을 사용합니다.
- 정기적 교체: 무단 접근 위험을 줄이기 위해 정기적으로 키를 삭제하고 다시 생성합니다.
