Auth0 Actions の仕組みを理解する

Auth0 Actions の仕組みと、Actions で実現できることを説明します。

Actions は、Auth0 プラットフォーム内の特定のタイミングで実行される、Node.js で記述された安全なテナント固有のバージョン管理された関数です。Actions を使うと、カスタムロジックによって Auth0 の機能をカスタマイズおよび拡張できます。

Auth0 Actions では、Actions の非同期関数の基盤となる、モダン JavaScript のPromise ベースのプログラミングモデルを採用しています。

このように拡張できるプロセスは、トリガーと呼ばれます。トリガーのグループは、Auth0 の処理フローにおける特定の時点で情報が移動する論理的なパイプラインを表します。1 つのトリガーには複数の Actions を追加でき、各 Action は追加された順序で実行されます。トリガーには、関連するフローをブロックする同期実行のものと、以下の表に示すように非同期実行のものがあります。

Actions は、Auth0 の拡張性機能を支える中核的な要素です。Actions を使うと、ニーズに応じてログインフローや ID フローに重要なカスタムロジックを追加できます。また、拡張性をさらに高める外部連携を組み込むことも可能です。たとえば、本人確認を専門とする Marketplace Partner を利用して、ライセンスやパスポートなどの認証情報を検証する Action をログイントリガーに追加できます。

​

Actions でできること

Action で何ができるかは、Auth0 のランタイム環境内のどこで実行されるかによって決まります。

サインアップとログイン: ユーザーがデータベースまたはパスワードレス コネクションに追加されたとき。

Trigger	Description
pre-user-registration	ユーザーが作成される前にトリガーされます。ソーシャル コネクションでは実行されません。
post-user-registration	ユーザーが作成された後に非同期でトリガーされます。ソーシャル コネクションでは実行されません。
post-login	ユーザーの認証後、トークンが発行される前にトリガーされます。

MFA 通知: 多要素認証 (MFA) の要素として SMS を使用する場合、またはカスタムプロバイダーを設定する場合。

Trigger	Description
send-phone-message	登録プロセスおよびチャレンジプロセスのメッセージ送信にカスタムプロバイダーを使用する場合にトリガーされます。ソーシャル コネクションでは実行されません。

パスワードリセット: パスワードリセットのリクエストが開始されたとき。

Trigger	Description
post-change-password	パスワードが変更された後にトリガーされます。ソーシャル コネクションでは実行されません。
password-reset-post-challenge	最初のチャレンジが完了した後、パスワードがリセットされる前にトリガーされます。

Machine to Machine: ユーザーではなくアプリケーションが認証および認可され、API を使用するとき。

Trigger	Description
credentials-exchange	アクセストークンが返される前にトリガーされます。

​

Actionsの主なメリット

​

開発者体験の向上

• Auth0 Dashboard 内で Action を編集する際は、各トリガーで何ができるかを示す豊富な型情報とインラインドキュメントを利用できるため、それぞれの トリガー がサポートする機能を簡単に把握できます。
• Action は、現在本番トラフィックを処理しているバージョンに影響を与えることなく、編集やテストを行えます。
• Action で問題が見つかった場合は、以前のバージョンにロールバックできます。

​

カスタム関数を再利用する

• Actions Modules を使用して、Actions 間で関数を作成、管理、共有できます。

​

npm パッケージへのアクセス

• Actions 内で、ほぼすべての公開 npm パッケージを使用できます。

​

可観測性

• Auth0 が Actions を実行すると、それらに関する主要なメトリクスが収集され、Auth0 ログ に関連付けられます。
• デバッグ時には、Actions Real-time Logs 機能を使用します。

​

各トリガーで複数のAction

• 各Actionトリガーでは、複数の独立したActionを利用できます。

​

はじめに

• 最初の Action を作成する。
• 最新の Action コーディングガイドライン を確認します。
• 最新の Actions の制限事項 を確認します。

​

詳細はこちら

• 最初のActionを作成する
• トリガーについて詳しく知る
• Actionsの制限事項
• バージョンを管理する
• Actions Betaから正式版へ移行する