X509CertificateInitiatorClientCredential.SetCertificate Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt das Zertifikat an, das zum Darstellen des Diensts verwendet werden soll.
Überlädt
| Name | Beschreibung |
|---|---|
| SetCertificate(String, StoreLocation, StoreName) |
Ermöglicht es Ihnen, das zertifikat anzugeben, das zum Darstellen des Diensts verwendet werden soll, indem Sie den Betreff distinguished Name angeben. |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Ermöglicht es Ihnen, das Zertifikat anzugeben, das zum Darstellen des Clients verwendet werden soll, indem Sie Abfrageparameter wie |
SetCertificate(String, StoreLocation, StoreName)
Ermöglicht es Ihnen, das zertifikat anzugeben, das zum Darstellen des Diensts verwendet werden soll, indem Sie den Betreff distinguished Name angeben.
public:
void SetCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);public void SetCertificate(string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);member this.SetCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unitPublic Sub SetCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)Parameter
- subjectName
- String
Betreff distinguished name.
- storeLocation
- StoreLocation
Der Speicherort des Zertifikatspeichers, den der Dienst zum Abrufen des Dienstzertifikats verwendet.
- storeName
- StoreName
Gibt den Namen des zu öffnenden X.509-Zertifikatspeichers an.
Beispiele
Der folgende Code gibt das zu verwendende Zertifikat an.
// Create a WSHttpBinding and set its security properties. The
// security mode is Message, and the client is authenticated with
// a certificate.
EndpointAddress ea = new EndpointAddress("http://contoso.com/");
WSHttpBinding b = new WSHttpBinding();
b.Security.Mode = SecurityMode.Message;
b.Security.Message.ClientCredentialType =
MessageCredentialType.Certificate;
// Create the client with the binding and EndpointAddress.
CalculatorClient cc = new CalculatorClient(b, ea);
// Set the client credential value to a valid certificate.
cc.ClientCredentials.ClientCertificate.SetCertificate(
"CN=MyName, OU=MyOrgUnit, C=US",
StoreLocation.CurrentUser,
StoreName.TrustedPeople);
Hinweise
Weitere Informationen zum subjectName Parameter finden Sie unter SubjectName.
Werte für storeLocation die Enumeration sind enthalten StoreLocation :
LocalMachine: der dem lokalen Computer zugewiesene Zertifikatspeicher (Standard).
CurrentUser: der vom aktuellen Benutzer verwendete Zertifikatspeicher.
Wenn die Clientanwendung unter einem Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Clientanwendung unter einem Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.
Die Werte für storeName diese sind in der StoreName Enumeration enthalten.
Gilt für:
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Ermöglicht es Ihnen, das Zertifikat anzugeben, das zum Darstellen des Clients verwendet werden soll, indem Sie Abfrageparameter wie storeLocation, storeName, findType und findValue.
public:
void SetCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);public void SetCertificate(System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);member this.SetCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unitPublic Sub SetCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)Parameter
- storeLocation
- StoreLocation
Der Speicherort des Zertifikatspeichers, den der Client zum Abrufen des Clientzertifikats verwendet.
- storeName
- StoreName
Gibt den Namen des zu öffnenden X.509-Zertifikatspeichers an.
- findType
- X509FindType
Definiert den Typ der X.509-Suche, die ausgeführt werden soll.
- findValue
- Object
Der Wert, nach dem im X.509-Zertifikatspeicher gesucht werden soll.
Beispiele
Der folgende Code gibt das zu verwendende Zertifikat an.
// Create a WSHttpBinding and set its security properties. The
// security mode is Message, and the client is authenticated with
// a certificate.
EndpointAddress ea = new EndpointAddress("http://contoso.com/");
WSHttpBinding b = new WSHttpBinding();
b.Security.Mode = SecurityMode.Message;
b.Security.Message.ClientCredentialType =
MessageCredentialType.Certificate;
// Create the client with the binding and EndpointAddress.
CalculatorClient cc = new CalculatorClient(b, ea);
// Set the client credential value to a valid certificate.
cc.ClientCredentials.ClientCertificate.SetCertificate(
StoreLocation.CurrentUser,
StoreName.TrustedPeople,
X509FindType.FindBySubjectName,
"client.com");
' Create a WSHttpBinding and set its security properties. The
' security mode is Message, and the client is authenticated with
' a certificate.
Dim ea As New EndpointAddress("http://contoso.com/")
Dim b As New WSHttpBinding()
b.Security.Mode = SecurityMode.Message
b.Security.Message.ClientCredentialType = MessageCredentialType.Certificate
' Create the client with the binding and EndpointAddress.
Dim cc As New CalculatorClient(b, ea)
' Set the client credential value to a valid certificate.
cc.ClientCredentials.ClientCertificate.SetCertificate( _
StoreLocation.CurrentUser, _
StoreName.TrustedPeople, _
X509FindType.FindBySubjectName, _
"client.com")
Hinweise
Werte für storeLocation die Enumeration sind enthalten StoreLocation :
LocalMachine: der dem lokalen Computer zugewiesene Zertifikatspeicher (Standard).
CurrentUser: der vom aktuellen Benutzer verwendete Zertifikatspeicher.
Wenn die Clientanwendung unter einem Systemkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in LocalMachine. Wenn die Clientanwendung unter einem Benutzerkonto ausgeführt wird, befindet sich das Zertifikat in der Regel in CurrentUser.
Die Werte für storeName diese sind in der StoreName Enumeration enthalten.
Die Werte für findType diese sind in der X509FindType Enumeration enthalten.
Die am häufigsten verwendete Aufzählung ist FindBySubjectName, bei der bei der Suche nach dem Antragstellernamen von Zertifikaten im angegebenen Speicher die Groß-/Kleinschreibung nicht beachtet wird. Dies kann eine ungenaue Suche sein. Wenn mehr als ein Zertifikat zurückgegeben wird, wird die erste, die der Suche entspricht, verwendet, um den Client darzustellen.
