feat(认证): 添加基础认证功能支持

easychen · easychen · commit 0f8ebb597109 · 2025-11-06T00:21:11.000+08:00
在应用设置中添加基础认证配置选项，包括用户名和密码输入
修改Dio客户端以支持基础认证头，并在设置保存时更新认证配置
添加本地存储功能保存认证相关配置
diff --git a/lib/core/constants/app_constants.dart b/lib/core/constants/app_constants.dart
@@ -18,6 +18,11 @@ class AppConstants {
   static const String cachedSessionsKey = 'cached_sessions';
   static const String currentSessionIdKey = 'current_session_id';
 
+  // Basic auth storage keys
+  static const String basicAuthEnabledKey = 'basic_auth_enabled';
+  static const String basicAuthUsernameKey = 'basic_auth_username';
+  static const String basicAuthPasswordKey = 'basic_auth_password';
+
   // Default configuration
   static const String defaultTheme = 'system';
   static const int maxMessageLength = 10000;
diff --git a/lib/core/di/injection_container.dart b/lib/core/di/injection_container.dart
@@ -124,4 +124,18 @@ Future<void> _loadLocalConfig() async {
     final baseUrl = 'http://$host:$port';
     dioClient.updateBaseUrl(baseUrl);
   }
+
+  // Load Basic auth configuration
+  final basicEnabled = await localDataSource.getBasicAuthEnabled();
+  if (basicEnabled == true) {
+    final username = await localDataSource.getBasicAuthUsername();
+    final password = await localDataSource.getBasicAuthPassword();
+    if ((username != null && username.isNotEmpty) &&
+        (password != null && password.isNotEmpty)) {
+      dioClient.setBasicAuth(username, password);
+    }
+  } else {
+    // Ensure no leftover auth header when disabled
+    dioClient.clearAuth();
+  }
 }
diff --git a/lib/core/network/dio_client.dart b/lib/core/network/dio_client.dart
@@ -1,9 +1,11 @@
 import 'package:dio/dio.dart';
 import '../constants/api_constants.dart';
+import 'dart:convert';
 
 /// Dio HTTP客户端配置
 class DioClient {
   late final Dio _dio;
+  String? _basicAuthHeader; // cached Authorization header
 
   DioClient({String? baseUrl}) {
     _dio = Dio(
@@ -29,13 +31,35 @@ class DioClient {
     }
   }
 
+  /// Set Basic Authorization header using username and password
+  void setBasicAuth(String username, String password) {
+    final credentials = '$username:$password';
+    final encoded = base64Encode(utf8.encode(credentials));
+    _basicAuthHeader = 'Basic $encoded';
+    _dio.options.headers[ApiConstants.authorization] = _basicAuthHeader!;
+    if (const bool.fromEnvironment('dart.vm.product') == false) {
+      print('[Dio] Basic auth header set');
+    }
+  }
+
+  /// Clear Authorization header
+  void clearAuth() {
+    _basicAuthHeader = null;
+    _dio.options.headers.remove(ApiConstants.authorization);
+    if (const bool.fromEnvironment('dart.vm.product') == false) {
+      print('[Dio] Authorization header cleared');
+    }
+  }
+
   void _setupInterceptors() {
     _dio.interceptors.add(
       LogInterceptor(
+        requestHeader: true,
         requestBody: true,
+        responseHeader: false,
         responseBody: true,
         logPrint: (object) {
-          // 在调试模式下打印日志
+          // Print logs in debug mode only
           if (const bool.fromEnvironment('dart.vm.product') == false) {
             print(object);
           }
@@ -47,7 +71,11 @@ class DioClient {
     _dio.interceptors.add(
       InterceptorsWrapper(
         onRequest: (options, handler) {
-          // 可以在这里添加认证头等
+          // Ensure Authorization header is present if configured
+          if (_basicAuthHeader != null &&
+              (options.headers[ApiConstants.authorization] == null)) {
+            options.headers[ApiConstants.authorization] = _basicAuthHeader;
+          }
           handler.next(options);
         },
         onResponse: (response, handler) {
diff --git a/lib/data/datasources/app_local_datasource.dart b/lib/data/datasources/app_local_datasource.dart
@@ -57,6 +57,24 @@ abstract class AppLocalDataSource {
   /// 保存会话列表到缓存
   Future<void> saveCachedSessions(String sessionsJson);
 
+  /// 获取是否启用 Basic 认证
+  Future<bool?> getBasicAuthEnabled();
+
+  /// 保存是否启用 Basic 认证
+  Future<void> saveBasicAuthEnabled(bool enabled);
+
+  /// 获取 Basic 认证用户名
+  Future<String?> getBasicAuthUsername();
+
+  /// 保存 Basic 认证用户名
+  Future<void> saveBasicAuthUsername(String username);
+
+  /// 获取 Basic 认证密码
+  Future<String?> getBasicAuthPassword();
+
+  /// 保存 Basic 认证密码
+  Future<void> saveBasicAuthPassword(String password);
+
   /// 清除所有数据
   Future<void> clearAll();
 }
@@ -160,6 +178,36 @@ class AppLocalDataSourceImpl implements AppLocalDataSource {
     await sharedPreferences.setString(AppConstants.cachedSessionsKey, sessionsJson);
   }
 
+  @override
+  Future<bool?> getBasicAuthEnabled() async {
+    return sharedPreferences.getBool(AppConstants.basicAuthEnabledKey);
+  }
+
+  @override
+  Future<void> saveBasicAuthEnabled(bool enabled) async {
+    await sharedPreferences.setBool(AppConstants.basicAuthEnabledKey, enabled);
+  }
+
+  @override
+  Future<String?> getBasicAuthUsername() async {
+    return sharedPreferences.getString(AppConstants.basicAuthUsernameKey);
+  }
+
+  @override
+  Future<void> saveBasicAuthUsername(String username) async {
+    await sharedPreferences.setString(AppConstants.basicAuthUsernameKey, username);
+  }
+
+  @override
+  Future<String?> getBasicAuthPassword() async {
+    return sharedPreferences.getString(AppConstants.basicAuthPasswordKey);
+  }
+
+  @override
+  Future<void> saveBasicAuthPassword(String password) async {
+    await sharedPreferences.setString(AppConstants.basicAuthPasswordKey, password);
+  }
+
   @override
   Future<void> clearAll() async {
     await sharedPreferences.clear();
diff --git a/lib/presentation/pages/server_settings_page.dart b/lib/presentation/pages/server_settings_page.dart
@@ -6,6 +6,7 @@ import '../../core/constants/app_constants.dart';
 import '../../core/constants/api_constants.dart';
 import '../../core/di/injection_container.dart';
 import '../../data/datasources/app_local_datasource.dart';
+import '../../core/network/dio_client.dart';
 
 /// Server settings page
 class ServerSettingsPage extends StatefulWidget {
@@ -19,6 +20,9 @@ class _ServerSettingsPageState extends State<ServerSettingsPage> {
   final _formKey = GlobalKey<FormState>();
   final _hostController = TextEditingController();
   final _portController = TextEditingController();
+  final _basicUsernameController = TextEditingController();
+  final _basicPasswordController = TextEditingController();
+  bool _basicEnabled = false;
 
   @override
   void initState() {
@@ -32,19 +36,30 @@ class _ServerSettingsPageState extends State<ServerSettingsPage> {
       final local = sl<AppLocalDataSource>();
       final savedHost = await local.getServerHost();
       final savedPort = await local.getServerPort();
+      final savedBasicEnabled = await local.getBasicAuthEnabled();
+      final savedUsername = await local.getBasicAuthUsername();
+      final savedPassword = await local.getBasicAuthPassword();
       if (savedHost != null && savedPort != null && mounted) {
         _hostController.text = savedHost;
         _portController.text = savedPort.toString();
         // Keep provider state consistent so other parts reflect the same values
         appProvider.setServerConfig(savedHost, savedPort);
       }
+      if (mounted) {
+        _basicEnabled = savedBasicEnabled ?? false;
+        _basicUsernameController.text = savedUsername ?? '';
+        _basicPasswordController.text = savedPassword ?? '';
+        setState(() {});
+      }
     });
   }
 
   @override
   void dispose() {
     _hostController.dispose();
     _portController.dispose();
+    _basicUsernameController.dispose();
+    _basicPasswordController.dispose();
     super.dispose();
   }
 
@@ -67,13 +82,19 @@ class _ServerSettingsPageState extends State<ServerSettingsPage> {
           ),
         ],
       ),
+      resizeToAvoidBottomInset: true,
       body: Padding(
         padding: const EdgeInsets.all(AppConstants.defaultPadding),
         child: Form(
           key: _formKey,
-          child: Column(
-            crossAxisAlignment: CrossAxisAlignment.stretch,
-            children: [
+          child: SingleChildScrollView(
+            padding: EdgeInsets.only(
+              bottom: AppConstants.defaultPadding +
+                  MediaQuery.of(context).viewInsets.bottom,
+            ),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.stretch,
+              children: [
               // Connection status card
               Consumer<AppProvider>(
                 builder: (context, appProvider, child) {
@@ -195,6 +216,56 @@ class _ServerSettingsPageState extends State<ServerSettingsPage> {
                         onPressed: _resetToDefault,
                         child: const Text('Reset to Default'),
                       ),
+
+                      const SizedBox(height: AppConstants.defaultPadding),
+
+                      // Basic authentication section
+                      SwitchListTile(
+                        value: _basicEnabled,
+                        onChanged: (val) {
+                          setState(() {
+                            _basicEnabled = val;
+                          });
+                        },
+                        title: const Text('Enable Basic Authentication'),
+                        subtitle: const Text(
+                          'If enabled, requests will include Basic Authorization header.',
+                        ),
+                      ),
+
+                      if (_basicEnabled) ...[
+                        const SizedBox(height: AppConstants.smallPadding),
+                        TextFormField(
+                          controller: _basicUsernameController,
+                          decoration: const InputDecoration(
+                            labelText: 'Username',
+                            prefixIcon: Icon(Icons.person_outline),
+                          ),
+                          validator: (value) {
+                            if (!_basicEnabled) return null;
+                            if (value == null || value.isEmpty) {
+                              return 'Please enter username';
+                            }
+                            return null;
+                          },
+                        ),
+                        const SizedBox(height: AppConstants.smallPadding),
+                        TextFormField(
+                          controller: _basicPasswordController,
+                          decoration: const InputDecoration(
+                            labelText: 'Password',
+                            prefixIcon: Icon(Icons.lock_outline),
+                          ),
+                          obscureText: true,
+                          validator: (value) {
+                            if (!_basicEnabled) return null;
+                            if (value == null || value.isEmpty) {
+                              return 'Please enter password';
+                            }
+                            return null;
+                          },
+                        ),
+                      ],
                     ],
                   ),
                 ),
@@ -231,6 +302,7 @@ class _ServerSettingsPageState extends State<ServerSettingsPage> {
                 ],
               ),
             ],
+            ),
           ),
         ),
       ),
@@ -256,12 +328,31 @@ class _ServerSettingsPageState extends State<ServerSettingsPage> {
     final success = await appProvider.updateServerConfig(mappedHost, port);
 
     if (success && mounted) {
+      // Save Basic auth settings
+      final local = sl<AppLocalDataSource>();
+      await local.saveBasicAuthEnabled(_basicEnabled);
+      await local.saveBasicAuthUsername(_basicUsernameController.text.trim());
+      await local.saveBasicAuthPassword(_basicPasswordController.text.trim());
+
+      // Apply to Dio client
+      final dioClient = sl<DioClient>();
+      if (_basicEnabled &&
+          _basicUsernameController.text.trim().isNotEmpty &&
+          _basicPasswordController.text.trim().isNotEmpty) {
+        dioClient.setBasicAuth(
+          _basicUsernameController.text.trim(),
+          _basicPasswordController.text.trim(),
+        );
+      } else {
+        dioClient.clearAuth();
+      }
+
       final info = 'Settings saved: http://$mappedHost:$port';
       ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text(info)));
       if (mappedHost != host && mounted) {
         ScaffoldMessenger.of(context).showSnackBar(
           const SnackBar(
-            content: Text('Android emulator detected: mapped localhost to 10.0.2.2'),
+          content: Text('Android emulator detected: mapped localhost to 10.0.2.2'),
           ),
         );
       }
