KeychainItemAccessibility

Undocumented

  • The data in the keychain item cannot be accessed after a restart until the device has been unlocked once by the user.

    After the first unlock, the data remains accessible until the next restart. This is recommended for items that need to be accessed by background applications. Items with this attribute migrate to a new device when using encrypted backups.

    Declaration

    Swift

    case afterFirstUnlock

  • The data in the keychain item cannot be accessed after a restart until the device has been unlocked once by the user.

    After the first unlock, the data remains accessible until the next restart. This is recommended for items that need to be accessed by background applications. Items with this attribute do not migrate to a new device. Thus, after restoring from a backup of a different device, these items will not be present.

    Declaration

    Swift

    case afterFirstUnlockThisDeviceOnly

  • The data in the keychain item can always be accessed regardless of whether the device is locked.

    This is not recommended for application use. Items with this attribute migrate to a new device when using encrypted backups.

    Declaration

    Swift

    case always

  • The data in the keychain can only be accessed when the device is unlocked. Only available if a passcode is set on the device.

    This is recommended for items that only need to be accessible while the application is in the foreground. Items with this attribute never migrate to a new device. After a backup is restored to a new device, these items are missing. No items can be stored in this class on devices without a passcode. Disabling the device passcode causes all items in this class to be deleted.

    Declaration

    Swift

    case whenPasscodeSetThisDeviceOnly

  • The data in the keychain item can always be accessed regardless of whether the device is locked.

    This is not recommended for application use. Items with this attribute do not migrate to a new device. Thus, after restoring from a backup of a different device, these items will not be present.

    Declaration

    Swift

    case alwaysThisDeviceOnly

  • The data in the keychain item can be accessed only while the device is unlocked by the user.

    This is recommended for items that need to be accessible only while the application is in the foreground. Items with this attribute migrate to a new device when using encrypted backups.

    This is the default value for keychain items added without explicitly setting an accessibility constant.

    Declaration

    Swift

    case whenUnlocked

  • The data in the keychain item can be accessed only while the device is unlocked by the user.

    This is recommended for items that need to be accessible only while the application is in the foreground. Items with this attribute do not migrate to a new device. Thus, after restoring from a backup of a different device, these items will not be present.

    Declaration

    Swift

    case whenUnlockedThisDeviceOnly