前提条件
匿名セッションを使用するには、以下が必要です。- Auth0 アカウントを作成します。
- Auth0 アプリケーションを登録します。Auth0 アプリケーションがない場合は、Auth0 React または Next.js 向けのQuickstartsから始めることができます。
- API (リソースサーバー) を登録します。
匿名セッションを設定する
- Auth0 Dashboard
- Management API
-
Dashboard > Tenant Settings > Advancedに移動し、下へスクロールしてセッション設定を表示します。
- Anonymous Session Lifetimeに分単位で値を入力します。
-
匿名セッションのリクエストで
auth0_anonクッキーを返すかどうかは、Anonymous Session Cookieスイッチの有効/無効で制御します。
アプリケーションで匿名セッションを有効にする
- Auth0 Dashboard
- Management API
- Dashboard > Applications > Applicationsに移動し、構成したいアプリケーションを選択します。
-
下にスクロールして、Anonymous Sessionsの設定を表示します。
- Allow Anonymous Sessionsのスイッチを有効にします。
APIで匿名アクセスを有効にする
- Auth0 Dashboard
- Management API
- Dashboard > Applications > APIsに移動し、設定するAPIを選択します。
-
Access token expirationセクションで、Anonymous Access Token Lifetimeを秒単位で設定します。最小値は1日 (86400秒) 、最大値は30日 (2592000秒) です。
-
Application Access PolicyでAnonymous AccessポリシーをPer-app authorizationに設定すると、このオーディエンスをアクセストークンのオーディエンスとする匿名セッションが利用できるようになります。
匿名ユーザー向けのAPI Accessポリシーを作成する
- Auth0 Dashboard
- Management API
- Dashboard > Applications > APIsに移動し、構成するAPIを選択します。
- [Application Access] タブを選択します。
-
匿名コンテキストでこのAPIにアクセストークンを発行させたいアプリケーションごとに、[Edit] を選択します。
-
[Anonymous Access] を選択し、このアプリケーションの使用時に匿名ユーザーへ付与する権限を [Configure] で構成します。
- [Save] を選択します。
匿名セッションを作成する
テナント、アプリケーション、API で匿名セッションを設定したら、/anonymous/token エンドポイントに POST リクエストを送信することで、匿名セッションを作成できます。
session_tokenとaccess_tokenが含まれます。
カスタムクレームを構成する
カスタムクレームを構成すると、匿名セッションのmetadataを、特定のオーディエンス向けに発行されるアクセストークンに直接mapできます。 これが役立つのは、匿名セッションではpost-loginアクションが実行されず、認証済みのアクセストークンの場合のようにapi.accessToken.setCustomClaim()で匿名アクセストークンを拡張できないためです。詳細については、匿名セッションのカスタムクレームを構成するをお読みください。
次のステップ
匿名セッションのユースケース
匿名セッションのユースケースについて詳しく説明します。