Insecure Storage: Insufficient Data Protection

識別的方法將資料寫入加密設定可能不足的檔案。

資料保護 API 設計為允許應用程式宣告何時可以存取金鑰鏈中的項目以及檔案系統上儲存的檔案。這適用於大多數的檔案和資料庫 API，包括 NSFileManager、CoreData、NSData 和 SQLite。開發人員可以藉由將四種保護類別之一指定給某個指定資源，指示基礎檔案系統使用衍生自裝置 UID 和使用者密碼兩者的金鑰，或是使用完全以裝置 UID 為基礎的金鑰，對該資源進行加密 (以及何時自動對其進行解密)。

資料保護類別定義於 NSFileManager，而常數則應該被指派為與 NSFileManager 實例相關聯之 Dictionary 中的 NSFileProtectionKey 金鑰值，以及可以透過使用 NSFileManager 函數 (包括 setAttributes(_:ofItemAtPath:)、attributesOfItemAtPath(_:) 和 createFileAtPath(_:contents:attributes:)) 建立檔案或修改其資料保護類別。此外，相對應的資料保護常數會針對 NSDataWritingOptions 列舉中的 NSData 物件定義，以便可以做為 options 引數傳遞到 NSData 函數
writeToFile(_:options:)。NSFileManager 和 NSData 的各種資料保護類別常數定義如下所示：

-NSFileProtectionComplete, NSDataWritingOptions.DataWritingFileProtectionComplete:
資源會以加密格式儲存在磁碟，當裝置處於鎖定狀態或者正在開機時，將無法進行讀取或寫入。
可用於 iOS 4.0 及更新版本。
-NSFileProtectionCompleteUnlessOpen, NSDataWritingOptions.DataWritingFileProtectionCompleteUnlessOpen:
資源會以加密格式儲存在磁碟。當裝置處於鎖定狀態時，可以建立資源，但是一旦關閉資源，就無法再次開啟，直到裝置解除鎖定。如果在解除鎖定時開啟了資源，則可以如常繼續存取資源，即使使用者鎖定了裝置也無妨。
可用於 iOS 5.0 及更新版本。
-NSFileProtectionCompleteUntilFirstUserAuthentication, NSDataWritingOptions.DataWritingFileProtectionCompleteUntilFirstUserAuthentication:
資源會以加密格式儲存在磁碟，只有在裝置開機之後，才能存取資源。在使用者首次解除鎖定裝置之後，您的應用程式可以存取資源，即使使用者之後鎖定了裝置，還是可以繼續存取。
可用於 iOS 5.0 及更新版本。
-NSFileProtectionNone, NSDataWritingOptions.DataWritingFileProtectionNone:
資源沒有與其相關聯的特殊保護。任何時候都可以讀取或寫入資源。
可用於 iOS 4.0 及更新版本。

所以，雖然以 NSFileProtectionCompleteUnlessOpen 或 NSFileProtectionCompleteUntilFirstUserAuthentication 標記檔案將會使用衍生自使用者密碼和裝置 UID 的金鑰為其加密，但是在某些情況下資料還是保持可存取的狀態。因此，使用 NSFileProtectionCompleteUnlessOpen 或 NSFileProtectionCompleteUntilFirstUserAuthentication 時應該仔細進行檢閱，以確定是否保證提供進一步的 NSFileProtectionComplete 保護。

範例 1：在以下範例中，只有在使用者開啟裝置並首次提供密碼後 (直到下次重新開機)，所指定的檔案才受到保護：

...
let documentsPath = NSURL(fileURLWithPath: NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true)[0])
let filename = "\(documentsPath)/tmp_activeTrans.txt"
let protection = [NSFileProtectionKey: NSFileProtectionCompleteUntilFirstUserAuthentication]
do {
    try NSFileManager.defaultManager().setAttributes(protection, ofItemAtPath: filename)
} catch let error as NSError {
    NSLog("Unable to change attributes: \(error.debugDescription)")
}
...
BOOL ok = textToWrite.writeToFile(filename, atomically:true)
...

範例 2：在以下範例中，只有在使用者開啟裝置並首次提供密碼後 (直到下次重新開機)，所指定的資料才受到保護：

...
let documentsPath = NSURL(fileURLWithPath: NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true)[0])
let filename = "\(documentsPath)/tmp_activeTrans.txt"
...
BOOL ok = textData.writeToFile(filepath, options: .DataWritingFileProtectionCompleteUntilFirstUserAuthentication);
...