Compartir a través de

<clientCertificate> del Elemento <clientCredentials>

  • Artículo

Define un certificado X.509 que se usa para autenticar un cliente en un servicio.

<configuración>
  <system.serviceModel>
    <behaviors>
      <endpointBehaviors>
        <behavior>
          <clientCredentials>
            <clientCertificate>

Sintaxis

<clientCertificate findValue="String"
                   storeLocation="LocalMachine/CurrentUser"
                   storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"
                   x509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" />

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios

Atributos

Atributo Descripción
findValue Una cadena que contiene el valor que se va a buscar en el almacén de certificados X.509. El tipo contenido en el atributo debe satisfacer los requisitos del valor del atributo x509FindType. El valor predeterminado es una cadena vacía.
storeLocation Especifica la ubicación del certificado X.509 que usa el cliente para autenticarse al servicio. Los valores válidos incluyen los siguientes:

- LocalMachine: el almacén de certificados asignado a la máquina local.
- CurrentUser: el almacén de certificados asignado al usuario actual.

El valor predeterminado es LocalMachine. Este atributo es del tipo StoreLocation.
storeName Especifica el nombre del almacén del certificado X.509 que se va a buscar. Los valores válidos incluyen los siguientes:

- AddressBook: almacén de certificados para otros usuarios.
- AuthRoot: almacén del certificado para las entidades de certificación (CA) de otros fabricantes.
- CertificateAuthority: almacén del certificado para las entidades de certificación (CA) intermedias.
- Disallowed: almacén de certificados para los certificados revocados.
- My: almacén de certificados para los certificados personales.
- Root: almacén del certificado para las entidades de certificación (CA) raíz de confianza.
- TrustedPeople: almacén de certificados para las personas y los recursos de confianza directa.
- TrustedPublisher: almacén de certificados para publicadores de confianza directa.

El valor predeterminado es My. Este atributo es del tipo StoreName.
x509FindType Define el tipo de búsqueda de X.509 que se va a ejecutar. El tipo contenido en el atributo findValue debe satisfacer los requisitos de este atributo. Los valores válidos incluyen los siguientes:

- FindByThumbPrint
- FindBySubjectName
- FindBySubjectDistinguishedName
- FindByIssuerName
- FindByIssuerDistinguishedName
- FindBySerialNumber
- FindByTimeValid
- FindByTimeNotYetValid
- FindByTemplateName
- FindByApplicationPolicy
- FindByCertificatePolicy
- FindByExtension
- FindByKeyUsage
- FindBySubjectKeyIdentifier

El valor predeterminado es FindBySubjectDistinguishedName. Este atributo es del tipo X509FindType.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción
<clientCredentials> Especifica las credenciales usadas para autenticar el cliente en un servicio.

Comentarios

Este elemento de configuración especifica que el certificado utilizado para autenticar el cliente con este elemento. Para obtener más información, consulta Cómo: Especificar valores de credenciales de cliente.

Consulte también