Adobe Pass 認証

概要

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

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

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

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

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

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

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

OAuth コードフローは、複数の異なるユーザーの代理でアクションを実行する必要がある外部ホストアプリケーションに適しています。 OAuth を介してベアラートークンを管理するには少し多くのオーバーヘッドがあるため、最初にデベロッパートークンで実験し、後でワークを OAuth アプリケーションにリファクタリングすることは珍しくありません。

デベロッパートークン

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

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

新しいトークンのテスト

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

$
curl -H "Authorization: Bearer <YOUR_TOKEN>" https://api.frame.io/v2/me

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

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

OAuth 2とは？

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

OAuth 2認証シンボルフロー

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

OAuth 2 の詳細

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

• OAuth 2
• 認証シンボル流量