Microsoft KB Archive/909425

= Error message in Windows Server 2003 and in Windows XP Professional: &quot;ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED&quot; =

Article ID: 909425

Article Last Modified on 10/11/2007

-

APPLIES TO

 Microsoft Windows Server 2003 SP1, when used with:  Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)

 Microsoft Windows Server 2003, Enterprise Edition

 Microsoft Windows Server 2003, Standard Edition (32-bit x86)

 Microsoft Windows Server 2003, Datacenter Edition for Itanium-Based Systems</li></ul>

 Microsoft Windows Server 2003, Enterprise Edition for Itanium-based Systems</li></ul> </li> Microsoft Windows Server 2003, Standard x64 Edition</li> Microsoft Windows Server 2003, Enterprise x64 Edition</li> Microsoft Windows Server 2003, Datacenter x64 Edition</li> Microsoft Windows XP Service Pack 2, when used with:  Microsoft Windows XP Professional</li></ul> </li></ul>

-

<div class="notice_section">

<div class="symptoms_section">

SYMPTOMS
When you try to retrieve information from the Secure Sockets Layer (SSL) certificate request message in Microsoft Windows Server 2003 or in Microsoft Windows XP Professional with Service Pack 2 (SP2), you may receive an error message that is similar to the following:

ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED

<div class="resolution_section">

Service pack information
To resolve this problem, obtain the latest service pack for Windows Server 2003. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

889100 How to obtain the latest service pack for Windows Server 2003

Prerequisites
Because of file dependencies, this hotfix requires Windows Server 2003 Service Pack 1 (SP1).

Note x64-based versions of Windows Server 2003 contain SP1.

Restart requirement
You must restart the computer after you apply this software update.

Hotfix replacement information
This hotfix replaces hotfix 902454.

File information
The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time tool in Control Panel.

Hotfix information
To resolve this problem for Microsoft Windows XP Professional, install the hotfix that is described in Microsoft Knowledge Base article 919477. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

919477 WinHTTP may not connect through a proxy server if proxy auto-configuration is used for Internet Explorer connectivity in Windows XP

<div class="status_section">

STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the &quot;Applies to&quot; section. This problem was first corrected in Windows Server 2003 Service Pack 2.

<div class="moreinformation_section">

MORE INFORMATION
When a client that has multiple certificates available connects to a server that requires a certificate, the client cannot know what certificate the server requested. The client must manually try each certificate until the client finds a certificate that the server accepts.

This hotfix provides a new Windows HTTP Services (WinHTTP) option to request the certificate information from the server so that the client can present the correct certificate.

Note The header value for the new option is 94.

The sample code for the new Windows HTTP Services (WinHTTP) option is similar to the following code. //Here is the header value. //Here is a sample usage for the new option WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST. SecPkgContext_IssuerListInfoEx* pIssuerList = NULL; DWORD dwBufferSize = sizeof(SecPkgContext_IssuerListInfoEx*); If (WinHttpQueryOption(hRequest, WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST, &pIssuerList, & dwBufferSize) == TRUE) {           // TODO: insert code to use / filter the issuer list GlobalFree(pIssuerList); // free the issuer list when done }
 * 1) define WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST 94
 * 1) include <schannel.h>

//Here is a sample usage of the issuer list retrieved from above. The example finds the certificate in the certificate store that matches the issuer list.

PCERT_CONTEXT pClientCert = NULL; CERT_CHAIN_FIND_BY_ISSUER_PARA SrchCriteria;
 * ZeroMemory(&SrchCriteria, sizeof(CERT_CHAIN_FIND_BY_ISSUER_PARA));

SrchCriteria.cbSize = sizeof(CERT_CHAIN_FIND_BY_ISSUER_PARA); SrchCriteria.cIssuer = pIssuerList->cIssuers; SrchCriteria.rgIssuer = pIssuerList->aIssuers; PCCERT_CHAIN_CONTEXT pClientCertChain = CertFindChainInStore(   pCacheEntry->_ClientCertStore,        X509_ASN_ENCODING,        CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_URL_FLAG |            // Do not perform wire download when building chains        CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_FLAG,            // Do not search pCacheEntry->_ClientCertStore             // for issuer certificates        CERT_CHAIN_FIND_BY_ISSUER,        &SrchCriteria,        NULL); if (pClientCertChain) { pClientCert = pClientCertChain->rgpChain[0]->rgpElement[0]->pCertContext; CertDuplicateCertificateContext(pClientCert); CertFreeCertificateChain(pClientCertChain); pClientCertChain = NULL; fRet = TRUE; } For more information, visit the following Microsoft Developer Network (MSDN) Web site:

http://msdn2.microsoft.com/en-us/library/aa384066.aspx

Additional query words: SSL Win2K3 WinHTTP

Keywords: kbbug kbfix kbqfe kbhotfixserver kbwinserv2003sp2fix KB909425

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.