YubiKit Starter is a single view iOS Swift Swift 5.0+ app with the Yubico Mobile iOS SDK (YubiKit) already integrated. This starter is intended to be used as a baseline for integrating strong two factor authentication for mobile apps using the YubiKey 5Ci hardware key over the Apple Lightning® port.
About the Yubico Mobile iOS SDK: The Yubico Mobile iOS SDK or YubiKit provides the interface between your iOS app and the YubiKey connected to the Lightning port. The YubiKey 5Ci is an MFi accessory and the YubiKit communicates with the key over iAP2 (iPod Accessory Protocol) when the key is connected to the Lightning port of a physical device.
Is the YubiKit required? You don't need to include the YubiKit into your app to interact with the YubiKey 5Ci connected to the Lightning port if you are only implementing
static passwords, or
custom slot 1 or 2 configurationas the YubiKey 5Ci acts as a HID keyboard (and not an MFi accessory) in these scenarios and will simply type out the codes to screen when the key (YubiKey 5Ci) is touched.
- Clone this repo from Mac Terminal
$ git clone https://github.com/yubicolabs/YubiKit-iOS-Starter.git
- Launch the project in Xcode (11+)
$ cd YubiKit-iOS-Starter $ open YubiKitStarter.xcodeproj
- Build and Run the Starter App on a real device
What does the YubiKit Starter app do? The YubiKit Starter app keeps track of the state of the YubiKey (connected or not connected) and displays information about the inserted key such as key
serial #, and
Congratulations! You now have the
YubiKit Starter app running and interacting with a YubiKey 5Ci via the Lightning port using very basic functions. You can now add features such as OTP, U2F, WebAuthn, or other features available via the YubiKey 5Ci to this starter app. If you already have an app and wish to integrate the YubiKit manually, follow the instructions below. Good luck and let us know if you have any questions or feedback by submitting a Github issue. Thanks!
This section is intended for developers that want to start with their own iOS app and add the YubiKit manually.
Step-by-step instructions for adding YubiKit SDK for iOS to your app
YubiKit SDK is currently available through a static framework and can be added to any new or existing iOS Xcode project.
[Download YubiKit SDK for iOS (zip file)]
Download the YubiKit SDK for iOS (.zip) to your desktop.
[Add YubiKit folder to your Xcode project]
- Drag the entire
/YubiKit_2_0_0/YubiKitfolder to your YubiKitStarter Xcode project. Check the option Copy items if needed.
[Linked Frameworks and Libraries]
Linked Frameworks and Libraries. Click + and select Add Other. Locate the
libYubiKit.ain YubiKit/debug_universal folder and add it.
[Library Search Paths]
Build Settings> Filter by 'Library Search Paths', expand to show debug & release. Set Release to
YubiKit/releasefolder and Set Debug to
[Header Search Paths]
Build Settings> Filter by 'Header Search Path'. Set both Debug & Release to
Add a Bridging-Header
You can add a Bridging Header manually or have Xcode do it for you. Here's how to add and configure Xcode to use the bridging header. A bit of trickery here...
- Right Click in the project explorer and choose new file
- Selected Objective-C File
- Name it DELETE_ME or something obvious as we'll go back and delete it
- When prompted to have a bridging file created, select yes
- Delete the file you created (DELETE_ME.m)
#import <YubiKit/YubiKit.h>to your bridging header
Let's build the project!
[Enable Lightning Protocol]
The YubiKey 5Ci is an Apple MFi external accessory and communicates over iAP2. You are telling your app that all communication with the 5Ci as a supported external accessory is via
[Grant accesss to NFC]
[Grant accesss to CAMERA]
Optional: if you are planning to use the camera to read QR codes for OTP Open info.plist and add the following usage: 'Privacy - Camera Usage Description' - "This application needs access to Camera for reading QR codes."
YubiKit Starter is provided under the Apache License 2.0.