diff --git a/KeychainSwift.xcodeproj/project.pbxproj b/KeychainSwift.xcodeproj/project.pbxproj index 6119eeb..e6fceb3 100644 --- a/KeychainSwift.xcodeproj/project.pbxproj +++ b/KeychainSwift.xcodeproj/project.pbxproj @@ -27,6 +27,11 @@ 508566A81FA34EB1004208ED /* macOS_Tests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 508566991FA34EB1004208ED /* macOS_Tests.swift */; }; 508566A91FA34EB1004208ED /* SynchronizableTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5085669A1FA34EB1004208ED /* SynchronizableTests.swift */; }; 508566AA1FA34EB1004208ED /* SynchronizableTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5085669A1FA34EB1004208ED /* SynchronizableTests.swift */; }; + 667F3ACD27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */ = {isa = PBXBuildFile; fileRef = 667F3ACC27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift */; }; + 667F3ACE27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */ = {isa = PBXBuildFile; fileRef = 667F3ACC27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift */; }; + 667F3ACF27D8F8A300E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */ = {isa = PBXBuildFile; fileRef = 667F3ACC27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift */; }; + 667F3AD027D8F8A400E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */ = {isa = PBXBuildFile; fileRef = 667F3ACC27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift */; }; + 667F3AD127D8F8A500E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */ = {isa = PBXBuildFile; fileRef = 667F3ACC27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift */; }; 7E3A6B7E1D3F6779007C5B1F /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7E3A6B7D1D3F6779007C5B1F /* AppDelegate.swift */; }; 7E3A6B801D3F6779007C5B1F /* ViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7E3A6B7F1D3F6779007C5B1F /* ViewController.swift */; }; 7E3A6B821D3F6779007C5B1F /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 7E3A6B811D3F6779007C5B1F /* Assets.xcassets */; }; @@ -130,6 +135,7 @@ 508566981FA34EB1004208ED /* Info.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; 508566991FA34EB1004208ED /* macOS_Tests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = macOS_Tests.swift; sourceTree = ""; }; 5085669A1FA34EB1004208ED /* SynchronizableTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = SynchronizableTests.swift; sourceTree = ""; }; + 667F3ACC27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = KeychainSwiftAccessControlFlag.swift; sourceTree = ""; }; 7E3A6B601D3F62C2007C5B1F /* macOS Tests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "macOS Tests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; }; 7E3A6B7B1D3F6779007C5B1F /* macOS Demo.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "macOS Demo.app"; sourceTree = BUILT_PRODUCTS_DIR; }; 7E3A6B7D1D3F6779007C5B1F /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; @@ -299,6 +305,7 @@ 7ED6C98F1B1C128100FE8090 /* TegKeychainConstants.swift */, 7ED6C9711B1C118F00FE8090 /* KeychainSwift.h */, 7ED6C96F1B1C118F00FE8090 /* Supporting Files */, + 667F3ACC27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift */, ); path = Sources; sourceTree = ""; @@ -717,6 +724,7 @@ buildActionMask = 2147483647; files = ( 232B4C821BC2995D001F2B7A /* KeychainSwift.swift in Sources */, + 667F3ACE27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */, 232B4C831BC2995D001F2B7A /* KeychainSwiftAccessOptions.swift in Sources */, 232B4C841BC2995D001F2B7A /* TegKeychainConstants.swift in Sources */, ); @@ -727,6 +735,7 @@ buildActionMask = 2147483647; files = ( 232B4C921BC29991001F2B7A /* KeychainSwift.swift in Sources */, + 667F3ACF27D8F8A300E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */, 232B4C931BC29991001F2B7A /* KeychainSwiftAccessOptions.swift in Sources */, 232B4C941BC29991001F2B7A /* TegKeychainConstants.swift in Sources */, ); @@ -737,6 +746,7 @@ buildActionMask = 2147483647; files = ( 23E785681BDA415000B7564A /* KeychainSwift.swift in Sources */, + 667F3AD027D8F8A400E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */, 23E785691BDA415000B7564A /* KeychainSwiftAccessOptions.swift in Sources */, 23E7856A1BDA415000B7564A /* TegKeychainConstants.swift in Sources */, ); @@ -769,6 +779,7 @@ buildActionMask = 2147483647; files = ( 7ED6C9911B1C128100FE8090 /* KeychainSwiftAccessOptions.swift in Sources */, + 667F3ACD27D8F89500E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */, 7ED6C9901B1C128100FE8090 /* KeychainSwift.swift in Sources */, 7ED6C9921B1C128100FE8090 /* TegKeychainConstants.swift in Sources */, ); @@ -783,6 +794,7 @@ 7ED6C9971B1C12B300FE8090 /* KeychainSwiftAccessOptions.swift in Sources */, C7E1DE4C1E4B7C9F003818F6 /* ConcurrencyTests.swift in Sources */, 7ED6C9961B1C12B100FE8090 /* KeychainSwift.swift in Sources */, + 667F3AD127D8F8A500E0BBF1 /* KeychainSwiftAccessControlFlag.swift in Sources */, 508566A91FA34EB1004208ED /* SynchronizableTests.swift in Sources */, 5085669B1FA34EB1004208ED /* AccessGroupTests.swift in Sources */, 7ED6C9981B1C12B500FE8090 /* TegKeychainConstants.swift in Sources */, @@ -1161,7 +1173,7 @@ GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; GCC_WARN_UNUSED_FUNCTION = YES; GCC_WARN_UNUSED_VARIABLE = YES; - IPHONEOS_DEPLOYMENT_TARGET = 9.0; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; MTL_ENABLE_DEBUG_INFO = YES; ONLY_ACTIVE_ARCH = YES; SDKROOT = iphoneos; @@ -1216,7 +1228,7 @@ GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; GCC_WARN_UNUSED_FUNCTION = YES; GCC_WARN_UNUSED_VARIABLE = YES; - IPHONEOS_DEPLOYMENT_TARGET = 9.0; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; MTL_ENABLE_DEBUG_INFO = NO; SDKROOT = iphoneos; SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule"; diff --git a/Sources/KeychainSwift.swift b/Sources/KeychainSwift.swift index 55bed1f..3e163da 100644 --- a/Sources/KeychainSwift.swift +++ b/Sources/KeychainSwift.swift @@ -52,19 +52,20 @@ open class KeychainSwift { Stores the text value in the keychain item under the given key. - - parameter key: Key under which the text value is stored in the keychain. - - parameter value: Text string to be written to the keychain. - - parameter withAccess: Value that indicates when your app needs access to the text in the keychain item. By default the .AccessibleWhenUnlocked option is used that permits the data to be accessed only while the device is unlocked by the user. +- parameter key: Key under which the text value is stored in the keychain. +- parameter value: Text string to be written to the keychain. +- parameter withAccess: Value that indicates when your app needs access to the text in the keychain item. By default the .AccessibleWhenUnlocked option is used that permits the data to be accessed only while the device is unlocked by the user. +- parameter withControlFlag: Value that indicates when your value in keychain can be read and written. - returns: True if the text was successfully written to the keychain. */ @discardableResult open func set(_ value: String, forKey key: String, - withAccess access: KeychainSwiftAccessOptions? = nil) -> Bool { + withAccess access: KeychainSwiftAccessOptions? = nil, withControlFlag controlFlag: KeychainSwiftAccessControlFlag? = nil) -> Bool { if let value = value.data(using: String.Encoding.utf8) { - return set(value, forKey: key, withAccess: access) + return set(value, forKey: key, withAccess: access, withControlFlag: controlFlag) } return false @@ -74,16 +75,17 @@ open class KeychainSwift { Stores the data in the keychain item under the given key. - - parameter key: Key under which the data is stored in the keychain. - - parameter value: Data to be written to the keychain. - - parameter withAccess: Value that indicates when your app needs access to the text in the keychain item. By default the .AccessibleWhenUnlocked option is used that permits the data to be accessed only while the device is unlocked by the user. +- parameter key: Key under which the data is stored in the keychain. +- parameter value: Data to be written to the keychain. +- parameter withAccess: Value that indicates when your app needs access to the text in the keychain item. By default the .AccessibleWhenUnlocked option is used that permits the data to be accessed only while the device is unlocked by the user. +- parameter withControlFlag: Value that indicates when your value in keychain can be read and written. - returns: True if the text was successfully written to the keychain. */ @discardableResult open func set(_ value: Data, forKey key: String, - withAccess access: KeychainSwiftAccessOptions? = nil) -> Bool { + withAccess access: KeychainSwiftAccessOptions? = nil, withControlFlag controlFlag: KeychainSwiftAccessControlFlag? = nil) -> Bool { // The lock prevents the code to be run simultaneously // from multiple threads which may result in crashing @@ -95,13 +97,28 @@ open class KeychainSwift { let accessible = access?.value ?? KeychainSwiftAccessOptions.defaultOption.value let prefixedKey = keyWithPrefix(key) + var accessWithFlag:Any = accessible as Any + + var query: [String : Any] + + if let control = controlFlag{ + accessWithFlag = SecAccessControlCreateWithFlags(nil, accessible as CFString, control.value, nil) as Any + query = [ + KeychainSwiftConstants.klass : kSecClassGenericPassword, + KeychainSwiftConstants.attrAccount : prefixedKey, + KeychainSwiftConstants.valueData : value, + KeychainSwiftConstants.accessControl : accessWithFlag + ] + }else{ + query = [ + KeychainSwiftConstants.klass : kSecClassGenericPassword, + KeychainSwiftConstants.attrAccount : prefixedKey, + KeychainSwiftConstants.valueData : value, + KeychainSwiftConstants.accessible : accessible + ] + } + - var query: [String : Any] = [ - KeychainSwiftConstants.klass : kSecClassGenericPassword, - KeychainSwiftConstants.attrAccount : prefixedKey, - KeychainSwiftConstants.valueData : value, - KeychainSwiftConstants.accessible : accessible - ] query = addAccessGroupWhenPresent(query) query = addSynchronizableIfRequired(query, addingItems: true) @@ -125,12 +142,12 @@ open class KeychainSwift { */ @discardableResult open func set(_ value: Bool, forKey key: String, - withAccess access: KeychainSwiftAccessOptions? = nil) -> Bool { + withAccess access: KeychainSwiftAccessOptions? = nil, withControlFlag controlFlag: KeychainSwiftAccessControlFlag? = nil) -> Bool { let bytes: [UInt8] = value ? [1] : [0] let data = Data(bytes) - return set(data, forKey: key, withAccess: access) + return set(data, forKey: key, withAccess: access,withControlFlag: controlFlag) } /** diff --git a/Sources/KeychainSwiftAccessControlFlag.swift b/Sources/KeychainSwiftAccessControlFlag.swift new file mode 100644 index 0000000..b1eb4d3 --- /dev/null +++ b/Sources/KeychainSwiftAccessControlFlag.swift @@ -0,0 +1,70 @@ +// +// KeychainSwiftAccessControlFlag.swift +// KeychainSwift +// +// Created by Salman Soumik on 3/9/22. +// Copyright © 2022 Evgenii Neumerzhitckii. All rights reserved. +// + +import Security + +/** + +These flags are used to determine when a keychain item should be readable. The default value is userPresence. + +*/ +public enum KeychainSwiftAccessControlFlag { + + /** + + Constraint: Touch ID (any finger) or Face ID. Touch ID or Face ID must be available. With Touch ID + at least one finger must be enrolled. With Face ID user has to be enrolled. Item is still accessible by Touch ID even + if fingers are added or removed. Item is still accessible by Face ID if user is re-enrolled. + + */ + case biometryAny + + /** + + Constraint: Touch ID from the set of currently enrolled fingers. Touch ID must be available and at least one finger must + be enrolled. When fingers are added or removed, the item is invalidated. When Face ID is re-enrolled this item is invalidated. + + */ + case biometryCurrentSet + + /** + User presence policy using biometry or Passcode. Biometry does not have to be available or enrolled. Item is still + accessible by Touch ID even if fingers are added or removed. Item is still accessible by Face ID if user is re-enrolled. + + */ + case userPresence + + /** + + Constraint: Device passcode + + */ + case devicePasscode + + + + static var defaultOption: KeychainSwiftAccessControlFlag { + return .userPresence + } + + var value: SecAccessControlCreateFlags { + switch self { + case .biometryAny: + return .biometryAny + + case .biometryCurrentSet: + return .biometryCurrentSet + + case .userPresence: + return .userPresence + + case .devicePasscode: + return .devicePasscode + } + } +} diff --git a/Sources/TegKeychainConstants.swift b/Sources/TegKeychainConstants.swift index 0ac13df..8c7c362 100644 --- a/Sources/TegKeychainConstants.swift +++ b/Sources/TegKeychainConstants.swift @@ -12,6 +12,8 @@ public struct KeychainSwiftConstants { */ public static var accessible: String { return toString(kSecAttrAccessible) } + + public static var accessControl: String { return toString(kSecAttrAccessControl) } /// Used for specifying a String key when setting/getting a Keychain value. public static var attrAccount: String { return toString(kSecAttrAccount) } diff --git a/Tests/KeychainSwiftTests/KeychainSwiftTests.swift b/Tests/KeychainSwiftTests/KeychainSwiftTests.swift index 3cea865..e524a23 100644 --- a/Tests/KeychainSwiftTests/KeychainSwiftTests.swift +++ b/Tests/KeychainSwiftTests/KeychainSwiftTests.swift @@ -33,6 +33,13 @@ class KeychainSwiftTests: XCTestCase { let accessValue = obj.lastQueryParameters?[KeychainSwiftConstants.accessible] as? String XCTAssertEqual(KeychainSwiftAccessOptions.accessibleAfterFirstUnlock.value, accessValue!) } + + func testSetWithAccessControlFlag() { + obj.set("hello :)", forKey: "key 1", withAccess: .accessibleAfterFirstUnlock, withControlFlag: .userPresence) + let accessValue = (obj.lastQueryParameters?[KeychainSwiftConstants.accessible]) as! SecAccessControl + let checkAccessValue = SecAccessControlCreateWithFlags(nil, (KeychainSwiftAccessOptions.accessibleAfterFirstUnlock.value) as CFString, .userPresence, nil)! + XCTAssertEqual(checkAccessValue, accessValue) + } // MARK: - Set data // -----------------------