IChannelCredentials Interfejs

Definicja

Przestrzeń nazw:

System.ServiceModel.ComIntegration

Zestaw:

System.ServiceModel.dll

Interfejs, który umożliwia ustawienie niektórych funkcji zabezpieczeń na serwerze proxy usługi.

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

Atrybuty

GuidAttribute InterfaceTypeAttribute

Przykłady

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)  

Uwagi

Niezarządzani klienci używają monikera "usługa", aby uzyskać dostęp do usług Windows Communication Foundation (WCF). Ci klienci podlegają modelowi zabezpieczeń WCF, a nie modelowi zabezpieczeń COM. IChannelCredentialsInterfejs jest dostarczany w celu określenia poświadczeń kanału. Jest to wymagane, ponieważ moniker COM nie może uzyskać dostępu do zarządzanego modelu obiektów zabezpieczeń WCF.

Wywoływanie metod w IChannelCredentials interfejsie po utworzeniu kanału nie jest dozwolone. Dzieje się tak, ponieważ Windows Communication Foundation (WCF) nie obsługuje zmiany ustawień zabezpieczeń w już otwartym kanale. Gdy klient monikera usługi uzyskuje serwer proxy, kanał nie został jeszcze utworzony. W ten sposób klient musi wywoływać IChannelCredentials metody przed wywołaniem metody usługi. Jeśli klient wywołuje IChannelCredentials metodę po wywołaniu metody usługi, zostanie zgłoszony wyjątek RPC_E_TOO_LATE.

Metody

SetClientCertificateFromFile(String, String, String)	Pobiera certyfikat z pliku i dodaje go do poświadczeń klienta.
SetClientCertificateFromStore(String, String, String, Object)	Pobiera certyfikat z magazynu certyfikatów i dodaje go do poświadczeń klienta.
SetClientCertificateFromStoreByName(String, String, String)	Pobiera certyfikat z magazynu certyfikatów według nazwy i dodaje go do poświadczeń klienta.
SetDefaultServiceCertificateFromFile(String, String, String)	Pobiera certyfikat z pliku i dodaje go do poświadczeń usługi jako certyfikat domyślny.
SetDefaultServiceCertificateFromStore(String, String, String, Object)	Pobiera certyfikat z magazynu certyfikatów i dodaje go do poświadczeń usługi jako certyfikatu domyślnego.
SetDefaultServiceCertificateFromStoreByName(String, String, String)	Pobiera certyfikat z magazynu certyfikatów według nazwy i dodaje go do poświadczeń usługi jako certyfikatu domyślnego.
SetIssuedToken(String, String, String)	Ustawia parametry dla wystawionego tokenu.
SetServiceCertificateAuthentication(String, String, String)	Ustawia parametry uwierzytelniania certyfikatu usługi.
SetUserNameCredential(String, String)	Ustawia poświadczenia nazwy użytkownika.
SetWindowsCredential(String, String, String, Int32, Boolean)	Ustawia poświadczenia systemu Windows.