Function

CFHTTPAuthenticationCopyRealm

Gets an authentication information’s namespace.

Declaration

CFStringRef CFHTTPAuthenticationCopyRealm(CFHTTPAuthenticationRef auth);

Parameters

auth

The CFHTTPAuthentication object to examine.

Return Value

The namespace, if there is one; otherwise NULL. Ownership follows the The Create Rule.

Discussion

Some authentication methods provide a namespace, and it is usually used to prompt the user for a name and password.

See Also

HTTP Authentication

CFHTTPAuthenticationRef

An opaque reference representing HTTP authentication information.

CFHTTPAuthenticationAppliesToRequest

Returns a Boolean value that indicates whether a CFHTTPAuthentication object is associated with a CFHTTPMessage object.

CFHTTPAuthenticationCopyDomains

Returns an array of domain URLs to which a given CFHTTPAuthentication object can be applied.

CFHTTPAuthenticationCopyMethod

Gets the strongest authentication method that will be used when a CFHTTPAuthentication object is applied to a request.

CFHTTPAuthenticationCreateFromResponse

Uses an authentication failure response to create a CFHTTPAuthentication object.

CFHTTPAuthenticationGetTypeID

Gets the Core Foundation type identifier for the CFHTTPAuthentication opaque type.

CFHTTPAuthenticationIsValid

Returns a Boolean value that indicates whether a CFHTTPAuthentication object is valid.

CFHTTPAuthenticationRequiresAccountDomain

Returns a Boolean value that indicates whether a CFHTTPAuthentication object uses an authentication method that requires an account domain.

CFHTTPAuthenticationRequiresOrderedRequests

Returns a Boolean value that indicates whether authentication requests should be made one at a time.

CFHTTPAuthenticationRequiresUserNameAndPassword

Returns a Boolean value that indicates whether a CFHTTPAuthentication object uses an authentication method that requires a username and a password.

kCFHTTPAuthenticationAccountDomain

Account domain to use for authentication.

kCFHTTPAuthenticationPassword

Password to use for authentication.

kCFHTTPAuthenticationSchemeBasic

Request the HTTP basic authentication scheme.

kCFHTTPAuthenticationSchemeDigest

Request the HTTP digest authentication scheme.

kCFHTTPAuthenticationSchemeKerberos

Request the HTTP Kerberos authentication scheme.

kCFHTTPAuthenticationSchemeNTLM

Request the HTTP NTLM authentication scheme.

kCFHTTPAuthenticationSchemeNegotiate

Request the HTTP Negotiate authentication scheme.

kCFHTTPAuthenticationSchemeNegotiate2

Request the HTTP Negotiate v2 authentication scheme.

kCFHTTPAuthenticationSchemeXMobileMeAuthToken

Request the HTTP XMobileMeAuthToken authentication scheme.

kCFHTTPAuthenticationUsername

Username to use for authentication.