Export (0) Print
Expand All

Authentication

BITS supports Basic authentication, Passport authentication, and several challenge/response authentication schemes. If the server or proxy requires user authentication, use the IBackgroundCopyJob2::SetCredentials method to specify the user's credentials. BITS uses the CryptoAPI to protect the credentials.

BITS 1.2 and earlier:  The SetCredentials method is not available.

Basic authentication requires the user name and password to be embedded in the URL, for example, HTTP://username:password@server/path/file. Because the user name and password are clear text, an administrator can enumerate the jobs in the transfer queue and see the user name and password. The user name and password can also be seen by a network monitor program that is on the same physical network link as the client and server (unless you use HTTPS).

Instead of embedding the user name and password in the URL, you should use the SetCredentials method to specify the user name and password for Basic authentication. This prevents others from viewing the credentials. If you specify credentials in both places, BITS uses the user name and password from the URL.

For Passport authentication, BITS supports explicit credentials only, not implicit credentials tied to the account.

For challenge/response authentication, BITS impersonates the user and uses Snego to determine which challenge/response authentication to use, such as NTLM or the Kerberos protocol. For a list of challenge/response schemes that BITS supports, see BG_AUTH_SCHEME.

BITS jobs can fail if the virtual directory on the server has anonymous authentication and another authentication scheme enabled and if ACLs protect the virtual directory or download files. For example, a job fails with "access denied" if the virtual directory has anonymous and integrated authentication enabled and the file contains an ACL that allows only Ben to read the file. This occurs because the virtual directory allows anonymous access, so IIS does not explicitly authenticate Ben (Ben's credentials are not used to access the file and access is denied).

Using implicit credentials

To use the user's implicit (logon) credentials for NTLM or Kerberos authentication, call the IBackgroundCopyJob2::SetCredentials method and set the UserName and Password members of the BG_BASIC_CREDENTIALS structure to NULL. If you specify implicit credentials for a proxy, BITS will also use the implicit credentials for server authentication unless you specify explicit server credentials.

For additional information for services, see Service Accounts and BITS.

You could also change the LMCompatibilityLevel or UseLMCompat registry value; however, you should change these values only if you have an existing application that cannot be changed to call the SetCredentials method.

BITS will use implicit credentials for authentication if the LMCompatibilityLevel registry value is two or greater, and you have not called the SetCredentials method. The full path to the LMCompatibilityLevel registry value is HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\LSA\LmCompatibilityLevel.

Note that changing the LMCompatibilityLevel registry value can affect other applications and services running on the computer. For more information about using the LMCompatibilityLevel registry value, see KB147706.

If setting the LMCompatibilityLevel registry value is an issue, you can create the UseLMCompat registry value under HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\BITS. The registry value is a DWORD. The following table lists the possible values for UseLMCompat:

ValueDescription
0BITS will send implicit credentials whenever the server prompts for NTLM or Kerberos credentials.
1BITS will send implicit credentials only if the client computer's LMCompatibilityLevel registry value is greater than or equal to 2.

Prior to BITS 1.5:  Not supported

2BITS will send implicit credentials only if the application called the SetCredentials method.

Prior to BITS 2.0:  Not supported

 

BITS will use the following default values for the UseLMCompat registry value if the registry value does not exist:

Operating systemValue
Windows XP0
Windows XP with Service Pack 1 (SP1)0
Windows XP with Service Pack 2 (SP2)1
Windows XP with Service Pack 3 (SP3)1
Windows Server 20031
Windows Server 2003 R21
Windows Vista2
Windows Server 20082

 

BITS 1.2 and earlier:  BITS uses implicit credentials for NTLM or Kerberos authentication. If you wrote an application based on BITS 1.0 or 1.2, the same application may not run using later versions of BITS if the LMCompatibilityLevel value is less than two. Note that the default LMCompatibilityLevel value for Windows XP is zero.

Using certificates for client/server authentication

In secure client/server communication, clients and servers can use digital certificates to mutually authenticate each other. BITS automatically supports certificate-based server authentication for secure HTTP transports. To provide BITS the client certificate needed for mutual authentication, call either the IBackgroundCopyJobHttpOptions::SetClientCertificateByID or IBackgroundCopyJobHttpOptions::SetClientCertificateByName method.

When a website accepts but does not require an SSL client certificate, and the BITS job does not specify a client certificate, the job will fail with ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED (0x80072f0c).

Prior to Windows Vista:  BITS supports certificate-based server authentication for secure HTTP transports, but certificate-based client authentication is not supported.

Authentication scenarios not supported

The following table shows the authentication requests that BITS does not support.

Scenario not supportedWindows XPWindows Server 2003
Passport authentication on the server when the proxy requires authentication (using the HTTPS protocol).Not supportedNot supported
Passport authentication when the auto-detect proxy setting is set.Not supportedNot supported
Any authentication scheme on the server when the proxy requires Digest authentication.Not supportedNot supported
Negotiate authentication on the server when the proxy requires Basic authentication.Not supported
Using HTTPS when the proxy requires Digest authentication.Not supported

 

 

 

Community Additions

ADD
Show:
© 2014 Microsoft