Εφαρμογή ασφαλούς αποθήκευσης δεδομένων με το μπρελόκ στην Ίο

⁇ αποθήκευσης κλειδαριών

Πριν από την αποθήκευση οτιδήποτε, πρέπει να αποφασίσετε για την Κλειδί αλυσίδας κατηγορίας στοιχείων. Το πιο κοινό για γενικούς κωδικούς πρόσβασης είναι . Για κωδικούς πρόσβασης στο διαδίκτυο ή πιστοποιητικά, υπάρχουν και άλλες κατηγορίες. Κάθε αντικείμενο αναφέρεται από ένα σύνολο χαρακτηριστικών ⁇ ένα λεξικό (CFDictionary) που περιγράφει το στοιχείο.

Η βασική ροή ακολουθεί πάντα αυτό το μοτίβο:

1. Κατασκευή ενός λεξικού ερωτημάτων με την κλάση και τα χαρακτηριστικά του αντικειμένου.
2. λειτουργία [, , , ].
3. Ελέγξτε τον επιστρεφόμενο (] ή έναν κωδικό σφάλματος).

Πριν από την εγγραφή κώδικα, εισαγωγή της ενότητας ασφαλείας:

import Security
import Foundation // for Data and String utilities

Αποθήκευση δεδομένων στο μπρελόκ

Εγγραφή ενός γενικού κωδικού πρόσβασης

Για να αποθηκεύσετε ένα κουπόνι (π.χ., ένα JWT) για τον τρέχοντα χρήστη:

func saveToken(_ token: String, forAccount account: String) -> Bool {
 guard let tokenData = token.data(using: .utf8) else { return false }

 let query: [String: Any] = [
 kSecClass as String: kSecClassGenericPassword,
 kSecAttrAccount as String: account,
 kSecValueData as String: tokenData,
 // Optional: restrict access to when device is unlocked
 kSecAttrAccessible as String: kSecAttrAccessibleWhenUnlockedThisDeviceOnly
 ]

 // Delete any existing item first to avoid duplicates
 SecItemDelete(query as CFDictionary)

 let status = SecItemAdd(query as CFDictionary, nil)
 return status == errSecSuccess
}

Βασικά σημεία:

• ενεργεί ως πρωταρχικό κλειδί· επιλέγει μια μοναδική συμβολοσειρά (π.χ., το αναγνωριστικό χρήστη ή μια σταθερά όπως ).
• ελέγχει όταν το στοιχείο μπορεί να διαβαστεί. Χρησιμοποιήστε [[LFT:17]] για καλύτερη ασφάλεια. Αποτρέπει το αντίγραφο ασφαλείας iCloud και περιορίζει την πρόσβαση στην τρέχουσα συσκευή.
• Καλούμε πριν προσθέσουμε για να αποφύγουμε τη συσσώρευση διπλών αντικειμένων. Εναλλακτικά, μπορείτε να χρησιμοποιήσετε .

Προσθήκη ελέγχου πρόσβασης (Βιομετρία ή κωδικός πρόσβασης)

Για εξαιρετικά ευαίσθητα δεδομένα, απαιτείται το Touch ID ή το Face ID πριν από την ανάγνωση:

let accessControl = SecAccessControlCreateWithFlags(
 nil,
 kSecAttrAccessibleWhenUnlockedThisDeviceOnly,
 .userPresence, // requires passcode, Face ID, or Touch ID
 nil
)

let query: [String: Any] = [
 kSecClass as String: kSecClassGenericPassword,
 kSecAttrAccount as String: account,
 kSecValueData as String: tokenData,
 kSecAttrAccessControl as String: accessControl as Any
]
SecItemAdd(query as CFDictionary, nil)

Τώρα οποιαδήποτε κλήση για αυτό το στοιχείο θα ενεργοποιήσει μια βιομετρική ή κωδικό πρόσβασης. Χρησιμοποιήστε [[LFT:22]] από την ΤοπικήΑυθεντικότητα για να χειριστείτε την αλληλεπίδραση χρήστη με χάρη.

Ανάκτηση δεδομένων από το μπρελόκ

Για να διαβάσετε το αποθηκευμένο ενδεικτικό:

func retrieveToken(forAccount account: String) -> String? {
 let query: [String: Any] = [
 kSecClass as String: kSecClassGenericPassword,
 kSecAttrAccount as String: account,
 kSecReturnData as String: true,
 kSecMatchLimit as String: kSecMatchLimitOne
 ]

 var item: CFTypeRef?
 let status = SecItemCopyMatching(query as CFDictionary, &item)

 guard status == errSecSuccess,
 let data = item as? Data,
 let token = String(data: data, encoding: .utf8) else {
 return nil
 }
 return token
}

Ορισμός σε για να πάρετε πίσω τα δεδομένα. Χρησιμοποιήστε για να ανακτήσετε ένα μόνο αποτέλεσμα. Αν παραλείψετε το όριο, το API μπορεί να επιστρέψει μια συστοιχία.

Σημαντικό: Όταν χρησιμοποιείται έλεγχος πρόσβασης (βιομετρία), η κλήση μπορεί να επιστρέψει [ αν ο χρήστης ακυρώσει. Χειριστείτε αυτή την περίπτωση ξεχωριστά και ποτέ μην πέσετε πίσω στην αποθήκευση απλού κειμένου.

Ενημέρωση και διαγραφή αντικειμένων κλειδαριών

Ενημέρωση Υφιστάμενου Αντικειμένου

Αντί να διαγραφεί και να επαναπροστεθεί, χρησιμοποιήστε :

func updateToken(_ newToken: String, forAccount account: String) -> Bool {
 guard let newData = newToken.data(using: .utf8) else { return false }

 let query: [String: Any] = [
 kSecClass as String: kSecClassGenericPassword,
 kSecAttrAccount as String: account
 ]

 let attributesToUpdate: [String: Any] = [
 kSecValueData as String: newData
 ]

 let status = SecItemUpdate(query as CFDictionary, attributesToUpdate as CFDictionary)
 return status == errSecSuccess
}

Αυτό είναι πιο αποτελεσματικό από ένα delete+add, και αποφεύγει τις πιθανές συνθήκες αγώνα.

Διαγραφή ενός αντικειμένου

func deleteItem(forAccount account: String) -> Bool {
 let query: [String: Any] = [
 kSecClass as String: kSecClassGenericPassword,
 kSecAttrAccount as String: account
 ]
 let status = SecItemDelete(query as CFDictionary)
 return status == errSecSuccess
}

Να είστε προσεκτικοί για να μην διαγράψετε αντικείμενα που ανήκουν σε άλλες εφαρμογές που μοιράζονται την ίδια ομάδα πρόσβασης ⁇ πάντα να καλύψετε το ερώτημά σας με αν χρησιμοποιείτε κοινόχρηστα μπρελόκ.

Χαρακτηριστικά ελέγχου και προσβασιμότητας πρόσβασης

Η σταθερά ορίζει ] πότε μπορεί να διαβαστεί το αντικείμενο του Keychain. Επιλέξτε την πιο περιοριστική επιλογή που εξακολουθεί να ικανοποιεί τις ανάγκες της εφαρμογής σας:

actor KeychainManager {
 func saveToken(_ token: String, for account: String) async -> Bool {
 // same implementation as above, but now it's safe to call from any context
 return saveToken(token, forAccount: account)
 }
}