EndpointIdentity.CreateRsaIdentity Yöntem

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.dll

Bir RSA kimliği oluşturur.

Aşırı Yüklemeler

CreateRsaIdentity(X509Certificate2)	Belirtilen X.509 sertifikasıyla bir RSA kimliği oluşturur.
CreateRsaIdentity(String)	Belirtilen ortak anahtarla bir RSA kimliği oluşturur.

Açıklamalar

Bu kimlikle bir uç noktaya bağlanan güvenli bir WCF istemcisi, sunucu tarafından sunulan taleplerin bu kimliği oluşturmak için kullanılan RSA ortak anahtarını içeren bir talep içerdiğini doğrular.

Bu statik yöntemlerden biri oluşturucusunu RsaEndpointIdentityçağırarak öğesinin RsaEndpointIdentity bir örneğini oluşturur.

CreateRsaIdentity(X509Certificate2)

Belirtilen X.509 sertifikasıyla bir RSA kimliği oluşturur.

public:
 static System::ServiceModel::EndpointIdentity ^ CreateRsaIdentity(System::Security::Cryptography::X509Certificates::X509Certificate2 ^ certificate);

public static System.ServiceModel.EndpointIdentity CreateRsaIdentity (System.Security.Cryptography.X509Certificates.X509Certificate2 certificate);

static member CreateRsaIdentity : System.Security.Cryptography.X509Certificates.X509Certificate2 -> System.ServiceModel.EndpointIdentity

Public Shared Function CreateRsaIdentity (certificate As X509Certificate2) As EndpointIdentity

Parametreler

certificate

X509Certificate2

X509Certificate2 RSA kimliği için sertifikayı içeren.

Döndürülenler

EndpointIdentity

Belirtilen certificateile ilişkilendirilmiş bir RSAEndpointIdentity.

Özel durumlar

ArgumentNullException

certificate, null değeridir.

NotSupportedException

certificate bir RSA sertifikası değildir.

Örnekler

Aşağıdaki kodda bu yöntemin nasıl çağrılacakları gösterilmektedir.

public static void CreateRSAIdentity()
{
    // Create a ServiceHost for the CalculatorService type. Base Address is supplied in app.config.
    using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
    {
        // The base address is read from the app.config.
        Uri dnsrelativeAddress = new Uri(serviceHost.BaseAddresses[0], "dnsidentity");
        Uri certificaterelativeAddress = new Uri(serviceHost.BaseAddresses[0], "certificateidentity");
        Uri rsarelativeAddress = new Uri(serviceHost.BaseAddresses[0], "rsaidentity");

        // Set the service's X509Certificate to protect the messages.
        serviceHost.Credentials.ServiceCertificate.SetCertificate(StoreLocation.LocalMachine,
                                                                  StoreName.My,
                                                                  X509FindType.FindBySubjectDistinguishedName,
                                                                  "CN=identity.com, O=Contoso");
        //Cache a reference to the server's certificate.
        X509Certificate2 servercert = serviceHost.Credentials.ServiceCertificate.Certificate;

        //Create endpoints for the service using a WSHttpBinding set for anonymous clients.
        WSHttpBinding wsAnonbinding = new WSHttpBinding(SecurityMode.Message);
        //Clients are anonymous to the service.
        wsAnonbinding.Security.Message.ClientCredentialType = MessageCredentialType.None;
        //Secure conversation (session) is turned off.
        wsAnonbinding.Security.Message.EstablishSecurityContext = false;

        //Create a service endpoint and change its identity to the DNS for an X509 Certificate.
        ServiceEndpoint ep = serviceHost.AddServiceEndpoint(typeof(ICalculator),
                                                            wsAnonbinding,
                                                            String.Empty);
        EndpointAddress epa = new EndpointAddress(dnsrelativeAddress, EndpointIdentity.CreateDnsIdentity("identity.com"));
        ep.Address = epa;

        //Create a service endpoint and change its identity to the X509 certificate's RSA key value.
        ServiceEndpoint ep3 = serviceHost.AddServiceEndpoint(typeof(ICalculator), wsAnonbinding, String.Empty);
        EndpointAddress epa3 = new EndpointAddress(rsarelativeAddress, EndpointIdentity.CreateRsaIdentity(servercert));
        ep3.Address = epa3;

Açıklamalar

Bu kimlikle bir uç noktaya bağlanan güvenli bir WCF istemcisi, sunucu tarafından sunulan taleplerin bu kimliği oluşturmak için kullanılan sertifikadan alınan RSA ortak anahtarını içeren bir talep içerdiğini doğrular.

Bu statik yöntem oluşturucusunu çağırarak RsaEndpointIdentityöğesinin RsaEndpointIdentity bir örneğini oluşturur.

CreateRsaIdentity(String)

Belirtilen ortak anahtarla bir RSA kimliği oluşturur.

public:
 static System::ServiceModel::EndpointIdentity ^ CreateRsaIdentity(System::String ^ publicKey);

public static System.ServiceModel.EndpointIdentity CreateRsaIdentity (string publicKey);

static member CreateRsaIdentity : string -> System.ServiceModel.EndpointIdentity

Public Shared Function CreateRsaIdentity (publicKey As String) As EndpointIdentity

Parametreler

publicKey

String

RSA kimliği için ortak anahtar.

Döndürülenler

EndpointIdentity

Belirtilen publicKeyile ilişkilendirilmiş bir RSAEndpointIdentity.

Özel durumlar

ArgumentNullException

publicKey, null değeridir.

Açıklamalar

Bu kimlikle bir uç noktaya bağlanan güvenli bir WCF istemcisi, sunucu tarafından sunulan taleplerin bu kimliği oluşturmak için kullanılan RSA ortak anahtarını içeren bir talep içerdiğini doğrular.

Bu statik yöntem oluşturucusunu çağırarak RsaEndpointIdentityöğesinin RsaEndpointIdentity bir örneğini oluşturur.