認証
ユーザー管理
カスタマイズ
プラットフォーム使用状況
完了と callback 関数
callback 関数が含まれます。Auth0 はこの callback 関数を提供し、操作の完了を通知します。
すべてのデータベースアクションスクリプトでは、完了する直前に (暗黙的に、または return ステートメントで明示的に) callback 関数を必ず1回だけ呼び出す必要があります。callback 関数が実行されないと、実行が停止し、最終的にエラーが返されます。
トラブルシューティングのために、Error オブジェクトを callback 関数に渡すことで、データベースアクションスクリプトからエラーを返すことができます。
callback() のように引数なしで callback 関数を呼び出すことは、callback(null) を呼び出すことと同じです。
非同期 JavaScript
callback 関数の呼び出しを延期する必要があります。非同期操作は、Webtask コンテナーの実行制限内に完了する必要があります。
公開 npm モジュール
npm モジュールを使用すると、アクションスクリプト全体のサイズを削減できるほか、幅広い既成機能を利用できます。
Auth0 のサーバーレス Webtask コンテナーでは、多くのサポート対象の公開 npm モジュールを使用できます。ほかのモジュールが必要な場合は、Auth0 の担当者に依頼するか、サポートチケットを起票してください。
アクションスクリプトでは、プライベートリポジトリの npm モジュールはサポートされていません。
提供されるアーティファクト
global オブジェクト
global オブジェクトにアクセスできます。
global オブジェクトを使用すると、コンテナーインスタンスで実行されるすべてのアクションスクリプトで使用する情報や関数を定義したり、サードパーティ (ログ記録) API 用の や、クライアント認証情報フローを介して取得した、Auth0 で定義した独自の API 用アクセストークンを保存するなど、取得コストの高いリソースをキャッシュしたりできます。
ユーザー固有の情報を
global オブジェクトに保存しないでください。Auth0 ではアクションスクリプトの実行時にコンテナーアフィニティがないため、アクションスクリプトは実行中の任意のコンテナーインスタンス、またはプールに追加された新しいコンテナーインスタンスで実行される可能性があります。global オブジェクト内のすべての代入宣言には、初期化処理も含める必要があります。これは、Webtask コンテナーが再利用またはインスタンス化されると global オブジェクトがリセットされるためです。
configuration オブジェクト
configuration オブジェクトを通じて、すべてのスクリプトから値を利用できるようになります。値は暗号化されます。
configuration オブジェクトは読み取り専用として扱い、アクションスクリプト内で値をハードコーディングしないために使用してください。たとえば、外部アイデンティティストアへのアクセスに使用する資格情報や API キーなどの機密情報を保存したり、tenant 固有の値を持つ変数を定義したりできます。
context オブジェクト
context オブジェクトを有効にすると、organizationデータをデータベースアクションスクリプトで利用できるようになります。これにより、id、name、metadata などの組織の詳細を含む追加の context 引数が、カスタムデータベーススクリプトに渡されます。
context オブジェクトは、一度有効にすると無効にできません。Delete スクリプトには、常に空の context オブジェクトが渡されます。
制限
-
アクションスクリプトの合計サイズは、import する
npmモジュールを除き、100 KBを超えることはできません。サイズが大きいほど、Webtask プラットフォームでのパッケージ化および転送処理によるレイテンシーが増加し、システムのパフォーマンスに影響します。 - 各アクションスクリプトのコンテナーには約20秒の実行時間制限があり、制限を超えるとコンテナーは再利用されます。これにより、アクションスクリプトで保留中の処理が終了し、エラーが発生する可能性があります。