Her ikisi de bir External ID’ye değil, bir telefon numarası veya e-posta adresi olan ham bir iletişim bilgisine gönderilir. Bu kılavuzdaki diğer tüm gönderimlerden temel fark budur.
Tek kullanımlık bir kodla telefon numarasını doğrulayın \
User Profile’da kullanıcı bir cep telefonu numarası ekleyebilir. Uygulama backend’den 6 haneli bir kodu SMS ile göndermesini ister, kullanıcı kodu yazar ve backend kontrol eder. Numara ancak bundan sonra doğrulanmış sayılır.
Telefon numarası ekleme: numarayı girin, kodu girin, doğrulandı.
1
Bir kod oluşturun ve karma olarak saklayın
Kod kriptografik bir rastgele kaynaktan gelir. Yalnızca kullanıcıya ve telefon numarasına bağlı, anahtarlı bir karma saklanır, böylece tablo tek başına kodlara geri dönüştürülemez. Anahtar, başka hiçbir şey için kullanılmayan özel bir gizli anahtar olan
OTP_HASH_SECRET’tır. Ayarlanmamışsa her iki fonksiyon da çalışmayı reddeder.supabase/functions/_shared/otp.ts
supabase/functions/send-otp/index.ts
2
Kodu OneSignal üzerinden SMS ile gönderin
include_phone_numbers numarayı doğrudan hedefler. OneSignal numarayı daha önce hiç görmediyse onun için bir SMS aboneliği oluşturur.supabase/functions/send-otp/index.ts
3
Kodu kontrol edin
Backend kullanıcının yazdığının karmasını alır ve saklanan karmayla karşılaştırır. Her yanlış tahmin sayılır. Beş yanlış denemeden sonra kod geçersiz olur ve yeni bir kod istenmesi gerekir.
supabase/functions/verify-otp/index.ts
4
Numarayı bir SMS aboneliği olarak kaydedin
Backend kodu onayladığında uygulama numarayı oturum açmış kullanıcıya ekler.Uygulama bunu her oturum açmadan sonra tekrarlar, böylece doğrulanmış bir numara kullanıcıyı yeni bir cihaza kadar takip eder.
src/lib/phone.ts
src/lib/phone.ts
E-postada olduğu gibi
addSms() yöntemini login() sonrasında çağırın. Ham bir telefon numarasına yapılan gönderim, kimseye ait olmayan bir abonelik oluşturur. Oturum açılmış bir uygulamadan çağrılan addSms(), bu aboneliği kullanıcıya bağlar. O zamana kadar abonelik kontrol panelinde ayrı bir kullanıcı kaydı olarak görünür.Uç noktayı koruyun \
İstek üzerine kısa mesaj gönderen bir fonksiyon her çalıştığında para harcar ve kötüye kullanım için bir hedeftir. Clean Beans şu sınırları uygular.supabase/functions/send-otp/index.ts
supabase/migrations/028_phone_verification_and_invites.sql
Numaranın girildiği yerde izin isteyin \
Bir telefon numarası tek başına ona mesaj gönderme izni değildir. Doğrulama kodları için telefon alanının yanında bir açıklama yeterlidir. Bu açıklama kimin gönderdiğini, ne göndereceğini, ücret uygulanabileceğini ve nasıl durdurulacağını belirtmelidir.src/components/PhoneVerificationCard.tsx
Henüz kullanıcı olmayan birini davet edin \
Household ekranında bir üye, birini SMS veya e-postayla davet edebilir. Davet edilen kişinin hesabı, kayıtlı bir cihazı ve External ID’si yoktur. Backend, uygulamanın katılma ekranını açan bir bağlantıyla ham iletişim bilgisine gönderim yapar.
Bir ev arkadaşını SMS veya e-postayla davet etme ve aldığı mesaj.
include_phone_numbers kullanır. E-posta, konu ve HTML gövdesi doğrudan isteğe eklenerek email_to kullanır.
supabase/functions/send-invite/index.ts
- E-posta tıklama izleme kapalıdır. İzleme, bağlantıları bir izleme alan adından geçecek şekilde yeniden yazar ve yeniden yazılmış bir bağlantı artık uygulamayı açmaz.
- SMS izlenen bir kısa bağlantı kullanmaz, aynı nedenle.
login() ile addEmail() veya addSms() çağrıları, davetin oluşturduğu aboneliği yeni kullanıcısına bağlar.
Bilinmesi gerekenler \
- Bir gönderici gereklidir. Settings > SMS bölümünde varsayılan bir gönderici seçin veya her istekle
sms_fromiletin. İkisi de yoksa istek “A valid number is required for ‘From’ field” hatasıyla reddedilir. 200yanıtı her zaman bir mesajın gönderildiği anlamına gelmez. Yalnızca durum koduna değil, yanıtta bir mesajiddeğeri olup olmadığına da bakın.- Numaraları E.164 biçiminde saklayın. Bu biçim, artı işaretinin ardından ülke kodu ve numaradan oluşur. API’yi çağırmadan önce başka her şeyi reddedin.
- OneSignal Verify yönetilen alternatiftir. Kodları sizin için oluşturur ve kontrol eder. Clean Beans tüm akışı göstermek için kendi çözümünü oluşturur.
Tek kullanımlık şifreler
OneSignal Verify ve kendi çözümünüzü oluşturma.
SMS izni ve toplama
İzin ve açıklama gereksinimleri.
SMS API referansı
Tüm SMS parametreleri.