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

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

Разработчик

Ссылка платформы основы ссылка класса NSURLCredential

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

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

NSURLCredential

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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


Доступный в iOS 2.0 и позже.

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

Загрузочная система URL поддерживает три типа учетных данных: основанные на пароле удостоверения пользователя, основанные на сертификате удостоверения пользователя и основанные на сертификате учетные данные сервера (используемый при проверке идентификационных данных сервера).

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

  • Создает и возвращается NSURLCredential объект для сервера доверяет аутентификации данное принятое доверие.

    Объявление

    Swift

    init(forTrust trust: SecTrust!) -> NSURLCredential

    Objective C

    + (NSURLCredential *)credentialForTrust:(SecTrustRef)trust

    Параметры

    trust

    Принятое доверие.

    Обсуждение

    Прежде, чем создать сервер доверяют учетным данным, это - ответственность делегата NSURLConnection возразите или NSURLDownload объект оценить доверие. Сделайте это путем вызова SecTrustEvaluate, передача его доверие, полученное из serverTrust метод сервера NSURLProtectionSpace объект. Если доверие недопустимо, запрос аутентификации должен быть отменен с cancelAuthenticationChallenge:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 3.0 и позже.

  • Создает и возвращается NSURLCredential объект для интернет-аутентификации по паролю с данным именем пользователя и паролем с помощью данной установки персистентности.

    Объявление

    Objective C

    + (NSURLCredential *)credentialWithUser:(NSString *)user password:(NSString *)password persistence:(NSURLCredentialPersistence)persistence

    Параметры

    user

    Пользователь для учетных данных.

    password

    Пароль для user.

    persistence

    Установка персистентности для учетных данных.

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

    NSURLCredential объект с именем пользователя user, пароль password, и использование установки персистентности persistence.

    Обсуждение

    Если persistence NSURLCredentialPersistencePermanent учетные данные сохранены в цепочке для ключей.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 2.0 и позже.

  • Создает и возвращается NSURLCredential объект для клиентской аутентификации сертификата с данными идентификационными данными и данным массивом клиентских сертификатов с помощью данной установки персистентности.

    Объявление

    Objective C

    + (NSURLCredential *)credentialWithIdentity:(SecIdentityRef)identity certificates:(NSArray *)certArray persistence:(NSURLCredentialPersistence)persistence

    Параметры

    identity

    Идентификационные данные для учетных данных.

    certArray

    Массив один или больше SecCertificateRef объекты, представляющие сертификаты для учетных данных.

    persistence

    Установка персистентности для учетных данных.

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

    Objective C

    @import Foundation;

    Доступность

    Доступный в iOS 3.0 и позже.

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

    Объявление

    Swift

    init(identity identity: SecIdentity, certificates certArray: [AnyObject], persistence persistence: NSURLCredentialPersistence)

    Objective C

    - (instancetype)initWithIdentity:(SecIdentityRef)identity certificates:(NSArray *)certArray persistence:(NSURLCredentialPersistence)persistence

    Параметры

    identity

    Идентификационные данные для учетных данных.

    certArray

    Массив один или больше SecCertificateRef объекты, представляющие сертификаты для учетных данных.

    persistence

    Установка персистентности для учетных данных.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 3.0 и позже.

  • Возвраты NSURLCredential объект для сервера доверяет аутентификации, инициализированной с данным принятым доверием.

    Объявление

    Swift

    init(trust trust: SecTrust!)

    Objective C

    - (instancetype)initWithTrust:(SecTrustRef)trust

    Параметры

    trust

    Принятое доверие.

    Обсуждение

    Прежде, чем создать сервер доверяют учетным данным, это - ответственность делегата NSURLConnection возразите или NSURLDownload объект оценить доверие. Сделайте это путем вызова SecTrustEvaluate, передача его доверие, полученное из serverTrust метод сервера NSURLProtectionSpace объект. Если доверие недопустимо, запрос аутентификации должен быть отменен с cancelAuthenticationChallenge:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 3.0 и позже.

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

    Объявление

    Swift

    init(user user: String, password password: String, persistence persistence: NSURLCredentialPersistence)

    Objective C

    - (instancetype)initWithUser:(NSString *)user password:(NSString *)password persistence:(NSURLCredentialPersistence)persistence

    Параметры

    user

    Пользователь для учетных данных.

    password

    Пароль для user.

    persistence

    Установка персистентности для учетных данных.

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

    NSURLCredential объект инициализируется с именем пользователя user, пароль password, и использование установки персистентности persistence.

    Обсуждение

    Если persistence NSURLCredentialPersistencePermanent учетные данные сохранены в цепочке для ключей.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • user Свойство

    Имя пользователя получателя. (только для чтения)

    Объявление

    Swift

    var user: String? { get }

    Objective C

    @property(readonly, copy) NSString *user

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • certificates Свойство

    Сертификаты об учетных данных, если это - клиентские учетные данные сертификата. (только для чтения)

    Объявление

    Swift

    var certificates: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *certificates

    Обсуждение

    Сертификаты SecCertificateRef объекты, представляющие сертификаты об учетных данных. nil если это не клиентские учетные данные сертификата.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 3.0 и позже.

  • hasPassword Свойство

    Булево значение, указывающее, имеет ли получатель пароль. (только для чтения)

    Объявление

    Swift

    var hasPassword: Bool { get }

    Objective C

    @property(readonly) BOOL hasPassword

    Обсуждение

    YEStrue если получатель имеет пароль, NOfalse иначе.

    Этот метод не пытается получить пароль.

    Если пароль этих учетных данных сохранен в цепочке для ключей пользователя, password может возвратиться nil даже если возвращается этот метод YEStrue— получение пароля может перестать работать, или пользователь может отказать в доступе.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

  • password Свойство

    Пароль получателя. (только для чтения)

    Объявление

    Swift

    var password: String? { get }

    Objective C

    @property(readonly, copy) NSString *password

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    hasPassword

  • identity Свойство

    Идентификационные данные этих учетных данных, если это - клиентские учетные данные сертификата. (только для чтения)

    Объявление

    Swift

    var identity: SecIdentity? { get }

    Objective C

    @property(readonly) SecIdentityRef identity

    Обсуждение

    Идентификационные данные учетных данных, или NULL если это не клиентские учетные данные сертификата.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 3.0 и позже.

  • persistence Свойство

    Установка персистентности получателя. (только для чтения)

    Объявление

    Swift

    var persistence: NSURLCredentialPersistence { get }

    Objective C

    @property(readonly) NSURLCredentialPersistence persistence

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.

Типы данных

  • Эти константы указывают, сколько времени будут сохранены учетные данные.

    Объявление

    Swift

    enum NSURLCredentialPersistence : UInt { case None case ForSession case Permanent case Synchronizable }

    Objective C

    typedef NS_ENUM(NSUInteger, NSURLCredentialPersistence) { NSURLCredentialPersistenceNone, NSURLCredentialPersistenceForSession, NSURLCredentialPersistencePermanent, NSURLCredentialPersistenceSynchronizable };

    Константы

    • None

      NSURLCredentialPersistenceNone

      Учетные данные не должны быть сохранены.

      Доступный в iOS 2.0 и позже.

    • ForSession

      NSURLCredentialPersistenceForSession

      Учетные данные должны быть сохранены только для этого сеанса.

      Доступный в iOS 2.0 и позже.

    • Permanent

      NSURLCredentialPersistencePermanent

      Учетные данные должны быть сохранены в цепочке для ключей.

      Доступный в iOS 2.0 и позже.

    • Synchronizable

      NSURLCredentialPersistenceSynchronizable

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

      Доступный в iOS 6.0 и позже.

    Обсуждение

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

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в iOS 2.0 и позже.