> ## 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.

# カスタマイズしたActionを使ってメールプロバイダーを設定する

> Auth0 DashboardまたはTerraform Auth0 providerからメールプロバイダーにメッセージを送信するActionを作成し、ユースケースに合わせたカスタムロジックを実装します。

<div id="configure-an-email-provider-action-using-the-auth0-dashboard">
  ## Auth0 Dashboard を使用してメールプロバイダー Action を設定する
</div>

Auth0 Dashboard を使用して、テナントにカスタムメールプロバイダー Action を設定するには、次の手順を実行します。

1. [Auth0 Dashboard > Branding > Email Provider](https://manage.auth0.com/#/templates/provider) に移動します。

2. **Use my own email provider** トグルを有効にします。

3. **Email Provider** セクションで、**Custom Provider** を選択します。

4. **From** フィールドに、メールの送信元として使用するデフォルトのメールアドレスを入力します。

5. コードエディターで、メールプロバイダー経由でメッセージを送信するための Action コードを記述します。API または SMTP 接続の詳細については、利用するプロバイダーのドキュメントを参照してください。

   コードエディターの左側のメニューでは、キーアイコンをクリックして secrets (たとえば API 認証に使用するもの) を追加し、ボックスアイコンをクリックして dependencies を追加できます。

6. Action の記述が完了したら、**Save** をクリックしてデプロイします。

設定をテストするには、**Send Test Email** をクリックします。

他の Actions と同様に、[Management API](https://auth0.com/docs/api/management/v2/actions/get-actions) を使用して Action とその[バージョン](/docs/ja-jp/customize/actions/manage-versions)を管理できます。すべての Actions には、同じ[制限事項](/docs/ja-jp/customize/actions/limitations)が適用されます。

<div id="configure-an-email-provider-action-using-terraform">
  ## Terraform を使用してメールプロバイダー Action を設定する
</div>

[Terraform Auth0 provider](https://registry.terraform.io/providers/auth0/auth0/latest/docs) は、[Auth0 Management API](https://auth0.com/docs/api/management/v2) を使用して Auth0 プラットフォーム上で操作を行います。

Terraform Auth0 provider を使用してカスタムメールプロバイダー Action を作成し、それを使用するようにテナントを設定できます。

<div id="1-unbind-or-delete-conflicting-actions">
  ### 1. 競合するActionのバインドを解除または削除する
</div>

`custom-email-provider` トリガーにバインドできる Action は最大 1 つです。

テナントですでにカスタムメールプロバイダーActionが設定されている場合は、Terraform で新しいメールプロバイダーActionを作成する前にリセットしてください。

1. [Auth0 Dashboard > Branding > Email Provider](https://manage.auth0.com/#/templates/provider) に移動します。
2. **Email Provider** セクションで、**Custom Provider** をクリックします。
3. Actions Code Editor の下にある **Reset** をクリックします。

`custom-email-provider` トリガーにバインドされた、デプロイ済みの別の Action があるかどうかは、Management API を使用して確認できます。

1. 重複する Action を特定するには、[Actions の一覧を取得します](https://auth0.com/docs/api/management/v2/actions/get-actions)。
2. [それらのトリガーバインディングを更新する](https://auth0.com/docs/api/management/v2/actions/patch-bindings) か、[Action を削除します](https://auth0.com/docs/api/management/v2/actions/delete-action)。

<div id="2-create-a-new-email-provider-action">
  ### 2. 新しいメールプロバイダー Action を作成する
</div>

[Terraform の `auth0_action` リソース](https://registry.terraform.io/providers/auth0/auth0/latest/docs/resources/action)を使用して、`custom-email-provider` トリガーに対応する Action を作成します。`deploy = true` を設定すると、Action の新しいバージョンがすぐに作成されます。

```terraform lines theme={null}
resource "auth0_action" "custom_email_provider" {
  name    = "Custom Email Provider"
  runtime = "node20"
  deploy  = true
  code    = <<-EOT
    /**
    * メール通知の送信時に実行されるハンドラー
    * @param {Event} event - ユーザーおよびログイン時のコンテキストに関する詳細情報。
    * @param {CustomEmailProviderAPI} api - メール通知の送信動作を変更するためのメソッドとユーティリティ。
    */
    exports.onExecuteCustomEmailProvider = async (event, api) => {
      // ここにコードを記述します
      return;
    };
  EOT
  supported_triggers {
    id      = "custom-email-provider"
    version = "v1"
  }
}
```

関数スタブに、メッセージをメールプロバイダーに送信するための Action コードを記述します。API や SMTP サーバーの詳細については、プロバイダーのドキュメントを参照してください。

<div id="3-bind-the-action-to-the-email-provider-trigger">
  ### 3. Action をメールプロバイダーのトリガーに紐付ける
</div>

[Terraform `auth0_trigger_action` リソース](https://registry.terraform.io/providers/auth0/auth0/latest/docs/resources/trigger_action) を使用して、Action を `custom-email-provider` トリガーに紐付けます。

```terraform lines theme={null}
resource "auth0_trigger_action" "custom_email_provider" {
  trigger = "custom-email-provider"
  actions {
    id           = auth0_action.custom_email_provider.id
    display_name = auth0_action.custom_email_provider.name
  }
   depends_on = [
    auth0_action.custom_email_provider
  ]
 }
```

<div id="4-configure-your-tenants-email-provider-with-the-action">
  ### 4. Action を使ってテナントのメールプロバイダーを設定する
</div>

[Terraform の `auth0_email_provider` リソース](https://registry.terraform.io/providers/auth0/auth0/latest/docs/resources/email_provider)を使用して、テナントでメールプロバイダー Action を使うように設定します。

```terraform lines theme={null}
resource "auth0_email_provider" "custom_email_provider" {
  name                 = "custom"
  enabled              = true
  default_from_address = "accounts@example.com"
  credentials {}
  depends_on = [
    auth0_trigger_actions.custom_email_provider
  ]
```

Terraform で新しいメールプロバイダー Action を作成しても有効にならない場合は、`custom-email-provider` トリガーに、すでにデプロイ済みの Action がバインドされている可能性があります。この問題を切り分けて解決するには、この記事の最初の手順に従って、[競合する Actions のバインドを解除するか削除](#1-unbind-or-delete-conflicting-actions)してください。

<div id="example-email-provider-action">
  ## メールプロバイダー Action の例
</div>

これは、`custom-email-provider` トリガー用の Action の例です。

このコードサンプルでは、関数 `onExecuteCustomEmailProvider` は [`custom-email-provider` イベントオブジェクト](/docs/ja-jp/customize/actions/reference/custom-email-provider/custom-email-provider-event-object) から 2 つの引数を受け取ります。`event` にはユーザーや通知のコンテキストに関する情報が含まれ、[`custom-email-provider` api オブジェクト](/docs/ja-jp/customize/actions/reference/custom-email-provider/custom-email-provider-api-object) の `api` では、通知の送信時にカスタム動作を実装するためのヘルパーメソッドが提供されます。

```javascript lines expandable theme={null}
/**
 * メール通知の送信中に実行されるハンドラー。
 * @param {Event} event - ユーザーおよびログイン時のコンテキストに関する詳細情報。
 * @param {CustomEmailProviderAPI} api - メール通知の送信動作を変更するためのメソッドとユーティリティ。
 */
exports.onExecuteCustomEmailProvider = async (event, api) => {
  // メールのペイロードを定義する
  const emailPayload = {
    from: {
      name: "Test Sender",
      email: "sender@example.com"
    },
    to: [{ email: event.user.email }],
    subject: event.notification.message_type,
    html: event.notification.html,
    text: event.notification.text,
  };
  try {
    // メール送信のAPIを呼び出す
    const response = await fetch('https://api.example.com/send-email', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${event.secrets.api_key}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(emailPayload),
    });
    if (response.ok) {
      console.log('Email sent successfully');
    } else if (response.status >= 500) {
      api.notification.retry(
        `Internal Server Error received from Messaging Proxy. Status code: ${response.status}.`
      );
      return;
    }
  } catch (error) {
    console.error(`Error sending email: ${error.message}`);
    api.notification.drop(`An unexpected error occurred. Error: ${error.message}`);
  }
  return;
};
```

Actions の詳細については、[Auth0 Actions の仕組みを理解する](/docs/ja-jp/customize/actions/actions-overview)をお読みください。