X509CertificateRecipientClientCredential.SetDefaultCertificate Méthode

Définition

Espace de noms:

System.ServiceModel.Security

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v8.0.0

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

Surcharges

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

Remarques

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

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

SetDefaultCertificate(String, StoreLocation, StoreName)

Source:

X509CertificateRecipientClientCredential.cs

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

L'emplacement du magasin de certificats que le service utilise pour obtenir le certificat de service.

storeName

StoreName

Le nom du magasin de certificats X.509 à ouvrir.

Exceptions

ArgumentNullException

subjectName a la valeur null.

InvalidOperationException

A tenté de définir quand 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 du magasin de l'emplacement spécifié qui correspond au paramètre subjectName.

Les valeurs pour storeLocation 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 se trouve généralement dans LocalMachine. Si l'application s'exécute sous un compte d'utilisateur, le certificat se trouve généralement dans CurrentUser.

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

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Source:

X509CertificateRecipientClientCredential.cs

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

L'emplacement du magasin de certificats que le service utilise pour obtenir le certificat de service.

storeName

StoreName

Le nom du magasin de certificats X.509 à ouvrir.

findType

X509FindType

Le 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

A tenté de définir quand 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 du magasin de l'emplacement spécifié qui correspond aux paramètres findType et findValue.

Les valeurs pour storeLocation 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 se trouve généralement dans LocalMachine. Si l'application s'exécute sous un compte d'utilisateur, le certificat se trouve généralement dans CurrentUser.

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

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

L'énumération la plus communément utilisée est FindBySubjectName, qui recherche dans le magasin spécifié (non sensible à la casse) le nom de sujet des certificats. Cette recherche peut être imprécise. Si aucun certificat ou plusieurs certificats qui correspondent aux critères sont trouvés, l'exception InvalidOperationException est levée.