NSURLCredential

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

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

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

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

NSObject
NSURLCredential

NSObject
NSURLCredential

Соответствует

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание учетных данных

init (forTrust:) + credentialForTrust:

Создает и возвращается 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

Доступность

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


    
    credentialWithUser:password:persistence:
    + credentialWithUser:password:persistence:

Создает и возвращается 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;

Доступность

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

См. также

– initWithUser:password:persistence:


    
    init (identity:certificates:persistence:)
    + credentialWithIdentity:certificates:persistence:

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

Объявление

Swift

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

Objective C

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

Параметры

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    init (identity:certificates:persistence:)
    - initWithIdentity:certificates:persistence:

Возвраты 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

Доступность

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

init (доверие:) - initWithTrust:

Возвраты 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

Доступность

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


    
    init (user:password:persistence:)
    - initWithUser:password:persistence:

Возвраты 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

Доступность

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

См. также

+ credentialWithUser:password:persistence:

Получение учетных свойств

пользователь пользователь Свойство

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

Объявление

Swift

var user: String? { get }

Objective C

@property(readonly, copy) NSString *user

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 и позже.
сертификаты сертификаты Свойство

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

Объявление

Swift

var certificates: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *certificates

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

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

Объявление

Swift

var hasPassword: Bool { get }

Objective C

@property(readonly) BOOL hasPassword

Обсуждение

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

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.2 и позже.
пароль пароль Свойство

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

Объявление

Swift

var password: String? { get }

Objective C

@property(readonly, copy) NSString *password

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

hasPassword
идентификационные данные идентификационные данные Свойство

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

Объявление

Swift

var identity: SecIdentity? { get }

Objective C

@property(readonly) SecIdentityRef identity

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

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

Объявление

Swift

var persistence: NSURLCredentialPersistence { get }

Objective C

@property(readonly) NSURLCredentialPersistence persistence

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Типы данных

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

Объявление

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
  
  Учетные данные не должны быть сохранены.
  
  Доступный в OS X v10.2 и позже.
- ForSession
  
  NSURLCredentialPersistenceForSession
  
  Учетные данные должны быть сохранены только для этого сеанса.
  
  Доступный в OS X v10.2 и позже.
- Permanent
  
  NSURLCredentialPersistencePermanent
  
  Учетные данные должны быть сохранены в цепочке для ключей.
  
  Доступный в OS X v10.2 и позже.
- Synchronizable
  
  NSURLCredentialPersistenceSynchronizable
  
  Учетные данные должны быть сохранены постоянно в цепочке для ключей, и кроме того должны быть распределены другим устройствам на основе владения AppleID.
  
  Доступный в OS X v10.8 и позже.
Обсуждение

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

NSURLCredential

Создание учетных данных

Объявление

Параметры

Обсуждение

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

Доступность

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Доступность

Объявление

Параметры

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

Доступность

Объявление

Параметры

Обсуждение

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

Доступность

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Получение учетных свойств

Объявление

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

Объявление

Обсуждение

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

Доступность

См. также

Объявление

Обсуждение

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

Доступность

Объявление

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

Доступность

Типы данных

Объявление

Константы

Обсуждение

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

Доступность