Export (0) Print
Expand All

ClientCredentials.ServiceCertificate Property

Gets an object used to specify a service's X.509 certificate.

Namespace:  System.ServiceModel.Description
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public X509CertificateRecipientClientCredential ServiceCertificate { get; }

Property Value

Type: System.ServiceModel.Security.X509CertificateRecipientClientCredential
An X509CertificateRecipientClientCredential that represents the certificate to use for a particular service.

You can use the object returned by this property to configure the certificate's properties by calling its members.

You can specify a single default certificate as well as a different certificate to be used when communicating with a particular URI.

Through this class, you also control the authentication settings for service certificates negotiated through SSL/TLS negotiation performed at the message level.

This property does not always have to be specified. Whether it is required depends on the authentication mode and negotiation options set on the binding that is used to communicate with the service. Some relevant classes that control this behavior are MessageSecurityOverHttp and MessageSecurityOverTcp.

You can also set this value using the <certificate> for <identity> element in a client application configuration file.

This code shows how to use this property to get the service's certificate and set its properties.

X509CertificateRecipientClientCredential rcc =
    client.ClientCredentials.ServiceCertificate;

X509Certificate2 cert = new X509Certificate2();
rcc.ScopedCertificates.Add(new Uri("http://fabrikam.com/sts"), cert);

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft