X509CertificateInitiatorClientCredential.SetCertificate Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee geeft u het certificaat op dat moet worden gebruikt om de service weer te geven.
Overloads
| Name | Description |
|---|---|
| SetCertificate(String, StoreLocation, StoreName) |
Hiermee kunt u het certificaat opgeven dat moet worden gebruikt om de service te vertegenwoordigen door de DN-naam van het onderwerp op te geven. |
| SetCertificate(StoreLocation, StoreName, X509FindType, Object) |
Hiermee kunt u het certificaat opgeven dat moet worden gebruikt om de client te vertegenwoordigen door queryparameters zoals |
SetCertificate(String, StoreLocation, StoreName)
Hiermee kunt u het certificaat opgeven dat moet worden gebruikt om de service te vertegenwoordigen door de DN-naam van het onderwerp op te geven.
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)Parameters
- subjectName
- String
DN-naam van onderwerp.
- storeLocation
- StoreLocation
De locatie van het certificaatarchief dat de service gebruikt om het servicecertificaat te verkrijgen.
- storeName
- StoreName
Hiermee geeft u de naam van het X.509-certificaatarchief dat moet worden geopend.
Voorbeelden
Met de volgende code wordt het certificaat opgegeven dat moet worden gebruikt.
// 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);
Opmerkingen
Zie voor meer informatie over de subjectName parameter SubjectName.
Waarden voor storeLocation worden opgenomen in de StoreLocation opsomming:
LocalMachine: het certificaatarchief dat is toegewezen aan de lokale computer (standaard).
CurrentUser: het certificaatarchief dat door de huidige gebruiker wordt gebruikt.
Als de clienttoepassing wordt uitgevoerd onder een systeemaccount, bevindt het certificaat zich meestal in LocalMachine. Als de clienttoepassing wordt uitgevoerd onder een gebruikersaccount, bevindt het certificaat zich meestal in CurrentUser.
Waarden voor storeName worden opgenomen in de StoreName opsomming.
Van toepassing op
SetCertificate(StoreLocation, StoreName, X509FindType, Object)
Hiermee kunt u het certificaat opgeven dat moet worden gebruikt om de client te vertegenwoordigen door queryparameters zoals storeLocation, storeNamefindTypeen 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)Parameters
- storeLocation
- StoreLocation
De locatie van het certificaatarchief dat de client gebruikt om het clientcertificaat te verkrijgen.
- storeName
- StoreName
Hiermee geeft u de naam van het X.509-certificaatarchief dat moet worden geopend.
- findType
- X509FindType
Definieert het type X.509-zoekopdracht dat moet worden uitgevoerd.
- findValue
- Object
De waarde die moet worden gezocht in het X.509-certificaatarchief.
Voorbeelden
Met de volgende code wordt het certificaat opgegeven dat moet worden gebruikt.
// 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")
Opmerkingen
Waarden voor storeLocation worden opgenomen in de StoreLocation opsomming:
LocalMachine: het certificaatarchief dat is toegewezen aan de lokale computer (standaard).
CurrentUser: het certificaatarchief dat door de huidige gebruiker wordt gebruikt.
Als de clienttoepassing wordt uitgevoerd onder een systeemaccount, bevindt het certificaat zich meestal in LocalMachine. Als de clienttoepassing wordt uitgevoerd onder een gebruikersaccount, bevindt het certificaat zich meestal in CurrentUser.
Waarden voor storeName worden opgenomen in de StoreName opsomming.
Waarden voor findType worden opgenomen in de X509FindType opsomming.
De meest gebruikte opsomming is FindBySubjectName, die een hoofdlettergevoelige zoekopdracht doet op de onderwerpnaam van certificaten in het opgegeven archief. Dit kan een onnauwkeurig zoeken zijn. Als er meer dan één certificaat wordt geretourneerd, wordt de eerste die overeenkomt met de zoekfunctie gebruikt om de client weer te geven.
