What is NSFaceIDUsageDescription - Face ID Usage Description Info.plist key?

Question

There is a new privacy NSFaceIDUsageDescription Info.plist key in the Xcode 9 GM where a developer supplies the usage description for the permissions alert. Does anyone have a link to docs on it? The plist view in Xcode summarizes it as:

Privacy - Face ID Usage Description

Answer 1

Now further explained in the above mentioned forum (by an Apple employee) https://forums.developer.apple.com/message/265156 :

Face ID requires adding a usage string with the key NSFaceIDUsageDescription (aka Privacy - Face ID Usage Description) to your app's Info.plist.

In the simulator, the Face ID permissions alert will show "This app was designed to use Touch ID and may not fully support Face ID" if that key is missing. On an actual device, your app will crash the same as if any other required usage string is missing.

Answer 2

maybe I'm later to the party but you can fix this just by adding this

<key>NSFaceIDUsageDescription</key>
<string>$(PRODUCT_NAME) Authentication with TouchId or FaceID</string>

to Project-Info.plist

Answer 3

Privacy - Face ID Usage Description (NSFaceIDUsageDescription) is string key, lets you describe the reason your app uses Face ID.

To protect user privacy, an iOS app that links on or after iOS 11 and that would access Face ID if the hardware supports it, must statically declare the intent to do so. Include the NSFaceIDUsageDescription key in your app's Info.plist file and provide a purpose string for this key. If your app attempts to access Face ID without a corresponding purpose string, your app may exit.

Note : This key is supported in iOS 11 and later.

Face-Id authentication is introduced for/with iPhone-X device and will work with iPhone-X only (Even no simulator)

With Xcode 9.0.1 & Xcode 9.2 beta - it seems found working

Ref.link to Apple Document - NSFaceIDUsageDescription
List of all available keys - Cocoa Keys

Answer 4

I have users that were reporting an app crash when the first TouchID alert shows. The fix was to test on the device and read the console (Xcode 9.4.1):

This app has crashed because it attempted to access privacy-sensitive data without a usage description. The app's Info.plist must contain an NSFaceIDUsageDescription key with a string value explaining to the user how the app uses this data.

Simply adding NSFaceIDUsageDescription by right clicking and "Add Row" in the root of the Info.plist and pasted NSFaceIDUsageDescription in and set it to YES.

The simulator isn't going to support FaceID so apps that use logins, keychain, and TouchID are affected if you don't add a one liner to the plist to support FaceID verification. The user will get an alert asking them to allow FaceID to log into your app by default so no coding required to support FaceID if you're already setup for TouchID.

Answer 5

In the Xcode version 14.0.1, I can't add the required info to infoPlist using "Add Row" method. Rather I added the statement below manually;

/* Localized versions of Info.plist keys */

NSFaceIDUsageDescription = "This app wants to use your Face ID. Plaese Hit OK to activate Face ID.";

Don't forget to add that semicolon by the way otherwise you will get validation error.