Aliyun Direct Mail を使用してメール認証を設定する

Logto 公式の Aliyun ダイレクトメールサービス用コネクターです。

ヒント:

このガイドは、Logto コネクターについての基本的な理解があることを前提としています。未経験の方は、コネクター ガイドを参照して始めてください。

はじめに

Aliyun はアジアで主要なクラウドサービスプロバイダーであり、DM（ダイレクトメール）を含む多くのクラウドサービスを提供しています。Aliyun DM コネクターは、Logto チームが提供するプラグインで、Aliyun DM サービス API を呼び出すことができます。これにより、Logto エンドユーザーはメール認証コード（または認証コード）を使って Logto アカウントの登録やサインインが可能になります。

Aliyun DirectMail コンソールでメールサービスを設定する

Aliyun アカウントを作成する

Aliyun にアクセスし、まだアカウントをお持ちでない場合は Aliyun アカウントを作成してください。

Aliyun Direct Mail を有効化・設定する

DM サービスコンソールページ にアクセスし、サインインします。ページ左上の「申請開通」ボタンをクリックして Direct Mail サービスを有効化し、設定を開始します。

DM 管理コンソールページ から、次の手順を行います：

1. サイドバーの「発信域名」から「新建域名」を追加し、指示に従って設定します。
2. 「発信地址」と「邮件标签」をそれぞれカスタマイズします。

セットアップが完了したら、テスト方法は 2 つあります：

• DirectMail 概要ページ にアクセスし、ページ下部の「操作引导」から「发送邮件」をクリックします。さまざまなテスト方法が確認できます。
• サイドバーの「发送邮件」→「发送邮件」からテストタスクを作成します。

コネクター JSON を作成する

1. DM 管理コンソールページ で右上のアバターにカーソルを合わせ、「AccessKey 管理」に進み、「创建 AccessKey」をクリックします。セキュリティ認証が完了すると「AccessKey ID」と「AccessKey Secret」のペアが取得できます。大切に保管してください。
2. DM 管理コンソールページ の「発信地址」または「邮件标签」タブに移動し、Sender Address または Email Tag を確認します。
3. Aliyun DM コネクターの設定を入力します：
   • accessKeyId と accessKeySecret フィールドには、手順 1 で取得したアクセスキーを入力します。
   • accountName と fromAlias フィールドには、手順 2 で確認した「Sender Address」と「Email Tag」を入力します。すべてのテンプレートでこの署名名が共有されます。（fromAlias は省略可能なので空欄でも構いません。）
   • 異なる用途ごとに複数の DM コネクターテンプレートを追加できます。以下は単一テンプレート追加の例です：
     • subject フィールドには送信メールのタイトルを入力します。
     • content フィールドには任意の文字列型コンテンツを入力します。ランダム認証コード用に {{code}} プレースホルダーを忘れずに残してください。
     • usageType フィールドには、用途に応じて Register、SignIn、ForgotPassword、Generic のいずれかを入力します。（usageType は適切な用途を識別するための Logto プロパティです。）すべてのユーザーフローを有効にするには、Register、SignIn、ForgotPassword、Generic の usageType を持つテンプレートが必要です。

Aliyun DM コネクターのテスト

「保存して完了」する前に、メールアドレスを入力して「送信」をクリックし、設定が機能するかどうかを確認できます。

以上です。サインアップ / サインインでコネクターを有効化するのを忘れないでください。

設定タイプ

Name	Type
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (OPTIONAL)
templates	Template[]

Template Properties	Type	Enum values
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' / 'SignIn' / 'ForgotPassword' / 'Generic'