IChannelCredentials Schnittstelle

Definition

Eine Schnittstelle, die die Einstellung bestimmter Sicherheitsfeatures in einem Dienstproxy zulässt.

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
Attribute

Beispiele

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)  

Hinweise

Nicht verwaltete Clients verwenden den Moniker "Dienst" für den Zugriff auf Windows Communication Foundation (WCF)-Dienste. Diese Clients unterliegen dem WCF-Sicherheitsmodell und nicht dem COM-Sicherheitsmodell. Die IChannelCredentials Schnittstelle wird bereitgestellt, um Kanalanmeldeinformationen anzugeben. Dies ist erforderlich, da der COM-Moniker nicht auf das verwaltete WCF-Sicherheitsobjektmodell zugreifen kann.

Es ist nicht zulässig, Methoden auf der IChannelCredentials Schnittstelle aufzurufen, nachdem der Kanal erstellt wurde. Dies liegt daran, dass Windows Communication Foundation (WCF) das Ändern von Sicherheitseinstellungen in einem bereits geöffneten Kanal nicht unterstützt. Wenn der Dienstmoniker-Client einen Proxy abruft, wird der Kanal noch nicht erstellt. Daher muss der Client Methoden aufrufen IChannelCredentials , bevor die Dienstmethode aufgerufen wird. Wenn der Client eine IChannelCredentials Methode aufruft, nachdem die Dienstmethode aufgerufen wurde, wird die Ausnahme ausgelöst, RPC_E_TOO_LATE ausgelöst wird.

Methoden

Name Beschreibung
SetClientCertificateFromFile(String, String, String)

Ruft ein Zertifikat aus einer Datei ab und fügt es den Clientanmeldeinformationen hinzu.

SetClientCertificateFromStore(String, String, String, Object)

Ruft ein Zertifikat aus einem Zertifikatspeicher ab und fügt es den Clientanmeldeinformationen hinzu.

SetClientCertificateFromStoreByName(String, String, String)

Ruft ein Zertifikat aus einem Zertifikatspeicher anhand des Namens ab und fügt es den Clientanmeldeinformationen hinzu.

SetDefaultServiceCertificateFromFile(String, String, String)

Ruft ein Zertifikat aus einer Datei ab und fügt es den Dienstanmeldeinformationen als Standardzertifikat hinzu.

SetDefaultServiceCertificateFromStore(String, String, String, Object)

Ruft ein Zertifikat aus einem Zertifikatspeicher ab und fügt es den Dienstanmeldeinformationen als Standardzertifikat hinzu.

SetDefaultServiceCertificateFromStoreByName(String, String, String)

Ruft ein Zertifikat aus einem Zertifikatspeicher anhand des Namens ab und fügt es den Dienstanmeldeinformationen als Standardzertifikat hinzu.

SetIssuedToken(String, String, String)

Legt Parameter für das ausgestellte Token fest.

SetServiceCertificateAuthentication(String, String, String)

Legt die Dienstzertifikatauthentifizierungsparameter fest.

SetUserNameCredential(String, String)

Legt die Anmeldeinformationen für den Benutzernamen fest.

SetWindowsCredential(String, String, String, Int32, Boolean)

Legt die Windows Anmeldeinformationen fest.

Gilt für: