[NL-66]: 기기 기반 고유값 발급, 저장 로직 구현 (#35)

* [NL-66]: KeyChain 로직 구현

* [NL-66]: 기기 기반 고유값 발급, 저장 로직 구현

Author: TTOzzi

App/Sources/AppDelegate.swift

@@ -1,3 +1,4 @@
+import Auth
 import DIInjector
 import Lib
 import Onboarding
@@ -11,7 +12,7 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
     _ application: UIApplication,
     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
   ) -> Bool {
-
+    DeviceUUIDManager.setup()
     registRouter()
 
     return true

Common/Auth/Sources/DeviceUUIDManager.swift

@@ -0,0 +1,45 @@
+//
+//  DeviceUUIDManager.swift
+//  Auth
+//
+//  Created by ttozzi on 8/15/25.
+//
+
+import Foundation
+import Lib
+
+public final class DeviceUUIDManager {
+  
+  private enum Constant {
+    static let uuidKey = "device-uuid"
+  }
+  
+  public static let shared = DeviceUUIDManager()
+  public var deviceUUID: String {
+    do {
+      return try KeyChainService.getString(forKey: Constant.uuidKey)
+    } catch {
+      let newUUID = UUID().uuidString
+      try? KeyChainService.set(newUUID, forKey: Constant.uuidKey)
+      return newUUID
+    }
+  }
+  
+  private init() {}
+  
+  func regenerateUUID() -> String {
+    let newUUID = UUID().uuidString
+    try? KeyChainService.set(newUUID, forKey: Constant.uuidKey)
+    return newUUID
+  }
+  
+  func deleteUUID() {
+    try? KeyChainService.remove(forKey: Constant.uuidKey)
+  }
+}
+
+public extension DeviceUUIDManager {
+  static func setup() {
+    _ = shared.deviceUUID
+  }
+}

Common/Auth/Sources/empty.swift

@@ -0,0 +1,143 @@
+//
+//  KeyChainService.swift
+//  Auth
+//
+//  Created by ttozzi on 8/15/25.
+//
+
+import Foundation
+import Security
+
+public final class KeyChainService {
+  
+  enum KeychainError: Error {
+    case duplicateEntry
+    case unknown(OSStatus)
+    case itemNotFound
+    case invalidItemFormat
+    case unhandledError(status: OSStatus)
+  }
+  
+  private static let service = "com.hanbang.satto"
+  
+  private static func set(_ data: Data, forKey key: String) throws {
+    let query: [String: Any] = [
+      kSecClass as String: kSecClassGenericPassword,
+      kSecAttrService as String: service,
+      kSecAttrAccount as String: key
+    ]
+    
+    let attributes: [String: Any] = [
+      kSecValueData as String: data
+    ]
+    
+    let status = SecItemUpdate(query as CFDictionary, attributes as CFDictionary)
+    
+    switch status {
+    case errSecSuccess:
+      return
+    case errSecItemNotFound:
+      try add(data, forKey: key)
+    default:
+      throw KeychainError.unhandledError(status: status)
+    }
+  }
+  
+  private static func get(forKey key: String) throws -> Data {
+    let query: [String: Any] = [
+      kSecClass as String: kSecClassGenericPassword,
+      kSecAttrService as String: service,
+      kSecAttrAccount as String: key,
+      kSecReturnData as String: true,
+      kSecMatchLimit as String: kSecMatchLimitOne
+    ]
+    
+    var result: AnyObject?
+    let status = SecItemCopyMatching(query as CFDictionary, &result)
+    
+    guard status == errSecSuccess else {
+      if status == errSecItemNotFound {
+        throw KeychainError.itemNotFound
+      }
+      throw KeychainError.unhandledError(status: status)
+    }
+    
+    guard let data = result as? Data else {
+      throw KeychainError.invalidItemFormat
+    }
+    
+    return data
+  }
+  
+  public static func remove(forKey key: String) throws {
+    let query: [String: Any] = [
+      kSecClass as String: kSecClassGenericPassword,
+      kSecAttrService as String: service,
+      kSecAttrAccount as String: key
+    ]
+    
+    let status = SecItemDelete(query as CFDictionary)
+    
+    guard status == errSecSuccess || status == errSecItemNotFound else {
+      throw KeychainError.unhandledError(status: status)
+    }
+  }
+  
+  static func hasKey(_ key: String) -> Bool {
+    do {
+      _ = try get(forKey: key)
+      return true
+    } catch {
+      return false
+    }
+  }
+  
+  private static func add(_ data: Data, forKey key: String) throws {
+    let query: [String: Any] = [
+      kSecClass as String: kSecClassGenericPassword,
+      kSecAttrService as String: service,
+      kSecAttrAccount as String: key,
+      kSecValueData as String: data
+    ]
+    
+    let status = SecItemAdd(query as CFDictionary, nil)
+    
+    switch status {
+    case errSecSuccess:
+      return
+    case errSecDuplicateItem:
+      throw KeychainError.duplicateEntry
+    default:
+      throw KeychainError.unhandledError(status: status)
+    }
+  }
+}
+
+public extension KeyChainService {
+  static func set(_ string: String, forKey key: String) throws {
+    guard let data = string.data(using: .utf8) else {
+      throw KeychainError.invalidItemFormat
+    }
+    try set(data, forKey: key)
+  }
+  
+  static func getString(forKey key: String) throws -> String {
+    let data = try get(forKey: key)
+    guard let string = String(data: data, encoding: .utf8) else {
+      throw KeychainError.invalidItemFormat
+    }
+    return string
+  }
+}
+
+public extension KeyChainService {
+  static func set<T: Codable>(_ object: T, forKey key: String) throws {
+    let data = try JSONEncoder().encode(object)
+    try set(data, forKey: key)
+  }
+  
+  static func get<T: Codable>(_ type: T.Type, forKey key: String) throws -> T {
+    let data = try get(forKey: key)
+    return try JSONDecoder().decode(type, from: data)
+  }
+}

Common/Lib/Sources/KeyChain/KeyChainService.swift

@@ -24,7 +24,12 @@ struct CommonLayer: Layer {
           ]
         )
       ),
-      .createTarget(name: "Auth"),
+      .createTarget(
+        name: "Auth",
+        dependencies: [
+          .target(name: "Lib"),
+        ]
+      ),
       .createTarget(
         name: "Base",
         dependencies: [