Como: definir a propriedade ProtectionLevel

Você pode definir o nível de proteção aplicando um atributo apropriado e definindo a propriedade. Você pode definir a proteção no nível do serviço para afetar todas as partes de cada mensagem ou definir a proteção em níveis granulares incrementais, de métodos a partes de mensagem. Para obter mais informações sobre a propriedade ProtectionLevel, consulte Noções básicas de nível de proteção.

Observação

Só é possível definir níveis de proteção no código, não na configuração.

Para assinar todas as mensagens de um serviço

1. Crie uma interface para o serviço.

2. Aplique o atributo ServiceContractAttribute ao serviço e defina a propriedade ProtectionLevel como Sign, conforme mostrado no código a seguir (o nível padrão é EncryptAndSign).

   // Set the ProtectionLevel on the whole service to Sign.
   [ServiceContract(ProtectionLevel = ProtectionLevel.Sign)]
   public interface ICalculator
   

   ' Set the ProtectionLevel on the whole service to Sign.
   <ServiceContract(ProtectionLevel:=ProtectionLevel.Sign)> _
   Public Interface ICalculator
   

Para assinar todas as partes de mensagem para uma operação

1. Crie uma interface para o serviço e aplique o atributo ServiceContractAttribute à interface.

2. Adicione uma declaração de método à interface.

3. Aplique o atributo OperationContractAttribute ao método e defina a propriedade ProtectionLevel como Sign, conforme mostrado no código a seguir.

   // Set the ProtectionLevel on the whole service to Sign.
   [ServiceContract(ProtectionLevel = ProtectionLevel.Sign)]
   public interface ICalculator
   {
       // Set the ProtectionLevel on this operation to None.
       [OperationContract(ProtectionLevel = ProtectionLevel.Sign)]
       double Add(double a, double b);
   }
   

   ' Set the ProtectionLevel on the whole service to Sign.
   <ServiceContract(ProtectionLevel:=ProtectionLevel.Sign)> _
   Public Interface ICalculator
   
       ' Set the ProtectionLevel on this operation to Sign.
       <OperationContract(ProtectionLevel:=ProtectionLevel.Sign)> _
       Function Add(ByVal a As Double, ByVal b As Double) As Double
   End Interface
   

Proteger mensagens de falha

Exceções geradas em um serviço podem ser enviadas a um cliente como falhas SOAP. Para obter mais informações sobre como criar falhas com tipos fortes, consulte Especificar e tratar falhas em contratos e serviços e Como declarar falhas em contratos de serviço.

Para proteger uma mensagem de falha

1. Crie um tipo que represente a mensagem de falha. O exemplo a seguir cria uma classe nomeada MathFault com dois campos.

2. Aplique o atributo DataContractAttribute ao tipo e a um atributo DataMemberAttribute a cada campo que deve ser serializado, conforme mostrado no código a seguir.

   [DataContract]
   public class MathFault
   {
       [DataMember]
       public string operation;
       [DataMember]
       public string description;
   }
   

   <DataContract()> _
   Public Class MathFault
       <DataMember()> _
       Public operation As String
       <DataMember()> _
       Public description As String
   End Class
   

3. Na interface que retornará a falha, aplique o atributo FaultContractAttribute ao método que retornará a falha e defina o parâmetro detailType como o tipo da classe de falha.

4. Também no construtor, defina a propriedade ProtectionLevel como EncryptAndSign, conforme mostrado no código a seguir.

   public interface ICalculator
   {
       // Set the ProtectionLevel on a FaultContractAttribute.
       [OperationContract(ProtectionLevel = ProtectionLevel.EncryptAndSign)]
       [FaultContract(
           typeof(MathFault),
           Action = @"http://localhost/Add",
           Name = "AddFault",
           Namespace = "http://contoso.com",
           ProtectionLevel = ProtectionLevel.EncryptAndSign)]
       double Add(double a, double b);
   }
   

   Public Interface ICalculator
       ' Set the ProtectionLevel on a FaultContractAttribute.
       <OperationContract(ProtectionLevel:=ProtectionLevel.EncryptAndSign), _
        FaultContract(GetType(MathFault), ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
       Function Add(ByVal a As Double, ByVal b As Double) As Double
   End Interface
   

Proteger partes de mensagens

Use um contrato de mensagem para proteger partes de uma mensagem. Para obter mais informações sobre contratos de mensagens, consulte Usar contratos de mensagem.

Para proteger um corpo da mensagem

1. Crie um tipo que represente a mensagem de falha. O exemplo a seguir cria uma classe nomeada Company com dois campos, CompanyName e CompanyID.

2. Aplique o atributo MessageContractAttribute à classe e defina a propriedade ProtectionLevel como EncryptAndSign.

3. Aplique o atributo MessageHeaderAttribute a um campo que será expresso como um cabeçalho de mensagem e defina a propriedade ProtectionLevel como EncryptAndSign.

4. Aplique o campo MessageBodyMemberAttribute a qualquer campo que será expresso como parte do corpo da mensagem e defina a propriedade ProtectionLevel como EncryptAndSign, conforme mostrado no exemplo a seguir.

   [MessageContract(ProtectionLevel = ProtectionLevel.EncryptAndSign)]
   public class Company
   {
       [MessageHeader(ProtectionLevel = ProtectionLevel.Sign)]
       public string CompanyName;
   
       [MessageBodyMember(ProtectionLevel = ProtectionLevel.EncryptAndSign)]
       public string CompanyID;
   }
   

   <MessageContract(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
   Public Class Company
       <MessageHeader(ProtectionLevel:=ProtectionLevel.Sign)> _
       Public CompanyName As String
   
       <MessageBodyMember(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
       Public CompanyID As String
   End Class
   

Exemplo

O exemplo a seguir define a propriedade ProtectionLevel de várias classes de atributo em vários locais em um serviço.

[ServiceContract(ProtectionLevel = ProtectionLevel.EncryptAndSign)]
public interface ICalculator
{
    [OperationContract(ProtectionLevel = ProtectionLevel.Sign)]
    double Add(double a, double b);

    [OperationContract()]
    [FaultContract(typeof(MathFault),
        ProtectionLevel = ProtectionLevel.EncryptAndSign)]
    double Subtract(double a, double b);

    [OperationContract(ProtectionLevel = ProtectionLevel.EncryptAndSign)]
    Company GetCompanyInfo();
}

[DataContract]
public class MathFault
{
    [DataMember]
    public string operation;
    [DataMember]
    public string description;
}

[MessageContract(ProtectionLevel = ProtectionLevel.EncryptAndSign)]
public class Company
{
    [MessageHeader(ProtectionLevel = ProtectionLevel.Sign)]
    public string CompanyName;

    [MessageBodyMember(ProtectionLevel = ProtectionLevel.EncryptAndSign)]
    public string CompanyID;
}

[MessageContract(ProtectionLevel = ProtectionLevel.Sign)]
public class Calculator : ICalculator
{
    public double Add(double a, double b)
    {
        return a + b;
    }

    public double Subtract(double a, double b)
    {
        return a - b;
    }

    public Company GetCompanyInfo()
    {
        Company co = new Company();
        co.CompanyName = "www.cohowinery.com";
        return co;
    }
}

public class Test
{
    static void Main()
    {
        Test t = new Test();
        try
        {
            t.Run();
        }
        catch (System.InvalidOperationException inv)
        {
            Console.WriteLine(inv.Message);
        }
    }

    private void Run()
    {
        // Create a binding and set the security mode to Message.
        WSHttpBinding b = new WSHttpBinding();
        b.Security.Mode = SecurityMode.Message;

        Type contractType = typeof(ICalculator);
        Type implementedContract = typeof(Calculator);
        Uri baseAddress = new Uri("http://localhost:8044/base");

        // Create the ServiceHost and add an endpoint.
        ServiceHost sh = new ServiceHost(implementedContract, baseAddress);
        sh.AddServiceEndpoint(contractType, b, "Calculator");

        ServiceMetadataBehavior sm = new ServiceMetadataBehavior();
        sm.HttpGetEnabled = true;
        sh.Description.Behaviors.Add(sm);
        sh.Credentials.ServiceCertificate.SetCertificate(
            StoreLocation.CurrentUser,
            StoreName.My,
            X509FindType.FindByIssuerName,
            "ValidCertificateIssuer");

        foreach (ServiceEndpoint se in sh.Description.Endpoints)
        {
            ContractDescription cd = se.Contract;
            Console.WriteLine("\nContractDescription: ProtectionLevel = {0}", cd.Name, cd.ProtectionLevel);
            foreach (OperationDescription od in cd.Operations)
            {
                Console.WriteLine("\nOperationDescription: Name = {0}", od.Name, od.ProtectionLevel);
                Console.WriteLine("ProtectionLevel = {1}", od.Name, od.ProtectionLevel);
                foreach (MessageDescription m in od.Messages)
                {
                    Console.WriteLine("\t {0}: {1}", m.Action, m.ProtectionLevel);
                    foreach (MessageHeaderDescription mh in m.Headers)
                    {
                        Console.WriteLine("\t\t {0}: {1}", mh.Name, mh.ProtectionLevel);

                        foreach (MessagePropertyDescription mp in m.Properties)
                        {
                            Console.WriteLine("{0}: {1}", mp.Name, mp.ProtectionLevel);
                        }
                    }
                }
            }
        }
        sh.Open();
        Console.WriteLine("Listening");
        Console.ReadLine();
        sh.Close();
    }
}

<ServiceContract(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
Public Interface ICalculator
    <OperationContract(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
    Function Add(ByVal a As Double, ByVal b As Double) As Double


    <OperationContract(), _
       FaultContract _
       (GetType(MathFault), _
       Action:="http://localhost/Add", _
       Name:="AddFault", _
       Namespace:="http://contoso.com", _
       ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
    Function Subtract(ByVal a As Double, ByVal b As Double) As Double

    <OperationContract(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
    Function GetCompanyInfo() As Company
End Interface


<DataContract()> _
Public Class MathFault
    <DataMember()> _
    Public operation As String
    <DataMember()> _
    Public description As String
End Class

<MessageContract(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
Public Class Company
    <MessageHeader(ProtectionLevel:=ProtectionLevel.Sign)> _
    Public CompanyName As String

    <MessageBodyMember(ProtectionLevel:=ProtectionLevel.EncryptAndSign)> _
    Public CompanyID As String
End Class

<MessageContract(ProtectionLevel:=ProtectionLevel.Sign)> _
Public Class Calculator
    Implements ICalculator

    Public Function Add(ByVal a As Double, ByVal b As Double) As Double _
      Implements ICalculator.Add
        Return a + b

    End Function

    Public Function Subtract(ByVal a As Double, ByVal b As Double) As Double _
       Implements ICalculator.Subtract
        Return a - b

    End Function

    Public Function GetCompanyInfo() As Company Implements ICalculator.GetCompanyInfo
        Dim co As New Company()
        co.CompanyName = "www.cohowinery.com"
        Return co
    End Function
End Class


Public Class Test

    Shared Sub Main()
        Dim t As New Test()
        Try
            t.Run()
        Catch inv As System.InvalidOperationException
            Console.WriteLine(inv.Message)
        End Try
    End Sub


    Private Sub Run()
        ' Create a binding and set the security mode to Message.
        Dim b As New WSHttpBinding()
        b.Security.Mode = SecurityMode.Message

        Dim contractType As Type = GetType(ICalculator)
        Dim implementedContract As Type = GetType(Calculator)
        Dim baseAddress As New Uri("http://localhost:8044/base")

        ' Create the ServiceHost and add an endpoint.
        Dim sh As New ServiceHost(implementedContract, baseAddress)
        sh.AddServiceEndpoint(contractType, b, "Calculator")

        Dim sm As New ServiceMetadataBehavior()
        sm.HttpGetEnabled = True
        sh.Description.Behaviors.Add(sm)
        sh.Credentials.ServiceCertificate.SetCertificate( _
           StoreLocation.CurrentUser, StoreName.My, _
           X509FindType.FindByIssuerName, "ValidCertificateIssuer")

        Dim se As ServiceEndpoint
        For Each se In sh.Description.Endpoints
            Dim cd As ContractDescription = se.Contract
            Console.WriteLine(vbLf + "ContractDescription: ProtectionLevel = {0}", _
               cd.Name, cd.ProtectionLevel)
            Dim od As OperationDescription
            For Each od In cd.Operations
                Console.WriteLine(vbLf + "OperationDescription: Name = {0}", od.Name, od.ProtectionLevel)
                Console.WriteLine("ProtectionLevel = {1}", od.Name, od.ProtectionLevel)
                Dim m As MessageDescription
                For Each m In od.Messages
                    Console.WriteLine(vbTab + " {0}: {1}", m.Action, m.ProtectionLevel)
                    Dim mh As MessageHeaderDescription
                    For Each mh In m.Headers
                        Console.WriteLine(vbTab + vbTab + " {0}: {1}", mh.Name, mh.ProtectionLevel)

                        Dim mp As MessagePropertyDescription
                        For Each mp In m.Properties
                            Console.WriteLine("{0}: {1}", mp.Name, mp.ProtectionLevel)
                        Next mp
                    Next mh
                Next m
            Next od
        Next se
        sh.Open()
        Console.WriteLine("Listening")
        Console.ReadLine()
        sh.Close()

    End Sub
End Class

Compilando o código

O código a seguir mostra os namespaces necessários para compilar o código de exemplo.

using System;
using System.ServiceModel;
using System.Net.Security;
using System.ServiceModel.Description;
using System.Security.Cryptography.X509Certificates;
using System.Runtime.Serialization;

Imports System.ServiceModel
Imports System.Net.Security
Imports System.ServiceModel.Description
Imports System.Security.Cryptography.X509Certificates
Imports System.Runtime.Serialization

Confira também

• ServiceContractAttribute
• OperationContractAttribute
• FaultContractAttribute
• MessageContractAttribute
• MessageBodyMemberAttribute
• Noções básicas de nível de proteção