IChannelCredentials Interfaccia

Definizione

Spazio dei nomi:

System.ServiceModel.ComIntegration

Assembly:

System.ServiceModel.dll

Interfaccia che consente l'impostazione di determinate funzionalità di sicurezza su un proxy del servizio.

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

Attributi

GuidAttribute InterfaceTypeAttribute

Esempio

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)  

Commenti

I client non gestiti usano il moniker "service" per accedere ai servizi Windows Communication Foundation (WCF). Questi client sono soggetti al modello di sicurezza WCF anziché al modello di sicurezza COM. L'interfaccia IChannelCredentials è fornita per specificare credenziali del canale. Questa operazione è necessaria perché il moniker COM non può accedere al modello a oggetti di sicurezza WCF gestito.

Dopo che il canale è stato creato, non è consentito chiamare metodi nell'interfaccia IChannelCredentials. Questo avviene perché Windows Communication Foundation (WCF) non supporta la modifica delle impostazioni di sicurezza in un canale già aperto. Quando il client del moniker del servizio ottiene un proxy, il canale non viene ancora creato. Il client deve quindi chiamare i metodi IChannelCredentials prima di richiamare il metodo del servizio. Se il client chiama un metodo IChannelCredentials dopo che è stato richiamato il metodo del servizio, verrà generata l'eccezione RPC_E_TOO_LATE.

Metodi

SetClientCertificateFromFile(String, String, String)	Recupera un certificato da un file e lo aggiunge alle credenziali client.
SetClientCertificateFromStore(String, String, String, Object)	Recupera un certificato da un archivio certificati e lo aggiunge alle credenziali client.
SetClientCertificateFromStoreByName(String, String, String)	Recupera un certificato da un archivio certificati in base al nome e lo aggiunge alle credenziali client.
SetDefaultServiceCertificateFromFile(String, String, String)	Recupera un certificato da un file e lo aggiunge alle credenziali del servizio come il certificato predefinito.
SetDefaultServiceCertificateFromStore(String, String, String, Object)	Recupera un certificato da un archivio certificati e lo aggiunge alle credenziali del servizio come il certificato predefinito.
SetDefaultServiceCertificateFromStoreByName(String, String, String)	Recupera un certificato da un archivio certificati in base al nome e lo aggiunge alle credenziali del servizio come certificato predefinito.
SetIssuedToken(String, String, String)	Consente di impostare i parametri per il token emesso.
SetServiceCertificateAuthentication(String, String, String)	Consente di impostare i parametri di autenticazione del certificato del servizio.
SetUserNameCredential(String, String)	Consente di impostare le credenziali del nome utente.
SetWindowsCredential(String, String, String, Int32, Boolean)	Imposta le credenziali di Windows.