> This page is for プラットフォーム, version レガシー.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 Experimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - レガシー: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Adobe Pass 認証

## 概要




Frame.io API で API 呼び出しを行うには Adobe Pass 認証が必要です。 Frame.io API では、Adobe Pass 認証に 2 つの選択肢があります：



* **デベロッパートークン**：それを生成した個人ユーザーと同じアクセスと権限を持つ永続的なベアラートークン。
* **OAuth 2 認証コードフロー**。これにより、Frame.io ユーザーは資格情報でログインし、外部アプリケーションに代理でアクションを実行する権限を付与できます。




どちらのタイプの Adobe Pass 認証を使用した場合でも、API を使用したすべてのアクションは最終的にベアラートークンヘッダーを使用し、範囲によってコントロールされます。





### プロジェクトに最適な Adobe Pass 認証タイプは？

はじめに、プロジェクトには[デベロッパートークン](/authentication/developer-tokens)を使用することをお勧めします。 **デベロッパートークン**は個人ユーザーのアカウントに関連付けられ、それを作成したユーザーと同じアクセス権限を持ち、範囲によって制限されます。

これらは以下に適しています：



* 実験（非常に迅速に作成および削除できるため）
* すべてのアクションを単一のアカウント/ユーザーコンテキストで実行できる統合シナリオ。

**OAuth コードフロー**は、複数の異なるユーザーの代理でアクションを実行する必要がある外部ホストアプリケーションに適しています。 OAuth を介してベアラートークンを管理するには少し多くのオーバーヘッドがあるため、最初にデベロッパートークンで実験し、後でワークを OAuth アプリケーションにリファクタリングすることは珍しくありません。
<Info>
  続行するには、Frame.io アカウントが必要です。 Frame.io アカウントをお持ちでない場合は、[Frame.io](https://frame.io) にアクセスして[**Sign Up Free**](https://accounts.frame.io/welcome)をクリックすることで、迅速かつ簡単に新規登録することができます。
</Info>


## デベロッパートークン



1. Frame.io ユーザー資格情報を使用して Frame.io [デベロッパーポータル](/)にログインします。
2. スタートアップスクリーンが表示されます。 新しいデベロッパートークンを作成するには、**Create a Token**ボタンをクリックします。
3. トークン screens が表示されます。 **New**をクリックします。
4. 新しいトークン画面では、トークンの説明と範囲を指定する必要があります。 **DESCRIPTION**では、トークンの用途を覚えやすいものを選択することをお勧めします。 **SCOPES**では、このトークンが持つべき正確なアクセス範囲を選択できます。 このチュートリアルでは、**Select all scopes**をクリックするだけです。 必要に応じて、より具体的な権限と特権を持つトークンを後で作成できます（詳細については[Scopes](/getting-started/key-concepts#scopes)を参照してください）。
5. 下にスクロールして**Create**ボタンをクリックします。 成功すると、トークンに関する情報の概要が表示されたページが表示されます。
6. **Token**フィールドに表示された文字列をコピーします。 **これが新しいトークンです**。 安全な場所に保存してください。これはアカウントへのアクセスを表しており、このページから移動すると、再度表示することはできません。




この時点で、選択した範囲でトークンを作成したことを確認するメールが届きます。




<Warning>
  Frame.ioトークンは、初回作成時にのみ表示されます。 トークンを紛失した場合は、いつでも新しいトークンを作成できますが、説明と範囲以外の古いトークンを表示することはできません。
</Warning>


### 新しいトークンのテスト




トークンを取得したので、ベアラー認証を使用してリクエストを試してみましょう。 自分自身に関する情報を取得する基本的なリクエストを実行します：




<CodeBlocks>
  


**`cURL`**

```bash title="cURL"
curl -H "Authorization: Bearer <YOUR_TOKEN>" https://api.frame.io/v2/me
```





**`Python`**

```python title="Python"
import requests

url = "https://api.frame.io/v2/me"
headers = {
 "Authorization": "Bearer <YOUR_TOKEN>"
}

requests.GET(url,headers=headers)
```



</CodeBlocks>


応答として、ユーザーレコードのJSON表示域が表示されます。





おめでとうございます！ Frame.io APIへの最初の呼び出しが完了しました。 🎉





## OAuth 2とは？




OAuth2.0は、資格情報を直接共有することなく、ユーザーが1つのアプリケーションが別のアプリケーションと限定的に相互作用することを許可する一般的な認証プロトコルです。 このプロセスは通常、特別なログイン画面を介してユーザーが「資格情報を付与する」と呼ばれます。





### OAuth 2認証シンボルフロー

OAuth 2認証シンボルフローにより、ユーザーは外部アプリケーションに限定的なアクセスを付与できます。 アプリケーションは初期設定に基づいて特定の権限をリクエストします。Frame.ioの場合、アプリケーションが[デベロッパーポータルに登録](https://developer.frame.io/app/oauth_apps)されたときです。 ユーザーがリクエストを承認すると、外部アプリケーションはそのユーザーに代わって操作できるようになります。 OAuth 2 認証コードフローの開始方法については、こちらをご覧ください：[OAuth 2 認証コードフローのセットアップ](/platform/v2/oauth-2-code-authorization-flow)

### OAuth 2 の詳細




OAuth 2 について詳しく知りたい場合は、以下の優れたリソースをご利用ください：



* [OAuth 2](https://oauth.net/2/)
* [認証シンボル流量](https://developer.okta.com/blog/2018/04/10/oauth-authorization-code-grant-type)