2 * Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
4 * This component and the accompanying materials are made available
5 * under the terms of "Eclipse Public License v1.0"
6 * which accompanies this distribution, and is available
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
9 * Initial Contributors:
10 * Nokia Corporation - initial contribution.
15 * Name : siphttpdigestchallengeobserver.h
16 * Part of : SIP Client
17 * Interface : SDK API, SIP Client API
24 #ifndef MSIPHTTPDIGESTCHALLENGEOBSERVER_H
25 #define MSIPHTTPDIGESTCHALLENGEOBSERVER_H
27 // FORWARD DECLARATIONS
35 * The user must implement this interface if it intends to
36 * provide HTTP Digest credentials upon received challenges
37 * from the SIP servers on the signaling path.
38 * The user should provide credentials or ignore the challenge
39 * using functions defined in TSIPHttpDigest class.
41 * MSIPHttpDigestChallengeObserver class is compliant with RFC 2543
42 * where Proxy use to forward only one challenge when it receives
43 * multiple challenges on forking the request. Applications are
44 * encouraged to use MSIPHttpDigestChallengeObserver2 class which
45 * provides interface to extract multiple challenges.
46 * MSIPHttpDigestChallengeObserver2 class is compliant to RFC 3261
49 class MSIPHttpDigestChallengeObserver
51 public: // New functions
53 * SIP request resulted in 401/407 response that contains
56 * @param aRealm a realm for which the challenge was received
58 virtual void ChallengeReceived(const TDesC8& aRealm) = 0;