IChannelCredentials Interfaz

Referencia

Definición

Espacio de nombres:: System.ServiceModel.ComIntegration

Ensamblado:: System.ServiceModel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Una interfaz que permite la configuración de ciertas características de seguridad en un proxy del servicio.

public interface class IChannelCredentials

[System.Runtime.InteropServices.Guid("181b448c-c17c-4b17-ac6d-06699b93198f")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIDispatch)]
public interface IChannelCredentials

[<System.Runtime.InteropServices.Guid("181b448c-c17c-4b17-ac6d-06699b93198f")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIDispatch)>]
type IChannelCredentials = interface

Public Interface IChannelCredentials

Atributos: GuidAttribute InterfaceTypeAttribute

Ejemplos

monString = "service:mexAddress=http://localhost:8000/ServiceModelSamples/Service?wsdl"  
    monString = monString + ", address=http://localhost:8000/ServiceModelSamples/Service"  
    monString = monString + ", binding=BasicHttpBinding_ICalculator, bindingNamespace=http://Microsoft.ServiceModel.Samples"  
    monString = monString + ", contract=ICalculator, contractNamespace=http://Microsoft.ServiceModel.Samples"  

    Set monikerProxy = GetObject(monString)  

    'Set the Service Certificate.  
    monikerProxy.ChannelCredentials.SetServiceCertificateAuthentication "CurrentUser", "NoCheck", "PeerOrChainTrust"  
    monikerProxy.ChannelCredentials.SetDefaultServiceCertificateFromStore "CurrentUser", "TrustedPeople", "FindBySubjectName", "localhost"  

    'Set the Client Certificate.  
    monikerProxy.ChannelCredentials.SetClientCertificateFromStoreByName "CN=client.com", "CurrentUser", "My"  
    MsgBox monikerProxy.Add(3, 4)

Comentarios

Los clientes no administrados usan el moniker "servicio" para tener acceso a los servicios Windows Communication Foundation (WCF). Estos clientes están sujetos al modelo de seguridad de WCF en lugar del modelo de seguridad COM. La interfaz IChannelCredentials se proporciona para especificar las credenciales del canal. Esto es necesario porque el moniker COM no puede tener acceso al modelo de objetos de seguridad de WCF administrado.

No es legal llamar métodos en la interfaz IChannelCredentials una vez creado el canal. Esto se debe a que Windows Communication Foundation (WCF) no admite la modificación de la configuración de seguridad en un canal ya abierto. Cuando el cliente de moniker de servicio obtiene un proxy, el canal no está todavía creado. De este modo, el cliente debe llamar a los métodos IChannelCredentials antes de invocar el método de servicio. Si el cliente llama a un método IChannelCredentials una vez invocado el método de servicio, se produce la excepción RPC_E_TOO_LATE.

Métodos

SetClientCertificateFromFile(String, String, String)	Recupera un certificado desde un archivo y lo agrega a las credenciales del cliente.
SetClientCertificateFromStore(String, String, String, Object)	Recupera un certificado desde un almacén de certificados y lo agrega a las credenciales del cliente.
SetClientCertificateFromStoreByName(String, String, String)	Recupera un certificado desde un almacén de certificados por nombre y lo agrega a las credenciales del cliente.
SetDefaultServiceCertificateFromFile(String, String, String)	Recupera un certificado de un archivo y lo agrega a las credenciales de servicio como el certificado predeterminado.
SetDefaultServiceCertificateFromStore(String, String, String, Object)	Recupera un certificado de un almacén de certificados y lo agrega a las credenciales de servicio como el certificado predeterminado.
SetDefaultServiceCertificateFromStoreByName(String, String, String)	Recupera un certificado de un almacén de certificados por nombre y lo agrega a las credenciales de servicio como el certificado predeterminado.
SetIssuedToken(String, String, String)	Configura los parámetros para el token emitido.
SetServiceCertificateAuthentication(String, String, String)	Configura los parámetros de autenticación del certificado de servicio.
SetUserNameCredential(String, String)	Configura las credenciales del nombre de usuario.
SetWindowsCredential(String, String, String, Int32, Boolean)	Configura las credenciales de Windows.

Se aplica a