X509CertificateRecipientClientCredential.SetDefaultCertificate Méthode

Définition

Espace de noms:
System.ServiceModel.Security
Assemblys:
System.ServiceModel.dll, System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.dll
Paquet:
System.ServiceModel.Primitives v10.0.652802

Spécifie le certificat par défaut à utiliser pour le service.

Surcharges

Nom Description
SetDefaultCertificate(String, StoreLocation, StoreName)

Spécifie le certificat par défaut à utiliser pour le service. Pour les liaisons qui utilisent la sécurité des messages basés sur des certificats, ce certificat est utilisé pour chiffrer les messages au service et doit être utilisé par le service pour signer des réponses au client.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Spécifie le certificat par défaut à utiliser pour le service. Pour les liaisons qui utilisent la sécurité des messages basés sur des certificats, ce certificat est utilisé pour chiffrer les messages au service et doit être utilisé par le service pour signer des réponses au client.

Remarques

Ces méthodes obtiennent un certificat à partir du magasin à l’emplacement spécifié qui correspond aux paramètres spécifiés.

Pour les liaisons qui utilisent la sécurité des messages basés sur des certificats, ce certificat est utilisé pour chiffrer les messages au service et doit être utilisé par le service pour signer des réponses au client.

SetDefaultCertificate(String, StoreLocation, StoreName)

Source:
X509CertificateRecipientClientCredential.cs
Source:
X509CertificateRecipientClientCredential.cs
Source:
X509CertificateRecipientClientCredential.cs

Spécifie le certificat par défaut à utiliser pour le service. Pour les liaisons qui utilisent la sécurité des messages basés sur des certificats, ce certificat est utilisé pour chiffrer les messages au service et doit être utilisé par le service pour signer des réponses au 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)

Paramètres

subjectName
String

Nom unique de l’objet.

storeLocation
StoreLocation

Emplacement du magasin de certificats que le service utilise pour obtenir le certificat de service.

storeName
StoreName

Nom du magasin de certificats X.509 à ouvrir.

Exceptions

ArgumentNullException

subjectName a la valeur null.

InvalidOperationException

Tentative de définition lorsque les informations d’identification sont en lecture seule.

Exemples

Le code suivant utilise cette méthode pour spécifier un certificat X.509 à utiliser.

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

Remarques

Cette méthode obtient un certificat à partir du magasin à l’emplacement spécifié qui correspond au subjectName paramètre.

Les valeurs pour storeLocation elles sont incluses dans l’énumération StoreLocation :

  • LocalMachine: magasin de certificats affecté à l’ordinateur local.

  • CurrentUser: magasin de certificats utilisé par l’utilisateur actuel (par défaut).

Si l’application s’exécute sous un compte système, le certificat est généralement dans LocalMachine. Si l’application s’exécute sous un compte d’utilisateur, le certificat est généralement dans CurrentUser.

Les valeurs pour storeName elles sont incluses dans l’énumération StoreName .

S’applique à

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Source:
X509CertificateRecipientClientCredential.cs
Source:
X509CertificateRecipientClientCredential.cs
Source:
X509CertificateRecipientClientCredential.cs

Spécifie le certificat par défaut à utiliser pour le service. Pour les liaisons qui utilisent la sécurité des messages basés sur des certificats, ce certificat est utilisé pour chiffrer les messages au service et doit être utilisé par le service pour signer des réponses au 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)

Paramètres

storeLocation
StoreLocation

Emplacement du magasin de certificats que le service utilise pour obtenir le certificat de service.

storeName
StoreName

Nom du magasin de certificats X.509 à ouvrir.

findType
X509FindType

Type de recherche X.509 à exécuter.

findValue
Object

Valeur à rechercher dans le magasin de certificats X.509.

Exceptions

ArgumentNullException

findValue a la valeur null.

InvalidOperationException

Tentative de définition lorsque les informations d’identification sont en lecture seule.

Exemples

Le code suivant utilise cette méthode pour spécifier un certificat X.509 à utiliser.

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

Remarques

Cette méthode obtient un certificat à partir du magasin à l’emplacement spécifié qui correspond aux paramètres et findType aux findValue paramètres.

Les valeurs pour storeLocation elles sont incluses dans l’énumération StoreLocation :

  • LocalMachine: magasin de certificats affecté à l’ordinateur local.

  • CurrentUser: magasin de certificats utilisé par l’utilisateur actuel (par défaut).

Si l’application s’exécute sous un compte système, le certificat est généralement dans LocalMachine. Si l’application s’exécute sous un compte d’utilisateur, le certificat est généralement dans CurrentUser.

Les valeurs pour storeName elles sont incluses dans l’énumération StoreName .

Les valeurs pour findType elles sont incluses dans l’énumération X509FindType .

L’énumération la plus couramment utilisée est FindBySubjectName, qui effectue une recherche sans respect de la casse sur le nom d’objet des certificats dans le magasin spécifié. Il peut s’agir d’une recherche imprécise. Si aucun certificat ou plusieurs certificats correspondant aux critères sont trouvés, un certificat InvalidOperationException est levée.

S’applique à