EndpointIdentity.CreateSpnIdentity(String) Método

Definição

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Cria uma identidade de SPN (nome da entidade de servidor) com um nome especificado.

public:
 static System::ServiceModel::EndpointIdentity ^ CreateSpnIdentity(System::String ^ spnName);

public static System.ServiceModel.EndpointIdentity CreateSpnIdentity (string spnName);

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

Public Shared Function CreateSpnIdentity (spnName As String) As EndpointIdentity

Parâmetros

spnName

String

O nome da identidade do SPN.

Retornos

EndpointIdentity

Um SPN EndpointIdentity associado ao spnName especificado.

Exceções

ArgumentNullException

spnName é null.

Exemplos

O código a seguir mostra como chamar esse método.

// Create the service host.
ServiceHost myServiceHost = new ServiceHost(typeof(Calculator));

// Create the binding.
WSHttpBinding binding = new WSHttpBinding();
binding.Security.Mode = SecurityMode.Message;
binding.Security.Message.ClientCredentialType =
     MessageCredentialType.Windows;

// Disable credential negotiation and establishment of the
// security context.
binding.Security.Message.NegotiateServiceCredential = false;
binding.Security.Message.EstablishSecurityContext = false;

// Create a URI for the endpoint address.
Uri httpUri = new Uri("http://localhost/Calculator");

// Create the EndpointAddress with the SPN for the Identity.
EndpointAddress ea = new EndpointAddress(httpUri,
    EndpointIdentity.CreateSpnIdentity("service_spn_name"));

// Get the contract from the ICalculator interface (not shown here).
// See the sample applications for an example of the ICalculator.
ContractDescription contract = ContractDescription.GetContract(
    typeof(ICalculator));

// Create a new ServiceEndpoint.
ServiceEndpoint se = new ServiceEndpoint(contract, binding, ea);

// Add the service endpoint to the service.
myServiceHost.Description.Endpoints.Add(se);

// Open the service.
myServiceHost.Open();
Console.WriteLine("Listening...");
Console.ReadLine();

// Close the service.
myServiceHost.Close();

Comentários

Um cliente WCF seguro que se conecta a um ponto de extremidade com essa identidade usa o SPN ao executar a autenticação SSPI com o ponto de extremidade.

Esse método estático cria uma instância chamando SpnEndpointIdentity seu construtor, SpnEndpointIdentityusando spnName como parâmetro de entrada.

Se spnName for especificado com uma cadeia de caracteres vazia, a autenticação retornará de Kerberos para NTLM, se possível. Se AllowNtlm for false, a autenticação falhará.