Overview

Challenge handler for Basic authentication as defined in RFC 2617.

This BasicChallengeHandler can be loaded and instantiated using KGChallengeHandlers load, and registered at a location using KGDispatchChallengeHandler register.

In addition, one can install general and realm-specific KGLoginHandler objects onto this KGBasicChallengeHandler to assist in handling challenges associated with any or specific realms. This can be achieved using setLoginHandler:(LoginHandler*) and setRealmLoginHandler:(NSString *)realm loginHandler:(KGLoginHandler *)loginHandler methods.

The following example loads an instance of a KGBasicChallengeHandler, sets a login handler onto it and registers the basic handler at a URI location. In this way, all attempts to access that URI for which the server issues “Basic” challenges are handled by the registered KGBasicChallengeHandler.

@interface MyLoginHandler : KGLoginHandler
@end

@implementation MyLoginHandler

-(NSURLCredential*) credentials {
    return [[NSURLCredential alloc] initWithUser:@"global" password:@"credentials" persistence:NSURLCredentialPersistenceNone];
}
@end

-(void)initChallenge {
    // set up Login Handler:
    MyLoginHandler* loginHandler = [[MyLoginHandler alloc] init];

    KGBasicChallengeHandler* challengeHandler = [KGBasicChallengeHandler create];
    [challengeHandler setLoginHandler:loginHandler];

    // Attach the challenge handler as a default challenge handler to the KGWebSocketFactory
    // It can also be attached to the KGWebSocket created using [KGWebSocket setChallengeHandler:]
    [webSocketFactory setDefaultChallengeHandler:challengeHandler];
}

see RFC 2616 – HTTP 1.1 see RFC 2617 Section 2 – Basic Authentication