إرسال OTP بالبريد من Flutter جزء من تدفق تحقق يملكه الخادم. لا يكفي توليد رقم في التطبيق أو مقارنة الرمز محليًا لإثبات ملكية البريد، لأن العميل يمكن تعديله. يحتفظ Flutter بحالة الطلب والواجهة فقط، بينما ينشئ الخادم التحدي ويرسله ويقرر صلاحيته.
عقد الخادم المطلوب
يستقبل مسار الطلب البريد ويعيد challengeId مبهمًا لا يحتوي الرمز. ينشئ الخادم الرمز بمصدر عشوائي آمن، ويحدد انتهاءه وحد المحاولات ومعدل إعادة الإرسال. عند التحقق يستقبل challengeId والرمز ويربط النتيجة بالسياق والحساب الصحيح، ثم يستهلك التحدي عند النجاح.
فصل الواجهة عن التحقق
EmailOtpApi في المقطع عقد abstract تنفذه أنت فوق HTTPS، وليس مزود بريد جاهزًا أو خدمة منشورة. يتحقق الكود محليًا من شكل رمز من ست خانات للتجربة فقط؛ طابق الطول مع سياسة خادمك. لا تعتبر الانتقال إلى الشاشة التالية توثيقًا للجلسة ما لم يقره الخادم.
المحاولات المتزامنة والأخطاء
يمنع المثال طلبين متداخلين ويمسح التحدي القديم قبل طلب جديد. بعد قبول الخادم يمسح معرف التحدي محليًا. رفض الرمز، انتهاءه وفشل الشبكة حالات مختلفة تحتاج رسائل مناسبة؛ لا تعرض تفاصيل تكشف وجود حساب إذا لم يسمح تصميم الخدمة بذلك.
الأسرار وإعداد البريد
يبقى SMTP أو سر مزود الإرسال في الخادم؛ flutter_dotenv داخل التطبيق لا يخفيه. أضف مراقبة للطلبات وحدود الإرسال وسياسة تنظيف السجلات دون تخزين OTP. اختبارات المثال تغطي حالة التدفق بعقد وهمي فقط ولا ترسل بريدًا أو تثبت تسليم الرسائل؛ يلزم اختبار تكامل في بيئة تملكها.
مثال تطبيقي
المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.
abstract interface class EmailOtpApi {
// Implement on your authenticated HTTPS backend; never generate OTP here.
Future<String> requestCode(String email); // returns opaque challengeId
Future<bool> verifyCode(String challengeId, String code);
}
class EmailOtpFlow {
EmailOtpFlow(this.api);
final EmailOtpApi api;
String? _challenge;
bool _busy = false;
Future<void> request(String email) async {
if (_busy) throw StateError('A request is already running');
_busy = true;
_challenge = null;
try {
final challenge = await api.requestCode(email.trim());
if (challenge.isEmpty) throw StateError('Missing challenge');
_challenge = challenge;
} finally { _busy = false; }
}
Future<bool> verify(String code) async {
final challenge = _challenge;
if (challenge == null || _busy || !RegExp(r'^\d{6}$').hasMatch(code.trim())) return false;
_busy = true;
try {
final valid = await api.verifyCode(challenge, code.trim());
if (valid) _challenge = null;
return valid;
} finally { _busy = false; }
}
}
تطبيق إرسال OTP بالبريد من Flutter في مشروعك
ينشئ الخادم الرمز ويتحقق منه ويحدد انتهاءه ومحاولاته؛ تخزين سر SMTP أو اعتبار تحقق العميل مصادقة نهائية يجعل التدفق قابلًا للتجاوز.
مراجع الموضوع: cheatsheetseries.owasp.org — Authentication_Cheat_Sheet.html






