NEW: Master Swift design patterns with my latest book! >>

< Previous: The basic text editor   Next: Touch to activate: Touch ID, Face ID and LocalAuthentication >

Writing somewhere safe: the iOS keychain

When the app first runs, users should see a totally innocuous screen, with nothing secret visible. But we also don't want secret information to be visible when the user leaves the app for a moment then comes back, or if they double-tap the home button to multitask – doing so might mean that the app is left unlocked, which is the last thing we want.

To make this work, let's start by giving the view controller a totally innocuous title that absolutely won't make anyone wonder what's going on. Put this into viewDidLoad():

title = "Nothing to see here"

Next we're going to create two new methods: unlockSecretMessage() to load the message into the text view, and saveSecretMessage(). But before we do that, I want to introduce you to a helpful class called KeychainWrapper, which we'll be using to read and write keychain values.

This class was not made by Apple; instead, it's open source software released under the MIT license, which means we can use it in our own projects as long as the copyright message remains intact. This class is needed because working with the keychain is complicated – far harder than anything we have done so far. So instead of using it directly, we'll be using this wrapper class that makes the keychain work like UserDefaults.

If you haven't already downloaded this project's files from GitHub (, please do so now. In there you'll find the files KeychainWrapper.swift and KeychainItemAccessibility.swift; please copy them into your Xcode project to make the class available.

The first of our two new methods, unlockSecretMessage(), needs to show the text view, then load the keychain's text into it. Loading strings from the keychain using KeychainWrapper is as simple as using its string(forKey:) method, but the result is optional so you should unwrap it once you know there's a value there.

Here it is:

func unlockSecretMessage() {
    secret.isHidden = false
    title = "Secret stuff!"

    if let text = KeychainWrapper.standard.string(forKey: "SecretMessage") {
        secret.text = text

The second of our two new methods, saveSecretMessage(), needs to write the text view's text to the keychain, then make it hidden. This is done using the set() method of KeychainWrapper, so it's just as easy as reading. Note that we should only execute this code if the text view is visible, otherwise if a save happens before the app is unlocked then it will overwrite the saved text!

Here's the code:

@objc func saveSecretMessage() {
    if !secret.isHidden {
        _ = KeychainWrapper.standard.set(secret.text, forKey: "SecretMessage")
        secret.isHidden = true
        title = "Nothing to see here"

I slipped a new method in there: resignFirstResponder(). This is used to tell a view that has input focus that it should give up that focus. Or, in Plain English, to tell our text view that we're finished editing it, so the keyboard can be hidden. This is important because having a keyboard present might arouse suspicion – as if our rather obvious navigation bar title hadn't done enough already…

Now, there are still two questions remaining: how should users trigger a save when they are ready, and how do we ensure that as soon as the user starts to leave the app we make their data safe? For the first problem, consider this: how often do you see a save button in iOS? Hardly ever, I expect!

It turns out that one answer solves both problems: if we automatically save when the user leaves the app then the user need never worry about saving because it's done for them, and our save method above automatically hides the text when it's called so the app becomes safe as soon as any action is taken to leave it.

We're already using NotificationCenter to watch for the keyboard appearing and disappearing, and we can watch for another notification that will tell us when the application will stop being active – i.e., when our app has been backgrounded or the user has switched to multitasking mode. This notification is called UIApplicationWillResignActive, and you should make us an observer for it in viewDidLoad() like this:

notificationCenter.addObserver(self, selector: #selector(saveSecretMessage), name: Notification.Name.UIApplicationWillResignActive, object: nil)

That calls our saveSecretMessage() directly when the notification comes in, which means the app automatically saves any text and hides it when the app is moving to a background state.

The last thing to do before the app is actually useful is to make tapping the button call unlockSecretMessage(), like this:

@IBAction func authenticateTapped(_ sender: Any) {

It's not actually secure at this point (other than saving its data in the iOS keychain!), but by saving and loading its text it is at least useful.

Upgrade to premium

The Hacking with Swift guide book helps you learn faster, plus get an Xcode tips and tricks video and Swift wall chart.

< Previous: The basic text editor   Next: Touch to activate: Touch ID, Face ID and LocalAuthentication >
Click here to visit the Hacking with Swift store >>