Tencent Short Message Service を使用して SMS 認証を設定する
Tencent Short Message Service 用の公式 Logto コネクターです。
ヒント:
このガイドは、Logto コネクターについての基本的な理解があることを前提としています。未経験の方は、コネクター ガイドを参照して始めてください。
はじめに
Tencent Cloud はアジアを代表するクラウドサービスプロバイダーであり、SMS（ショートメッセージサービス）を含むさまざまなサービスを提供しています。
Tencent Short Message Service コネクターは、エンドユーザーが SMS 認証コードを使って登録またはサインインできるようにする公式 Logto インテグレーションです。
Tencent Cloud でショートメッセージサービスを設定する
Tencent Cloud アカウントを作成する
Tencent Cloud のウェブサイト にアクセスし、アカウントをお持ちでない場合は登録してください。
Tencent Cloud SMS を有効化・設定する
- Tencent Cloud のウェブサイト でアカウントにサインインし、SMS サービスコンソールページ にアクセスします。
- SMS サービスページで「無料試用」(免费试用) ボタンをクリックし、セットアップ手順に従います。
- 「SMS サービス有効化規約」(短信开通服务条款) に同意し、「サービスを有効化」(开通服务) をクリックして進めます。
- 「SMS コンソール概要」(短信服务控制台概览) で、ニーズに応じてサイドバーから「国内メッセージ」(国内消息) または「国際/香港・マカオ・台湾メッセージ」(国际/港澳台消息) を選択します。
- SMS メッセージ用のシグネチャとテンプレートを追加します。注意点：
- 「シグネチャ」(签名) を追加する際は、「適用シナリオ」(模版类型) フィールドで「認証コード」(验证码) を選択してください。
- テンプレートを追加する際は、テンプレートタイプとして「認証コード」を選択してください。
- テンプレート内容にはプレースホルダー
{1}を含めてください。これはランダムに生成されたコードに置き換えられます。 - 複数のプレースホルダーを含むテンプレートはサポートされていません。単一プレースホルダーのテンプレートを使用または作成してください。
- シグネチャとテンプレートを申請して承認を受けます。申請後：
- 反映されるまでお待ちください。
- 「SMS コンソール概要」(短信服务控制台概览) からテスト SMS を送信できます。承認済みのシグネチャとテンプレートはテストに直接使用できます。審査中の場合はテスト用テンプレートを利用してください。
- テスト用に十分な残高があること、テスト用電話番号を事前登録して SMS を正常に受信できるようにしてください。
詳細なガイダンスは、SMS コンソール概要の「新規ユーザーガイド」(新手配置指引) タブをクリックしてください。
コネクター JSON を作成する
- 「SMS コンソール概要」にアクセスし、右上のアバターにカーソルを合わせて「アクセス管理 > アクセスキー > API キー」へ進み、セキュリティ認証を完了後に
AccessKey IDとAccessKey Secretを生成します。大切に保管してください。 - 「国内メッセージ」(国内消息) または「国際/香港・マカオ・台湾メッセージ」(国际/港澳台消息) タブから「シグネチャ名」(签名名称) と「テンプレートコード」(模版 CODCE) を取得します。
- テスト用テンプレートの場合は、「テスト専用テンプレート」(测试专用签名模版) の「クイックスタート」(快速开始) タブを確認してください。
- Tencent Cloud SMS コネクターを次のフィールドで設定します：
accessKeyIdおよびaccessKeySecret：手順 1 で取得した認証情報を使用します。signName：手順 2 で取得したシグネチャ名。すべてのテンプレートに適用されます。- 必要に応じて、異なるシナリオ用に複数のテンプレートを追加できます。単一テンプレートの例：
templateCode：手順 2 で取得したテンプレートコード。usageType：シナリオに応じてRegister、SignIn、ForgotPassword、Genericのいずれかを指定します（Logto 固有のプロパティ）。- すべてのシナリオ（4 種類）に対応するテンプレートが設定されていることを確認してください。
sdkAppId：「アプリケーション管理」(应用管理) で確認できます。region：「送信ドキュメント」(发送文档) でサポートされているリージョンを指定してください。
Tencent Cloud SMS コネクターのテスト
電話番号を入力し、「送信」をクリックすることで、「保存して完了」前に設定が機能するかどうかを確認できます。
以上です。サインアップ / サインインでコネクターを有効化 するのをお忘れなく。
設定タイプ
| Name | Type |
|---|---|
| accessKeyId | string |
| accessKeySecret | string |
| signName | string |
| region | string |
| sdkAppId | string |
| templates | Template[] |
| テンプレートプロパティ | Type | Enum values |
|---|---|---|
| templateCode | string | N/A |
| usageType | enum string | 'Register' | 'SignIn' | 'ForgotPassword' | 'Generic' |