OAuth 2.0クライアント資格情報を使用する

Paths（パス）

フローがクライアント資格情報を送信する場所。

このフィールドは完全URLである必要があります（例：https://api.box.com/oauth2/token）。

Credentials（資格情報）

サービスによって提供される公開された文字列。これは、OAuthアプリケーションの識別と認証URLの構築に使用されます。

このフィールドの値は、接続の作成時にエンドユーザーが指定します。

サービスによって提供されるプライベート文字列値。この値は、サービスに対してアプリケーションIDを認証するために使用されます。

このフィールドの値は、接続の作成時にエンドユーザーが指定します。

Scopes（スコープ）（任意）

各スコープは、サービスからの接続リクエストの詳細なアクセスレベルを定義します。接続にOAuthスコープを追加する方法は次のとおりです。

1. ［Add Scope（スコープを追加）］をクリックして、この接続用に要求する一意のスコープをサービスに追加します。

2. スコープ名を入力します（例：openid、offline_access）。

   トグルを使ってスコープが［Required（必須）］であるかどうかを指定します。スコープを［Required（必須）］としてマークするには、事前に［Allow users to customize scopes（スコープのカスタマイズをユーザーに許可）］オプションを有効化しておく必要があります。

   

   必須としてマークされたスコープは常に要求されます。通常は、コネクターが正しく機能するために必要なスコープです。また、APIのすべてのエンドポイントを呼び出すCAPIAカードでは、通常は接続によってすべてのスコープが有効化されている必要があります。

   追加する各スコープは、［新規接続］プレビューの［権限］タブに表示されます。

3. ユーザーがスコープリストを変更できるようにするには、［Allow users to customize scopes（スコープのカスタマイズをユーザーに許可）］オプションを選択します。

   この機能は、異なるスコープを使ってサービスを呼び出す複数の接続をユーザーが作成できるようにする場合に有用です。たとえば、これらのユーザーは最小権限の原則に合わせてスコープを削除できます。

   たとえば、メールサービスへの1つの接続には、管理を合理化するためにread-emailスコープが含まれる場合があります。同一サービスへのより高度な別の接続には、delete-emailスコープやsend-emailスコープも含まれるかもしれません。

   このオプションは、サービスから要求されるスコープを定義するための2つの選択肢を提供するセレクターを［権限］タブに追加します。

   • ［Use default scopes（デフォルトスコープを使用）］：定義済みのすべてのスコープを要求します。

     

   • ［Customize scopes（スコープをカスタマイズ）］：ユーザーは、元のリストから必須以外のスコープを削除できます。必須スコープは消去できません。

     

4. ユーザーがコネクターを通じて追加のスコープリクエストを追加できるようにするには、［Allow users to request additional scopes（追加スコープの要求をユーザーに許可）］オプションを選択します。

   スコープは［Manually add scopes（スコープを手動で追加）］フィールドに入力できます。この入力フィールドの文字数制限は500です。スコープは個別に追加することも、スペースまたはカンマ区切りのスコープリストとして追加することもできます。区切り文字は、［Scopes Delimiter（スコープ区切り文字）］フィールドの選択と一致します。

   このオプションを選択しない場合、ユーザーはOkta Ideasサイトを通じてコネクターへの新規スコープの追加を求めることができます。このリンクは、［権限］タブの下部にあります。

   このオプションは、［Allow users to customize scopes（スコープのカスタマイズをユーザーに許可）］オプションを有効にした場合にのみ利用できます。

ユーザーが個々のスコープを区切って入力するための区切り文字を指定します。

オプションはスペースとカンマです。

パラメーターを使用することで、インスタンスやサブドメインなど、認証に必要な追加情報をコネクターユーザーから収集できます。これらのフィールドは、ユーザーが接続を最初に作成する際に表示され、必須です。

Label（ラベル）：コネクターのセットアップ時に［New Connection（新規接続）］ダイアログに表示されるパラメーターの名前。

Key（キー）：サービスで使用されるキー/値ペアのテキスト値。たとえば、api_key、application_key、authentication。

Type（タイプ）：3つのフィールドタイプから選択できます。

• テキスト：ユーザーにプレーンテキストフィールドを表示します。これは、加工なしのオープンテキストフィールドです。

• パスワード：加工されたテキストフィールドを表示します。このフィールドに入力したテキストはユーザーには表示されません。

• ドロップダウンリスト：ユーザーが選択する値の、手動で作成されたドロップダウンリストを表示します。

クライアント資格情報付与タイプでは、デフォルトでClient ID（クライアントID）パラメーターとClient Secret（クライアントシークレット）パラメーターが表示されます。テキストを追加してこれらのラベル用に一意の名前を作成することはできますが、これらのパラメーターは削除できません。