どちらもExternal IDではなく、電話番号やメールアドレスといった連絡先そのものに送信します。これが、このガイドのほかのすべての送信との主な違いです。
ワンタイムコードで電話番号を認証する \
User Profileで、ユーザーは携帯電話番号を追加できます。アプリはバックエンドに6桁のコードをSMSで送るよう依頼し、ユーザーがそれを入力し、バックエンドが確認します。それが済んで初めて、番号は認証済みとみなされます。
電話番号の追加:番号の入力、コードの入力、認証完了。
1
コードを生成し、ハッシュ化して保存する
コードは暗号論的な乱数源から生成します。ユーザーと電話番号に紐付けたキー付きハッシュだけを保存するため、テーブルだけからコードを復元することはできません。キーは専用のシークレット
OTP_HASH_SECRETで、ほかの用途には使いません。これが設定されていない場合、どちらの関数も実行を拒否します。supabase/functions/_shared/otp.ts
supabase/functions/send-otp/index.ts
2
OneSignal経由でSMSを送信する
include_phone_numbersは番号を直接指定します。OneSignalがその番号を初めて扱う場合は、SMSサブスクリプションを作成します。supabase/functions/send-otp/index.ts
3
コードを確認する
バックエンドはユーザーが入力した値をハッシュ化し、保存済みのハッシュと比較します。誤入力は回数が記録されます。5回誤るとコードは無効になり、新しいコードをリクエストする必要があります。
supabase/functions/verify-otp/index.ts
4
番号をSMSサブスクリプションとして登録する
バックエンドがコードを確認すると、アプリはサインイン中のユーザーに番号を追加します。アプリはサインインのたびにこれを繰り返すため、認証済みの番号は新しいデバイスにも引き継がれます。
src/lib/phone.ts
src/lib/phone.ts
メールと同様に、
addSms()はlogin()の後に呼び出してください。電話番号に直接送信すると、誰にも属さないサブスクリプションが作成されます。サインイン中のアプリからaddSms()を呼ぶと、そのサブスクリプションがユーザーに紐付きます。それまでは、ダッシュボード上で別のユーザーレコードとして表示されます。エンドポイントを保護する \
リクエストに応じてテキストメッセージを送る関数は、実行のたびに費用がかかり、悪用の標的にもなります。Clean Beansは次の制限を設けています。supabase/functions/send-otp/index.ts
supabase/migrations/028_phone_verification_and_invites.sql
番号を入力する場所で同意を得る \
電話番号があるだけでは、SMSを送る許可にはなりません。認証コードの場合は、電話番号の入力欄の横に開示文を置けば十分です。開示文には、送信者、送信内容、料金が発生する場合があること、停止方法を記載する必要があります。src/components/PhoneVerificationCard.tsx
まだユーザーでない人を招待する \
Household画面で、メンバーはSMSまたはメールで人を招待できます。招待される人にはアカウントも、登録済みのデバイスも、External IDもありません。バックエンドは連絡先に直接、アプリの参加画面を開くリンク付きで送信します。
SMSまたはメールで同居人を招待する画面と、相手が受け取るメッセージ。
include_phone_numbersを使います。メールはemail_toを使い、件名とHTML本文をリクエストに直接含めます。
supabase/functions/send-invite/index.ts
- メールのクリックトラッキングをオフにしています。 トラッキングはリンクをトラッキング用ドメイン経由に書き換えるため、書き換えられたリンクではアプリが開かなくなります。
- SMSではトラッキング付きの短縮リンクを使いません。理由は同じです。
login()とaddEmail()またはaddSms()の呼び出しにより、招待で作成されたサブスクリプションがその新しいユーザーに紐付きます。
知っておくべきこと \
- 送信者が必要です。 Settings > SMSでデフォルトの送信者を選ぶか、リクエストごとに
sms_fromを渡してください。どちらもない場合、リクエストは「A valid number is required for ‘From’ field」で拒否されます。 200レスポンスが必ずしもメッセージの送信を意味するとは限りません。 ステータスコードだけでなく、レスポンスにメッセージのidがあるか確認してください。- 番号はE.164形式で保存してください。 プラス記号の後に国番号と番号を続ける形式です。それ以外はAPIを呼び出す前に拒否してください。
- OneSignal Verifyはマネージドな代替手段です。 コードの生成と確認を代行します。Clean Beansはフロー全体を示すために独自に実装しています。
ワンタイムパスワード
OneSignal Verifyと独自実装。
SMSのオプトインと収集
同意と開示の要件。
SMS APIリファレンス
すべてのSMSパラメーター。