メインコンテンツへスキップ
RulesとHooksのサポート終了(EOL)日は 2026年11月18日 であり、 2023年10月16 日の時点で作成された新しいテナントは使用できなくなります。Hooksが有効な既存のテナントは、サポート終了までHooksを利用できます。今後はActionsに移行して、Auth0の機能を拡張することを強くお勧めします。Actionsを使用すると、豊富な情報やインラインドキュメント、パブリックnpmパッケージにアクセスして、外部統合を使って全体的な拡張エクスペリエンスを強化することができます。Actionsの詳細については、「Auth0 Actionsの仕組みを理解する」をお読みください。当社では、移行の参考資料として、RulesからActionsへの移行HooksからActionsへの移行に関するガイドを提供しています。また、専用の「Actionsへの移行」ページでは、機能の比較やActionsのデモ、その他のリソースを掲載して、円滑な移行をサポートしています。RulesとHooksの廃止の詳細については、当社のブログ記事「RulesとHooksの提供終了について」をお読みください。
RulesとHooksの機能は2026年にサポートの終了を予定しているため、新しいルールやフックは、アクションへの移行をテストするためだけに、開発環境内で作成してください。RulesからActionsへの移行方法については、「RulesからActionsに移行する」をお読みください。HooksからActionsへの移行方法については、「HooksからActionsに移行する」をお読みください。
Hooksは、Dashboardまたはを使って更新できます。 フックのインポートとエクスポートにはCLI(Deploy Command-Line Interface)ツールを使用することもできます。
必要に応じて、フックにシークレット(Twilioキーやデータベース接続文字列など)を追加できます。

Dashboardを使用してフックの名前を変更する

  1. [Auth0 Dashboard]>[Auth Pipeline(Authパイプライン)]>[Hooks(フック)]に移動し、名前を変更したいフックの横にある歯車アイコンをクリックします。
  2. [Rename(名前を変更)] をクリックします。
  3. フックの新しい名前を入力して、 [Rename(名前を変更)] をクリックします。
    Auth0 Rename Hooks

Dashboardを使用してフックスクリプトを更新する

  1. [Auth0 Dashboard]>[Auth Pipeline(Authパイプライン)]>[Hooks(フック)]に移動し、更新したいフックの横にある鉛筆アイコンをクリックします。
    Auth0 Hooks select a Hook
  2. Hook Editorを使用してフックを更新し、ディクスのアイコンをクリックして保存します。
    Auth0 Hook Editor

Management APIを使用してフックを更新する

フック更新エンドポイントPATCH呼び出しを行います。HOOK_IDMGMT_API_ACCESS_TOKENのプレースホルダーの値を、それぞれフックIDとManagement APIのアクセストークンに置き換えてください。
curl --request PATCH \
  --url 'https://{yourDomain}/api/v2/hooks/HOOK_ID' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{ "name": "HOOK_NAME", "script": "HOOK_SCRIPT", "enabled": "true" }'
説明
HOOK_ID更新するフックのID。
MGMT_API_ACCESS_TOKENupdate:hooksを持つManagement APIのアクセストークン。詳細については、「Management APIのアクセストークン」をお読みください。
HOOK_NAME作成するフックの名前。
HOOK_SCRIPTフックのコードを含むスクリプト。Dashboardを使って新しいフックを作成していた場合は、入力する内容と一致する必要があります。
enabledプロパティは、ルールが有効(true)か、無効(false)かを示します。

フック内からAPIを呼び出すときのレート制限に対処する

フックのスクリプト内からAuth0 APIを呼び出す場合、レート制限に対処する必要があります。X-RateLimit-Remainingヘッダーを確認して、返された値が0に近い場合は適切に対応してください。また、指定しているレート制限の超過に対処し、HTTPステータスコードの429Too Many Requests(要求が多過ぎます)」を受け取るロジックを追加します。この際に再試行が必要な場合は、無限の再試行ループを避けるために、バックオフを許可することが得策です。
I