DigestAuthentication Property of the IFPCWebListenerProperties Interface
The DigestAuthentication property gets or sets a Boolean value that indicates whether Digest authentication is used.
C++
HRESULT put_DigestAuthentication(
VARIANT_BOOL fDigestAuthentication
);
HRESULT get_DigestAuthentication(
VARIANT_BOOL* pfDigestAuthentication
);
Parameters
fDigestAuthentication
Boolean value that indicates whether Digest authentication is used.pfDigestAuthentication
Pointer to a Boolean variable that is set on return to VARIANT_TRUE if Digest authentication is used, or to VARIANT_FALSE if Digest authentication is not used.
Return Value
These property methods return S_OK if the call is successful; otherwise, they return an error code.
Visual Basic
Property DigestAuthentication As Boolean
Property Value
Boolean value that indicates whether Digest authentication is used.
Remarks
This property is read/write. Its default value is False (VARIANT_FALSE in C++).
Digest authentication offers the same features as Basic authentication but involves a different way of transmitting the client's identity. The authentication credentials (the user name and password) pass through a one-way process, often referred to as hashing. The result of this process is a fixed-length value called a hash or digest, which is not feasibly decrypted, that is, the original user name and password cannot be recovered from the hash value.
Additional information is added to the password before hashing so that no one can capture the password hash and use it to impersonate the true user. Values are added that help to identify the user, the user's computer, and the domain to which the user belongs. A time stamp is added to prevent a user from using a password after it has been revoked. This is an advantage over Basic authentication, because the password cannot be intercepted and used by an unauthorized person.
If this property is set to True (VARIANT_TRUE in C++) and the UseDigestSSP property of the FPCWebProxy object (IFPCWebProxy interface in C++) is set to True (VARIANT_TRUE in C++), Advanced Digest authentication will be used instead of Digest authentication provided all the conditions for using Advanced Digest authentication are met.
Digest authentication can be enabled for a Web listener together with Basic authentication, Integrated authentication, and SSL certificate authentication.
Requirements
Client | Requires Windows 7 or Windows Vista. |
Server | Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2. |
Version | Requires Forefront Threat Management Gateway (TMG) 2010. |
IDL | Declared in Msfpccom.idl. |
DLL | Requires Msfpccom.dll. |
See Also
Send comments about this topic to Microsoft
Build date: 6/30/2010