Twilio SMS を使用して SMS 認証を設定する
Twilio ショートメッセージサービス用の公式 Logto コネクターです。
このガイドでは、Logto コネクターに関する基本的な知識を持っていることを前提としています。もし持っていない場合は、コネクターの設定 ガイドを参照して始めてください。
はじめに
Twilio は、電話の発信と受信、テキストメッセージの送信と受信、その他の通信機能のためのプログラム可能な通信ツールを提供します。私たちはその Web サービス API を通じて「認証コード」テキストメッセージを送信できます。
Twilio アカウントを登録する
Twilio で新しいアカウントを作成します。(すでにアカウントをお持ちの場合は次のステップに進んでください。)
送信者の電話番号を設定する
Twilio コンソールページ にアクセスし、Twilio アカウントでサインインします。
「Phone Numbers」->「Manage」->「Buy a number」から電話番号を購入します。
ℹ️ ヒント
特定の国や地域で SMS サービスがサポートされていない場合があります。他の地域から番号を選択して回避してください。
有効な番号を取得したら、「Messaging」->「Services」に移動します。ボタンをクリックして新しいメッセージサービスを作成します。
フレンドリーなサービス名を付け、サービス目的として Notify my users を選択します。次のステップでは、Sender Type として Phone Number
を選択し、先ほど取得した電話番号を送信者としてこのサービスに追加します。
ℹ️ 注意
各電話番号は 1 つのメッセージングサービスにのみリンクできます。
アカウントの資格情報を取得する
コネクターを機能させるために API の資格情報が必要です。Twilio コンソールページ から始めましょう。
右上の「Account」メニューをクリックし、「API keys & tokens」ページに移動して Account SID
と Auth token
を取得します。
サイドバーから「Messaging」->「Services」設定ページに戻り、サービスの Sid
を見つけます。
コネクター JSON を作成する
accountSID、authToken、fromMessagingServiceSID フィールドに、対応するメッセージングサービスの Account SID
、Auth token
、Sid
を入力します。
異なるケースに対して複数の SMS コネクターテンプレートを追加できます。以下は単一のテンプレートを追加する例です:
content
フィールドに任意の文字列型の内容を入力します。ランダムな認証コードのために{{code}}
プレースホルダーを忘れずに残してください。usageType
フィールドには、異なる使用ケースに応じてRegister
、SignIn
、ForgotPassword
、Generic
のいずれかを入力します。完全なユーザーフローを有効にするためには、Register
、SignIn
、ForgotPassword
、Generic
の usageType を持つテンプレートが必要です。
Twilio SMS コネクターをテストする
「保存して完了」する前に、電話番号を入力して「送信」をクリックし、設定が機能するかどうかを確認できます。
これで完了です。サインイン体験でコネクターを有効にする のを忘れないでください。
設定タイプ
名前 | タイプ |
---|---|
accountSID | string |
authToken | string |
fromMessagingServiceSID | string |
templates | Templates[] |
テンプレートプロパティ | タイプ | 列挙値 |
---|---|---|
content | string | N/A |
usageType | enum string | 'Register' | 'SignIn' | 'ForgotPassword' | 'Generic' |