> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Actions の Login フローと、ユーザーのログイン後およびリフレッシュトークンの要求時に実行される post-login Action トリガーについて説明します。

# Login トリガー

Login トリガーは、ユーザーが Auth0 テナント内のアプリケーションに対する認証に成功したときに実行されます。これには、サインアップ後の認証も含まれます。

<Frame>
  <img src="https://mintcdn.com/translations/Dcx0M11uuptU53TX/docs/images/cdy7uua7fh8z/2SkfIOm4fFOJ8N0GNJwam8/77230cdb4411b2383751b037fb56fe29/2024-09-30_10-01-42.png?fit=max&auto=format&n=Dcx0M11uuptU53TX&q=85&s=a87746af202921d48a23dfd31d096779" alt="Actions の Login フローを示す図。" width="1592" height="486" data-path="docs/images/cdy7uua7fh8z/2SkfIOm4fFOJ8N0GNJwam8/77230cdb4411b2383751b037fb56fe29/2024-09-30_10-01-42.png" />
</Frame>

このトリガー内の Actions はブロッキング (同期) です。つまり、トリガーの処理の一部として実行され、Action が完了するまで Auth0 パイプラインの後続の処理は実行されません。

<div id="triggers">
  ## トリガー
</div>

<div id="login-post-login">
  ### Login / Post Login
</div>

`post-login` トリガーは、ユーザーのログイン後、および <Tooltip tip="リフレッシュトークン: ユーザーに再度ログインさせることなく、新しいアクセストークンを取得するために使用されるトークンです。" cta="用語集を見る" href="/ja/docs/glossary?term=Refresh+Token">リフレッシュトークン</Tooltip> の交換時に実行される関数です。

<div id="references">
  #### 参考資料
</div>

* [イベントオブジェクト](/ja/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/post-login-event-object): Auth0 経由でログインする1人のユーザーに関するコンテキスト情報を提供します。
* [API オブジェクト](/ja/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/post-login-api-object): フローの動作を変更するためのメソッドを提供します。

<div id="common-use-cases">
  ## よくあるユースケース
</div>

<div id="access-control">
  ### アクセス制御
</div>

アプリケーションへのアクセスを試みるユーザーのアクセスを拒否するカスタムロジックを実装するには、post-login Action を使用できます。

```javascript lines theme={null}
/**
 * @param {Event} event - ユーザーとログイン時のコンテキストに関する詳細情報。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
exports.onExecutePostLogin = async (event, api) => {
  if (event.user.email && event.user.email.endsWith("@example.com") && event.client.name === "My SPA") {
    api.access.deny(`Access to ${event.client.name} is not allowed.`);
  }
};
```

<div id="allow-access-only-on-weekdays-for-a-specific-application">
  ### 特定のアプリケーションへのアクセスを平日のみに制限する
</div>

特定のアプリケーションへのアクセスを平日のみにしたい場合は、次の Action を作成します。

```javascript lines theme={null}
/**
 * @param {Event} event - ユーザーとログイン時のコンテキストに関する詳細情報。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
 exports.onExecutePostLogin = async (event, api) => {
  if (event.client.name === "APP_NAME") {
    const d = new Date().getDay();

    if (d === 0 || d === 6) {
      api.access.deny("This app is only available during the week.");
    }
  }
}
```

<div id="deny-access-to-anyone-calling-an-api">
  ### API を呼び出すすべてのユーザーのアクセスを拒否する
</div>

API を呼び出すすべてのユーザーのアクセスを拒否したいとします。つまり、API の <Tooltip tip="オーディエンス: 発行されたトークンの対象者を一意に識別する値です。トークン内では aud という名前で表され、その値には、IDトークンの場合はアプリケーション（クライアントID）の ID、アクセストークンの場合は API（API 識別子）の ID が含まれます。" cta="用語集を表示" href="/ja/docs/glossary?term=audience">オーディエンス</Tooltip> 値に応じてアクセスを拒否する必要があります。この値は、[Dashboard > Applications > APIs](https://manage.auth0.com/#/apis) にある API の **API Audience** フィールドで確認できます。これを行うには、次の Action を作成します。

```javascript lines theme={null}
/**
 * @param {Event} event - ユーザーとログイン時のコンテキストに関する詳細情報。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
 exports.onExecutePostLogin = async (event, api) => {
  // Actions では、API はリソースサーバーと呼ばれます。
  if (event.resource_server && event.resource_server.identifier === "http://todoapi2.api") {
    api.access.deny("end_users_not_allowed");
  }
}
```

<div id="add-user-roles-to-id-and-access-tokens">
  ### ID トークンとアクセストークンにユーザーロールを追加する
</div>

Auth0 が発行するトークンにユーザーロールを追加するには、`event.authorization` オブジェクトと `api.idToken.setCustomClaim` メソッドおよび `api.accessToken.setCustomClaim` メソッドを使用します。

```javascript lines theme={null}
/**
 * @param {Event} event - ユーザーとログイン時のコンテキストに関する詳細。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
exports.onExecutePostLogin = async (event, api) => {
  const namespace = 'https://my-app.example.com';
  if (event.authorization) {
    api.idToken.setCustomClaim(`${namespace}/roles`, event.authorization.roles);
    api.accessToken.setCustomClaim(`${namespace}/roles`, event.authorization.roles);
  }
}
```

* カスタムクレームには特定の用語を含めることはできません。また、URI 形式の名前空間付きクレームを使用することを強く推奨します。詳しくは、[カスタムクレームに関するドキュメント](/ja/docs/secure/tokens/json-web-tokens/create-custom-claims)を参照してください。
* リクエスト元のアプリケーションに返される <Tooltip tip="JSON Web Token（JWT）: 2 者間でクレームを安全に表現するために使用される標準的な IDトークン 形式（および多くの場合は アクセストークン 形式）。" cta="用語集を表示" href="/ja/docs/glossary?term=JWT">JWT</Tooltip> は、トリガー処理の最後に生成され、署名されます。最終的に署名された JWT には、Action からはアクセスできません。

<div id="enrich-the-user-profile">
  ### ユーザープロフィールを拡張する
</div>

Auth0 は、[ユーザープロフィール](/ja/docs/manage-users/user-accounts/user-profiles/normalized-user-profiles) にメタデータを保存するための仕組みを提供しています。ログイン時にユーザープロフィールの `user_metadata` または `app_metadata` を設定するには、`api.user.setUserMetadata` または `api.user.setAppMetadata` 関数を使用します。

```javascript lines theme={null}
/**
 * @param {Event} event - ユーザーとログイン時のコンテキストに関する詳細情報。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
exports.onExecutePostLogin = async (event, api) => {
  api.user.setUserMetadata("favorite_color", "blue");
};
```

すべてのpost-login Actionの実行が完了すると、Actionsはユーザープロフィールを1回の操作で更新します。この操作には、"Write Users" [レート制限](/ja/docs/troubleshoot/customer-support/operational-policies/rate-limit-policy/management-api-endpoint-rate-limits) が適用されます。

<div id="enforce-custom-mfa-policy">
  ### カスタム MFA ポリシーを適用する
</div>

post-login Action を使用すると、アプリケーションの要件に応じて、ユーザーに <Tooltip tip="多要素認証（MFA）: SMS で送信される code など、username と password に加えて認証要素を使用するユーザー認証プロセス。" cta="用語集を表示" href="/ja/docs/glossary?term=MFA">MFA</Tooltip> を動的に要求できます。

```javascript lines theme={null}
/**
 * @param {Event} event - ユーザーおよびログイン時のコンテキストに関する詳細情報。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
exports.onExecutePostLogin = async (event, api) => {
  // 北米からログインするすべてのユーザーに MFA を要求する。
  if (event.request.geoip.continentCode === "NA") {
    api.multifactor.enable("any");
  };
};
```

ログイン時にMFAを有効にするには、MFAプロバイダーを設定する必要があります。詳細については、[多要素認証](/ja/docs/secure/multi-factor-authentication)を参照してください。

<div id="reduce-friction-with-passkeys">
  ### パスキーで手間を軽減する
</div>

post-login Action を使用すると、パスキーで認証したユーザーについて、MFA を動的にスキップしてログイン時の負担を軽減できます。

```javascript lines theme={null}
/**
* PostLogin フローの実行中に呼び出されるハンドラー。
*
* @param {Event} event - ユーザーおよびログインコンテキストの詳細。
* @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
*/
exports.onExecutePostLogin = async (event, api) => {
 // パスキーが認証に使用されたかどうかを確認する
 const skipMFA = event.authentication?.methods.some(
   (method) => method.name === "passkey"
 );

 // パスキーが使用された場合は MFA をスキップする
 if (skipMFA) {
   api.multifactor.enable("none");
 }
};
```

接続でパスキーとMFAが有効になっている必要があります。詳細については、[Passkeys](/ja/docs/authenticate/database-connections/passkeys) および [多要素認証](/ja/docs/secure/multi-factor-authentication) を参照してください。

<div id="redirect-the-user-to-an-external-site">
  ### ユーザーを外部サイトにリダイレクトする
</div>

[Redirect Rules](/ja/docs/customize/rules/redirect-users) と同様に、post-login Action を使用してユーザーを外部サイトにリダイレクトできます。完了後、ユーザーは Auth0 にリダイレクトされて戻り、ログインフローを続行できます。以下の例では、ユーザーに好きな色を入力してもらうために Redirect Action を使用しています。

```javascript lines expandable theme={null}
/**
 * @param {Event} event - Details about the user and the context in which they are logging in.
 * @param {PostLoginAPI} api - Interface whose methods can be used to change the behavior of the login.
 */
exports.onExecutePostLogin = async (event, api) => {
  // Skip the redirect if the user has already chosen a favorite color.
  if (event.user.user_metadata.favorite_color) {
    return;
  }

  const token = api.redirect.encodeToken({
    secret: event.secrets.MY_SHARED_SECRET,
    payload: {
      email: event.user.email,
    },
  });

  // Send the user to https://my-app.example.com along
  // with a `session_token` query string param.
  api.redirect.sendUserTo("https://my-app.example.com", { 
    query: { session_token: token }
  });
};

/**
 * @param {Event} event - ユーザーとログイン時のコンテキストに関する詳細。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
exports.onContinuePostLogin = async (event, api) => {
  // /continue エンドポイントが呼び出されたら、署名済みトークンを展開し、
  // お気に入りの色をユーザーメタデータとして保存する。

  const payload = api.redirect.validateToken({
    secret: event.secrets.MY_SHARED_SECRET,
  });

  api.user.setUserMetadata("favorite_color", payload.favorite_color);
};
```

ユーザーがリダイレクトされている間、Actions パイプラインは一時停止されます。ユーザーが Auth0 のログインプロセスを続行すると、Actions パイプラインは停止された箇所から再開されます。リダイレクト前に実行された Action は再実行されません。

Redirect Actions の詳細については、[Actions を使用したリダイレクト](/ja/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/redirect-with-actions) を参照してください。

<div id="modify-scopes-on-an-access-token">
  ### アクセストークンのスコープを変更する
</div>

<Tooltip tip="アクセストークン: API へのアクセスに使用される、オペーク文字列または JWT の形式の認可資格情報。" cta="用語集を見る" href="/ja/docs/glossary?term=access+token">アクセストークン</Tooltip>に関連付けられたスコープを変更する場合は、オーディエンスの指定に関するベストプラクティスに従ってください。

* スコープを追加する前に、必ず想定しているオーディエンスであることを確認してください。
* スコープを追加する際に、信頼できない入力を使用しないでください。

```javascript lines theme={null}
/**
 * @param {Event} event - ユーザーおよびログイン時のコンテキストに関する詳細情報。
 * @param {PostLoginAPI} api - ログインの動作を変更するために使用できるメソッドを持つインターフェース。
 */
exports.onExecutePostLogin = async (event, api) => {
  if (event?.resource_server?.identifier === 'https://example.com/api') {
    api.accessToken.addScope("read:xyz");
  }
};
```

<div id="deny-access-to-specific-ja3ja4-fingerprints">
  ### 特定の JA3/JA4 フィンガープリントからのアクセスを拒否する
</div>

`event.security_context` オブジェクトには、現在のトランザクションの JA3/JA4 フィンガープリント値が含まれています。

```js lines theme={null}
exports.onExecutePreUserRegistration = async (event, api) => {
  const clientJa4 = event?.security_context?.ja4;
  console.log('[ACTION]', {clientJa4});
  const badFingerprints = ['t13d1517h2_8daaf6152771_b6f405a00624','t13d1516h2_8daaf6152771_d8a2da3f94cd'];
  if (clientJa4 && badFingerprints.includes(clientJa4)){
    api.access.deny('suspicious_tls_fingerprint', 'Your TLS fingerprint has been flagged as suspicious');
  }
};
```

<div id="learn-more">
  ## 詳細情報
</div>

* [post-login Action トリガーを使用してユーザーメタデータを管理する](/ja/docs/manage-users/user-accounts/metadata/manage-user-metadata)
* [Actions を使用したリダイレクト](/ja/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/redirect-with-actions)
* [ユーザープロフィールでのメタデータの仕組みを理解する](/ja/docs/manage-users/user-accounts/metadata)