LAContext

Представляет контекст аутентификации.

Контексты аутентификации используются для оценки политики аутентификации, позволяя приложениям запросить пользователя аутентифицировать себя с помощью персональных данных, таких как цифровой отпечаток, зарегистрированный в Касании ID.

Наследование

NSObject
LAContext

NSObject
LAContext

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import LocalAuthentication

Objective C

@import LocalAuthentication;

Доступность

Доступный в OS X v10.10 и позже.

Оценка политики аутентификации


    
    canEvaluatePolicy (_: ошибка:)
    - canEvaluatePolicy:error:

Предварительные рейсы политика аутентификации, чтобы видеть, возможно ли для аутентификации успешно выполниться.

Объявление

Swift

func canEvaluatePolicy(_ policy: LAPolicy, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError **)error

Параметры


      policy

Политика оценить.


      error

На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

Возвращаемое значение

YEStrue если политика может быть оценена, NOfalse иначе.

Обсуждение

Политики могут иметь требования, которые должны быть удовлетворены, чтобы иметь любую возможность успешной аутентификации. Например, политика, требующая биометрики, потребовала бы, чтобы Касание ID был включен и зарегистрировал цифровые отпечатки.

Возвращаемое значение этого метода может изменяться в течение долгого времени, таким образом, Вы не должны хранить это значение для будущего использования в Вашем приложении. Значение, как гарантируют, останется непротиворечивым, пока Ваше приложение не введет фон.

Специальные замечания

Этот метод не должен быть призван reply блок evaluatePolicy:localizedReason:reply:, потому что выполнение так могло вести для заведения в тупик.

Оператор импорта

Objective C

@import LocalAuthentication;

Swift

import LocalAuthentication

Доступность

Доступный в OS X v10.10 и позже.


    
    evaluatePolicy (_: localizedReason:reply:)
    - evaluatePolicy:localizedReason:reply:

Оценивает указанную политику.

Объявление

Swift

func evaluatePolicy(_ policy: LAPolicy, localizedReason localizedReason: String!, reply reply: ((Bool, NSError!) -> Void)!)

Objective C

- (void)evaluatePolicy:(LAPolicy)policy localizedReason:(NSString *)localizedReason reply:(void (^)(BOOL success, NSError *error))reply

Параметры


      policy

Политика оценить.


      localizedReason

Предоставленная приложением причина запроса аутентификации. Эта строка должна быть предоставлена на текущем языке пользователя и должна быть коротка и ясна. Это будет выведено на экран в подзаголовке диалога аутентификации. Имя приложения появится в заголовке диалога аутентификации, таким образом, Вы не должны будете копировать свое имя приложения здесь.


      reply

Блок ответа, выполняющийся, когда заканчивается оценка политики. Этот блок оценен на частной очереди, внутренней к платформе в неуказанном контексте поточной обработки. Вы не должны вызывать canEvaluatePolicy:error: в этом блоке, потому что выполнение так могло вести для заведения в тупик.

`success`	`YEStrue` если оценка политики успешно выполнилась, `NOfalse` иначе.
`error`	`nil` если оценка политики успешно выполнилась, ошибочный объект, который должен быть представлен пользователю иначе. Посмотрите `LAError` для возможных ошибочных значений

Обсуждение

Этот метод асинхронно оценивает политику аутентификации. reply блок используется для предоставления результатов оценки. Оценка политики может включить запрос пользователя для различных видов взаимодействия или аутентификации. Фактическое поведение зависит от оцененной политики и типа устройства. Это может также быть затронуто установленными профилями конфигурации.

Вы не должны предполагать, что предыдущая успешная оценка политики обязательно приведет к последующей успешной оценке. Оценка политики может перестать работать по различным причинам, включая пользовательскую отмену или системную отмену. Посмотрите LAError для возможных ошибочных значений.

Оператор импорта

Objective C

@import LocalAuthentication;

Swift

import LocalAuthentication

Доступность

Доступный в OS X v10.10 и позже.

Константы

LAError
Коды ошибки, которые могут быть возвращены при оценке политики.

Объявление

Swift

enum LAError : Int { case AuthenticationFailed case UserCancel case UserFallback case SystemCancel case PasscodeNotSet case TouchIDNotAvailable case TouchIDNotEnrolled }

Objective C

typedef NS_ENUM (NSInteger, LAError ) { LAErrorAuthenticationFailed = kLAErrorAuthenticationFailed, LAErrorUserCancel = kLAErrorUserCancel, LAErrorUserFallback = kLAErrorUserFallback, LAErrorSystemCancel = kLAErrorSystemCancel, LAErrorPasscodeNotSet = kLAErrorPasscodeNotSet, LAErrorTouchIDNotAvailable = kLAErrorTouchIDNotAvailable, LAErrorTouchIDNotEnrolled = kLAErrorTouchIDNotEnrolled, };

Константы
- AuthenticationFailed
  
  LAErrorAuthenticationFailed
  
  Аутентификация не была успешна, потому что пользователю не удалось обеспечить допустимые учетные данные.
  
  Доступный в OS X v10.10 и позже.
- UserCancel
  
  LAErrorUserCancel
  
  Аутентификация была отменена пользователем — например, пользователь коснулся Отмены в диалоговом окне.
  
  Доступный в OS X v10.10 и позже.
- UserFallback
  
  LAErrorUserFallback
  
  Аутентификация была отменена, потому что пользователь коснулся, кнопка нейтрализации (Введите Пароль).
  
  Доступный в OS X v10.10 и позже.
- SystemCancel
  
  LAErrorSystemCancel
  
  Аутентификация была отменена системой — например, если другое приложение прибыло в передний план, в то время как произошел диалог аутентификации.
  
  Доступный в OS X v10.10 и позже.
- PasscodeNotSet
  
  LAErrorPasscodeNotSet
  
  Аутентификация не могла запуститься, потому что код доступа не установлен на устройстве.
  
  Доступный в OS X v10.10 и позже.
- TouchIDNotAvailable
  
  LAErrorTouchIDNotAvailable
  
  Аутентификация не могла запуститься, потому что Касание ID не доступно на устройстве.
  
  Доступный в OS X v10.10 и позже.
- TouchIDNotEnrolled
  
  LAErrorTouchIDNotEnrolled
  
  Аутентификация не могла запуститься, потому что Касание ID не имеет никаких зарегистрированных пальцев.
  
  Доступный в OS X v10.10 и позже.
Оператор импорта

Objective C

@import LocalAuthentication;

Swift

import LocalAuthentication

Доступность

Доступный в OS X v10.10 и позже.
Ошибочный домен локальной аутентификации
Ошибочный домен для платформы Локальной аутентификации.

Объявление

Swift

let LAErrorDomain: NSString!

Objective C

NSString *const LAErrorDomain;

Константы
- LAErrorDomain
  
  LAErrorDomain
  
  Строковая константа, идентифицирующая ошибочный домен для платформы Локальной аутентификации.
  
  Доступный в OS X v10.10 и позже.