--- title: "概要と用語" url: https://docs.catalyst.zoho.com/ja/api/oauth2/overview-and-terminology/ description: "保護されたCatalystリソースへの安全なアクセスを得るために、ユーザーが行うAPIリクエストを認証・認可するCatalystが準拠するOAuth 2.0業界標準プロトコルについて" last_updated: 2026-08-06T05:54:02Z service: All Services type: api --- # 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で利用可能なスコープを一覧で説明します。