OAuth 2.0認証
概要
OAuth 2.0は、認証と認可のための業界標準プロトコルです。このフレームワークにより、多数のサードパーティクライアントアプリケーションがAPIを通じてZohoの保護されたリソースへの安全な委任アクセスを取得できます。
OAuth 2.0の一般的な特徴:
- クライアントはパスワード認証をサポートしたり、ユーザー資格情報を保存したりする必要がありません。各呼び出しでユーザー資格情報を提供することなく、API呼び出しでリソースにアクセスできます。
- クライアントは、ユーザーが認証したリソースにのみアクセスできます。
- ユーザーはいつでもクライアントの委任アクセスを取り消すことができます。
- OAuth 2.0のaccess tokenは設定された時間後に期限切れとなるため、強力なセキュリティを提供します。
用語
OAuth 2.0の実装手順を学ぶ前に、Catalystにおける以下のOAuth 2.0関連用語を理解する必要があります:
| キーワード | 説明 |
|---|---|
| 保護されたリソース | Cache、Cron、テーブル、フォルダーなどのCatalystリソース |
| リソースサーバー | Catalystの保護されたリソースをホストするCatalystサーバー |
| クライアント | エンドユーザーに代わって保護されたリソースにアクセスするために、リソースサーバーにリクエストを送信するアプリケーション |
| client_id | 登録されたクライアントに対して生成される一意のキー |
| client_secret | 特定の登録済みクライアントのclient_idに対して生成されるシークレット値。Zoho APIコンソールでCatalystアプリケーションを登録すると、client_idとclient_secretが生成されます。 |
| 認証サーバー | access_tokenやrefresh_tokenなどの必要な資格情報をクライアントに提供するCatalyst認可サーバー |
| Grant Tokenまたは code | Catalyst認可サーバーが一時トークンを生成し、ブラウザーを介してクライアントに送信します。クライアントはaccess tokenとrefresh tokenを取得するために、このcodeを認可サーバーに返送します。 |
| access_token | ユーザーの保護されたリソースにアクセスするためにリソースサーバーに送信される一時トークン。クライアントはAPIを使用して関連するアプリケーションにリクエストを行うためにaccess_tokenを使用します。各access_tokenは設定された期間有効であり、スコープで定義された操作のみを実行できます。 |
| refresh_token | 新しいaccess tokenを取得するために使用できるトークン。このトークンはエンドユーザーによって取り消されるまで無期限に有効です。 |
| スコープ | スコープは、クライアントアプリケーションがアクセスできるリソースの種類を制御します。セキュリティ強化のため、各トークンは通常、選択されたスコープで作成されます。たとえば、Data Storeのデータを読み取るだけのスコープでaccess_tokenを生成できます。スコープを定義する標準形式はscope=service_name.scope_name.operation_typeです。次のセクションでは、Catalystで利用可能なスコープを一覧で説明します。 |
Yes
No
Send your feedback to us
Skip
Submit