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 コンソール概要の「新手配置指引」(Getting Started Guide) タブをクリックしてください。
コネクター JSON を作成する
- 「SMS コンソール概要」に移動し、右上のアバターにカーソルを合わせます。「アクセス管理 > アクセスキー > API キー」に移動し、セキュリティ検証を完了した後に
AccessKey IDとAccessKey Secretを生成します。これらを適切に保管してください。 - 「国内メッセージ」(国内消息) または「国際/香港、マカオ、台湾メッセージ」(国际/港澳台消息) タブから、「署名名」(签名名称) と「テンプレートコード」(模版 CODCE) を取得します。
- テストテンプレートについては、「テスト専用テンプレート」(测试专用签名模版) の下の「快速开始」(Getting Started) タブを確認してください。
- 次のフィールドで Tencent Cloud SMS コネクターを設定します：
accessKeyIdとaccessKeySecret：ステップ 1 からの資格情報を使用します。signName：ステップ 2 で取得した署名名。これはすべてのテンプレートに適用されます。- 必要に応じて、異なるシナリオのために複数のテンプレートを追加します。単一テンプレートの例：
templateCode：ステップ 2 での「テンプレートコード」から取得。usageType：異なるシナリオのためにRegister、SignIn、ForgotPassword、またはGenericのいずれかを指定します（Logto 固有のプロパティ）。- フローを完了するために、すべての 4 つのシナリオに対してテンプレートが設定されていることを確認します。
sdkAppId：「アプリケーション管理」(应用管理) で見つかります。region：「送信ドキュメント」(发送文档) からサポートされている地域を指定します。
Tencent Cloud SMS コネクターをテストする
電話番号を入力し、「送信」をクリックして、設定が機能するかどうかを「保存して完了」する前に確認できます。
以上です。サインイン体験で コネクターを有効にする のを忘れないでください。
設定タイプ
| 名前 | タイプ |
|---|---|
| accessKeyId | string |
| accessKeySecret | string |
| signName | string |
| region | string |
| sdkAppId | string |
| templates | Template[] |
| テンプレートプロパティ | タイプ | 列挙値 |
|---|---|---|
| templateCode | string | N/A |
| usageType | enum string | 'Register' | 'SignIn' | 'ForgotPassword' | 'Generic' |