X509CertificateRecipientClientCredential.SetDefaultCertificate Methode

Definitie

Naamruimte:
System.ServiceModel.Security
Assembly:
System.ServiceModel.dll

Hiermee geeft u het standaardcertificaat op dat moet worden gebruikt voor de service.

Overloads

Name Description
SetDefaultCertificate(String, StoreLocation, StoreName)

Hiermee geeft u het standaardcertificaat op dat moet worden gebruikt voor de service. Voor bindingen die gebruikmaken van berichtbeveiliging op basis van certificaten, wordt dit certificaat gebruikt om berichten naar de service te versleutelen en wordt naar verwachting door de service gebruikt voor het ondertekenen van antwoorden op de client.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Hiermee geeft u het standaardcertificaat op dat moet worden gebruikt voor de service. Voor bindingen die gebruikmaken van berichtbeveiliging op basis van certificaten, wordt dit certificaat gebruikt om berichten naar de service te versleutelen en wordt naar verwachting door de service gebruikt voor het ondertekenen van antwoorden op de client.

Opmerkingen

Met deze methoden wordt een certificaat opgehaald uit het archief op de opgegeven locatie die overeenkomt met de opgegeven parameters.

Voor bindingen die gebruikmaken van berichtbeveiliging op basis van certificaten, wordt dit certificaat gebruikt om berichten naar de service te versleutelen en wordt naar verwachting door de service gebruikt voor het ondertekenen van antwoorden op de client.

SetDefaultCertificate(String, StoreLocation, StoreName)

Hiermee geeft u het standaardcertificaat op dat moet worden gebruikt voor de service. Voor bindingen die gebruikmaken van berichtbeveiliging op basis van certificaten, wordt dit certificaat gebruikt om berichten naar de service te versleutelen en wordt naar verwachting door de service gebruikt voor het ondertekenen van antwoorden op de client.

public:
 void SetDefaultCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);
public void SetDefaultCertificate(string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);
member this.SetDefaultCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit
Public Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

Parameters

subjectName
String

De DN-naam van het onderwerp.

storeLocation
StoreLocation

De locatie van het certificaatarchief dat door de service wordt gebruikt om het servicecertificaat te verkrijgen.

storeName
StoreName

De naam van het X.509-certificaatarchief dat moet worden geopend.

Uitzonderingen

ArgumentNullException

subjectName is null.

InvalidOperationException

Er is geprobeerd om in te stellen wanneer de referentie het kenmerk Alleen-lezen heeft.

Voorbeelden

In de volgende code wordt deze methode gebruikt om een X.509-certificaat op te geven dat moet worden gebruikt.

public void snippet23(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate("http://fabrikam.com/sts",
                             StoreLocation.CurrentUser,
                             StoreName.TrustedPeople);
}

Opmerkingen

Met deze methode wordt een certificaat opgehaald uit het archief op de opgegeven locatie die overeenkomt met de subjectName parameter.

Waarden voor storeLocation worden opgenomen in de StoreLocation opsomming:

  • LocalMachine: het certificaatarchief dat is toegewezen aan de lokale computer.

  • CurrentUser: het certificaatarchief dat wordt gebruikt door de huidige gebruiker (standaard).

Als de toepassing wordt uitgevoerd onder een systeemaccount, bevindt het certificaat zich meestal in LocalMachine. Als de toepassing wordt uitgevoerd onder een gebruikersaccount, bevindt het certificaat zich meestal in CurrentUser.

Waarden voor storeName worden opgenomen in de StoreName opsomming.

Van toepassing op

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Hiermee geeft u het standaardcertificaat op dat moet worden gebruikt voor de service. Voor bindingen die gebruikmaken van berichtbeveiliging op basis van certificaten, wordt dit certificaat gebruikt om berichten naar de service te versleutelen en wordt naar verwachting door de service gebruikt voor het ondertekenen van antwoorden op de client.

public:
 void SetDefaultCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);
public void SetDefaultCertificate(System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);
member this.SetDefaultCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit
Public Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

Parameters

storeLocation
StoreLocation

De locatie van het certificaatarchief dat de service gebruikt om het servicecertificaat te verkrijgen.

storeName
StoreName

De naam van het X.509-certificaatarchief dat moet worden geopend.

findType
X509FindType

Het type X.509-zoekopdracht dat moet worden uitgevoerd.

findValue
Object

De waarde die moet worden gezocht in het X.509-certificaatarchief.

Uitzonderingen

ArgumentNullException

findValue is null.

InvalidOperationException

Er is geprobeerd om in te stellen wanneer de referentie het kenmerk Alleen-lezen heeft.

Voorbeelden

In de volgende code wordt deze methode gebruikt om een X.509-certificaat op te geven dat moet worden gebruikt.

public void snippet22(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS");
}

Opmerkingen

Met deze methode wordt een certificaat opgehaald uit het archief op de opgegeven locatie die overeenkomt met de findType en findValue parameters.

Waarden voor storeLocation worden opgenomen in de StoreLocation opsomming:

  • LocalMachine: het certificaatarchief dat is toegewezen aan de lokale computer.

  • CurrentUser: het certificaatarchief dat wordt gebruikt door de huidige gebruiker (standaard).

Als de toepassing wordt uitgevoerd onder een systeemaccount, bevindt het certificaat zich meestal in LocalMachine. Als de toepassing 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 geen certificaten of meerdere certificaten worden gevonden die voldoen aan de criteria, wordt er een InvalidOperationException gegenereerd.

Van toepassing op