Gör så här: Ange egenskapen ProtectionLevel

Du kan ange skyddsnivån genom att använda ett lämpligt attribut och ange egenskapen. Du kan ange skydd på tjänstnivå för att påverka alla delar av varje meddelande, eller så kan du ange skydd på allt mer detaljerade nivåer, från metoder till meddelandedelar. Mer information om egenskapen finns i ProtectionLevel Förstå skyddsnivå.

Kommentar

Du kan bara ange skyddsnivåer i kod, inte i konfigurationen.

Så här signerar du alla meddelanden för en tjänst

1. Skapa ett gränssnitt för tjänsten.

2. ServiceContractAttribute Använd attributet för tjänsten och ange ProtectionLevel egenskapen till Sign, som du ser i följande kod (standardnivån är 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
   

Så här signerar du alla meddelandedelar för en åtgärd

1. Skapa ett gränssnitt för tjänsten och tillämpa ServiceContractAttribute attributet på gränssnittet.

2. Lägg till en metoddeklaration i gränssnittet.

3. OperationContractAttribute Använd attributet för metoden och ange ProtectionLevel egenskapen till Sign, som du ser i följande kod.

   // 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
   

Skydda felmeddelanden

Undantag som utlöses på en tjänst kan skickas till en klient som SOAP-fel. Mer information om hur du skapar starkt maskinskrivna fel finns i Ange och hantera fel i kontrakt och tjänster och Så här: Deklarera fel i tjänstkontrakt.

Så här skyddar du ett felmeddelande

1. Skapa en typ som representerar felmeddelandet. I följande exempel skapas en klass med namnet MathFault med två fält.

2. DataContractAttribute Använd attributet för typen och ett DataMemberAttribute attribut för varje fält som ska serialiseras, enligt följande kod.

   [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. I gränssnittet som returnerar felet tillämpar du FaultContractAttribute attributet på den metod som returnerar felet och anger parametern detailType till typen av felklass.

4. I konstruktorn anger du ProtectionLevel även egenskapen till EncryptAndSign, som du ser i följande kod.

   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
   

Skydda meddelandedelar

Använd ett meddelandekontrakt för att skydda delar av ett meddelande. Mer information om meddelandekontrakt finns i Använda meddelandekontrakt.

Skydda en meddelandetext

1. Skapa en typ som representerar meddelandet. I följande exempel skapas en Company klass med två fält och CompanyNameCompanyID.

2. MessageContractAttribute Använd attributet för klassen och ange ProtectionLevel egenskapen till EncryptAndSign.

3. MessageHeaderAttribute Använd attributet på ett fält som uttrycks som ett meddelandehuvud och ange ProtectionLevel egenskapen till EncryptAndSign.

4. Använd på MessageBodyMemberAttribute alla fält som ska uttryckas som en del av meddelandetexten och ange ProtectionLevel egenskapen till EncryptAndSign, som du ser i följande exempel.

   [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
   

Exempel

I följande exempel anges egenskapen för ProtectionLevel flera attributklasser på olika platser i en tjänst.

[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

Kompilera koden

Följande kod visar de namnområden som krävs för att kompilera exempelkoden.

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

Se även

• ServiceContractAttribute
• OperationContractAttribute
• FaultContractAttribute
• MessageContractAttribute
• MessageBodyMemberAttribute
• Förstå skyddsnivå