---
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クイックスタート](/ja/quickstart)でさらに3回のリクエストを行うと、最初の通話を実行できます。

## ローテーションと失効

新しいキーを作成し、サービスを移行してから、同じタブで古いキーを削除します。リストには各キーのプレフィックスと名前が表示されるため、区別できます。ローテーションをスクリプト化するには、ログイン済みセッショントークンを使用して[開発者 API キーエンドポイント](/api-reference/developer-api-keys)を呼び出します。`sk_live_` キーではキーの作成、一覧表示、取り消しはできないため、漏洩したキーが自身の代替キーを作成することはありません。これは、メンバー、招待、支払い設定、その他の[アカウント管理](/api-reference/introduction#what-api-keys-cant-do)にも同様に適用されます。

<Note>
  サーバーAPIキーはマシン認証情報であり、組織の
  [**パスキーを必須にする**](/ja/guides/sso)
  ポリシーの対象外です。この設定は人間によるログインを確認するものであり、`sk_live_...` キーは確認しません。
  そのため、キーをここで速やかにローテーションおよび失効させることが、継続的なAPIアクセスを管理する主な方法です。パスキーが必須の場合、セキュリティポリシーパネルには現在対象外となっている有効なキーの数が表示されます。
</Note>

<Tip>
  アプリ内コパイロットに「APIキーを作成」と依頼すると、このフローを案内し、各コントロールをリアルタイムで強調表示します。
</Tip>

---

## 次のステップ

<CardGroup cols={2}>
  <Card title="APIクイックスタート" icon="terminal" href="/ja/quickstart">
    エージェント、番号、Webhook、最初の通話を4回のREST呼び出しで設定します。
  </Card>
  <Card title="認証リファレンス" icon="lock" href="/api-reference/introduction">
    Bearer 認証と組織への紐付けの仕組み。
  </Card>
</CardGroup>