· Flutter 개발 · 4 min read
flutter_secure_storage로 민감 정보 안전하게 저장
SharedPreferences는 왜 안 되나
SharedPreferences에 저장된 데이터는 암호화되지 않는다. Android에서는 /data/data/{package}/shared_prefs/에 평문으로 저장되기 때문에, 루팅된 기기나 백업 파일에서 데이터가 노출될 수 있다.
JWT Access Token, Refresh Token 같은 민감한 인증 정보는 반드시 암호화된 저장소에 보관해야 한다.
flutter_secure_storage
flutter_secure_storage는 플랫폼별 보안 저장소를 사용한다:
- iOS: Keychain Services
- Android: Android Keystore + EncryptedSharedPreferences
dependencies:
flutter_secure_storage: ^9.2.4
기본 사용법
final storage = const FlutterSecureStorage();
// 저장
await storage.write(key: 'access_token', value: token);
// 읽기
final token = await storage.read(key: 'access_token');
// 삭제
await storage.delete(key: 'access_token');
// 모두 삭제 (로그아웃 시)
await storage.deleteAll();
TokenManager 구현
이전 편에서 소개한 TokenManager를 flutter_secure_storage 기반으로 구현한다:
// data/auth/token_manager.dart
class TokenManager {
final FlutterSecureStorage _storage;
static const _keyAccessToken = 'smarthome_access_token';
static const _keyRefreshToken = 'smarthome_refresh_token';
static const _keyExpiresAt = 'smarthome_token_expires_at';
static const _keyUserId = 'smarthome_user_id';
const TokenManager(this._storage);
Future<void> saveTokens({
required String accessToken,
required String refreshToken,
required DateTime expiresAt,
required String userId,
}) async {
await Future.wait([
_storage.write(key: _keyAccessToken, value: accessToken),
_storage.write(key: _keyRefreshToken, value: refreshToken),
_storage.write(
key: _keyExpiresAt,
value: expiresAt.millisecondsSinceEpoch.toString(),
),
_storage.write(key: _keyUserId, value: userId),
]);
}
Future<String?> getAccessToken() async {
return _storage.read(key: _keyAccessToken);
}
Future<String?> getRefreshToken() async {
return _storage.read(key: _keyRefreshToken);
}
Future<String?> getUserId() async {
return _storage.read(key: _keyUserId);
}
Future<bool> hasValidTokens() async {
final accessToken = await getAccessToken();
final refreshToken = await getRefreshToken();
return accessToken != null && refreshToken != null;
}
Future<void> clearAll() async {
await _storage.deleteAll();
}
}
Android 백업 설정
Android 자동 백업 기능이 켜져 있으면 Secure Storage 데이터가 다른 기기로 복원될 수 있다. 보안을 위해 백업에서 제외한다:
<!-- android/app/src/main/AndroidManifest.xml -->
<application
android:allowBackup="true"
android:fullBackupContent="@xml/backup_rules">
<!-- android/app/src/main/res/xml/backup_rules.xml -->
<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
<exclude domain="sharedpref" path="FlutterSecureStorage"/>
</full-backup-content>
앱 삭제 후 재설치 동작
iOS에서는 앱을 삭제해도 Keychain 데이터가 남아있다. 재설치 후 이전 토큰이 그대로 남아있어서 예상치 못한 동작이 생길 수 있다.
처음 앱을 실행할 때 이전 설치의 데이터인지 확인하고 지우는 처리를 추가했다:
// 앱 첫 실행 여부 확인
Future<void> handleFirstLaunchCleanup() async {
final isFirstLaunch = !GetStorage().hasData('app_launched');
if (isFirstLaunch) {
// 이전 설치 데이터 정리 (iOS Keychain은 앱 삭제 후에도 남음)
await _tokenManager.clearAll();
GetStorage().write('app_launched', true);
}
}
보안 고려사항
Secure Storage를 쓴다고 해서 완벽한 보안이 되는 건 아니다. 루팅된 Android 기기나 탈옥된 iOS에서는 Keychain 데이터도 접근 가능할 수 있다. 그래도 일반 SharedPreferences보다는 훨씬 안전하다.
추가로 고려할 수 있는 보안 조치:
- 루팅/탈옥 기기 감지 후 경고
- 생체 인증으로 앱 잠금
- 토큰 유효 기간 짧게 유지
다음 편부터는 IoT 모니터링 대시보드 파트다. 산업용 IoT 기기를 앱에서 제어하는 이야기다.