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

# パーソナルアクセストークン

> プログラムからAPIにアクセスするために、ご自身として認証します

<div id="overview">
  ## 概要
</div>

パーソナルアクセストークン (PAT) を利用すると、人間のユーザーは自分自身のIDでプログラムから認証できます。サービスユーザー APIキー (人間ではないサービスユーザーとして認証するもの) とは異なり、PAT は **あなた** — つまり、そのトークンを作成した人間のユーザー — として認証されます。

| Token type                | Authenticates as         | Identity    | Permissions         |
| ------------------------- | ------------------------ | ----------- | ------------------- |
| **Service User API Key**  | Service User (non-human) | サービスユーザーのID | サービスユーザーに割り当てられたロール |
| **Personal Access Token** | User (human)             | あなたのユーザーID  | あなたの権限とorgへの所属      |

すべてのAPI認証情報は、`cog_` プレフィックス形式を利用します。どちらのトークンタイプも、`Authorization` ヘッダーでは同じ方法で利用します。

```bash theme={null}
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $YOUR_PAT"
```

<div id="when-to-use-pats">
  ## PATs を利用する場面
</div>

PATs は、**自分自身として**プログラムから API にアクセスする必要がある場合に適しています。

* **個人用スクリプトやツール** — 共有のサービスユーザーを使わずに、自分のワークフローを自動化する場合
* **ローカル開発** — 自分のアカウントを使って API 統合をテストする場合
* **短期間の自動化** — 自分に紐づく単発のスクリプト

本番環境の統合、CI/CD パイプライン、共有の自動化には、代わりに [サービスユーザー APIキー](/ja/api-reference/authentication#service-users-recommended-for-automation) を利用してください。サービスユーザーを使うと、監査証跡の向上、一元的なキー管理、RBAC の制御が可能になります。

<div id="creating-and-managing-pats">
  ## PATの作成と管理
</div>

**Devin API** 設定ページの **PATs** タブでPATを管理します。

1. **PATを作成** — 名前と有効期限を設定します。トークンは `cog_` で始まり、作成時に一度だけ表示されます。
2. **トークンを使用** — サービスユーザーAPIキーとまったく同じように、`Authorization` ヘッダーで使用します。すべてのAPIコールはユーザーアカウントとして認証され、権限、orgへの所属、監査証跡が適用されます。
3. **PATをローテーション** — 名前を変更せずに、既存のトークンの新しいシークレットを生成します。古いシークレットは直ちに使用できなくなります。
4. **PATを失効する** — いつでもトークンを無効化できます。

PATはACPライブWebSocketなどのリアルタイムエンドポイントでも利用できるため、Devin CLIやデスクトップクライアントなどのツールをPATで認証できます。

<div id="enterprise-governance">
  ## Enterprise ガバナンス
</div>

Enterprise アカウントでは、PAT の利用可否は、Enterprise 内のすべての組織に適用される Enterprise 全体の **PAT ポリシー** によって管理されます。Enterprise 管理者は、Enterprise の **Devin API** 設定ページの **PAT ポリシー** タブからポリシーを設定します。

<div id="policy-modes">
  ### ポリシーモード
</div>

| モード            | 動作                                                    |
| -------------- | ----------------------------------------------------- |
| **無効** (デフォルト) | メンバーはPATを作成または利用できません                                 |
| **承認が必要**      | メンバーはPATリクエストを送信し、トークンを作成するにはEnterprise 管理者による承認が必要です |
| **セルフサービス**    | メンバーは有効期限ポリシーに従って、PATを直接作成できます                        |

<div id="expiration-policy">
  ### 有効期限ポリシー
</div>

Enterprise で PAT が有効になっている場合、すべての PAT **に有効期限を設定する必要があります**。有効期限はポリシーで定められた最大有効期間 (デフォルトでは **365 日**。管理者はこれより短い上限を設定できます) を超えることはできません。非 Enterprise (Teams) アカウントでは、有効期限のない PAT を作成できます。

<div id="approval-workflow">
  ### 承認ワークフロー
</div>

**承認が必要** の場合:

1. メンバーがPATsタブからPATをリクエストします (名前と有効期限) 。
2. Enterprise管理者は **Approval queue** でリクエストを確認し、承認または拒否します。
3. 承認後、メンバーはリクエストを完了してトークンを発行します (トークンは一度だけ表示されます) 。
4. 保留中のリクエストは、対応されない場合、**7日後** に自動的に失効します。

リクエスト者と管理者には、トークンのライフサイクルの各段階 (リクエスト、承認、拒否、取り消し) でメール通知が送信されます。

<div id="token-inventory-and-revocation">
  ### トークンの一覧と失効
</div>

Enterprise 管理者は次の操作を行えます。

* トークン一覧でEnterprise全体のすべてのPATを**閲覧する**。現在のポリシーへの準拠状況も確認できます
* トークンを**一括失効**する (例：ポリシーを厳格化した後)

ポリシーを厳格化する (またはPATを無効にする) と、影響を受ける保留中のリクエストはキャンセルされ、一覧では準拠しなくなった既存のトークンにフラグが付けられます。

<div id="automatic-revocation">
  ### 自動失効
</div>

ユーザーがアカウントのメンバーでなくなると、そのユーザーの PAT は自動的に失効します。これには、SCIM によるプロビジョニング解除や IdP グループの変更による削除も含まれます。

<div id="security-considerations">
  ## セキュリティに関する注意事項
</div>

* PATはパスワードと同様に厳重に管理してください。アカウントへの完全なアクセス権を与えます
* PATは環境変数またはシークレットマネージャーに保存し、ソースコードには決して保存しないでください
* ユースケースに必要な最短の有効期限を設定してください
* PATが侵害された場合は、直ちに失効させてください
* 共有または本番環境の自動化には、サービスユーザー APIキーを優先してください

<div id="next-steps">
  ## 次のステップ
</div>

* [Authentication overview](/ja/api-reference/authentication) — 認証の全体像を理解する
* [Teams quick start](/ja/api-reference/getting-started/teams-quickstart) — サービスユーザーの利用を始める