Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы SecurityInterface ссылка класса SFCertificateTrustPanel

Опции
Развертывание Target:

На этой странице

SFCertificateTrustPanel

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

Следующие данные показывают пример панели доверия сертификата.

Панель доверия рисунка 1Certificate image: ../Art/cert_trust_panel.eps

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

Для отображения сертификата в панели или листе без доступных для редактирования доверительных настроек используйте SFCertificatePanel класс. Для отображения сертификатов в пользовательском представлении используйте SFCertificateView класс.

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


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


Не применимый

Objective C

@import SecurityInterface;

Доступность


Доступный в OS X v10.3 и позже
  • Возвращает совместно используемый объект панели доверия сертификата. Если объект не был уже создан, этот метод выделяет и инициализирует объект сначала.

    Объявление

    Objective C

    + (SFCertificateTrustPanel *)sharedCertificateTrustPanel

    Обсуждение

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

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

    Objective C

    @import SecurityInterface;

    Доступность

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

    См. также

    alloc(NSObject)
    init(NSObject)

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

    Объявление

    Objective C

    - (void)beginSheetForWindow:(NSWindow *)docWindow modalDelegate:(id)delegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo trust:(SecTrustRef)trust message:(NSString *)message

    Параметры

    docWindow

    Родительское окно, к которому присоединяется лист.

    delegate

    Объект делегата, в котором метод указал в didEndSelector параметр реализован.

    didEndSelector

    Когда лист был отклонен, селектор метода для метода делегата вызвал. Реализация этого метода делегата является дополнительной.

    contextInfo

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

    trust

    Доверительный объект управления. Используйте SecTrustCreateWithCertificates функция (в Security/SecTrust.h) для создания доверительного объекта управления.

    message

    Строка сообщения для отображения в листе.

    Обсуждение

    Метод делегата имеет следующую подпись:

    • -(void)createPanelDidEnd:(NSWindow *)sheet
    • returnCode:(int)returnCode
    • contextInfo:(void *)contextInfo

    Параметры для метода делегата:

    sheet

    Окно, к которому был присоединен лист.

    returnCode

    Код результата, указывающий, которые снабжают кнопками пользователя, щелкнул: также NSFileHandlingPanelOKButton или NSFileHandlingPanelCancelButton.

    contextInfo

    Определенные клиентами контекстные данные, передающиеся в contextInfo параметр beginSheetForWindow:... метод.

    Метод делегата может отклонить сам лист настроек цепочки для ключей; если это не делает, лист отклонен по возврату из beginSheetForWindow:... метод.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

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

    Объявление

    Objective C

    - (NSInteger)runModalForTrust:(SecTrustRef)trust message:(NSString *)message

    Параметры

    trust

    Доверительный объект управления. Используйте SecTrustCreateWithCertificates функция (в Security/SecTrust.h) для создания доверительного объекта управления.

    message

    Строка сообщения для отображения в панели.

    Обсуждение

    Этот метод возвраты NSOKButton если кнопка по умолчанию нажата, или NSCancelButton если нажата альтернативная кнопка.

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

    Обратите внимание на то, что изменение пользовательских настроек доверия не влияет на результаты доверительной оценки. Поэтому доверительная оценка, показанная в панели (такой как “Этот сертификат еще не допустимо”), не изменяется, ни делает результат вызова к SecTrustGetResult. Это до Вашего приложения, чтобы определить, как обработать доверительное решение пользователя.

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • Возвращает (дополнительный) информативный текст, в настоящее время выводимый на экран в панели.

    Объявление

    Objective C

    - (NSString *)informativeText

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

    Objective C

    @import SecurityInterface;

    Доступность

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

  • Устанавливает (дополнительный) информативный текст, выведенный на экран в SFCertificateTrustPanel.

    Объявление

    Objective C

    - (void)setInformativeText:(NSString *)informativeText

    Параметры

    informativeText

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

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

    Objective C

    @import SecurityInterface;

    Доступность

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