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

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

ヒント:

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

はじめに

Aliyun はアジアの主要なクラウドサービスプロバイダーであり、DM (ダイレクトメール) を含む多くのクラウドサービスを提供しています。Aliyun DM コネクターは、Logto チームが提供するプラグインで、Aliyun DM サービス API を呼び出すためのものです。これを利用して、Logto のエンドユーザーはメール認証コード（または別の言い方をすれば、認証コード）を通じて Logto アカウントに登録およびサインインできます。

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

Aliyun アカウントを作成する

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

Aliyun Direct Mail を有効化および設定する

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

DM 管理コンソールページ から始めて、次のことを行います：

1. サイドバーから「発信域名」に移動し、指示に従って「新建域名」を追加します。
2. 「発信アドレス」と「メールタグ」をそれぞれカスタマイズします。

設定が完了したら、次の 2 つの方法でテストできます：

• DirectMail 概要ページ に移動し、ページの下部にある「操作引导」を見つけ、「发送邮件」をクリックします。さまざまなテスト方法が見つかります。
• サイドバーの「发送邮件」->「发送邮件任务」のパスに従ってテストタスクを作成します。

コネクター JSON を作成する

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

Aliyun DM コネクターをテストする

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

これで完了です。サインイン体験でコネクターを有効化する のを忘れないでください。

設定タイプ

名前	タイプ
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (OPTIONAL)
templates	Template[]

テンプレートプロパティ	タイプ	列挙値
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'