Cómo: Proteger un servicio con credenciales de Windows

Artículo
02/27/2011

En este tema se muestra cómo habilitar la seguridad de transferencia en un servicio Windows Communication Foundation (WCF) que reside en un dominio de Windows y al que llaman los clientes del mismo dominio. Para obtener más información sobre este escenario, consulte Seguridad del transporte con la autenticación de Windows. Para obtener una aplicación de ejemplo, consulte el ejemplo WSHttpBinding.

En este tema se parte del supuesto de que ya tiene definidas una interfaz e implementación de contrato. También puede modificar un servicio y cliente existentes.

Puede proteger completamente un servicio con credenciales de Windows en el código. Alternativamente, puede omitir una parte del código mediante un archivo de configuración. En este tema se explican ambos métodos. Asegúrese de que sigue solamente uno de ellos.

Los tres primeros procedimientos muestran cómo proteger el servicio en el código. En el cuarto y quinto procedimientos se muestra cómo hacerlo con un archivo de configuración.

Mediante código

El código completo para el servicio y el cliente se encuentra en la sección Ejemplo al final de este tema.

El primer procedimiento le guía en la creación y configuración de una clase WSHttpBinding en el código. El enlace usa el transporte HTTP. El mismo enlace se usa en el cliente.

Para crear un WSHttpBinding que utiliza credenciales de Windows y seguridad de mensaje

El código de este procedimiento se encuentra insertado al principio del método Run de la clase Test en el código del servicio, en la sección Ejemplo.
Cree una instancia de la clase WSHttpBinding.
Establezca la propiedad Mode de la clase WsHttpSecurity en Message.
Establezca la propiedad ClientCredentialType de la clase MessageSecurityOverHttp en Windows.

El código de este procedimiento es el siguiente:

Dim myBinding As New WSHttpBinding()
myBinding.Security.Mode = SecurityMode.Message
myBinding.Security.Message.ClientCredentialType = MessageCredentialType.Windows

// First procedure:
// create a WSHttpBinding that uses Windows credentials and message security
WSHttpBinding myBinding = new WSHttpBinding();
myBinding.Security.Mode = SecurityMode.Message;
myBinding.Security.Message.ClientCredentialType =
    MessageCredentialType.Windows;

Utilizar el enlace en un servicio

Éste es el segundo procedimiento, que muestra cómo usar el enlace en un servicio autohospedado. Para obtener más información sobre cómo hospedar los servicios, consulte Servicios de hospedaje.

Utilizar un enlace en un servicio

Inserte el código de este procedimiento después del código del procedimiento anterior.
Cree una variable TypecontractType con nombre y asígnele el tipo de la interfaz (ICalculator). Cuando utilice Visual Basic, utilice al operador GetType; cuando utilice C#, utilice la palabra clave typeof.
Cree una segunda variable TypeserviceType con nombre y asígnele el tipo del contrato implementado (Calculator).
Cree una instancia de la clase Uri denominada baseAddress con la dirección base del servicio. La dirección base debe tener un esquema que coincida con el transporte. En este caso, el esquema de transporte es HTTP y la dirección incluye el identificador uniforme de recursos (URI) especial "localhost" y un número de puerto (8036) así como una dirección de extremo base ("serviceModelSamples/): https://localhost:8036/serviceModelSamples/.
Cree una instancia de la claseServiceHost con serviceType y variables baseAddress.
Agregue un extremo al servicio incluyendo contractType, el enlace y el nombre del extremo ("secureCalculator"). Un cliente debe concatenar la dirección base y el nombre de extremo al iniciar una llamada al servicio.

Llame al método Open para iniciar el servicio. El código de este procedimiento se muestra aquí:

' Create the Type instances for later use and the URI for 
' the base address.
Dim contractType As Type = GetType(ICalculator)
Dim serviceType As Type = GetType(Calculator)
Dim baseAddress As New Uri("https://localhost:8036/serviceModelSamples/")

' Create the ServiceHost and add an endpoint, then start
' the service.
Dim myServiceHost As New ServiceHost(serviceType, baseAddress)
myServiceHost.AddServiceEndpoint(contractType, myBinding, "secureCalculator")
myServiceHost.Open()

// 2nd Procedure:
// Use the binding in a service
// Create the Type instances for later use and the URI for 
// the base address.
Type contractType = typeof(ICalculator);
Type serviceType = typeof(Calculator);
Uri baseAddress = new
    Uri("https://localhost:8036/SecuritySamples/");

// Create the ServiceHost and add an endpoint, then start
// the service.
ServiceHost myServiceHost =
    new ServiceHost(serviceType, baseAddress);
myServiceHost.AddServiceEndpoint
    (contractType, myBinding, "secureCalculator");

//enable metadata
ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
smb.HttpGetEnabled = true;
myServiceHost.Description.Behaviors.Add(smb);

myServiceHost.Open();

Utilizar el enlace en un cliente

Este procedimiento muestra cómo generar un proxy que se comunica con el servicio. El proxy se genera con la Herramienta de utilidad de metadatos de ServiceModel (Svcutil.exe), que usa los metadatos del servicio para crear el proxy.

En este procedimiento también se crea una instancia de la clase WSHttpBinding para comunicarse con el servicio y, a continuación, se llama al servicio.

Este ejemplo solo utiliza código para crear el cliente. Como alternativa, puede utilizar un archivo de configuración, que se muestra en la sección que sigue a este procedimiento.

Para usar un enlace en un cliente con el código

Use la herramienta SvcUtil.exe para generar el código del proxy a partir de los metadatos del servicio. Para obtener más información, vea Creación de un cliente de Windows Communication Foundation. El código de proxy generado hereda de la clase ClientBase, lo cual garantiza que cada cliente tenga los constructores, métodos y propiedades necesarios para comunicarse con un servicio WCF. En este ejemplo, el código generado incluye la clase CalculatorClient, que implementa la interfaz ICalculator, habilitando la compatibilidad con el código del servicio.
El código de este procedimiento se encuentra insertado al principio del método Main del programa cliente.
Cree una instancia de la clase WSHttpBinding y establezca su modo de seguridad en Message y su tipo de credencial de cliente en Windows. El ejemplo denomina el clientBindingvariable.
Cree una instancia de la clase EndpointAddress denominada serviceAddress. Inicialice la instancia con la dirección base concatenada con el nombre de extremo.
Cree una instancia de la clase de cliente generada con serviceAddress y las variables clientBinding.
Llame el método Open, como se indica el siguiente código.

Llame al servicio y muestre los resultados.

Dim b As New WSHttpBinding(SecurityMode.Message)
b.Security.Message.ClientCredentialType = MessageCredentialType.Windows

Dim ea As New EndpointAddress("net.tcp://machinename:8036/endpoint")
Dim cc As New CalculatorClient(b, ea)
cc.Open()

' Alternatively, use a binding name from a configuration file generated by the
' SvcUtil.exe tool to create the client. Omit the binding and endpoint address 
' because that information is provided by the configuration file.
' CalculatorClass cc = new CalculatorClient("ICalculator_Binding")

// 3rd Procedure:
//  Creating a binding and using it in a service

// To run using config, comment the following lines, and uncomment out the code
// following this section
WSHttpBinding b = new WSHttpBinding(SecurityMode.Message);
b.Security.Message.ClientCredentialType = MessageCredentialType.Windows;

EndpointAddress ea = new EndpointAddress("Http://localhost:8036/SecuritySamples/secureCalculator");
CalculatorClient cc = new CalculatorClient(b, ea);
cc.Open();

// Now call the service and display the results
// Call the Add service operation.
double value1 = 100.00D;
double value2 = 15.99D;
double result = cc.Add(value1, value2);
Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

// Closing the client gracefully closes the connection and cleans up resources.
cc.Close();

Usar el archivo de configuración

En lugar de crear el enlace con código de procedimiento, puede usar el código siguiente, que se muestra para la sección de enlaces del archivo de configuración.

Si aún no tiene un servicio definido, consulte Diseño e implementación de servicios y Configuración de servicios.

Nota Este código de configuración se usa tanto en el archivo de configuración del servicio como del cliente.

Habilitar la seguridad de la transferencia en un servicio en un dominio de Windows utilizando la configuración

Agregue un elemento <wsHttpBinding><bindings> a la sección del elemento del archivo de configuración.
Agregue un elemento <binding> al elemento <WSHttpBinding> y establezca el atributo configurationName en un valor apropiado a su aplicación.
Agregue un elemento <security> y establezca el atributo mode en Message.
Agregue un elemento <message> y establezca el atributo clientCredentialType en Windows.
En el archivo de configuración del servicio, reemplace la sección <bindings> con el código siguiente. Si aún no tiene un archivo de configuración de servicio, consulte Utilización de enlaces para configurar servicios y clientes.
```
<bindings>
  <wsHttpBinding>
   <binding name = "wsHttpBinding_Calculator">
     <security mode="Message">
       <message clientCredentialType="Windows"/>
     </security>
    </binding>
  </wsHttpBinding>
</bindings>
```

Utilizar el enlace en un cliente

En este procedimiento se muestra cómo generar dos archivos: un proxy que se comunica con el servicio y un archivo de configuración. También se describen los cambios en el programa cliente, que es el tercer archivo utilizado en el cliente.

Para usar un enlace en un cliente mediante configuración

Use la herramienta SvcUtil.exe para generar el código proxy y el archivo de configuración a partir de los metadatos del servicio. Para obtener más información, vea Creación de un cliente de Windows Communication Foundation.
Reemplace la sección <Bindings> del archivo de configuración generado con el código de configuración de la sección anterior.
El código de procedimiento se encuentra insertado al principio del método Main del programa cliente.
Cree una instancia de la clase de cliente generada, pasando el nombre del enlace en el archivo de configuración como parámetro de entrada.
Llame al método Open, como se muestra en el siguiente código.

Llame al servicio y muestre los resultados.

// 4th Procedure:
//  Using config instead of the binding-related code
// In this case, use a binding name from a configuration file generated by the
// SvcUtil.exe tool to create the client. Omit the binding and endpoint address 
// because that information is provided by the configuration file.

CalculatorClient cc = new CalculatorClient("ICalculator_Binding");
cc.Open();

// Now call the service and display the results
// Call the Add service operation.
double value1 = 100.00D;
double value2 = 15.99D;
double result = cc.Add(value1, value2);
Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

// Closing the client gracefully closes the connection and cleans up resources.
cc.Close();

Ejemplo

using System;
using System.Collections;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.Security.Permissions;

[assembly: SecurityPermission(SecurityAction.RequestMinimum, Execution = true)]
namespace Microsoft.Security.Samples
{
    public class Test
    {
        static void Main()
        {
            Test t = new Test();
            Console.WriteLine("Starting....");
            t.Run();

        }

        private void Run()
        {
            // First procedure:
            // create a WSHttpBinding that uses Windows credentials and message security
            WSHttpBinding myBinding = new WSHttpBinding();
            myBinding.Security.Mode = SecurityMode.Message;
            myBinding.Security.Message.ClientCredentialType =
                MessageCredentialType.Windows;

            // 2nd Procedure:
            // Use the binding in a service
            // Create the Type instances for later use and the URI for 
            // the base address.
            Type contractType = typeof(ICalculator);
            Type serviceType = typeof(Calculator);
            Uri baseAddress = new
                Uri("https://localhost:8036/SecuritySamples/");

            // Create the ServiceHost and add an endpoint, then start
            // the service.
            ServiceHost myServiceHost =
                new ServiceHost(serviceType, baseAddress);
            myServiceHost.AddServiceEndpoint
                (contractType, myBinding, "secureCalculator");

            //enable metadata
            ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
            smb.HttpGetEnabled = true;
            myServiceHost.Description.Behaviors.Add(smb);

            myServiceHost.Open();
            Console.WriteLine("Listening");
            Console.WriteLine("Press Enter to close the service");
            Console.ReadLine();
            myServiceHost.Close();
        }
    }

    [ServiceContract]
    public interface ICalculator
    {
        [OperationContract]
        double Add(double a, double b);
    }

    public class Calculator : ICalculator
    {
        public double Add(double a, double b)
        {
            return a + b;
        }
    }
}

Vea también

Cómo: Proteger un servicio con credenciales de Windows

Mediante código

Para crear un WSHttpBinding que utiliza credenciales de Windows y seguridad de mensaje

Utilizar el enlace en un servicio

Utilizar un enlace en un servicio

Utilizar el enlace en un cliente

Para usar un enlace en un cliente con el código

Usar el archivo de configuración

Habilitar la seguridad de la transferencia en un servicio en un dominio de Windows utilizando la configuración

Utilizar el enlace en un cliente

Para usar un enlace en un cliente mediante configuración

Ejemplo

Vea también

Tareas

Referencia

Conceptos

Recursos adicionales