Descripción de los niveles de protección

Artículo
02/27/2011

La propiedad ProtectionLevel se encuentra en muchas clases diferentes, como las clases ServiceContractAttribute y OperationContractAttribute. La propiedad controla cómo se protege una parte de un mensaje (o todo entero). En este tema se explica la característica Windows Communication Foundation (WCF) y cómo funciona.

Para obtener instrucciones sobre cómo establecer el nivel de protección, vea Cómo: Establecer la propiedad ProtectionLevel.

Nota:
Los niveles de protección solo se pueden establecer en el código, no en la configuración.

Fundamentos

Para entender la característica de nivel de protección, se aplican las instrucciones básicas siguientes:

Existen tres niveles básicos de protección para cualquier parte de un mensaje. La propiedad (dondequiera que se produzca) está establecida como uno de los valores de la enumeración ProtectionLevel. En orden ascendente de protección, incluyen:
- None.
- Sign. La parte protegida está firmada digitalmente. De esta manera se garantiza la detección de cualquier modificación en la parte protegida del mensaje.
- EncryptAndSign. La parte del mensaje se cifra para garantizar la confidencialidad antes de firmarse.
Solo puede establecer los requisitos de protección para los datos de la aplicación con esta característica. Por ejemplo, los encabezados de WS-Addressing son los datos de la infraestructura y, por consiguiente, no se verán afectados por ProtectionLevel.
Cuando el modo de seguridad está establecido como Transport, el mecanismo de transporte protege el mensaje completo. Por consiguiente, establecer un nivel de protección independiente para las distintas partes de un mensaje no tendrá ningún efecto.
ProtectionLevel es una manera para que el programador establezca el nivel mínimo que un enlace debe cumplir. Cuando se implementa un servicio, el enlace real especificado en la configuración puede admitir o no el nivel mínimo. Por ejemplo, de forma predeterminada, la clase BasicHttpBinding no proporciona seguridad (aunque puede estar habilitada). Por consiguiente, utilizarlo con un contrato que tiene un valor distinto de None producirá una excepción.
Si el servicio requiere que el valor mínimo de ProtectionLevel para todos los mensajes sea Sign, un cliente (quizás creado por una tecnología que no sea de WCF ) puede cifrar y firmar todos los mensajes (que es más que el mínimo requerido). En este caso, WCF no producirá una excepción porque el cliente ha hecho más que el mínimo. Tenga en cuenta, sin embargo, que las aplicaciones WCF (servicios o clientes) no sobreprotegerán una parte del mensaje si es posible, sino que cumplirán con el nivel mínimo. Además, tenga en cuenta que al utilizar Transport como modo de seguridad, el transporte puede sobreproteger la secuencia de mensajes porque no puede proteger en un nivel más específico.
Si establece ProtectionLevel como Sign o EncryptAndSign, deberá usar un enlace con la seguridad habilitada o se producirá una excepción.
Si selecciona un enlace que habilita la seguridad y no establece la propiedad ProtectionLevel en cualquier parte del contrato, se cifrarán y firmarán todos los datos de la aplicación.
Si selecciona un enlace que no tiene la seguridad habilitada (por ejemplo, la clase BasicHttpBinding tiene la seguridad deshabilitada de forma predeterminada) y no se establece ProtectionLevel explícitamente, no se protegerá ninguno de los datos de la aplicación.
Si está utilizando un enlace que aplica la seguridad en el nivel de transporte, todos los datos de la aplicación se protegerán según las capacidades del transporte.
Si utiliza un enlace que aplica la seguridad en el nivel de mensaje, a continuación, los datos de la aplicación se protegerán según los niveles de protección establecidos en el contrato. Si no especifica un nivel de protección, a continuación, se cifrarán y firmarán todos los datos de la aplicación en los mensajes.
Se puede establecer ProtectionLevel en distintos niveles de ámbito. Hay una jerarquía asociada con el ámbito, que se explicará en la sección siguiente.

Ámbito

Establecer ProtectionLevel en la API de nivel superior define el nivel para todos los niveles debajo de ella. Si ProtectionLevel está establecido con un valor diferente en un nivel más bajo, todas las API debajo de ese nivel en la jerarquía se restablecerán ahora en el nuevo nivel (sin embargo, las API por encima de él se seguirán viendo afectadas por el nivel superior). La jerarquía es la siguiente. Los atributos que están alineados son del mismo nivel.

ServiceContractAttribute

OperationContractAttribute

FaultContractAttribute

MessageContractAttribute

MessageHeaderAttribute

MessageBodyMemberAttribute

Programación de ProtectionLevel

Para programar ProtectionLevel en cualquier punto de la jerarquía, basta con establecer la propiedad con un valor adecuado cuando se aplique el atributo. Para obtener ejemplos, vea Cómo: Establecer la propiedad ProtectionLevel.

Nota:
Establecer la propiedad en errores y contratos de mensaje exige conocer cómo funcionan esas características. Para obtener más información, vea Cómo: Establecer la propiedad ProtectionLevel y Usar contratos de mensaje.

Dependencia de WS-Addressing

En la mayoría de los casos, usar Herramienta de utilidad de metadatos de ServiceModel (Svcutil.exe) para generar un cliente garantiza que los contratos del cliente y de servicios son idénticos. Sin embargo, los contratos aparentemente idénticos pueden hacer que el cliente produzca una excepción. Esto ocurre siempre que un enlace no admita la especificación de WS-Addressing y se especifiquen varios niveles de protección en el contrato. Por ejemplo, la clase BasicHttpBinding no admite la especificación o si crea un enlace personalizado que no admite WS-Addressing. La característica ProtectionLevel confía en la especificación de WS-Addressing para habilitar los niveles de protección diferentes en un contrato único. Si el enlace no admite la especificación de WS-Addressing, todos los niveles estarán establecidos en el mismo nivel de protección. El nivel de protección eficaz para todos los ámbitos del contrato estará establecido en el nivel de protección más alto utilizado en el contrato.

Esto puede producir un problema que será difícil depurar a primera vista. Es posible crear un contrato de cliente (una interfaz) que incluya los métodos para más de un servicio. Es decir, la misma interfaz se utiliza para crear un cliente que comunica con muchos servicios y la interfaz contiene los métodos para todos los servicios. El desarrollador debe tener cuidado en este escenario atípico para invocar solo aquellos métodos que son aplicables para cada servicio determinado. Si el enlace es la clase BasicHttpBinding, no se pueden admitir varios niveles de protección. Sin embargo, un servicio que responde al cliente podría responder a un cliente con un nivel de protección más bajo que el necesario. En este caso, el cliente producirá una excepción porque espera un nivel más alto.

El siguiente ejemplo del código muestra este problema. El ejemplo siguiente muestra un contrato de servicio y uno de cliente. Suponga que el enlace es el elemento <basicHttpBinding>. Por consiguiente, todas las operaciones en un contrato tienen el mismo nivel de protección. Este nivel de protección uniforme se determina como el nivel de protección máximo en todas las operaciones.

El contrato de servicios es:

<ServiceContract()> _
Public Interface IPurchaseOrder
    <OperationContract(ProtectionLevel := ProtectionLevel.Sign)> _
    Function Price() As Integer
End Interface

[ServiceContract()]
public interface IPurchaseOrder
{
    [OperationContract(ProtectionLevel = ProtectionLevel.Sign)]
    int Price();
}

En el siguiente ejemplo de código se muestra una interfaz de contrato de cliente. Observe que incluye un método Tax que se utilizará con un servicio diferente:

<ServiceContract()> _
Public Interface IPurchaseOrder
    <OperationContract()> _
    Function Tax() As Integer

    <OperationContract(ProtectionLevel := ProtectionLevel.Sign)> _
    Function Price() As Integer
End Interface

[ServiceContract()]
public interface IPurchaseOrder
{
    [OperationContract()]
    int Tax();

    [OperationContract(ProtectionLevel = ProtectionLevel.Sign)]
    int Price();
}

Cuando el cliente llama al método Price, produce una excepción cuando recibe una respuesta del servicio. Esto se produce porque el cliente no especifica un ProtectionLevel en ServiceContractAttribute y, por consiguiente, el cliente utiliza el valor predeterminado (EncryptAndSign) para todos los métodos, incluido el método Price. Sin embargo, el servicio devuelve el valor mediante el nivel Sign porque el contrato de servicios define un método único que tiene el nivel de protección definido en Sign. En este caso, se producirá un error en el cliente al validar la respuesta del servicio.

Vea también

Compartir a través de

Descripción de los niveles de protección

Fundamentos

Ámbito

Programación de ProtectionLevel

Dependencia de WS-Addressing

Vea también

Tareas

Referencia

Conceptos

Recursos adicionales