2 * Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
4 * This component and the accompanying materials are made available
5 * under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
6 * which accompanies this distribution, and is available
7 * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
9 * Initial Contributors:
10 * Nokia Corporation - initial contribution.
15 * Name : siphttpdigestchallengeobserver2.h
16 * Part of : SIP Client
17 * Interface : SDK API, SIP Client API
24 #ifndef MSIPHTTPDIGESTCHALLENGEOBSERVER2_H
25 #define MSIPHTTPDIGESTCHALLENGEOBSERVER2_H
30 // FORWARD DECLARATIONS
31 class CSIPClientTransaction;
39 * The user should implement this interface if it intends to
40 * provide HTTP Digest credentials upon received challenges
41 * from the SIP servers on the signaling path.
42 * The user should provide credentials or ignore the challenge
43 * using functions defined in CSIPHttpDigest class.
47 class MSIPHttpDigestChallengeObserver2
49 public: // New functions
51 * A SIP request resulted in 401/407 response that contains
53 * The challenges can be obtained from Proxy-Authenticate- and/or
54 * WWW-Authenticate-headers in the CSIPResponseElements
55 * attached to the CSIPClientTransaction.
56 * The user must call CSIPHttpDigest::SetCredentialsL or
57 * CSIPHttpDigest::IgnoreChallenge for each challenge.
59 * @param aTransaction transaction which was completed with
60 * a response containing HTTP Digest challenge.
62 virtual void ChallengeReceived(
63 const CSIPClientTransaction& aTransaction) = 0;
66 * A refreshed SIP request resulted in 401/407 response that contains
68 * The challenges can be obtained from Proxy-Authenticate- and/or
69 * WWW-Authenticate-headers in the CSIPResponseElements
70 * attached to the CSIPClientTransaction attached to the CSIPRefresh.
71 * The user must call CSIPHttpDigest::SetCredentialsL or
72 * CSIPHttpDigest::IgnoreChallenge for each challenge.
74 * @param aRefresh the refresh for which a transaction completed with
75 * a response containing HTTP Digest challenge.
77 virtual void ChallengeReceived(
78 const CSIPRefresh& aRefresh) = 0;
81 #endif // MSIPHTTPDIGESTCHALLENGEOBSERVER2_H