Loading...

お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

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で利用可能なスコープを一覧で説明します。