<clientCredentials>

Specifies the credentials used to authenticate the client to a service.

Schema Hierarchy

<system.serviceModel>
  <behaviors>
    <endpointBehaviors>
      <behavior> of <endpointBehaviors>
        <clientCredentials>

Syntax

<clientCredentials type="String"
      supportInteractive="Boolean" >
   <clientCertificate>
   </clientCertificate>
   <digest>
   </digest>
   <isuedToken>
   </isuedToken>
   <peer>
   </peer>
   <serviceCertificate>
   </serviceCertificate>
   <windowsAuthentication>
   </windowsAuthentication>
</clientCredentials>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description

supportInteractive

A Boolean value that specifies whether an interactive user can be involved in selecting a client credential at runtime. The default value is true.

type

A string that specifies the type of this configuration element.

Child Elements

Element Description

<clientCertificate> of <clientCredentials> Element

Specifies the certificate used to authenticate the client to the service. This element is of type X509InitiatorCertificateClientElement.

<httpDigest> Element

Specifies a digest used to authenticate the client to the service. This element is of type HttpDigestClientElement.

<issuedToken>

Specifies a custom token type used to authenticate the client to a Secure Token Service (STS). This element is of type IssuedTokenClientElement.

<peer> of <clientCredentials> Element

Specifies a current peer credential. This element is of type PeerCredentialElement.

<serviceCertificate> of <clientCredentials> Element

Specifies the certificate used to authenticate the service to the client and provides a structure for setting certificate options. This certificate must be supplied out-of-band from the service to the client. This element is of type X509RecipientCertificateClientElement.

<windows> of <clientCredentials> Element

Specifies a Windows credential. The default is the credential of the current thread. This element is of type WindowsClientElement.

Parent Elements

Element Description

<behavior> of <endpointBehaviors>

Specifies an endpoint behavior.

Remarks

Client credentials are used to authenticate the client to services in cases where mutual authentication is required. This configuration section can also be used to specify service certificates for scenarios where the client must secure messages to a service with the service's certificate.

See Also

Reference

ClientCredentialsElement
ClientCredentials

Other Resources

Security Behaviors in WCF
Securing Clients


© 2007 Microsoft Corporation. All rights reserved.
Last Published: 2010-01-05