> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 키

> API 키를 생성 및 관리하여 프로그램 방식으로 프로젝트에 연결합니다.

**API 키** 탭에서는 API 키를 생성하고 레이블을 지정하여 플랫폼 기능에 프로그램 방식으로 연결할 수 있습니다. 이 키를 사용하여 다른 서비스와의 연결을 설정하고 유지합니다. API 키를 정기적으로 검토하고 더 이상 필요하지 않은 키를 삭제하여 무단 접근으로부터 프로젝트를 보호하는 것을 권장합니다.

<Note>
  API 키는 프로젝트 전용이며 프로젝트 리소스에 대한 접근을 제공합니다. 안전하게 보관하고 정기적으로 교체하십시오.
</Note>

## API 키 목록

API 키 목록에는 이 프로젝트에 생성된 모든 키가 표시됩니다. **이름 또는 키로 검색** 필드를 사용하여 특정 키를 검색합니다. 각 항목에는 다음과 같은 열이 표시됩니다:

| 열         | 설명                                                              |
| --------- | --------------------------------------------------------------- |
| **이름**    | API 키에 할당된 이름으로, 타입(**권한** 또는 **시스템**)을 나타내는 배지가 표시됩니다.         |
| **API 키** | 키 값의 축약된 미리보기입니다. 복사 아이콘을 사용하여 전체 키를 클립보드에 복사합니다.               |
| **생성일**   | 키가 생성된 날짜와 시간입니다.                                               |
| **작업**    | 사용자가 생성한 키에는 **삭제** 링크가 있습니다. 시스템 키는 **보호됨**으로 표시되며 삭제할 수 없습니다. |

## 키 타입

새 API 키를 생성할 때 다음 키 타입 중 하나를 선택해야 합니다:

| 타입           | 설명                                                                                                                         |
| ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **권한 키**     | 프로젝트에 대한 완전한 접근 권한입니다. 채팅 전송, 프로젝트 리소스/에이전트/워크플로우/설정의 편집 및 삭제가 가능합니다. 신뢰할 수 있는 통합 및 서버 간 자동화에 사용합니다.                       |
| **제한된 뷰어 키** | 프로젝트에 대한 읽기 전용 접근과 채팅 런타임(봇 상호작용)이 가능합니다. 프로젝트 리소스/에이전트/워크플로우/설정의 편집 및 삭제는 불가능합니다. Teams나 채널 봇 인증과 같이 제한된 범위의 배포를 위한 것입니다. |

## 새 API 키 생성

<Steps>
  <Step title="API 키 생성 양식 열기">
    **설정 → API 키** 탭에서 **API 키 생성** 버튼을 선택합니다.
  </Step>

  <Step title="키 타입 선택">
    필요한 접근 수준에 따라 **권한 키** 또는 **제한된 뷰어 키**를 선택합니다.
  </Step>

  <Step title="키 이름 지정">
    **키 이름** 필드에 키의 목적을 명확하게 나타내는 설명적인 이름을 입력합니다.
  </Step>

  <Step title="키 생성">
    **생성** 버튼을 선택합니다. 키가 생성되며 API 키 목록에 표시됩니다.
  </Step>
</Steps>

<Warning>
  키를 생성한 직후 바로 복사하여 안전하게 보관하십시오. 전체 키 값이 다시 표시되지 않을 수 있습니다.
</Warning>

## API 키 삭제

**Automator 키**는 모든 프로젝트에 자동으로 생성되는 시스템 키로 삭제할 수 없습니다. 그 외 생성한 모든 API 키는 필요에 따라 삭제할 수 있습니다.

1. **설정 → API 키** 탭에서 삭제할 키의 **삭제** 링크를 선택합니다.
2. 팝업에서 삭제를 확인합니다.

삭제 확인 메시지가 표시되며 키는 목록에서 사라집니다.

## 모범 사례

1. **적절한 키 타입 사용**: 권한 키는 신뢰할 수 있는 서버 측 통합에만 사용합니다. 공개용 또는 채널 봇 배포에는 제한된 뷰어 키를 사용합니다.
2. **명확한 명명**: 키의 목적과 해당 통합을 명확하게 나타내는 설명적인 이름을 사용합니다.
3. **정기적 교체**: 무단 접근 위험을 줄이기 위해 정기적으로 키를 삭제하고 다시 생성합니다.