방법: ProtectionLevel 속성 설정

적절한 특성을 적용하고 속성을 설정하여 보호 수준을 설정할 수 있습니다. 각 메시지의 모든 부분에 영향을 주도록 서비스 수준에서 보호를 설정하거나 메서드에서 메시지 부분으로 점차 세부적인 수준에서 보호를 설정할 수 있습니다. ProtectionLevel 속성에 대한 자세한 내용은 보호 수준 이해를 참조하세요.

참고 항목

구성이 아닌 코드에서만 보호 수준을 설정할 수 있습니다.

서비스의 모든 메시지를 서명하려면

1. 서비스에 대한 인터페이스를 만듭니다.

2. 다음 코드에 표시된 것처럼 ServiceContractAttribute 특성을 서비스에 적용하고 ProtectionLevel 속성을 Sign으로 설정합니다. 기본 수준은 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
   

작업에 대한 모든 메시지 부분을 서명하려면

1. 서비스에 대한 인터페이스를 만들고 ServiceContractAttribute 특성을 인터페이스에 적용합니다.

2. 메서드 선언을 인터페이스에 추가합니다.

3. 다음 코드에 표시된 것처럼 OperationContractAttribute 특성을 메서드에 적용하고 ProtectionLevel 속성을 Sign으로 설정합니다.

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

오류 메시지 보호

서비스에서 throw된 예외는 클라이언트에 SOAP 오류로 전송될 수 있습니다. 강력한 형식의 오류 만들기에 대한 자세한 내용은 계약 및 서비스의 오류 지정 및 처리 및 방법: 서비스 계약의 오류 선언을 참조하세요.

오류 메시지를 보호하려면

1. 오류 메시지를 나타내는 형식을 만듭니다. 다음 예제에서는 두 개의 필드를 사용하여 MathFault라는 클래스를 만듭니다.

2. 다음 코드에 표시된 것처럼 DataContractAttribute 특성을 형식에 적용하고 DataMemberAttribute 특성을 serialize해야 하는 각 필드에 적용합니다.

   [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. 오류를 반환할 인터페이스에서 FaultContractAttribute 특성을 오류를 반환할 메서드에 적용하고 detailType 매개 변수를 오류 클래스 형식으로 설정합니다.

4. 또한 다음 코드에 표시된 것처럼 생성자에서 ProtectionLevel 속성을 EncryptAndSign으로 설정합니다.

   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
   

메시지 부분 보호

메시지 계약을 사용하여 메시지의 일부분을 보호합니다. 메시지 계약에 대한 자세한 내용은 메시지 계약 사용을 참조하세요.

메시지 본문을 보호하려면

1. 메시지를 나타내는 형식을 만듭니다. 다음 예제에서는 Company 및 CompanyName 필드를 사용하여 CompanyID를 만듭니다.

2. MessageContractAttribute 특성을 클래스에 적용하고 ProtectionLevel 속성을 EncryptAndSign으로 설정합니다.

3. MessageHeaderAttribute 특성을 메시지 헤더로 표시될 필드에 적용하고 ProtectionLevel 특성을 EncryptAndSign으로 설정합니다.

4. 다음 예에 표시된 것처럼 MessageBodyMemberAttribute를 메시지 본문의 일부로 표시될 필드에 적용하고 ProtectionLevel 속성을 EncryptAndSign으로 설정합니다.

   [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
   

예시

다음 예제에서는 서비스의 다양한 위치에서 여러 특성 클래스의 ProtectionLevel 속성을 설정합니다.

[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

코드 컴파일

다음 코드에서는 예제 코드를 컴파일하는 데 필요한 네임스페이스를 보여 줍니다.

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

참고 항목

• ServiceContractAttribute
• OperationContractAttribute
• FaultContractAttribute
• MessageContractAttribute
• MessageBodyMemberAttribute
• 보호 수준 이해