Język

IChannelCredentials Interfejs

Definicja

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

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

Klienci niezarządzani używają nazwy "service" do uzyskiwania dostępu do usług Windows Communication Foundation (WCF). Ci klienci podlegają modelowi zabezpieczeń WCF, a nie modelowi zabezpieczeń MODELU COM. Interfejs IChannelCredentials jest udostępniany do określania poświadczeń kanału. Jest to wymagane, ponieważ moniker COM nie może uzyskać dostępu do zarządzanego modelu obiektów zabezpieczeń WCF.

Nie jest legalne wywoływanie metod w interfejsie IChannelCredentials po utworzeniu kanału. Dzieje się tak, ponieważ Windows Communication Foundation (WCF) nie obsługuje zmiany ustawień zabezpieczeń na już otwartym kanale. Gdy klient moniker usługi uzyskuje serwer proxy, kanał nie został jeszcze utworzony. W związku z tym klient musi wywołać IChannelCredentials metody przed wywołaniem metody usługi. Jeśli klient wywołuje metodę IChannelCredentials po wywołaniu metody usługi, zgłaszany jest wyjątek RPC_E_TOO_LATE.

Metody

Nazwa Opis
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 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 Windows.

Dotyczy