APIアクセススコープを作成する

スコープは、APIエンドポイントに対して実行できる高レベルの操作を表します。アプリケーションは認可サーバーからこれらのスコープを要求します。サーバーアクセスポリシーは、権限を付与するスコープと拒否するスコープを決定します。

すべての認可サーバーは複数の予約済みスコープを保有しています。必要に応じてアプリケーションごとに別のスコープを追加できます。

1. 管理コンソールで、［Security（セキュリティ）］［API］に移動します。

2. 認可サーバーの名前をクリックし、［Scopes（スコープ）］を選択します。
3. ［Add Scope（スコープを追加）］をクリックします。
4. 名前と説明を入力します。
［User Consent（ユーザーの同意）］オプションを選択します。
• ［Implicit（暗黙）］：デフォルト設定。ユーザーは、情報へのアクセス権をアプリに付与するように求められません。このスコープについてユーザーの同意が暗に示されます。
• ［Optional（任意）：ユーザーはサインインウィジェットに同意の画面が表示される場合、このスコープの承認をスキップできます。
• ［Required（必須）］：このスコープについてユーザーの同意が必要であり、ユーザーは同意のオプションを変更しない可能性があります。
任意。［User Consent（ユーザーの同意）］に［Optional（任意）］または［Required（必須）］オプションを選択する場合、［Block services from requesting this scope（サービスがこのスコープを要求するのをブロックする）］チェックボックスをオフにします。

5. 許可リクエストでスコープを指定していないアプリにOktaが許可リクエストを付与できるようにするには、［Set as a default scope（デフォルトスコープとして設定）］を選択します。

   クライアントが認可リクエストでスコープパラメーターを省略した場合、Oktaはアクセスポリシールールで許可されているすべてのデフォルトスコープをアクセストークンで返します。

6. 公開メタデータにこのスコープを含めるには、［Include in public metadata（公開メタデータに含める）］を選択します。

7. ［Save（保存）］をクリックします。

これらのスコープは、［Claims（クレーム）］によって参照されます。