APIアクセスクレームを作成する

トークンには、件名または別の件名に関する記述であるクレームが含まれています(名前、ロール、メールアドレスなど)。

IDトークンクレームは動的です。デフォルトでは、認可サーバーは、アクセストークンまたは認証コードで要求された場合、IDトークンクレームをIDトークンに含めません。このデフォルトを維持するには、トークンタイプに含める(Include in token type)(Userinfo/id_token request)ユーザー情報/IDトークンの要求(Userinfo/id_token request)(Include in token type)を選択します。

IDトークンに常にクレームを含めるように認可サーバーを強制するには、トークンタイプに含める(Include in token type)(Always)常に(Always)(Include in token type)を選択します。

  1. 表示する認可サーバーの名前を選択し、クレーム(Claims)を選択します。Oktaはデフォルトの件名クレームを提供します。マッピングを編集するか、独自のクレームを作成できます。
  2. クレームを追加(Add Claim)を選択し、必要な情報を入力します。

    • 名前(Name)

    • トークンタイプに含める(Include in token type)(Include in token type:)アクセストークン(Access Token)(OAuth 2.0)またはIDトークン(ID Token)(OpenID Connect)を選択します。IDトークンに関しては、2番目のドロップダウンボックスで、常に(Always)またはユーザー情報/IDトークンの要求(Userinfo/id_token request)を選択します。

    • 値タイプ(Value type):クレームで定義された値がグループ(Group)フィルターを使用するか、Okta Expression Languageで記述された式(Expression)を使用するかを選択します。

      • マッピング(Mapping)式(Expression)を選択した際に表示されます。ここでOkta Expression Languageを使用してマッピングを追加します(例:appuser.username)。式が予期した結果を返すことを必ず確認してください。式はここでは検証されません。

      • フィルター(Filter)グループ(Groups)を選択した際に表示されます。グループフィルターを追加するために使用します。空欄のままにすると、このクレームはすべてのユーザーを対象に含めます。

    • クレームを無効化(Disable claim):テストまたはデバッグのためにクレームを一時的に無効にするには、このオプションをオンにします。

    • 含める(Include in):クレームが任意のスコープに対して有効かどうかを指定するか、クレームが有効なスコープを選択します。

クレーム(Claims)リストでは、次のことができます。

  • クレームをタイプで並べ替えます。
  • 作成したクレームを削除するか、テストまたはデバッグの目的でクレームを無効にします。