Ссылка плагина авторизации

Обсуждение

Когда приложение вызывает AuthorizationCopyRights функционируйте для запроса определенного права авторизации, Агент безопасности ищет то право в базе данных политики авторизации. Если то право соответствует Вашему плагину, механизм авторизации вызывает MechanismInvoke функция для каждого механизма перечислена в базе данных правил управления для Вашего плагина.

Когда механизм авторизации вызывает Ваш MechanismInvoke функция, Ваш плагин должен вызвать указанный механизм для попытки операции авторизации. Вы используете SetResult функционируйте для возврата результатов этой работы. Если возвращается механизм kAuthorizationResultAllow, тогда механизм авторизации вызывает следующий механизм (если таковые имеются) указанный в базе данных политики авторизации для политики. Если какой-либо из механизмов сообщает о результате кроме kAuthorizationResultAllow, сбои попытки авторизации. Если все механизмы сообщают о результатах kAuthorizationResultAllow, авторизация, как полагают, успешно выполнилась.

Обратите внимание на то, что можно отделить отдельный процесс и возвратиться из MechanismInvoke перед вызовом SetResult. Например, Вы могли бы сделать так, чтобы избежать блокировать Сервер безопасности, если Ваш механизм занимает существенное количество времени для завершения или если Вы хотите быть в состоянии отменить работу путем вызова RequestInterrupt функция (если, например, пользователь нажал Cancel).In, что случай, Ваш отдельный процесс должен вызвать SetResult функционируйте для создания отчетов о результате; механизм авторизации не вызывает следующий механизм, пока Вы не делаете так.

Механизм авторизации отправляет Вам точку входа в SetResult функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

Обсуждение

Когда Вы вызываете эту функцию, механизм безопасности вызывает MechanismDeactivate функционируйте для в настоящее время активного механизма своего плагина; т.е. механизм, в последний раз вызванный и это еще не вызвало SetResult функционируйте для создания отчетов о его результате. Ваш механизм должен тогда остановить любую активную обработку и вызвать DidDeactivate функция. Когда все механизмы неактивны (т.е. они вызвали также SetResult или DidDeactivate), механизм авторизации вызывает MechanismInvoke функция для вызвавшего механизма RequestInterrupt так, чтобы это могло возобновить процесс авторизации от той точки. После того, как все механизмы вызвали SetResult, механизм авторизации вызывает каждый механизм MechanismDestroy функция.

Если Ваш механизм отделяет отдельный процесс или поток UI, тот поток может вызвать RequestInterrupt функция, чтобы повторно вызвать механизм, даже если тот механизм уже вызвал SetResult функция. Например, если Ваш плагин реализует метод аутентификации смарт-карты, читение и оценивание карты могли бы занять несколько минут для выполнения. Поэтому во избежание блокирования другой обработки, в то время как карта оценивается, Вы могли бы отделить поток UI, чтобы взаимодействовать с пользователем и затем возвратиться из MechanismInvoke. Когда карта была считана, поток UI вызывает SetResult функция со значением kAuthorizationResultAllow и изменяет UI для запроса PIN пользователя. Механизм авторизации вызывает следующий механизм, проверяющий PIN. Если пользователь вытаскивает карту, прежде чем проверка будет завершена, поток UI может вызвать RequestInterrupt. Механизм авторизации тогда вызывает активный механизм MechanismDeactivate функция, заставляя его завершить проверку PIN и вызов DidDeactivate. Тогда механизм авторизации вызывает Ваш механизм UI MechanismInvoke функционируйте снова. Ваш UI может тогда предложить пользователю повторно вставлять карту.

Для понимания этой последовательности лучше предположите, что плагин содержит три механизма: A, B, и C. Механизм A вызвал SetResult и не имеет никаких активных процессов. Механизм B вызвал SetResult, но все еще имеет выполнение потока UI. Механизм C выполняет и еще не вызвал SetResult. Пользователь нажимает Cancel или иначе прерывает поток UI, заставляя поток UI вызвать RequestInterrupt функция. Следующая последовательность событий происходит:

1. Механизм авторизации вызывает механизм C MechanismDeactivate функция.

2. Механизм C останавливает активную обработку и вызывает DidDeactivate функция.

3. Механизм авторизации вызывает механизм B MechanismInvoke функция (потому что механизм B является вызвавшим тем RequestInterrupt).

4. Механизм B обновляет UI и вызывает SetResult функция со значением kAuthorizationResultAllow.

5. Механизм авторизации вызывает механизм C MechanismInvoke функция.

6. Механизм C завершает обработку и вызовы SetResult с kAuthorizationResultAllow.

7. Механизм авторизации вызывает MechanismDestroy функция каждого механизма поочередно (A, B, тогда C).

Механизм авторизации отправляет Вам точку входа в RequestInterrupt функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

Обсуждение

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

Механизм авторизации отправляет Вам точку входа в DidDeactivate функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

Обсуждение

Ваш сменный механизм авторизации мог бы собрать данные, такие как имя пользователя и другая информация аутентификации во время оценки авторизации. Можно использовать SetContextValue функция для имения Сервера безопасности хранит эти данные и GetContextValue функция для получения его.

Механизм авторизации отправляет Вам точку входа в GetContextValue функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

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

Обсуждение

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

Когда Вы храните эти данные контекста, Вы отмечаете их, чтобы указать, может ли клиент авторизации получить значение с AuthorizationCopyInfo функция. Если данные установлены быть извлекаемыми (kAuthorizationContextFlagExtractable), для клиента авторизации возможно использовать AuthorizationCopyInfo функция для получения значения. Если данные отмечены как энергозависимые (kAuthorizationContextFlagVolatile), значение не доступно клиенту. В любом случае уязвимые данные, такие как пароль пользователя не предоставлены клиенту.

Механизм авторизации отправляет Вам точку входа в SetContextValue функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

Не вызывайте эту функцию после вызова SetResult функция. Если Вы делаете так, функция не устанавливает данные контекста, даже при том, что функция возвращается errAuthorizationSuccess код результата.

Обсуждение

Ваш сменный механизм авторизации может сохранить и получить вспомогательную информацию — названный подсказками — для использования последующими механизмами, которые являются частью той же авторизации. Вы используете SetHintValue функция для имения Сервера безопасности хранит эти данные и GetHintValue функция для получения его. Подсказки не сохраняются как часть результата авторизации; как только все механизмы утвердили авторизацию, или любой механизм отклонил ее, механизм безопасности избавляется от подсказок.

Механизм авторизации отправляет Вам точку входа в GetHintValue функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

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

Обсуждение

Ваш сменный механизм авторизации может сохранить и получить вспомогательную информацию — названный подсказками — для использования последующими механизмами, которые являются частью той же авторизации. Вы используете SetHintValue функция для имения Сервера безопасности хранит эти данные и GetHintValue функция для получения его. Подсказки не сохраняются как часть результата авторизации; как только все механизмы утвердили авторизацию, или любой механизм отклонил ее, механизм безопасности избавляется от подсказок.

Механизм авторизации отправляет Вам точку входа в SetHintValue функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

Не вызывайте эту функцию после вызова SetResult функция. Если Вы делаете так, функция не устанавливает данные подсказки, даже при том, что функция возвращается errAuthorizationSuccess код результата.

Обсуждение

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

Механизм авторизации отправляет Вам точку входа в GetArguments функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.

Обсуждение

Сеанс ID является уникальным значением, предоставленным механизмом авторизации для данного сеанса авторизации. Обычно, все механизмы в Вашем плагине вызывают поочередно для данного сеанса авторизации и нет никакой потребности попросить сеанса у ID. Однако, если необходимо было запустить демона авторизации (например), что данные кэшей от различных сеансов авторизации, и затем использует те данные позже, Вы, возможно, должны были бы отслеживать, которого сеанса элемент определенных данных прибыл из. Если Вы хотите реализовать такую систему, ID сеанса доступен для Вашего использования.

Механизм авторизации отправляет Вам точку входа в GetSessionID функция в AuthorizationCallbacks структура, когда Вы вызываете AuthorizationPluginCreate функция.