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

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

Разработчик

Ссылка служб подписания кода ссылки концепции безопасности

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

На этой странице
Язык:

Ссылка служб подписывания кода

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

Функции

Получение идентификаторов типов
  • SecCodeGetTypeID () SecCodeGetTypeID

    Возвращает уникальный идентификатор непрозрачного типа к который a SecCodeRef объект принадлежит.

    Объявление

    Swift

    func SecCodeGetTypeID() -> CFTypeID

    Objective C

    CFTypeID SecCodeGetTypeID ( void );

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

    Значение, идентифицирующее непрозрачный тип a SecCodeRef объект.

    Обсуждение

    Можно сравнить значение, возвращенное этой функцией к CFTypeID идентификатор, полученный путем вызова CFGetTypeID функция на конкретном объекте. Эти значения могли бы измениться от выпуска до выпуска или платформы на платформу.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecHostCreateGuest

  • SecRequirementGetTypeID () SecRequirementGetTypeID

    Возвращает уникальный идентификатор непрозрачного типа к который a SecRequirementRef объект принадлежит.

    Объявление

    Swift

    func SecRequirementGetTypeID() -> CFTypeID

    Objective C

    CFTypeID SecRequirementGetTypeID ( void );

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

    Значение, идентифицирующее непрозрачный тип a SecRequirementRef объект.

    Обсуждение

    Можно сравнить значение, возвращенное этой функцией к CFTypeID идентификатор, полученный путем вызова CFGetTypeID функция на конкретном объекте. Эти значения могли бы измениться от выпуска до выпуска или платформы на платформу.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecRequirementCreateWithString
    SecRequirementCreateWithStringAndErrors

  • SecStaticCodeGetTypeID () SecStaticCodeGetTypeID

    Возвращает уникальный идентификатор непрозрачного типа к который a SecStaticCodeRef объект принадлежит.

    Объявление

    Swift

    func SecStaticCodeGetTypeID() -> CFTypeID

    Objective C

    CFTypeID SecStaticCodeGetTypeID ( void );

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

    Значение, идентифицирующее непрозрачный тип a SecStaticCodeRef объект.

    Обсуждение

    Можно сравнить значение, возвращенное этой функцией к CFTypeID идентификатор, полученный путем вызова CFGetTypeID функция на конкретном объекте. Эти значения могли бы измениться от выпуска до выпуска или платформы на платформу.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecStaticCodeCreateWithPath

Обработка выполнения кода со знаком

Объект кода (т.е. объект типа SecCodeRef) представляет отдельно идентифицированный рабочий код в системе. В дополнение к процессам UNIX это может также включать (с поддержкой со стороны узла кода) сценарии, апплеты, виджеты, и т.д.

  • SecCodeCopySelf (_: _:) SecCodeCopySelf

    Получает объект кода для кода, сделавшего звонок.

    Объявление

    Swift

    func SecCodeCopySelf(_ flags: SecCSFlags, _ `self`: UnsafeMutablePointer<Unmanaged<SecCode>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCopySelf ( SecCSFlags flags, SecCodeRef *self );

    Параметры

    flags

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

    self

    По возврату, объект кода представление вызывающей стороны.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Объект кода (т.е. объект типа SecCodeRef) представляет код, работающий на системе. Код может быть процессом UNIX, сценарием, апплетом, виджетом или любым другим отдельно идентифицируемым кодом. Можно использовать объект кода, возвращенный этой функцией, как введено к другим функциям в Code Signing Services API. Эта функция возвращает объект кода для кода, вызывающего ее независимо от того, подписывается ли код. Вызовите SecCodeCheckValidity или SecCodeCheckValidityWithErrors функция, чтобы определить, имеет ли код действительную подпись.

    Если код, вызывающий эту функцию, является или выделенным узлом или вызвал SecHostSelectGuest функция, тогда узел считается, действуя как прокси для его преданного или выбранного гостя и SecCodeCopySelf функционируйте возвращает объект кода для того гостя. Посмотрите kSecCSDedicatedHost для обсуждения выделенных узлов.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopyStaticCode
    SecCodeCopyHost
    SecCodeCopyGuestWithAttributes

  • SecCodeCopyStaticCode (_: _: _:) SecCodeCopyStaticCode

    Определяет местоположение источника рабочего кода и возвращает статический объект кода представление кода в файловой системе.

    Объявление

    Swift

    func SecCodeCopyStaticCode(_ code: SecCode!, _ flags: SecCSFlags, _ staticCode: UnsafeMutablePointer<Unmanaged<SecStaticCode>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCopyStaticCode ( SecCodeRef code, SecCSFlags flags, SecStaticCodeRef *staticCode );

    Параметры

    code

    Допустимый объект кода, представляющий код, работающий на системе.

    flags

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

    staticCode

    По возврату, статический объект кода представление кода в файловой системе, которая является источником кода, указанного code параметр.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

    Много функций в Code Signing Services API берут или статический объект кода или объект кода как входной параметр. Для этих функций, если Вы передаете в ссылке кода, функция сначала переводит ее в статическую ссылку кода таким же образом как SecCodeCopyStaticCode функция. В каждом таком случае описание параметра документирует это поведение.

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

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopySelf
    SecCodeCopyHost
    SecCodeCopyPath
    SecCodeCopyGuestWithAttributes

  • SecCodeCopyHost (_: _: _:) SecCodeCopyHost

    Получает объект кода для узла указанного гостевого кода.

    Объявление

    Swift

    func SecCodeCopyHost(_ guest: SecCode!, _ flags: SecCSFlags, _ host: UnsafeMutablePointer<Unmanaged<SecCode>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCopyHost ( SecCodeRef guest, SecCSFlags flags, SecCodeRef *host );

    Параметры

    guest

    Допустимый объект кода, представляющий код, работающий на системе как гость другого кода.

    flags

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

    host

    По возврату, объекту кода узла кода, указанного в guest параметр.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Действия кода узла как супервизор и контроллер его гостя кодируют, и окончательные полномочия на динамической законности и состоянии его гостей.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopySelf
    SecHostCreateGuest
    SecCodeCopyGuestWithAttributes

  • SecCodeCopyGuestWithAttributes (_: _: _: _:) SecCodeCopyGuestWithAttributes

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

    Объявление

    Swift

    func SecCodeCopyGuestWithAttributes(_ host: SecCode!, _ attributes: CFDictionary!, _ flags: SecCSFlags, _ guest: UnsafeMutablePointer<Unmanaged<SecCode>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCopyGuestWithAttributes ( SecCodeRef host, CFDictionaryRef attributes, SecCSFlags flags, SecCodeRef *guest );

    Параметры

    host

    Допустимый объект кода, представляющий код, работающий на системе, действующей как узел к коду со знаком. Передача NULL указать, что корень подписывания кода доверия (в настоящее время, системное ядро) должен использоваться в качестве узла кода.

    attributes

    Словарь, содержащий нуль или больше значений атрибута, которые будут использоваться в идентификации гостевого кода. Посмотрите Ключи Словаря Селектора Атрибута) для возможных ключей словаря и описаний присваиваемых значений. Каждый узел поддерживает только определенные комбинации ключей и значений, и функция возвращает ошибку, если требуют какой-либо неподдерживаемый набор. Передача NULL указать пустой набор атрибута. Обратите внимание на то, что некоторые узлы, поддерживающие цепочки хостинга (гости, являющиеся узлами), могут возвратить подгостей этой функции; т.е. объект кода, возвращенный этим вызовом, может не быть прямым гостем запрошенного узла, несмотря на то, что это будет гость где-нибудь в цепочке хостинга.

    flags

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

    guest

    По возврату, объект кода идентификация определенного гостя узла, имеющего указанные значения атрибута. Если атрибуты указывают сам узел, функция возвращает объект кода для узла. Если больше чем один гость удовлетворяет указанные критерии, функция возвращает результат errSecCSMultipleGuests.

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

    Код результата; посмотрите Коды Результата. В частности:

    • errSecCSUnsupportedGuestAttributes— Узел не поддерживает указанный тип атрибута.

    • errSecCSInvalidAttributeValues— Тип имеющий значение, данный для гостевого атрибута, не поддерживается узлом.

    • errSecCSNoSuchCode— Узел не имеет никакого гостя с указанным значением атрибута, даже при том, что значение имеет поддерживаемый тип. Если код указал в, эта ошибка может также быть возвращена host параметр в настоящее время не действует как узел кода.

    • errSecCSNotAHost— Код, указанный в host параметр не может действовать как узел кода, потому что он отсутствует kSecCodeSignatureHost флаг опции в его подписи кода.

    • errSecCSMultipleGuests— Указанные атрибуты однозначно не идентифицируют гостя (спецификация не уникальна).

    Обсуждение

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

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopySelf
    SecCodeCopyHost
    SecCodeCopyStaticCode

  • SecCodeCheckValidity (_: _: _:) SecCodeCheckValidity

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

    Объявление

    Swift

    func SecCodeCheckValidity(_ code: SecCode!, _ flags: SecCSFlags, _ requirement: SecRequirement!) -> OSStatus

    Objective C

    OSStatus SecCodeCheckValidity ( SecCodeRef code, SecCSFlags flags, SecRequirementRef requirement );

    Параметры

    code

    Объект кода, который будет проверен.

    flags

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

    requirement

    Требование кода, указывающее дополнительные условия код, должно удовлетворить, чтобы считаться допустимым. Указать NULL если Вы не хотите налагать какие-либо дополнительные требования. Используйте SecRequirementCreateWithString или SecRequirementCreateWithStringAndErrors функция для создания объекта требования кода. Посмотрите Руководство по Подписыванию кода для обсуждения требований кода.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCheckValidityWithErrors
    SecStaticCodeCheckValidity

  • SecCodeCheckValidityWithErrors (_: _: _: _:) SecCodeCheckValidityWithErrors

    Выполняет динамическую проверку кода со знаком и возвращает подробную информацию об ошибке в случае отказа.

    Объявление

    Swift

    func SecCodeCheckValidityWithErrors(_ code: SecCode!, _ flags: SecCSFlags, _ requirement: SecRequirement!, _ errors: UnsafeMutablePointer<Unmanaged<CFError>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCheckValidityWithErrors ( SecCodeRef code, SecCSFlags flags, SecRequirementRef requirement, CFErrorRef *errors );

    Параметры

    code

    Объект кода, который будет проверен.

    flags

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

    requirement

    Требование кода, указывающее дополнительные условия код, должно удовлетворить, чтобы считаться допустимым. Указать NULL если Вы не хотите налагать какие-либо дополнительные требования. Используйте SecRequirementCreateWithString или SecRequirementCreateWithStringAndErrors функция для создания объекта требования кода. Посмотрите Руководство по Подписыванию кода для обсуждения требований кода.

    errors

    По возврату, если вызов функции приводит к сбою и возвращает код результата кроме errSecSuccess, точки к ошибке возражают дальнейшему описанию природы и обстоятельств отказа. Используйте CFErrorCopyUserInfo функция для получения пользовательского информационного словаря от ошибочного объекта. Посмотрите Пользовательские Информационные Ошибочные Ключи Словаря для возможных значений. Передача NULL если Вы не хотите эту информацию. Вызовите CFRelease функционируйте для выпуска этого объекта, когда Вы будете закончены с ним.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCheckValidity
    SecStaticCodeCheckValidityWithErrors

  • SecCodeCopyPath (_: _: _:) SecCodeCopyPath

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

    Объявление

    Swift

    func SecCodeCopyPath(_ staticCode: SecStaticCode!, _ flags: SecCSFlags, _ path: UnsafeMutablePointer<Unmanaged<CFURL>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCopyPath ( SecStaticCodeRef staticCode, SecCSFlags flags, CFURLRef *path );

    Параметры

    staticCode

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

    flags

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

    path

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

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

    Код результата; посмотрите Коды Результата.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopySigningInformation

  • SecCodeCopyDesignatedRequirement (_: _: _:) SecCodeCopyDesignatedRequirement

    Получает определяемое требование кода кода со знаком.

    Объявление

    Swift

    func SecCodeCopyDesignatedRequirement(_ code: SecStaticCode!, _ flags: SecCSFlags, _ requirement: UnsafeMutablePointer<Unmanaged<SecRequirement>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCopyDesignatedRequirement ( SecStaticCodeRef code, SecCSFlags flags, SecRequirementRef *requirement );

    Параметры

    code

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

    flags

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

    requirement

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

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopySigningInformation

  • SecCodeCopySigningInformation (_: _: _:) SecCodeCopySigningInformation

    Получает различные данные от подписи кода.

    Объявление

    Swift

    func SecCodeCopySigningInformation(_ code: SecStaticCode!, _ flags: SecCSFlags, _ information: UnsafeMutablePointer<Unmanaged<CFDictionary>?>) -> OSStatus

    Objective C

    OSStatus SecCodeCopySigningInformation ( SecStaticCodeRef code, SecCSFlags flags, CFDictionaryRef *information );

    Параметры

    code

    Код или статический код возражают, от чьей подписи Вы хотите получить информацию. При обеспечении объекта кода функция обрабатывает его таким же образом как SecCodeCopyStaticCode функция — т.е. статическая информация о подписывании кода получена из подписи на диске. Обратите внимание на то, что динамическая информация (kSecCSDynamicInformation) может быть получен только для объекта кода, не для статического объекта кода.

    flags

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

    information

    По возврату, словарь, содержащий информацию о коде. Содержание словаря зависит от флагов, которые Вы передаете в flags параметр. Независимо от флагов, kSecCodeInfoIdentifier ключ всегда присутствует, если код подписывается, и всегда отсутствуйте, если код без знака. Посмотрите Ключи Словаря информации о Подписании для описаний ключей словаря. Вызовите CFRelease функционируйте для выпуска этого объекта, когда Вы будете закончены с ним.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Сумма и уровень детализации данных возвратились, управляется флагами, переданными вызову.

    Если код существует, но не подписывается, этот вызов функции следует и возвращает словарь, не содержащий kSecCodeInfoIdentifier ключ. Это - рекомендуемый способ проверить быстро, подписывается ли код, если это - единственная информация, Вам нужно. Однако обратите внимание на то, что эта функция не проверяет подпись.

    Если данные подписания для кода повреждены или недопустимы, эта функция может перестать работать, или это может возвратить частичные данные. Чтобы гарантировать, что только допустимые данные возвращаются (и ошибки повышены для недопустимых данных), необходимо успешно вызвать SecCodeCheckValidity или SecCodeCheckValidityWithErrors функция перед вызовом SecCodeCopySigningInformation.

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

    Некоторые объекты, возвращенные в информационном словаре, (сохраняются) «живые» объекты API, используемые инфраструктурой подписывания кода. Внесение изменений в эти объекты не поддерживается и может заставить последующие операции подписывания кода на затронутом коде вести себя неопределенными способами.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopyPath
    SecCodeCopyDesignatedRequirement

  • SecCodeMapMemory (_: _:) SecCodeMapMemory

    Просит ядро принимать информацию о подписании, в настоящее время присоединяемую к объекту кода, и использует ее для проверки страницы-памяти-ins.

    Объявление

    Swift

    func SecCodeMapMemory(_ code: SecStaticCode!, _ flags: SecCSFlags) -> OSStatus

    Objective C

    OSStatus SecCodeMapMemory ( SecStaticCodeRef code, SecCSFlags flags );

    Параметры

    code

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

    flags

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

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Эта функция для использования узлов кода, использующих память, отображающуюся для управления их собственным кодом. Ядро берет информацию о подписании, присоединенную к коду диска, указанного code параметр и присоединения это к объекту памяти. После этого это использует подпись для проверки страницы-памяти-ins, обновляя динамическое состояние законности соответственно. Можно использовать SecCodeCopySigningInformation функционируйте для проверки динамического состояния законности кода. Присоединение подписи к объекту памяти влияет на все процессы, имеющие основную исполнимую программу этого отображенного кода.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

Обработка гостевого кода

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

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

И узлы и гости представлены объектами кода — т.е. объектами типа SecCodeRef. В хостинге API гости идентифицируются простыми числовыми дескрипторами, которые уникальны и допустимы только в контексте их определенного узла.

Функции в этом разделе всегда применяются к узлу кода, сделавшему звонки. Они не могут использоваться для прямого опроса другого узла.

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

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

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

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

  • SecHostCreateGuest (_: _: _: _: _: _:) SecHostCreateGuest

    Создает нового гостя и описывает его начальные свойства.

    Объявление

    Swift

    func SecHostCreateGuest(_ host: SecGuestRef, _ status: UInt32, _ path: CFURL!, _ attributes: CFDictionary!, _ flags: SecCSFlags, _ newGuest: UnsafeMutablePointer<SecGuestRef>) -> OSStatus

    Objective C

    OSStatus SecHostCreateGuest ( SecGuestRef host, uint32_t status, CFURLRef path, CFDictionaryRef attributes, SecCSFlags flags, SecGuestRef *newGuest );

    Параметры

    host

    Гостевая идентификация объекта кода кода, который должен быть прямым узлом нового гостя. Передача kSecNoGuest если процесс, вызывающий эту функцию, должен быть узлом. Для создания гостя другого гостя (расширяющий цепочку хостинга) передайте гостевой объект кода гостя, который должен действовать как узел нового гостя. Если указанный узел уже имеет преданного гостя, то тот преданный гость становится фактическим узлом нового гостя (если у преданного гостя также нет преданного гостя, когда тому же алгоритму отвечают рекурсивно). Посмотрите kSecCSDedicatedHost для обсуждения выделенных узлов.

    status

    Флаги состояния кода для нового гостя (см. Флаги Состояния Кода). Обратите внимание на то, что определенные флаги состояния кода могут быть установлены только один раз вызывающей стороной SecHostCreateGuest функционируйте, когда это создаст гостя. В частности если Вы не устанавливаете kSecCodeStatusValid флаг во время создания гостя, тогда новый гость создается динамично недопустимый и никогда не может становиться динамично допустимым.

    path

    Канонический путь к коду гостя диска. Это - путь, который Вы передали бы SecStaticCodeCreateWithPath функция для создания статической ссылки на объект кода. Необходимо использовать абсолютный путь.

    attributes

    Словарь значения ключа атрибутов, которые могут использоваться для идентификации этого определенного гостя среди всех гостей вызывающей стороны. kSecGuestAttributeCanonical атрибут — содержащий объект кода гостя (т.е. SecGuestRef объект возвратился в newGuest параметр), автоматически добавляется к атрибутам гостя. Передача NULL для этого параметра, если Вы не хотите устанавливать какие-либо другие атрибуты для этого гостя. Несмотря на то, что можно указать, что любые пары ключ/значение в этом приписывают словарь, ключи в Ключах Словаря Селектора Атрибута традиционно используются с этой целью.

    flags

    Дополнительные флаги; посмотрите Гостевые Флаги Создания для возможных значений. Передача kSecCSDefaultFlags для стандартного поведения. Передача kSecCSDedicatedHost сделать код указанным в host параметр выделенный узел для нового гостя.

    newGuest

    По возврату, гостевой объект кода, идентифицирующий нового гостя.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Код, вызывающий эту функцию, становится узлом кода, работающим в режиме хостинга прокси (см. Гостевой Код Обработки). Впоследствии, информация о кэшах Code Signing Services о гостевом коде, предоставленном узлом, когда это вызывает SecHostCreateGuest, SecHostSetGuestStatus, и SecHostRemoveGuest функции. Code Signing Services использует эту информацию для создания отчетов о состоянии хостинга вызывающим сторонам непосредственно, не консультируясь с узлом. Узел кода, работающий в режиме хостинга прокси, не может переключиться на динамический режим хостинга.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecHostRemoveGuest
    SecHostSelectGuest
    SecHostSetHostingPort
    SecCodeCopyGuestWithAttributes

  • SecHostRemoveGuest (_: _: _:) SecHostRemoveGuest

    Удаляет гостя из узла.

    Объявление

    Swift

    func SecHostRemoveGuest(_ host: SecGuestRef, _ guest: SecGuestRef, _ flags: SecCSFlags) -> OSStatus

    Objective C

    OSStatus SecHostRemoveGuest ( SecGuestRef host, SecGuestRef guest, SecCSFlags flags );

    Параметры

    host

    Гостевой объект кода узла гостя. Вы не можете указать узел узла здесь кроме случая выделенного узла. Для выделенного узла выделенным узлом автоматически заменяют его гостя. Посмотрите kSecCSDedicatedHost для обсуждения выделенных узлов.

    guest

    Гостевой код возражает для гостя, гостевое отношение которого Вы хотите завершить.

    flags

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

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Эта функция удаляет всю память отношения приглашенного ведущего программы из Code Signing Services, размещающей систему. Вы не можете удалить преданного гостя. Указанный гость, должно быть, был создан с помощью SecHostCreateGuest функция. Если Вы удаляете гостя, который является также узлом, все гости гостя удалены, рекурсивно, также, даже если один или больше тех гостей выделенные узлы.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecHostCreateGuest

  • SecHostSelectGuest (_: _:) SecHostSelectGuest

    Делает вызывающий поток прокси для указанного гостя.

    Объявление

    Swift

    func SecHostSelectGuest(_ guestRef: SecGuestRef, _ flags: SecCSFlags) -> OSStatus

    Objective C

    OSStatus SecHostSelectGuest ( SecGuestRef guestRef, SecCSFlags flags );

    Параметры

    guestRef

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

    flags

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

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

    Эта функция говорит системе, что Ваше приложение действует от имени выбранного гостя (или от его собственного имени, если Вы указываете kSecNoGuest для guestRef параметр). Эта функция действует на основе на поток; т.е. каждый из потоков Вашего приложения может вызвать эту функцию для выбора гостя для того потока. После того система предполагает, что любые меры, принятые Вашим приложением на том потоке, от имени выбранного гостя. Например, если Ваше приложение пытается получить доступ к цепочке для ключей, система предполагает, что выбранный гость является приложением, пытающимся получить доступ к цепочке для ключей и действиям соответственно. Можно вызывать эту функцию так же часто по мере необходимости для действия от имени стольких гостей, сколько Вы желаете.

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecHostCreateGuest
    SecHostSelectedGuest

  • SecHostSelectedGuest (_: _:) SecHostSelectedGuest

    Получает дескриптор для гостя, в настоящее время выбираемого для вызывающего потока.

    Объявление

    Swift

    func SecHostSelectedGuest(_ flags: SecCSFlags, _ guestRef: UnsafeMutablePointer<SecGuestRef>) -> OSStatus

    Objective C

    OSStatus SecHostSelectedGuest ( SecCSFlags flags, SecGuestRef *guestRef );

    Параметры

    flags

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

    guestRef

    По возврату, гостевому объекту кода текущего выбранного гостя для вызывающего потока. Если никакой гость не активен на этом потоке (т.е. поток действует узла), значение возвратилось, kSecNoGuest.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecHostSelectGuest

  • SecHostSetGuestStatus (_: _: _: _:) SecHostSetGuestStatus

    Обновляет состояние и атрибуты определенного гостя.

    Объявление

    Swift

    func SecHostSetGuestStatus(_ guestRef: SecGuestRef, _ status: UInt32, _ attributes: CFDictionary!, _ flags: SecCSFlags) -> OSStatus

    Objective C

    OSStatus SecHostSetGuestStatus ( SecGuestRef guestRef, uint32_t status, CFDictionaryRef attributes, SecCSFlags flags );

    Параметры

    guestRef

    Гостевой объект кода кода, на имя которого действует этот поток.

    status

    Новый набор флагов состояния кода для гостя (см. Флаги Состояния Кода. Узел должен осуществить ограничения на изменения в гостевом состоянии: kSecCodeStatusValid бит может только быть очищен и kSecCodeStatusHard и kSecCodeStatusKill флаги могут только быть установлены. Передайте предыдущее гостевое состояние, чтобы указать, что не желаемо никакое изменение.

    attributes

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

    flags

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

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Эта функция должна быть вызвана узлом, действующим в режиме прокси каждый раз, когда состояние гостя изменяется так, чтобы Code Signing Services могла обновить информационный кэш для того гостя. Указанный гость, должно быть, был создан с помощью SecHostCreateGuest функция.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecHostCreateGuest

  • SecHostSetHostingPort (_: _:) SecHostSetHostingPort

    Говорит Code Signing Services, размещающей подсистему, что код вызова будет непосредственно реагировать на запросы хостинга по данному порту.

    Объявление

    Swift

    func SecHostSetHostingPort(_ hostingPort: mach_port_t, _ flags: SecCSFlags) -> OSStatus

    Objective C

    OSStatus SecHostSetHostingPort ( mach_port_t hostingPort, SecCSFlags flags );

    Параметры

    hostingPort

    Порт сообщения Маха с отправляет права. Этот порт зарегистрирован и вручен сторонам, заинтересованным запросами узла о его дочерних элементах.

    flags

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

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Если Вы хотите использовать динамический режим хостинга (см. Гостевой Код Обработки), вызовите эту функцию прежде, чем вызвать любую другую Code Signing Services, размещающую функции. Когда Вы вызываете SecHostSetHostingPort, код вызова берет на себя непосредственную ответственность за ответ на вопросы о его гостях, использующих службы IPC хостинга. После того, как Вы вызовете эту функцию, Вы не можете вызвать SecHostCreateGuest, SecHostRemoveGuest, или SecHostSetGuestStatus функции.

    SecHostSelectGuest и SecHostSelectedGuest работа функций после вызывания этой функции.

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

    Динамический хостинг полезен, если у Вас есть большой узел со многими гостями, изменяющими состояние часто. В этом случае более эффективно только реагировать на запросы информации, когда они сделаны, чем вызвать функции обновления статуса (SecHostCreateGuest, SecHostSetGuestStatus, или SecHostRemoveGuest) каждый раз что-то изменяется. Однако динамический режим хостинга не полностью поддерживается высокоуровневыми API-функциями в это время. Если Вы не имеете обширные знания Маха, обменивающегося сообщениями, и имеете определенную потребность управлять Вашим гостевым кодом динамично, рекомендуется использовать режим хостинга прокси.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecHostCreateGuest

Обработка требований кода

Требование кода является условием или ограничением, которое код должен удовлетворить, чтобы считаться допустимым в некоторой цели. Весь код со знаком имеет неявные или явные требования кода. Code Signing Services не имеет никаких встроенных критериев того, почему такое ограничение является надлежащим или полезным; это только обеспечивает инструменты для формулировки, записи и оценки требований кода, чтобы Вы установили. Можно указать явные требования кода, когда Вы подписываете свой код, или можно подписать код, не указывая явных требований кода, когда codesign утилита обычно создает определяемое требование из имени программы и цепочки подписей, защищающих подпись кода. Определяемое требование является набором критериев, используемых, чтобы определить, является ли код со знаком тем же кодом, который верификатор видел прежде.

Требования кода обычно сохранены в форме двоичных блобов переменной длины, которые могут инкапсулироваться как a CFDataRef объекты. Они получены, поскольку требование кода возражает (объекты типа SecRequirementRef). Они могут быть сформулированы в текстовой форме, которая может быть скомпилирована в двоичную форму и декомпилировалась назад в текстовую форму без потери функции (хотя комментарии и форматирование не сохраняются). Можно использовать функции в Code Signing Services API для преобразования между различными формами требований кода.

Требования кода и язык требования подписывания кода документируются в Руководство по Подписыванию кода.

  • SecRequirementCopyData (_: _: _:) SecRequirementCopyData

    Извлекает двоичную форму требования кода от объекта требования кода.

    Объявление

    Swift

    func SecRequirementCopyData(_ requirement: SecRequirement!, _ flags: SecCSFlags, _ data: UnsafeMutablePointer<Unmanaged<CFData>?>) -> OSStatus

    Objective C

    OSStatus SecRequirementCopyData ( SecRequirementRef requirement, SecCSFlags flags, CFDataRef *data );

    Параметры

    requirement

    Допустимый объект требования кода.

    flags

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

    data

    По возврату, требованию кода в форме двоичного блоба.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecRequirementCreateWithData

  • SecRequirementCopyString (_: _: _:) SecRequirementCopyString

    Преобразовывает объект требования кода в текстовую форму.

    Объявление

    Swift

    func SecRequirementCopyString(_ requirement: SecRequirement!, _ flags: SecCSFlags, _ text: UnsafeMutablePointer<Unmanaged<CFString>?>) -> OSStatus

    Objective C

    OSStatus SecRequirementCopyString ( SecRequirementRef requirement, SecCSFlags flags, CFStringRef *text );

    Параметры

    requirement

    Допустимый объект требования кода.

    flags

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

    text

    По возврату, текстовому представлению требования кода.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Если Вы используете SecRequirementCreateWithString или SecRequirementCreateWithStringAndErrors функция для создания требования кода возражает от текстовой строки и более позднего использования SecRequirementCopyString функционируйте для преобразования объекта назад в строку, перераспределенный текст может отличаться по форматированию, содержать комментарии другого источника и выполнить свои функции проверки в различном порядке от оригинала. Однако гарантируется, что это перераспределенный текст функционально идентично оригиналу; т.е. перекомпилировав текстовое использование SecRequirementCreateWithString произведет объект требования кода, ведущий себя тождественно к первому, который Вы создали.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecRequirementCreateWithString
    SecRequirementCreateWithStringAndErrors

  • SecRequirementCreateWithData (_: _: _:) SecRequirementCreateWithData

    Создает объект требования кода из двоичной формы требования кода.

    Объявление

    Swift

    func SecRequirementCreateWithData(_ data: CFData!, _ flags: SecCSFlags, _ requirement: UnsafeMutablePointer<Unmanaged<SecRequirement>?>) -> OSStatus

    Objective C

    OSStatus SecRequirementCreateWithData ( CFDataRef data, SecCSFlags flags, SecRequirementRef *requirement );

    Параметры

    data

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

    flags

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

    requirement

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

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecRequirementCopyData

  • SecRequirementCreateWithString (_: _: _:) SecRequirementCreateWithString

    Создает объект требования кода путем компиляции допустимого текстового представления требования кода.

    Объявление

    Swift

    func SecRequirementCreateWithString(_ text: CFString!, _ flags: SecCSFlags, _ requirement: UnsafeMutablePointer<Unmanaged<SecRequirement>?>) -> OSStatus

    Objective C

    OSStatus SecRequirementCreateWithString ( CFStringRef text, SecCSFlags flags, SecRequirementRef *requirement );

    Параметры

    text

    Текстовая форма требования кода.

    flags

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

    requirement

    По возврату, содержит объект требования кода, реализующий условия, описанные в тексте.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Требования кода и язык требования подписывания кода документируются в Руководство по Подписыванию кода.

    Если Вы используете SecRequirementCreateWithString функция для создания требования кода возражает от текстовой строки и более позднего использования SecRequirementCopyString функционируйте для преобразования объекта назад в строку, перераспределенный текст может отличаться по форматированию, содержать комментарии другого источника и выполнить свои функции проверки в различном порядке от оригинала. Однако гарантируется, что это перераспределенный текст функционально идентично оригиналу; т.е. перекомпилировав текстовое использование SecRequirementCreateWithString произведет объект требования кода, ведущий себя тождественно к первому, который Вы создали.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecRequirementCreateWithStringAndErrors
    SecRequirementCopyString

  • SecRequirementCreateWithStringAndErrors (_: _: _: _:) SecRequirementCreateWithStringAndErrors

    Создает объект требования кода путем компиляции допустимого текстового представления требования кода и возвращает подробную информацию об ошибке в случае отказа.

    Объявление

    Swift

    func SecRequirementCreateWithStringAndErrors(_ text: CFString!, _ flags: SecCSFlags, _ errors: UnsafeMutablePointer<Unmanaged<CFError>?>, _ requirement: UnsafeMutablePointer<Unmanaged<SecRequirement>?>) -> OSStatus

    Objective C

    OSStatus SecRequirementCreateWithStringAndErrors ( CFStringRef text, SecCSFlags flags, CFErrorRef *errors, SecRequirementRef *requirement );

    Параметры

    text

    Текстовая форма требования кода.

    flags

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

    errors

    По возврату, если вызов функции приводит к сбою и возвращает код результата кроме errSecSuccess, точки к ошибке возражают дальнейшему описанию природы и обстоятельств отказа. Используйте CFErrorCopyUserInfo функция для получения пользовательского информационного словаря от ошибочного объекта. Посмотрите Пользовательские Информационные Ошибочные Ключи Словаря для возможных значений. Передача NULL если Вы не хотите эту информацию. Вызовите CFRelease функционируйте для выпуска этого объекта, когда Вы будете закончены с ним.

    requirement

    По возврату, содержит объект требования кода, реализующий условия, описанные в тексте.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Преимущество этой функции SecRequirementCreateWithString это, если существуют какие-либо ошибки в текстовой строке, которую Вы передаете в text параметр, эта функция возвращает синтаксические ошибки, сгенерированные синтаксическим анализатором. Эти ошибки без обиняков и могут быть выведены на экран пользователю, если было бы полезно сделать так. Требования кода и язык требования подписывания кода документируются в Руководство по Подписыванию кода.

    Если Вы используете SecRequirementCreateWithStringAndErrors функция для создания требования кода возражает от текстовой строки и более позднего использования SecRequirementCopyString функционируйте для преобразования объекта назад в строку, перераспределенный текст может отличаться по форматированию, содержать комментарии другого источника и выполнить свои функции проверки в различном порядке от оригинала. Однако гарантируется, что это перераспределенный текст функционально идентично оригиналу; т.е. перекомпилировав текстовое использование SecRequirementCreateWithString произведет объект требования кода, ведущий себя тождественно к первому, который Вы создали.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecRequirementCreateWithString
    SecRequirementCopyString

Обработка статического кода со знаком

Статический объект кода (т.е. объект типа SecStaticCodeRef) представляет код в файловой системе. Это включает приложения, инструменты, платформы, плагины, сценарии, и т.д.

Обычно, каждый объект кода имеет определенный статический объект кода, содержащий его статические данные подписания. Неофициально, это - статический объект кода, из которого объект кода был сделан его узлом (см. SecHostCreateGuest). Нет, однако, никакой жизнеспособной ссылки в другом направлении — дана статический объект кода, не возможно найти, перечислить, или управлять любым объектом кода, произошедшим из него.

  • SecStaticCodeCheckValidity (_: _: _:) SecStaticCodeCheckValidity

    Проверяет статический объект кода.

    Объявление

    Swift

    func SecStaticCodeCheckValidity(_ staticCode: SecStaticCode!, _ flags: SecCSFlags, _ requirement: SecRequirement!) -> OSStatus

    Objective C

    OSStatus SecStaticCodeCheckValidity ( SecStaticCodeRef staticCode, SecCSFlags flags, SecRequirementRef requirement );

    Параметры

    staticCode

    Статический код возражает, чтобы быть проверенным.

    flags

    Дополнительные флаги; посмотрите Статические Флаги Проверки Кода для возможных значений. Передача kSecCSDefaultFlags для стандартного поведения.

    requirement

    Требование кода, указывающее дополнительные условия код, должно удовлетворить, чтобы считаться допустимым. Указать NULL если Вы не хотите налагать какие-либо дополнительные требования. Используйте SecRequirementCreateWithString или SecRequirementCreateWithStringAndErrors функция для создания объекта требования кода. Посмотрите Руководство по Подписыванию кода для обсуждения требований кода.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Эта функция получает и заверяет подпись на коде, указанном объектом кода. Это проверяет законность всех изолированных компонентов, включая ресурсы (если таковые имеются). Это проверяет код против требования кода, если Вы указаны. Если все эти условия являются удовлетворительными, вызов успешно выполняется.

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCheckValidity
    SecStaticCodeCheckValidityWithErrors

  • SecStaticCodeCheckValidityWithErrors (_: _: _: _:) SecStaticCodeCheckValidityWithErrors

    Выполняет статическую проверку статического кода со знаком и возвращает подробную информацию об ошибке в случае отказа.

    Объявление

    Swift

    func SecStaticCodeCheckValidityWithErrors(_ staticCode: SecStaticCode!, _ flags: SecCSFlags, _ requirement: SecRequirement!, _ errors: UnsafeMutablePointer<Unmanaged<CFError>?>) -> OSStatus

    Objective C

    OSStatus SecStaticCodeCheckValidityWithErrors ( SecStaticCodeRef staticCode, SecCSFlags flags, SecRequirementRef requirement, CFErrorRef *errors );

    Параметры

    staticCode

    Объект кода, который будет проверен.

    flags

    Дополнительные флаги; посмотрите Статические Флаги Проверки Кода для возможных значений. Передача kSecCSDefaultFlags для стандартного поведения.

    requirement

    Требование кода, указывающее дополнительные условия код, должно удовлетворить, чтобы считаться допустимым. Указать NULL если Вы не хотите налагать какие-либо дополнительные требования. Используйте SecRequirementCreateWithString или SecRequirementCreateWithStringAndErrors функция для создания объекта требования кода. Посмотрите Руководство по Подписыванию кода для обсуждения требований кода.

    errors

    По возврату, если вызов функции приводит к сбою и возвращает код результата кроме errSecSuccess, точки к ошибке возражают дальнейшему описанию природы и обстоятельств отказа. Используйте CFErrorCopyUserInfo функция для получения пользовательского информационного словаря от ошибочного объекта. Посмотрите Пользовательские Информационные Ошибочные Ключи Словаря для возможных значений. Передача NULL если Вы не хотите эту информацию. Вызовите CFRelease функционируйте для выпуска этого объекта, когда Вы будете закончены с ним.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Эта функция получает и заверяет подпись на коде, указанном объектом кода. Это проверяет законность всех изолированных компонентов, включая ресурсы (если таковые имеются). Это проверяет код против требования кода, если Вы указаны. Если все эти условия являются удовлетворительными, вызов успешно выполняется.

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCheckValidityWithErrors
    SecStaticCodeCheckValidity

  • SecStaticCodeCreateWithPath (_: _: _:) SecStaticCodeCreateWithPath

    Создает статический объект кода представление кода в указанном пути файловой системы.

    Объявление

    Swift

    func SecStaticCodeCreateWithPath(_ path: CFURL!, _ flags: SecCSFlags, _ staticCode: UnsafeMutablePointer<Unmanaged<SecStaticCode>?>) -> OSStatus

    Objective C

    OSStatus SecStaticCodeCreateWithPath ( CFURLRef path, SecCSFlags flags, SecStaticCodeRef *staticCode );

    Параметры

    path

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

    flags

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

    staticCode

    По возврату статический объект кода представление кода Вы указали в path параметр.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Статический объект кода по сути не соединяется с рабочим кодом в системе.

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopyStaticCode
    SecCodeCopyPath

  • SecStaticCodeCreateWithPathAndAttributes (_: _: _: _:) SecStaticCodeCreateWithPathAndAttributes

    Создает статический объект кода представление кода в указанном пути файловой системы и словаре атрибутов.

    Объявление

    Swift

    func SecStaticCodeCreateWithPathAndAttributes(_ path: CFURL!, _ flags: SecCSFlags, _ attributes: CFDictionary!, _ staticCode: UnsafeMutablePointer<Unmanaged<SecStaticCode>?>) -> OSStatus

    Objective C

    OSStatus SecStaticCodeCreateWithPathAndAttributes ( CFURLRef path, SecCSFlags flags, CFDictionaryRef attributes, SecStaticCodeRef *staticCode );

    Параметры

    path

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

    flags

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

    attributes

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

    staticCode

    По возврату статический объект кода представление кода Вы указали в path параметр.

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

    Код результата; посмотрите Коды Результата.

    Обсуждение

    Статический объект кода по сути не соединяется с рабочим кодом в системе.

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

    См. также

    SecCodeCopyStaticCode
    SecCodeCopyPath

Типы данных

  • SecCodeRef SecCodeRef

    Ссылка на объект SecCode, представляя подписала код, работающий на системе.

    Объявление

    Swift

    typealias SecCodeRef = SecCode

    Objective C

    typedef struct __SecCode *SecCodeRef;

    Обсуждение

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

  • SecStaticCodeRef SecStaticCodeRef

    Ссылка на объект SecStaticCode, представляя подписала код диска.

    Объявление

    Swift

    typealias SecStaticCodeRef = SecStaticCode

    Objective C

    typedef struct __SecCode const *SecStaticCodeRef;

    Обсуждение

    Соответствуйте SecCodeRef.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

  • SecRequirementRef SecRequirementRef

    Ссылка на объект SecRequirement, представляя требование кода.

    Объявление

    Swift

    typealias SecRequirementRef = SecRequirement

    Objective C

    typedef struct __SecRequirement *SecRequirementRef;

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

  • SecGuestRef SecGuestRef

    Ссылка на объект SecGuest, идентифицирующий определенный блок гостевого кода в контексте его узла подписывания кода.

    Объявление

    Swift

    typealias SecGuestRef = UInt32

    Objective C

    typedef u_int32_t SecGuestRef;

    Обсуждение

    Гостевые дескрипторы присваиваются узлом по желанию, с kSecNoGuest (0) быть зарезервированным как нулевое значение. Они могут быть снова использованы для новых дочерних элементов при желании.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

Константы

  • Припишите селекторные ключи словаря

    Используемый с функциями SecHostCreateGuest, SecHostSetGuestStatus, и SecCodeCopyGuestWithAttributes.

    Объявление

    Swift

    let kSecGuestAttributeCanonical: CFString! let kSecGuestAttributeHash: CFString! let kSecGuestAttributeMachPort: CFString! let kSecGuestAttributePid: CFString! let kSecGuestAttributeArchitecture: CFString! let kSecGuestAttributeSubarchitecture: CFString!

    Objective C

    const CFStringRef kSecGuestAttributeCanonical; const CFStringRef kSecGuestAttributeHash; const CFStringRef kSecGuestAttributeMachPort; const CFStringRef kSecGuestAttributePid; const CFStringRef kSecGuestAttributeArchitecture; const CFStringRef kSecGuestAttributeSubarchitecture;

    Константы

    • kSecGuestAttributeCanonical

      kSecGuestAttributeCanonical

      Гостевой объект кода (SecGuestRef) для того гостя. Этот объект плюс процесс ID (kSecGuestAttributePid) однозначно определите гостя.

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

    • kSecGuestAttributeHash

      kSecGuestAttributeHash

      A CFDataRef объект, содержащий хеш SHA 1 каталога кода.

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

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

    • kSecGuestAttributeMachPort

      kSecGuestAttributeMachPort

      Не реализованный.

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

    • kSecGuestAttributePid

      kSecGuestAttributePid

      Целое число типа pid_t представление процесса ID (PID), обычно гостя ядра.

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

    • kSecGuestAttributeArchitecture

      kSecGuestAttributeArchitecture

      A CFNumber представление типа ЦП, под которым гостевой код разработан для выполнения. Посмотрите ARCH (3) страница руководства для списка возможных типов ЦП.

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

    • kSecGuestAttributeSubarchitecture

      kSecGuestAttributeSubarchitecture

      ACFNumber представление CPU выделяет подтипы, под которым гостевой код разработан для выполнения. Посмотрите ARCH (3) страница руководства для списка возможных подтипов CPU.

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

  • Подписание информационных флагов

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

    Объявление

    Swift

    var kSecCSInternalInformation: Int { get } var kSecCSSigningInformation: Int { get } var kSecCSRequirementInformation: Int { get } var kSecCSDynamicInformation: Int { get } var kSecCSContentInformation: Int { get }

    Objective C

    enum { kSecCSInternalInformation = 1 << 0, kSecCSSigningInformation = 1 << 1, kSecCSRequirementInformation = 1 << 2, kSecCSDynamicInformation = 1 << 3, kSecCSContentInformation = 1 << 4 };

    Константы

    • kSecCSInternalInformation

      kSecCSInternalInformation

      Внутренняя информация о подписывании кода.

      Эта информация для использования Apple, Inc.. и подлежит изменению без предварительного уведомления.

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

    • kSecCSSigningInformation

      kSecCSSigningInformation

      Криптографическая информация о подписании.

      Цепочка сертификата и данные Cryptographic Message Syntax (CMS) (если таковые имеются). Для оперативного кода со знаком нет никаких сертификатов, и данные CMS пусты.

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

    • kSecCSRequirementInformation

      kSecCSRequirementInformation

      Требования кода — включая определяемое требование — встроенный в код.

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

    • kSecCSDynamicInformation

      kSecCSDynamicInformation

      Динамическая информация о законности о рабочем коде.

      Эта информация не может быть возвращена для кода диска (представленный a SecStaticCodeRef).

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

    • kSecCSContentInformation

      kSecCSContentInformation

      Больше информации о содержимом файловой системы, составляющем код со знаком диска.

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

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

  • Подписание информационных ключей словаря

    Ключи словаря, используемые с SecCodeCopySigningInformation функция для указания информации о коде со знаком.

    Объявление

    Swift

    let kSecCodeInfoCertificates: CFString! let kSecCodeInfoChangedFiles: CFString! let kSecCodeInfoCMS: CFString! let kSecCodeInfoDesignatedRequirement: CFString! let kSecCodeInfoEntitlements: CFString! let kSecCodeInfoEntitlementsDict: CFString! let kSecCodeInfoFormat: CFString! let kSecCodeInfoDigestAlgorithm: CFString! let kSecCodeInfoIdentifier: CFString! let kSecCodeInfoImplicitDesignatedRequirement: CFString! let kSecCodeInfoMainExecutable: CFString! let kSecCodeInfoPList: CFString! let kSecCodeInfoRequirements: CFString! let kSecCodeInfoRequirementData: CFString! let kSecCodeInfoSource: CFString! let kSecCodeInfoStatus: CFString! let kSecCodeInfoTime: CFString! let kSecCodeInfoTimestamp: CFString! let kSecCodeInfoTrust: CFString! let kSecCodeInfoUnique: CFString!

    Objective C

    const CFStringRef kSecCodeInfoCertificates; const CFStringRef kSecCodeInfoChangedFiles; const CFStringRef kSecCodeInfoCMS; const CFStringRef kSecCodeInfoDesignatedRequirement; const CFStringRef kSecCodeInfoEntitlements; const CFStringRef kSecCodeInfoEntitlementsDict; const CFStringRef kSecCodeInfoFormat; const CFStringRef kSecCodeInfoIdentifier; const CFStringRef kSecCodeInfoImplicitDesignatedRequirement; const CFStringRef kSecCodeInfoMainExecutable; const CFStringRef kSecCodeInfoPList; const CFStringRef kSecCodeInfoRequirements; const CFStringRef kSecCodeInfoRequirementData; const CFStringRef kSecCodeInfoSource; const CFStringRef kSecCodeInfoStatus; const CFStringRef kSecCodeInfoTime; const CFStringRef kSecCodeInfoTimestamp; const CFStringRef kSecCodeInfoTrust; const CFStringRef kSecCodeInfoUnique; const CFStringRef kSecCodeSignerFlags;

    Константы

    • kSecCodeInfoCertificates

      kSecCodeInfoCertificates

      Цепочка сертификата сертификата подписания, как замечено системой.

      A CFArrayRef массив SecCertificateRef объекты, что системное использование для обработки подписи. Отсутствующий для оперативного кода со знаком. Может быть частичным или отсутствовать в случае ошибки.

      Укажите kSecCSSigningInformation флаг для получения этой информации.

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

    • kSecCodeInfoChangedFiles

      kSecCodeInfoChangedFiles

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

      A CFArrayRef массив CFURLRef объекты. Файлы не в этом списке не были затронуты работой подписания.

      Укажите kSecCSContentInformation флаг для получения этой информации.

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

    • kSecCodeInfoCMS

      kSecCodeInfoCMS

      Криптографический объект CMS, защищающий подпись кода.

      A CFDataRef объект. Пустой для оперативного кода со знаком.

      Укажите kSecCSSigningInformation флаг для получения этой информации.

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

    • kSecCodeInfoDesignatedRequirement

      kSecCodeInfoDesignatedRequirement

      Определяемое требование кода.

      A SecRequirementRef объект. Если этот объект идентичен тому, возвращенному kSecCodeInfoImplicitDesignatedRequirement ключ, тогда нет никакого явного определяемого требования, и определяемое требование в использовании было сгенерировано системой.

      Укажите kSecCSRequirementInformation флаг для получения этой информации.

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

    • kSecCodeInfoEntitlements

      kSecCodeInfoEntitlements

      Встроенный дающий право блоб кода, если таковые имеются.

      A CFDataRef объект.

      Укажите kSecCSRequirementInformation флаг для получения этой информации.

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

    • kSecCodeInfoEntitlementsDict

      kSecCodeInfoEntitlementsDict

      A CFDictionaryRef объект, содержащий встроенные права кода, если это имеет права и они находятся в стандартной словарной форме. Отсутствующий, если код не имеет никаких прав, или они находятся в другом формате (когда, посмотрите kSecCodeInfoEntitlements).

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

    • kSecCodeInfoFormat

      kSecCodeInfoFormat

      Тип и формат кода в форме, подходящей для дисплея хорошо осведомленному пользователю.

      A CFStringRef объект.

      Это - универсальная информация, возвращенная, независимо от которого передаются флаги информации о Подписании.

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

    • kSecCodeInfoDigestAlgorithm

      kSecCodeInfoDigestAlgorithm

      A CFNumber указание вида криптографической хеш-функции, используемой в подписи для изоляции ее частей вместе.

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

    • kSecCodeInfoIdentifier

      kSecCodeInfoIdentifier

      Идентификатор подписания изолируется в подпись.

      A CFStringRef объект. Отсутствующий для кода без знака.

      Это - универсальная информация, возвращенная, независимо от которого передаются флаги информации о Подписании.

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

    • kSecCodeInfoImplicitDesignatedRequirement

      kSecCodeInfoImplicitDesignatedRequirement

      Определяемое требование (DR), которое сгенерированная система — или генерировала бы — для кода в отсутствие явно объявленного DR.

      A SecRequirementRef объект. Фактическое определяемое требование возвращается kSecCodeInfoDesignatedRequirement ключ. Если DR был неявно сгенерирован системой, два значения являются тем же; можно использовать этот факт для тестирования на явный DR.

      Укажите kSecCSRequirementInformation флаг для получения этой информации.

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

    • kSecCodeInfoMainExecutable

      kSecCodeInfoMainExecutable

      URL, определяющий местоположение основного исполняемого файла кода.

      A CFURLRef объект. Для единственных файлов URL определяет местоположение самого файла. Для пакетов это определяет местоположение основной исполнимой программы, как идентифицировано пакетом Info.plist файл.

      Это - универсальная информация, возвращенная, независимо от которого передаются флаги информации о Подписании.

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

    • kSecCodeInfoPList

      kSecCodeInfoPList

      Информационный словарь, содержащий содержание защищенного Info.plist файл, как замечено Code Signing Services.

      A CFDictionaryRef объект. Отсутствующий, если никакой информационный список свойств (Info.plist) файл известен Code Signing Services. Обратите внимание на то, что это - не обязательно тот же словарь как тот, который был бы возвращен функцией CFBundle такой как CFBundleCopyInfoDictionaryForURL, потому что CFBundle свободен добавить записи в информационный список свойств).

      Это - универсальная информация, возвращенная, независимо от которого передаются флаги информации о Подписании.

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

    • kSecCodeInfoRequirements

      kSecCodeInfoRequirements

      Внутренние требования кода как текстовая строка в каноническом синтаксисе.

      A CFStringRef объект. Если существует явное определяемое требование, то оно включено в эту текстовую строку.

      Укажите kSecCSRequirementInformation флаг для получения этой информации.

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

    • kSecCodeInfoRequirementData

      kSecCodeInfoRequirementData

      Внутренние требования кода как двоичный блоб.

      A CFDataRef объект. Если существует явное определяемое требование, то оно включено в этот блоб данных.

      Укажите kSecCSRequirementInformation флаг для получения этой информации.

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

    • kSecCodeInfoSource

      kSecCodeInfoSource

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

      A CFStringRef объект. Эта строка в целях дисплея только; не полагайтесь на точное возвращенное значение.

      Это - универсальная информация, возвращенная, независимо от которого передаются флаги информации о Подписании.

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

    • kSecCodeInfoStatus

      kSecCodeInfoStatus

      Флаги состояния кода для рабочего кода (см. Флаги Состояния Кода).

      A CFNumberRef объект. Это - снимок, взятый в то время, когда функция выполняется и может устареть к тому времени, когда Вы исследуете ее. Отметьте, однако, что некоторые флаговые значения не могут быть изменены и поэтому постоянно надежны.

      Укажите kSecCSDynamicInformation флаг для получения этой информации.

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

    • kSecCodeInfoTime

      kSecCodeInfoTime

      Дата подписания встраивается в подпись кода.

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

      Укажите kSecCSSigningInformation флаг для получения этой информации.

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

    • kSecCodeInfoTimestamp

      kSecCodeInfoTimestamp

      A CFDateRef объект, описывающий дату подписания, как (надежно) сертифицируется службой полномочий метки времени. Эта метка времени не может быть сфальсифицирована подписывающим лицом и доверена тому же градусу как служба метки времени, создавшая метку времени.

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

    • kSecCodeInfoTrust

      kSecCodeInfoTrust

      Доверие возражает системному использованию для оценки законности подписи кода.

      Сохраненный SecTrustRef объект. Можно использовать функции SecTrust (см. Сертификат, Ключ и Ссылку Trust Services для извлечения подробной информации, особенно по причинам, почему проверка сертификата, возможно, перестала работать. Поскольку этот объект может продолжать использоваться для дальнейших оценок подписи кода при внесении каких-либо изменений в него поведение функций SecTrust не определено.

      Укажите kSecCSSigningInformation флаг для получения этой информации.

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

    • kSecCodeInfoUnique

      kSecCodeInfoUnique

      Двоичное число, однозначно определяющее статический код.

      A CFDataRef объект. Этот идентификатор может использоваться для распознавания этого определенного кода в будущем. Этот идентификатор связывается к текущей версии кода, в отличие от этого kSecCodeInfoIdentifier идентификатор, остающийся стабильным через утвержденные разработчиками обновления. kSecCodeInfoUnique идентификатор в настоящее время является хешем SHA 1 каталога кода; однако, будущие версии системы могут использовать различный алгоритм для недавно кода со знаком. В любом случае идентификатор для уже подписанного кода не изменится.

      Это - универсальная информация, возвращенная, независимо от которого передаются флаги информации о Подписании.

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

    • kSecCodeSignerFlags

      kSecCodeSignerFlags

      A CFNumber объект, описывающий динамическое состояние объекта. Для списка констант посмотрите Флаги Подписи Кода.

      Доступный в OS X v10.7 через OS X v10.8.

  • Флаги подписи кода

    Опция отмечает для kSecCodeSignerFlags это может быть встроено в подпись кода во время подписания и которые управляют использованием подписи.

    Объявление

    Swift

    typealias SecCodeSignatureFlags = UInt32

    Objective C

    enum { kSecCodeSignatureHost = 0x0001, kSecCodeSignatureAdhoc = 0x0002, kSecCodeSignatureForceHard = 0x0100, kSecCodeSignatureForceKill = 0x0200, kSecCodeSignatureForceExpiration = 0x0400, }; typedef uint32_t SecCodeSignatureFlags;

    Константы

    • kSecCodeSignatureHost

      kSecCodeSignatureHost

      Может разместить гостевой код.

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

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

    • kSecCodeSignatureAdhoc

      kSecCodeSignatureAdhoc

      Должен использоваться без идентификационных данных подписания.

      Код был изолирован без идентификационных данных подписания. Никакие идентификационные данные не могут быть получены от него, и любые ограничения устанавливающего требования кода для идентификационных данных подписания перестанут работать. Когда Вы создаете оперативную подпись и не можете быть установлены явно, этот флаг установлен Code Signing Services. Оперативная подпись создается путем подписания с псевдоидентификационными данными «-» (тире).

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

    • kSecCodeSignatureForceHard

      kSecCodeSignatureForceHard

      Всегда устанавливайте kSecCodeStatusHard флаг состояния на запуске.

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

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

    • kSecCodeSignatureForceKill

      kSecCodeSignatureForceKill

      Всегда устанавливайте kSecCodeStatusKill флаг состояния на запуске.

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

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

    • kSecCodeSignatureForceExpiration

      kSecCodeSignatureForceExpiration

      Всегда устанавливайте kSecCSConsiderExpiration отметьте при проверке кода.

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

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

    Обсуждение

    Некоторые из этих флагов могут быть установлены через codesign(1) команда --options параметр и некоторые установлены неявно на основе подписания обстоятельств. Все флаги могут быть установлены с помощью kSecCodeSignerFlags запись в словаре информации о подписании.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

  • Гостевые флаги создания

    Флаги, используемые SecHostCreateGuest функция.

    Объявление

    Swift

    var kSecCSDedicatedHost: Int { get } var kSecCSGenerateGuestHash: Int { get }

    Objective C

    enum { kSecCSDedicatedHost = 1 << 0, kSecCSGenerateGuestHash = 1 << 1, };

    Константы

    • kSecCSDedicatedHost

      kSecCSDedicatedHost

      Объявляет выделенный хостинг для данного узла.

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

      Это недопустимо для объявления выделенного хостинга, если узел уже имеет других гостей, и это недопустимо для представления дополнительных гостей для этого узла после этого вызова.

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

    • kSecCSGenerateGuestHash

      kSecCSGenerateGuestHash

      Попросите, чтобы узел генерировал уникальный двоичный идентификатор (kSecCodeInfoUnique) от копии на диске в данном пути.

      Идеально, когда узел запускает гостевой код, это должно принести подпись в каталоге кода в память одновременно, создать уникальный двоичный идентификатор путем вычисления хеша SHA 1 подписи и передать его SecHostCreateGuest функционируйте как kSecGuestAttributeHash атрибут в словаре, когда это создает гостя. Выполнение так гарантирует, что идентификатор был сделан из той же версии кода, как был загружен в память. Этот идентификатор может использоваться узлом и другими процессами, чтобы удостовериться, что код не был изменен, потому что хеш каталога кода является уникальным идентификатором определенного экземпляра подписи. kSecCSGenerateGuestHash флаг говорит Code Signing Services выбирать подпись от диска и делать само вычисление. Наличие системы создает идентификатор из кода диска, удобно, но не самая безопасная опция, потому что для атакующего с доступом для записи возможно заменить различной копией каталога кода на диске после того, как код загружается в память, но прежде чем система генерирует идентификатор.

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

  • Пользовательские информационные ошибочные ключи словаря

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

    Объявление

    Swift

    let kSecCFErrorArchitecture: CFString! let kSecCFErrorPattern: CFString! let kSecCFErrorResourceSeal: CFString! let kSecCFErrorResourceAdded: CFString! let kSecCFErrorResourceAltered: CFString! let kSecCFErrorResourceMissing: CFString! let kSecCFErrorInfoPlist: CFString! let kSecCFErrorGuestAttributes: CFString! let kSecCFErrorRequirementSyntax: CFString! let kSecCFErrorPath: CFString!

    Objective C

    const CFStringRef kSecCFErrorPattern; const CFStringRef kSecCFErrorResourceSeal; const CFStringRef kSecCFErrorResourceAdded; const CFStringRef kSecCFErrorResourceAltered; const CFStringRef kSecCFErrorResourceMissing; const CFStringRef kSecCFErrorInfoPlist; const CFStringRef kSecCFErrorGuestAttributes; const CFStringRef kSecCFErrorRequirementSyntax; const CFStringRef kSecCFErrorPath;

    Константы

    • kSecCFErrorArchitecture

      kSecCFErrorArchitecture

      A CFStringRef объект, содержащий имя архитектуры, вызывающей проблему.

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

    • kSecCFErrorPattern

      kSecCFErrorPattern

      недопустимый образец выбора ресурса встретился.

      A CFStringRef объект, содержащий регулярное выражение, это - часть спецификации ресурса, не анализировавшей правильно. Спецификация ресурса является информационным списком свойств (Info.plist файл), который говорит, какие файлы являются ресурсами и которые не являются. Если какая-либо часть спецификации ресурса не может быть проанализирована, эта ошибка возвращается.

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

    • kSecCFErrorResourceSeal

      kSecCFErrorResourceSeal

      Недопустимый компонент в изоляции ресурса (CodeResources файл).

      A CFTypeRef содержа часть изоляции ресурса, имевшей проблему. CodeResources файл, сгенерированный как часть процесса подписывания кода, служит изоляцией пакета. Этот файл является CFDictionary, содержащим перечисление всех файлов, найденных в Вашем пакете вместе с их соответствующими значениями хэш-функции и рядом определений правила. Тип объекта возвратился, зависит, на котором элемент в словаре имел проблему. Посмотрите Подписывание кода OS X Подробно для получения дополнительной информации о CodeResources файл.

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

    • kSecCFErrorResourceAdded

      kSecCFErrorResourceAdded

      Негерметизированный ресурс найден.

      A CFURLRef объект, указывающий на ресурс на диске, не включенном в ресурсы со знаком для кода.

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

    • kSecCFErrorResourceAltered

      kSecCFErrorResourceAltered

      Измененный ресурс найден.

      A CFURLRef объект, указывающий на ресурс на измененном диске.

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

    • kSecCFErrorResourceMissing

      kSecCFErrorResourceMissing

      Обязательный изолированный ресурс отсутствует

      A CFURLRef объект, указывающий URL недостающего ресурса, поскольку это указано в CodeResources файл.

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

    • kSecCFErrorInfoPlist

      kSecCFErrorInfoPlist

      Info.plist словарь или другой компонент, как находили, были недопустимы.

      A CFTypeRef объект, идентифицирующий недопустимый компонент или ключ в словаре.

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

    • kSecCFErrorGuestAttributes

      kSecCFErrorGuestAttributes

      Гостевой атрибут, не принятый.

      A CFTypeRef объект, содержащий атрибут, передал SecHostCreateGuest или SecHostSetGuestStatus функция, которая является нераспознанной или это содержит значение неправильного типа.

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

    • kSecCFErrorRequirementSyntax

      kSecCFErrorRequirementSyntax

      Ошибка компиляции для источника требования кода.

      A CFStringRef содержа ошибку компиляции, сгенерированную синтаксическим анализатором, когда SecRequirementCreateWithStringAndErrors функция обрабатывает строку требования кода.

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

    • kSecCFErrorPath

      kSecCFErrorPath

      A CFURLRef объект для субкомпонента, содержащего ошибку.

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

  • Нулевой гостевой дескриптор

    Константа, которая может использоваться в качестве нулевого значения для a SecGuestRef объект.

    Объявление

    Swift

    var kSecNoGuest: Int { get }

    Objective C

    enum { kSecNoGuest = 0,

    Константы

    • kSecNoGuest

      kSecNoGuest

      Не допустимое SecGuestRef объект.

      Некоторые функции в API используют это значение, чтобы указать, что нет никакого гостя, и некоторые функции используют его, чтобы указать, что функция применяется к самому узлу, а не гостю.

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

  • Флаги функции подписывания кода

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

    Объявление

    Swift

    typealias SecCSFlags = UInt32

    Objective C

    typedef uint32_t SecCSFlags; enum { kSecCSDefaultFlags = 0, /* no particular flags (default behavior ) */ kSecCSConsiderExpiration = 1 << 31, /* consider expired certificates invalid */ kSecCSEnforceRevocationChecks = 1 << 30, /* force revocation checks regardless of preference settings */ };

    Константы

    • kSecCSDefaultFlags

      kSecCSDefaultFlags

      Никакие флаги (используют поведение по умолчанию).

      Не смешивайте это значение с другими флаговыми значениями.

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

    • kSecCSConsiderExpiration

      kSecCSConsiderExpiration

      Считайте истекшие сертификаты недопустимыми.

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

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

    • kSecCSEnforceRevocationChecks

      kSecCSEnforceRevocationChecks

      Проверка сил сертификатов против списков аннулирования или OCSP (онлайновый протокол состояния сертификата) независимо от предпочтительных настроек.

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

    Обсуждение

    Все биты в SecCSFlags перечисление резервируется Apple, Inc. При установке каких-либо битов, не определенных здесь поведение не определено.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

  • Флаги состояния кода

    Операционные флаги, присоединенные Code Signing Services к рабочему коду.

    Объявление

    Swift

    typealias SecCodeStatus = UInt32

    Objective C

    typedef uint32_t SecCodeStatus; enum { kSecCodeStatusValid = 0x0001, kSecCodeStatusHard = 0x0100, kSecCodeStatusKill = 0x0200,

    Константы

    • kSecCodeStatusValid

      kSecCodeStatusValid

      Указывает, что код динамично допустим

      Код это динамично допустимо, выполняет код, запустившийся должным образом подписанный и не лишенный законной силы, так как это запустилось. Допустимый бит не может быть установлен на рабочем коде; это может только быть очищено. Если Вы не устанавливаете kSecCodeStatusValid флаг во время создания гостя с SecCodeGetTypeID функция, тогда новый гость создается динамично недопустимый и никогда не может становиться динамично допустимым. Обратите внимание на то, что этот бит не предоставляет заверений о статической законности кода.

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

    • kSecCodeStatusHard

      kSecCodeStatusHard

      Указывает, что код предпочитает быть запрещенным доступа к ресурсам, если получение доступа лишило бы законной силы его.

      Этот бит не может быть очищен на рабочем коде; это может только быть установлено. Это не определено, будет ли код, имеющий твердый набор флага, но это начинается с допустимым очищенным битом (т.е. это уже недопустимо) все еще запрещен доступа к ресурсу, который лишил бы законной силы его, если это было все еще допустимо. Т.е. код может или может не получить доступ к такому ресурсу будучи недопустимым.

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

    • kSecCodeStatusKill

      kSecCodeStatusKill

      Указывает, что код хочет быть уничтоженным (завершенный), если он когда-нибудь теряет свою законность.

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

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

    Обсуждение

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

    Все биты в SecCodeStatus перечисление резервируется Apple, Inc. При установке каких-либо битов, не определенных здесь поведение не определено.

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

  • Атрибуты кода

    Атрибуты для словаря атрибута в SecStaticCodeCreateWithPathAndAttributes.

    Объявление

    Swift

    let kSecCodeAttributeArchitecture: CFString! let kSecCodeAttributeSubarchitecture: CFString! let kSecCodeAttributeBundleVersion: CFString!

    Objective C

    extern const CFStringRef kSecCodeAttributeArchitecture; extern const CFStringRef kSecCodeAttributeSubarchitecture; extern const CFStringRef kSecCodeAttributeBundleVersion;

    Константы

    • kSecCodeAttributeArchitecture

      kSecCodeAttributeArchitecture

      Архитектура, такой как i386 или x86_64.

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

    • kSecCodeAttributeSubarchitecture

      kSecCodeAttributeSubarchitecture

      Подархитектура (определенный тип процессора), такой как i686 или core2.

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

    • kSecCodeAttributeBundleVersion

      kSecCodeAttributeBundleVersion

      Версия комплекта.

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

  • Внутренние типы требования

    Перечисление, указывающее различные типы внутренних требований для кода. Эти константы являются индексами в наборы требования и в настоящее время не используются ни в каком общедоступном API.

    Объявление

    Swift

    typealias SecRequirementType = UInt32

    Objective C

    typedef uint32_t SecRequirementType; enum { kSecHostRequirementType = 1, kSecGuestRequirementType = 2, kSecDesignatedRequirementType = 3, kSecLibraryRequirementType = 4, kSecPluginRequirementType = 5, kSecInvalidRequirementType, kSecRequirementTypeCount = kSecInvalidRequirementType };

    Константы

    • kSecHostRequirementType

      kSecHostRequirementType

      Какие узлы могут выполнить этот код.

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

    • kSecGuestRequirementType

      kSecGuestRequirementType

      Каких гостей этот код может выполнить.

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

    • kSecDesignatedRequirementType

      kSecDesignatedRequirementType

      Определяемое требование.

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

    • kSecLibraryRequirementType

      kSecLibraryRequirementType

      Против каких библиотек этот код может соединиться.

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

    • kSecPluginRequirementType

      kSecPluginRequirementType

      Какие плагины этот код может загрузить.

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

    • kSecInvalidRequirementType

      kSecInvalidRequirementType

      Недопустимый тип требования.

      Эта константа для внутреннего использования Apple.

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

    • kSecRequirementTypeCount

      kSecRequirementTypeCount

      Число допустимых типов требования.

      Эта константа для внутреннего использования Apple.

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

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

    Objective C

    @import Security;

    Swift

    import Security

    Доступность

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

  • Статические флаги проверки кода

    Флаги используются функциями SecStaticCodeCheckValidity и SecStaticCodeCheckValidityWithErrors управлять проверкой кода в файловой системе.

    Объявление

    Swift

    var kSecCSCheckAllArchitectures: Int { get } var kSecCSDoNotValidateExecutable: Int { get } var kSecCSDoNotValidateResources: Int { get } var kSecCSBasicValidateOnly: Int { get } var kSecCSCheckNestedCode: Int { get }

    Objective C

    enum { kSecCSCheckAllArchitectures = 1 << 0, kSecCSDoNotValidateExecutable = 1 << 1, kSecCSDoNotValidateResources = 1 << 2, kSecCSBasicValidateOnly = kSecCSDoNotValidateExecutable | kSecCSDoNotValidateResources, kSecCSCheckNestedCode = 3 };

    Константы

    • kSecCSCheckAllArchitectures

      kSecCSCheckAllArchitectures

      Для мультиархитектуры (универсальные) Мужественные программы проверьте всю включенную архитектуру.

      По умолчанию только собственная архитектура проверена.

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

    • kSecCSDoNotValidateExecutable

      kSecCSDoNotValidateExecutable

      Не проверяйте содержание основной исполнимой программы.

      Содержание основной исполнимой программы обычно проверяется.

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

    • kSecCSDoNotValidateResources

      kSecCSDoNotValidateResources

      Не проверяйте присутствие и содержание всех ресурсов пакета (если таковые имеются).

      По умолчанию несоответствие в любом ресурсе пакета заставляет проверку перестать работать.

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

    • kSecCSBasicValidateOnly

      kSecCSBasicValidateOnly

      Комбинация kSecCSDoNotValidateExecutable и kSecCSDoNotValidateResources.

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

    • kSecCSCheckNestedCode

      kSecCSCheckNestedCode

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

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

Коды результата

Наиболее распространенные коды результата, возвращенные Code Signing Services, перечислены в таблице ниже. Присвоенный диапазон кодов результата для Code Signing Services 0xFFFE к 0xFAxx.

  • errSecSuccess

    Никакая ошибка.

    Значение

    0

    Описание

    Никакая ошибка.

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

  • errSecUnimplemented

    Функция или работа не реализованы.

    Значение

    - 4

    Описание

    Функция или работа не реализованы.

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

  • errSecParam

    Один или более параметров, переданных функции, не были допустимы.

    Значение

    - 50

    Описание

    Один или более параметров, переданных функции, не были допустимы.

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

  • errSecAllocate

    Не удалось выделить память.

    Значение

    - 108

    Описание

    Не удалось выделить память.

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

  • errSecCSUnimplemented

    Нереализованная функция подписывания кода.

    Значение

    - 67072

    Описание

    Нереализованная функция подписывания кода.

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

  • errSecCSInvalidObjectRef

    Недопустимая ссылка на объект API.

    Значение

    - 67071

    Описание

    Недопустимая ссылка на объект API.

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

  • errSecCSInvalidFlags

    Указаны недопустимые или несоответствующие флаги API.

    Значение

    - 67070

    Описание

    Указаны недопустимые или несоответствующие флаги API.

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

  • errSecCSObjectRequired

    Требуемый параметр указателя был NULL.

    Значение

    - 67069

    Описание

    Требуемый параметр указателя был NULL.

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

  • errSecCSStaticCodeNotFound

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

    Значение

    - 67068

    Описание

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

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

  • errSecCSUnsupportedGuestAttributes

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

    Значение

    - 67067

    Описание

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

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

  • errSecCSInvalidAttributeValues

    Значение атрибута, связанное с ключом, вне диапазона или является неправильным типом.

    Значение

    - 67066

    Описание

    Значение атрибута, связанное с ключом, вне диапазона или является неправильным типом.

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

  • errSecCSNoSuchCode

    Узел подписывания кода не имеет никакого гостевого кода с требуемыми атрибутами.

    Значение

    - 67065

    Описание

    Узел подписывания кода не имеет никакого гостевого кода с требуемыми атрибутами.

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

  • errSecCSMultipleGuests

    Узел подписывания кода имеет больше чем один блок гостевого кода с этим значением атрибута.

    Значение

    - 67064

    Описание

    Узел подписывания кода имеет больше чем один блок гостевого кода с этим значением атрибута.

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

  • errSecCSGuestInvalid

    Идентификационные данные гостевого кода были лишены законной силы.

    Значение

    - 67063

    Описание

    Идентификационные данные гостевого кода были лишены законной силы.

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

  • errSecCSUnsigned

    Объект кода не подписывается.

    Значение

    - 67062

    Описание

    Объект кода не подписывается.

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

  • errSecCSSignatureFailed

    Код или подпись изменяются.

    Значение

    - 67061

    Описание

    Код или подпись изменяются.

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

  • errSecCSSignatureNotVerifiable

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

    Значение

    - 67060

    Описание

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

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

  • errSecCSSignatureUnsupported

    Неподдерживаемый тип или версия подписи.

    Значение

    - 67059

    Описание

    Неподдерживаемый тип или версия подписи.

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

  • errSecCSBadDictionaryFormat

    Требуемый информационный список свойств (Info.plist) файл или ресурс уродливы.

    Значение

    - 67058

    Описание

    Требуемый информационный список свойств (Info.plist) файл или ресурс уродливы.

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

  • errSecCSResourcesNotSealed

    Ресурсы не изолируются подписью.

    Значение

    - 67057

    Описание

    Ресурсы не изолируются подписью.

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

  • errSecCSResourcesNotFound

    Не может найти изолированные ресурсы в коде.

    Значение

    - 67056

    Описание

    Не может найти изолированные ресурсы в коде.

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

  • errSecCSResourcesInvalid

    Изолированный каталог ресурса недопустим.

    Значение

    - 67055

    Описание

    Изолированный каталог ресурса недопустим.

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

  • errSecCSBadResource

    Изолированный ресурс отсутствует или недопустимый.

    Значение

    - 67054

    Описание

    Изолированный ресурс отсутствует или недопустимый.

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

  • errSecCSResourceRulesInvalid

    Недопустимое правило выбора ресурса или правила.

    Значение

    - 67053

    Описание

    Недопустимое правило выбора ресурса или правила.

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

  • errSecCSReqInvalid

    Недопустимые или поврежденные требования кода.

    Значение

    - 67052

    Описание

    Недопустимые или поврежденные требования кода.

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

  • errSecCSReqUnsupported

    Неподдерживаемый тип или версия требований кода.

    Значение

    - 67051

    Описание

    Неподдерживаемый тип или версия требований кода.

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

  • errSecCSReqFailed

    Коду не удалось удовлетворить одно из требований кода.

    Значение

    - 67050

    Описание

    Коду не удалось удовлетворить одно из требований кода.

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

  • errSecCSBadObjectFormat

    Формат объектных файлов, недопустимый или неподходящий.

    Значение

    - 67049

    Описание

    Формат объектных файлов, недопустимый или неподходящий.

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

  • errSecCSInternalError

    Внутренняя ошибка в подсистеме Code Signing Services.

    Значение

    - 67048

    Описание

    Внутренняя ошибка в подсистеме Code Signing Services.

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

  • errSecCSHostReject

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

    Значение

    - 67047

    Описание

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

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

  • errSecCSNotAHost

    Этот код не является узлом подписывания кода.

    Значение

    - 67046

    Описание

    Этот код не является узлом подписывания кода.

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

  • errSecCSSignatureInvalid

    Недопустимый формат для подписи.

    Значение

    - 67045

    Описание

    Недопустимый формат для подписи.

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

  • errSecCSHostProtocolRelativePath

    Разместите нарушение протокола: абсолютный гостевой путь требуется.

    Значение

    - 67044

    Описание

    Разместите нарушение протокола: абсолютный гостевой путь требуется.

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

  • errSecCSHostProtocolContradiction

    Разместите нарушение протокола: противоречащие режимы хостинга.

    Значение

    - 67043

    Описание

    Разместите нарушение протокола: противоречащие режимы хостинга.

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

  • errSecCSHostProtocolDedicationError

    Разместите нарушение протокола: работа, не позволенная с или для преданного гостя

    Значение

    - 67042

    Описание

    Разместите нарушение протокола: работа, не позволенная с или для преданного гостя

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

  • errSecCSHostProtocolNotProxy

    Разместите нарушение протокола: хостинг прокси, не занятый.

    Значение

    - 67041

    Описание

    Разместите нарушение протокола: хостинг прокси, не занятый.

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

  • errSecCSHostProtocolStateError

    Разместите нарушение протокола: недопустимый гостевой запрос изменения состояния.

    Значение

    - 67040

    Описание

    Разместите нарушение протокола: недопустимый гостевой запрос изменения состояния.

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

  • errSecCSHostProtocolUnrelated

    Разместите нарушение протокола: указанный код не является гостем указанного узла подписывания кода.

    Значение

    - 67039

    Описание

    Разместите нарушение протокола: указанный код не является гостем указанного узла подписывания кода.

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

  • errSecCSInvalidOperation

    Требуемая работа не допустима.

    Значение

    - 67038

    Описание

    Требуемая работа не допустима.

    Доступный в OS X v10.6 через OS X v10.6.

  • errSecCSNotSupported

    Работа, не поддерживаемая для этого типа кода.

    Значение

    - 67037

    Описание

    Работа, не поддерживаемая для этого типа кода.

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

  • errSecCSCMSTooLarge

    Подпись, слишком большая для встраивания.

    Значение

    - 67036

    Описание

    Подпись, слишком большая для встраивания.

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

  • errSecCSHostProtocolInvalidHash

    Разместите нарушение протокола: недопустимый хеш гостевого кода.

    Значение

    - 67035

    Описание

    Разместите нарушение протокола: недопустимый хеш гостевого кода.

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

  • errSecCSStaticCodeChanged

    Код диска был изменен после того, как код начал работать.

    Значение

    - 67034

    Описание

    Код диска был изменен после того, как код начал работать.

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

  • errSecCSDBDenied

    Доступ к базе данных подписи запрещен. Когда система пытается подписать код без знака оперативно и не могла записать в базу данных подписи из-за проблемы разрешения, эта ошибка возвращается.

    Значение

    - 67033

    Описание

    Доступ к базе данных подписи запрещен. Когда система пытается подписать код без знака оперативно и не могла записать в базу данных подписи из-за проблемы разрешения, эта ошибка возвращается.

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

  • errSecCSSigDBDenied

    Доступ к базе данных подписи запрещен. Когда система пытается подписать код без знака оперативно и не могла записать в базу данных подписи из-за проблемы разрешения, эта ошибка возвращается.

    Значение

    - 67033

    Описание

    Доступ к базе данных подписи запрещен. Когда система пытается подписать код без знака оперативно и не могла записать в базу данных подписи из-за проблемы разрешения, эта ошибка возвращается.

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

  • errSecCSDBAccess

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

    Значение

    - 67032

    Описание

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

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

  • errSecCSSigDBAccess

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

    Значение

    - 67032

    Описание

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

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

  • errSecCSHostProtocolInvalidAttribute

    Узел подписывания кода возвратил недопустимые или противоречивые атрибуты для гостевого кода.

    Значение

    - 67031

    Описание

    Узел подписывания кода возвратил недопустимые или противоречивые атрибуты для гостевого кода.

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

  • errSecCSInfoPlistFailed

    Недопустимый Info.plist ( Info.plist файл или подпись были изменены).

    Значение

    - 67030

    Описание

    Недопустимый Info.plist ( Info.plist файл или подпись были изменены).

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

  • errSecCSNoMainExecutable

    Код не имеет никакого основного исполняемого файла.

    Значение

    - 67029

    Описание

    Код не имеет никакого основного исполняемого файла.

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

  • errSecCSBadBundleFormat

    Формат пакета является нераспознанным, недопустимым, или неподходящим.

    Значение

    - 67028

    Описание

    Формат пакета является нераспознанным, недопустимым, или неподходящим.

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

  • errSecCSNoMatches

    Никакие соответствия не были найдены для работы поиска или обновления.

    Значение

    - 67027

    Описание

    Никакие соответствия не были найдены для работы поиска или обновления.

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

  • errSecCSFileHardQuarantined

    Значение

    - 67026

    Описание

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

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