شارك المقالة
تخزين البيانات الحساسة في Flutter باستخدام flutter_secure_storage

تخزين البيانات الحساسة في Flutter باستخدام flutter_secure_storage

احفظ البيانات الحساسة في Flutter باستخدام flutter_secure_storage، مع تحويل القوائم إلى JSON ومعالجة القراءة الفاشلة ومسح بيانات الحساب.

flutter_secure_storage يتيح تخزين قيم حساسة عبر آليات المنصة بدل حفظها كنص في تفضيلات عامة. لا يعني ذلك أن التطبيق صار غير قابل للاختراق أو أن من الآمن طباعة رموز الجلسات. يركز المثال على حفظ قائمة نصية وقراءتها بشكل متين، مع فصل سياسة المسح عن واجهة المستخدم.

ما البيانات المناسبة؟

احفظ الحد الأدنى اللازم مثل رمز جلسة قابل للإلغاء، ولا تنقل أسرار الخادم أو مفاتيح حساب التاجر إلى التطبيق. اعتمد صلاحية قصيرة وتحققًا في الخادم؛ التشفير المحلي ليس بديلًا عن التحكم في الوصول. تفضيلات اللون واللغة لا تحتاج بالضرورة المسار نفسه.

تسلسل البيانات وفحصها

الحزمة تقرأ وتكتب قيمًا نصية. يحول المثال List إلى JSON ويتحقق عند القراءة من أن القيمة قائمة وأن جميع عناصرها نصوص. إذا كانت البيانات تالفة أو من مخطط قديم يرجع null ليتعامل المستدعي مع الحالة بدل cast يسبب انهيارًا. يمكن إضافة schema إذا تطور النموذج لاحقًا.

أخطاء المنصة وتسجيل الخروج

عمليات القراءة والكتابة غير متزامنة وقد تفشل؛ أظهر حالة مناسبة دون تسريب القيمة في logs. يحذف clearAccount مفتاح المثال فقط، فلا يمسح بيانات تخص ميزة أخرى. عند وجود مفاتيح متعددة للحساب احتفظ بسجل واضح لها وامسحها وفق سياسة تسجيل الخروج.

النسخ الاحتياطي وتغيير الإصدارات

اختُبر المثال مع flutter_secure_storage 10.3.4. راجع دليل الهجرة عند اختيار إصدار رئيسي مختلف، وإعدادات Keychain والنسخ الاحتياطي على Android. قد تبقى بيانات أو تستعاد بعد إعادة التثبيت بحسب المنصة والإعداد؛ افحص ذلك على جهاز فعلي بدل افتراض أن الحذف يمحو كل أثر.

الإعداد

flutter pub add flutter_secure_storage

مثال تطبيقي

المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.

import 'dart:convert';
import 'package:flutter_secure_storage/flutter_secure_storage.dart';

List<String>? decodeLabels(String? raw) {
  if (raw == null) return null;
  try {
    final decoded = jsonDecode(raw);
    if (decoded is! List || decoded.any((v) => v is! String)) return null;
    return List<String>.unmodifiable(decoded.cast<String>());
  } on FormatException {
    return null;
  }
}

class PrivateStore {
  PrivateStore({FlutterSecureStorage? storage})
      : _storage = storage ?? const FlutterSecureStorage();
  final FlutterSecureStorage _storage;
  static const _key = 'account_labels_v1';
  Future<void> saveLabels(List<String> values) =>
      _storage.write(key: _key, value: jsonEncode(values));
  Future<List<String>?> readLabels() async => decodeLabels(await _storage.read(key: _key));
  Future<void> clearAccount() => _storage.delete(key: _key);
}

تطبيق flutter_secure_storage في مشروعك

التخزين الآمن يقلل التعرض لكنه لا يجعل التطبيق غير قابل للاختراق؛ لا تطبع الرموز، وحدد سياسة المسح عند تسجيل الخروج.

مراجع الموضوع: pub.dev — flutter_secure_storage

اختيار التخزين في سلسلة قواعد البيانات

هذا المثال يركز على القيم الحساسة ويختلف عن حفظ تفضيلات المظهر أو قائمة أسماء عامة. لا تنقل كل بيانات SQLite إلى التخزين الآمن لمجرد اسمه؛ حدّد حجم البيانات وطريقة البحث وسياسة المسح. المثال السابق اختُبر مع إصدار الحزمة المذكور داخله؛ راجع دليل الهجرة قبل الانتقال إلى إصدار رئيسي أحدث. احذف نسخة الرمز القديمة من التفضيلات بعد نجاح نقلها، ولا تطبع القيمة للتأكد من الحذف.

لإكمال هذا الجزء، انتقل إلى حفظ حالة Onboarding ورمز الجلسة في Flutter بطريقة صحيحة، ثم طبّق الربط الذي يناسب بنية مشروعك.

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع