IChannelCredentials Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ett gränssnitt som tillåter inställning av vissa säkerhetsfunktioner på en tjänstproxy.
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
- Attribut
Exempel
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)
Kommentarer
Ohanterade klienter använder monikern "service" för att komma åt Windows Communication Foundation(WCF) tjänster. Dessa klienter omfattas av WCF-säkerhetsmodellen i stället för COM-säkerhetsmodellen. Gränssnittet IChannelCredentials tillhandahålls för att ange kanalautentiseringsuppgifter. Detta krävs eftersom COM-monikern inte kan komma åt den hanterade WCF-säkerhetsobjektmodellen.
Det är inte lagligt att anropa metoder i IChannelCredentials gränssnittet när kanalen har skapats. Det beror på att Windows Communication Foundation (WCF) inte stöder ändring av säkerhetsinställningar på en redan öppen kanal. När tjänstmonikerklienten hämtar en proxy skapas inte kanalen ännu. Klienten måste därför anropa IChannelCredentials metoder innan den anropar tjänstmetoden. Om klienten anropar en IChannelCredentials metod efter att tjänstmetoden anropats utlöses undantaget RPC_E_TOO_LATE.
Metoder
| Name | Description |
|---|---|
| SetClientCertificateFromFile(String, String, String) |
Hämtar ett certifikat från en fil och lägger till det i klientens autentiseringsuppgifter. |
| SetClientCertificateFromStore(String, String, String, Object) |
Hämtar ett certifikat från ett certifikatarkiv och lägger till det i klientens autentiseringsuppgifter. |
| SetClientCertificateFromStoreByName(String, String, String) |
Hämtar ett certifikat från ett certifikatarkiv med namn och lägger till det i klientens autentiseringsuppgifter. |
| SetDefaultServiceCertificateFromFile(String, String, String) |
Hämtar ett certifikat från en fil och lägger till det i tjänstens autentiseringsuppgifter som standardcertifikat. |
| SetDefaultServiceCertificateFromStore(String, String, String, Object) |
Hämtar ett certifikat från ett certifikatarkiv och lägger till det i tjänstens autentiseringsuppgifter som standardcertifikat. |
| SetDefaultServiceCertificateFromStoreByName(String, String, String) |
Hämtar ett certifikat från ett certifikatarkiv med namn och lägger till det i tjänstens autentiseringsuppgifter som standardcertifikat. |
| SetIssuedToken(String, String, String) |
Anger parametrar för den utfärdade token. |
| SetServiceCertificateAuthentication(String, String, String) |
Anger autentiseringsparametrarna för tjänstcertifikatet. |
| SetUserNameCredential(String, String) |
Anger autentiseringsuppgifterna för användarnamnet. |
| SetWindowsCredential(String, String, String, Int32, Boolean) |
Anger autentiseringsuppgifterna för Windows. |