NSURLCredential(GDNET) Category Reference

NSURLCredential category with additional features. More...

#import <BlackBerryDyanmics/GD/NSURLCredential+GDNET.h>

Description

This class is a category of the Foundation NSURLCredential class that can be used when the BlackBerry Dynamics proxy infrastructure is in use via the URL Loading System (see GDURLLoadingSystem). This class provides the ability to set the persistence of credentials.

See also

NSURLCredential class reference on the apple.com developer website.

Properties
NSUInteger	gdPersistence
	Credential persistence. More...
BOOL	gdKerberosAllowDelegation
	Whether to request Kerberos tickets that can be delegated. More...

Property Documentation

gdPersistence

- (NSUInteger) gdPersistence

readwriteatomicassign

Set this property of an NSURLCredential object to specify the persistence for the credential that it represents. This property can be set on a server trust credential that is created as part of the processing of an NSURLAuthenticationMethodServerTrust authentication challenge.

The property can be set to one of the following values:

• NSURLCredentialPersistenceNone Credential won't be stored persistently.
• NSURLCredentialPersistencePermanent Credential will be stored persistently in the application's BlackBerry Dynamics secure store.

If the credential is stored persistently then it will be reused automatically every time an authentication challenge for the same protection space is received. This means that the following callbacks won't be invoked:

• NSURLConnectionDelegate willSendRequestForAuthenticationChallenge
• GDURLRequestConnectionDelegate willSendRequestForAuthenticationChallenge

Automatic reuse continues until one of the following occurs:

• The server presents different certificate details.
• The application cancels persistence, by calling the undoPriorTrustDecision function.

See the class reference of the NSMutableURLRequest(GDNET) category for details of the undoPriorTrustDecision function.

gdKerberosAllowDelegation

- (BOOL) gdKerberosAllowDelegation

readwriteatomicassign

Set this property of an NSURLCredential object to specify whether to request tickets that can be delegated when the credential that it represents it used for Kerberos authentication.

Even if this property is set to YES, a ticket that can be delegated might not be issued. Delegation also depends on configuration in the Kerberos Key Distribution Center (KDC) at the enterprise.

---

The documentation for this category was generated from the following file:

• NSURLCredential+GDNET.h