---
title: "서버 API 키 만들기"
description: "대시보드에서 ThunderPhone API에 대한 서버 간 호출용 sk_live_ 시크릿 키를 발급하고, 안전하게 보관하며, 필요할 때 교체하거나 폐기합니다."
---

서버 API 키(`sk_live_...`)는 ThunderPhone API에 대한 서버 간 호출을 인증합니다. 키는 **조직 → 키**에서 관리합니다.

<Warning>
  서버 키는 비밀 정보입니다. 클라이언트 측 코드에 절대 포함하지 마세요. 브라우저에서는 대신 도메인이 제한된
  [공개 키](/api-reference/publishable-keys) (`pk_live_...`)를 사용하세요.
</Warning>

<Steps>
  <Step title="키 탭 열기">
    **조직 → 키**로 이동한 다음 **키 만들기**를 클릭하세요.
  </Step>
  <Step title="이름 지정하기">
    "프로덕션 백엔드"처럼 키를 사용할 위치를 나타내는 이름을 지정하세요. 이름은 라벨일 뿐이며 액세스에는 영향을 주지 않습니다.
  </Step>
  <Step title="키 만들기">
    대화 상자에서 **키 만들기**를 클릭하세요. 그러면 비밀 키가 생성됩니다.
  </Step>
  <Step title="지금 복사하기">
    전체 비밀 키는 **한 번만** 표시됩니다. 비밀 키 관리자에 복사하세요. 화면을 벗어나면 접두사만 표시됩니다.
  </Step>
</Steps>

## 사용하기

키는 이 조직에 연결되어 있으므로 요청에 조직 ID가 필요하지 않습니다. Bearer 헤더만 추가하세요.

```bash
curl https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

이제 [API 빠른 시작](/ko/quickstart)을 따라 요청 세 번만 더 보내면 첫 통화를 만들 수 있습니다.

## 교체 및 폐기

새 키를 만들고 서비스를 이전한 다음 동일한 탭에서 기존 키를 삭제합니다. 목록에는 각 키의 접두사와 이름이 표시되므로 키를 구분할 수 있습니다. 키 순환을 스크립트로 자동화하려면 로그인된 세션 토큰으로 [개발자 API 키 엔드포인트](/api-reference/developer-api-keys)를 호출합니다. `sk_live_` 키로는 키를 생성, 나열 또는 해지할 수 없으므로 유출된 키가 자체 대체 키를 만들 수 없습니다. 이는 멤버, 초대, 결제 설정 및 기타 [계정 통제 항목](/api-reference/introduction#what-api-keys-cant-do)에도 동일하게 적용됩니다.

<Note>
  서버 API 키는 머신 자격 증명이므로 조직의 [**패스키 필수**](/ko/guides/sso) 정책이 적용되지 않습니다. 이 설정은 `sk_live_...` 키가 아니라 사용자의 로그인을 확인합니다. 따라서 여기에서 키를 신속하게 교체하고 폐기하는 것이 지속적인 API 액세스를 제어하는 주요 통제 항목입니다. 패스키가 필수인 경우 보안 정책 패널에 현재 적용 제외된 활성 키 수가 표시됩니다.
</Note>

<Tip>
  앱 내 코파일럿에게 "API 키 만들기"를 요청하면 각 통제 항목을 실시간으로 강조 표시하며 이 과정을 안내합니다.
</Tip>

---

## 다음 단계

<CardGroup cols={2}>
  <Card title="API 빠른 시작" icon="terminal" href="/ko/quickstart">
    에이전트, 번호, 웹훅, 첫 통화 — REST 호출 네 번입니다.
  </Card>
  <Card title="인증 참조" icon="lock" href="/api-reference/introduction">
    Bearer 인증과 조직 연결의 작동 방식입니다.
  </Card>
</CardGroup>