SMS ile Doğrulama Kodu (OTP) Gönderme: Startup ve Uygulamalar İçin Rehber

Nirvana SMS · · Geliştirici

Kısaca: OTP, kullanıcının telefon numarasını doğrulamak için gönderilen tek kullanımlık koddur. Kod sunucuda rastgele üretilir, kısa süre geçerli tutulur, deneme sayısı sınırlanır ve SMS API ile tek istekte gönderilir.

Yeni bir uygulama ya da web platformu kuruyorsanız, kullanıcının gerçekten o telefon numarasının sahibi olduğunu doğrulamanız gerekir. Bunun en yaygın yolu SMS ile tek kullanımlık doğrulama kodu (OTP) göndermektir.

OTP nerelerde kullanılır?

  • Üyelikte telefon numarası doğrulama
  • Girişte iki adımlı doğrulama (2FA)
  • Şifre sıfırlama
  • Ödeme, adres ya da hesap bilgisi değişikliği gibi önemli işlemlerin onayı

Güvenli bir OTP akışı nasıl kurulur?

  1. Kodu sunucuda üretin: Kriptografik olarak güvenli rastgele sayı üreticisiyle 6 haneli kod oluşturun. Kodu asla tarayıcıda ya da mobil uygulamada üretmeyin.
  2. Kodun özetini saklayın: Kodu düz metin yerine özetlenmiş hâlde, kullanıcı ve oturumla ilişkilendirerek kaydedin.
  3. Kısa süre tanıyın: Kodu 2-5 dakika geçerli tutun.
  4. Deneme sayısını sınırlayın: Örneğin 5 hatalı denemeden sonra kodu geçersiz kılın.
  5. Yeniden gönderimi sınırlayın: Aynı numaraya kısa aralıklarla tekrar kod gönderilmesini engelleyin; hem kötüye kullanımı hem maliyeti önler.
  6. Mesajı sade tutun: Kodu, ne için olduğunu ve kimseyle paylaşılmaması gerektiğini yazın.

Doğrulama kodunuz: 482915. Bu kodu kimseyle paylaşmayın.

SMS API ile gönderim

Nirvana SMS API, HTTP üzerinden XML ile çalışır; her programlama diliyle kullanılabilir. Sunucunuz kodu ürettikten sonra tek bir istekle SMS'i gönderir ve bir gönderim kimliği alır. Bu kimlikle iletim raporunu sorgulayarak kodun ulaşıp ulaşmadığını görebilirsiniz.

İstek yapısı ve örnekler için SMS API sayfamıza ve API entegrasyon rehberine bakabilirsiniz. API dokümanını dosya arşivinden indirebilirsiniz.

Dikkat edilmesi gerekenler

  • API anahtarını gizli tutun: Anahtarı yalnızca sunucu tarafında saklayın.
  • Mükerrer gönderim: Aynı mesajın 2 dakika içinde tekrar gönderilmesi altyapı tarafından engellenir; her kod farklı olduğu için OTP'de sorun yaratmaz.
  • Mesaj uzunluğu: OTP mesajlarını tek SMS'e sığacak kısalıkta tutun.

Startup'lar için kullanım alanı sayfamıza göz atabilir, entegrasyon için teknik ekibimize ulaşabilirsiniz.

Sık sorulanlar

OTP SMS'leri için İYS onayı gerekir mi?

Hayır. Doğrulama kodu bir bilgilendirme mesajıdır; ticari ileti sayılmaz. Mesaja kampanya ya da tanıtım eklerseniz ticari ileti hâline gelir.

Doğrulama kodu kaç haneli olmalı?

Yaygın uygulama 6 hanedir. Kısa geçerlilik süresi ve deneme sınırıyla birlikte kullanıldığında yeterli güvenlik sağlar.

İlk mesajınızı 10 dakika içinde gönderin

Ücretsiz üye olun, evraklarınızı panelden yükleyin, sözleşmeyi e-Devlet'ten onaylayın. Paneliniz anında aktif olur.