Службы авторизации C ссылка

Обсуждение

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

Можно использовать эту функцию для авторизации всех или частичных прав. Авторизация прав с этой функцией является самой полезной для приложений, требующих однократной авторизации. Путем передачи NULL к authorization параметр, Сервер безопасности пытается авторизовать требуемые права и возвращает надлежащий код результата, фактически не предоставляя права. Если Вы не собираетесь вызывать какие-либо другие функции авторизации, используйте этот метод, чтобы определить, есть ли у пользователя авторизация, не предоставляя прав.

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

Если Вы не указываете kAuthorizationFlagPartialRights маска и Сервер безопасности отклоняют по крайней мере одно право, тогда состояние этой функции по возврату errAuthorizationDenied.

Если Вы не указываете kAuthorizationFlagInteractionAllowed маска и Сервер безопасности требуют взаимодействия с пользователем, тогда состояние этой функции по возврату errAuthorizationInteractionNotAllowed.

Если Вы указываете kAuthorizationFlagInteractionAllowed маска и пользователь отменяют процесс аутентификации, тогда состояние этой функции по возврату errAuthorizationCanceled.

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

Обсуждение

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

Обсуждение

Существует три главных причины использовать эту функцию. Первая причина состоит в том, чтобы предварительно авторизовать права путем указания kAuthorizationFlagPreAuthorize, kAuthorizationFlagInteractionAllowed, и kAuthorizationFlagExtendRights маски как опции авторизации. Когда право имеет нулевой тайм-аут, предварительная авторизация является самой полезной. Например, можно предварительно авторизовать в приложении и если оно успешно выполняется, вызовите инструмент помощника и запросите авторизацию. Если Сервер безопасности не может позже авторизовать указанные права, это устраняет вызов инструмента помощника.

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

Третья причина использовать эту функцию состоит в том, чтобы авторизовать частичные права. Путем указания kAuthorizationFlagPartialRights, kAuthorizationFlagInteractionAllowed, и kAuthorizationFlagExtendRights маски как опции авторизации, Сервер безопасности предоставляет все права, которые он может авторизовать. По возврату авторизованный набор содержит все права.

Если Вы не указываете kAuthorizationFlagPartialRights маска и Сервер безопасности отклоняют по крайней мере одно право, тогда состояние этой функции по возврату errAuthorizationDenied.

Если Вы не указываете kAuthorizationFlagInteractionAllowed маска и Сервер безопасности требуют взаимодействия с пользователем, тогда состояние этой функции по возврату errAuthorizationInteractionNotAllowed.

Если Вы указываете kAuthorizationFlagInteractionAllowed маска и пользователь отменяют процесс аутентификации, тогда состояние этой функции по возврату errAuthorizationCanceled.

Обсуждение

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

Обсуждение

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

Обсуждение

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

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

Обсуждение

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

Обсуждение

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

Обсуждение

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

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

добавляет правило для разрешения администраторам отправить факсы. Этот пример создает названное право “com.ifoo.ifax.send” и устанавливает правила, чтобы потребовать, чтобы пользователь был администратором при помощи kAuthorizationRuleIsAdmin постоянный. Этот пример также устанавливает комментарий, чтобы позволить системному администратору знать, что право разрешает администраторов отправлять факс.

Поскольку первый параметр NULL, новое AuthorizationRef объект создают внутренне и избавляются. Если Вам нужно к дальнейшему использованию AuthorizationRef объект (например, при вызове AuthorizationExecuteWithPrivileges), необходимо явно создать объект и передать его в как первый параметр AuthorizationRightSet, тогда освободите его с вызовом к AuthorizationFree.

Для указания дополнительных атрибутов для права можно передать CFDictionary введите rightDefinition параметр как показано в следующем примере.

Этот вызов создает то же право как прежде, но добавляет определенный правильный комментарий к определению правил.

При указании комментариев необходимо быть определенными о том, что необходимо авторизовать. Например, средние значения доказательства, требуемого для kAuthorizationRuleAuthenticateAsAdmin (имя пользователя и пароль), не должен быть включен здесь, так как то правило могло бы быть сконфигурировано по-другому.

Обсуждение

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