### GenericKeychain ###
================================================================================
DESCRIPTION:
This sample shows how to navigate through the Keychain Services API
provided by iOS. Its demonstration leverages the Generic
Keychain Item class and provides a template on how to successfully set up calls
to: SecItemAdd, SecItemCopyMatching, SecItemDelete, and SecItemUpdate.
The user interface is a master-detail designed in Interface Builder, archived in the MainWindow nib.
The user interface is modeled on a typical iOS app preferences screen.
The sample builds two separate applications from the same code base. Both applications
have their own keychain item that stores a username and password. Both apps also share
a second keychain item that stores an account number. This takes advantage
of the shared keychain item capability added in iOS 3.0.
Testing:
The ability to share keychain items between apps is based on code signing entitlements. These
in turn are based on the app ID prefix that is contained in your provisioning profile. All
apps that share a keychain item must be built using the same app ID prefix.
The sample must be edited to include your app ID prefix in five places where the text "YOUR_APP_ID_HERE"
appears before building and running the sample apps. The easiest way to do that is to use Xcode's Find in Project
command to locate the places that must be edited first. Just change the app ID prefix; leave the rest unchanged.
Next, make GenericKeychain the active target and select Build and Go to run the first app GenericKeychain.
Finally, make GenericKeychain2 the active target and select Build and Go to run the second app GenericKeychain2.
NOTE:
Apps that are built for the simulator aren't signed, so there's no keychain access group
for the simulator to check. This means that all keychain items are in the same default access group
and all apps can see all keychain items when run on the simulator.
If a SecItem contains an access group attribute, SecItemAdd and SecItemUpdate on the
simulator will return -25243 (errSecNoAccessForItem).
The sample is written to ignore the access group if built for the simulator.
================================================================================
BUILD REQUIREMENTS:
iOS 4 SDK
================================================================================
RUNTIME REQUIREMENTS:
iOS 3.2 or later
================================================================================
PACKAGING LIST:
AppDelegate
Adds the root navigation controller's view to the main window and displays the window when the
application launches.
KeychainItemWrapper
Abstract interface to Keychain Services that wraps a single keychain item.
DetailViewController
Custom detail view controller.
EditorController
View controller subclass for abstracting an interface to either a text field or a text view.
MainWindow.xib
The nib file containing the main window and the view controllers used in the application.
================================================================================
CHANGES FROM PREVIOUS VERSIONS:
Version 1.2
Fixed minor memory leak and upgraded project to build with the iOS 4 SDK.
Version 1.1
Adopted UITableView and UITableViewCell API for iPhone OS 3.0. Added support for
shared keychain items.
Version 1.0
N/A
Copyright (c) 2008-2010 Apple Inc. All rights reserved.