方法 : トランスポートセキュリティを使用します。

[アーティクル]
10/29/2009

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。空白のトピックは、プレースホルダーとして挿入されています。]

.NET Compact Framework Version 3.5 では、デスクトップ上の Windows Communication Foundation (WCF) サービスに接続するには、HTTPS トランスポートの使用できます。これはサポートサーバー認証とクライアント認証しています。

ここでは、サービスの構成の例について説明し、相互認証用のクライアントコードを修正方法を示します。

注意

サーバー認証の場合のみ、クライアント証明書が必要ないです。メッセージセキュリティの .NET Compact Framework 3.5 でもサポートされますがこの例で使用されていません。

デスクトップの WCF サービスを作成するには

作成し、サーバー証明書とクライアント証明書をインストールします。

以下の手順は、証明書の生成ツール (たとえば、Makecert.exe https://msdn.microsoft.com/ja-jp/library/bfsktky3(v=vs.100)) を使用し、このトピックの範囲を超えていますに固有です。次のタスク必要があります。
- 自己署名入り証明書を作成し、名前 (たとえば、会社名を使用します。会社) です。
- 会社のによって署名されたサーバー証明書を作成します。サーバー証明書名のサービスにアクセスするために使用される URL ホスト名と一致する必要があります。
- 会社のによって署名されたクライアント証明書を作成します。
注意

現在のユーザーにインストールではなくローカルコンピューターにサーバー証明書をインストールすることを推奨します。それ以外の場合は、サービスがインターネットインフォメーションサービス (IIS) でホストされている、現在のユーザーにインストールする場合、動作しません。
新しい Web サービスプロジェクトを作成します。

Web.config ファイルをここに示す例に置き換えます。次の要素と、ファイル内の属性を変更します。

新しいサービスを使用しているに service name 属性を変更します。
新しい動作の名前を参照する behaviorConfiguration 属性を変更します。
サービスインターフェイスを参照するには、endpoint contract 属性を変更します。

注意

binding <endpoint> 要素の属性値が"basicHttpBinding"かを確認します。.NET Compact Framework は、テキストのエンコーディングがないバイナリエンコーディングサポートします。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service 
          name="CalculatorService"
          behaviorConfiguration="MyServiceTypeBehaviors">
        <endpoint address=""
                  binding="basicHttpBinding"
                  bindingConfiguration="transport"
                  contract="ICalculatorService" />
        <endpoint address="mex"
                  binding="basicHttpBinding"
                  bindingConfiguration="transport"
                  contract="IMetadataExchange" />
      </service>
    </services>
    <bindings>
      <basicHttpBinding>
        <binding name="transport">
          <security mode="Transport">
            <transport clientCredentialType="Certificate" />
          </security>
        </binding>
      </basicHttpBinding>
    </bindings>
    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="MyServiceTypeBehaviors">
          <serviceMetadata httpsGetEnabled="True" httpsGetUrl=""/>
          <serviceDebug includeExceptionDetailInFaults="False" />
          <serviceCredentials>
            <clientCertificate>
               <authentication trustedStoreLocation="LocalMachine"
                           revocationMode="NoCheck"
                           certificateValidationMode="ChainTrust"/>
            </clientCertificate>
          </serviceCredentials>
        </behavior>
      </serviceBehaviors>
    </behaviors>

  </system.serviceModel>

</configuration>

WCF サービスのソースコードで、コードから属性を ServiceContractOperationContract で指定された任意のパラメーターを削除します。

注意

このサンプルは、ServiceContractOperationContract などの契約で指定されたパラメーターのサポートを実装しません。場合パラメーターサポートコントラクトは、WCF の .NET Compact Framework ServiceModel ユーティリティツール (NetCFSvcUtil.exe) を使用してクライアントコードを生成することができます。このツールはこれらのパラメーターの多くのサポート、.NET Compact Framework に基づくアプリケーションにビルドします。NetCFSvcUtil.exe は .NET Compact Framework の電源社で使用できます。詳細については、Power Toy .NET Compact Framework を参照してください。

次の例を簡略化の電卓アプリケーションの WCF サービスのソースコードに示します。
```
<ServiceContract()>  _
PublicInterface ICalculatorService
    <OperationContract()>  _
    Function Add(ByVal n1 AsDouble, ByVal n2 AsDouble) AsDouble    '<OperationContract()>  _Function Subtract(ByVal n1 AsDouble, ByVal n2 AsDouble) AsDoubleEndInterfacePublicClass CalculatorService
    Implements ICalculatorService

    PublicFunction Add(ByVal n1 AsDouble, ByVal n2 AsDouble) AsDoubleImplements ICalculatorService.Add
        Return n1 + n2

    EndFunctionPublicFunction Subtract(ByVal n1 AsDouble, ByVal n2 AsDouble) AsDoubleImplements ICalculatorService.Subtract
        Return n1 - n2

    EndFunctionEndClass
```
```
[ServiceContract()]
publicinterface ICalculatorService
{
    [OperationContract]
    double Add(double n1, double n2);
    [OperationContract]
    double Subtract(double n1, double n2);
}

publicclass CalculatorService : ICalculatorService
{
    publicdouble Add(double n1, double n2) { return n1 + n2; }
    publicdouble Subtract(double n1, double n2) { return n1 - n2; }
}
```
Web サイトまたは仮想ディレクトリを作成し、Web サービスプロジェクトを参照します。 Web サーバー上には HTTPS とクライアント証明書を要求するサービス構成します。

注意

指定 IIS では、してください、サーバーの証明書とクライアントの証明書
Web サーバーを起動します。

Web サービス記述言語 (WSDL) の出力を表示し、localhost に、サービスを実行する場合は、https://localhost/CalculatorService/Service.svc?wsdl に移動します。 WCF サービスの指定した同じ Web プロジェクト名を使用します。
アクセスすることを確認することができます、ディレクトリ、デスクトップブラウザーと、デバイスのブラウザーから HTTPS を使用しています。

ある証明書が正しく構成されて、サービスにアクセスすることができます前に確認する必要があります。 Web サーバーを構成、WCF サービスに対する要求を処理する必要があります。

.NET Compact Framework クライアントを作成するには

サービスが実行中に、コマンドラインを開き、WCF サービスがあるディレクトリに移動します。
コマンドプロンプトで WCF ServiceModel デスクトップユーティリティツール、WCF クライアントプロキシを生成するには、(SvcUtil.exe) を実行します。以下に、localhost のサービスがホストされている SvcUtil のコマンドラインの呼び出しを示します。
```
svcutil.exe /language:c# https://localhost/CalculatorService/Service.svc
```
サポートされていない属性と要素を次を含む、生成されたクライアントプロキシコードから削除します。
- すべての System.ServiceModel 属性。
- IClientChannel クラスへの参照。
- <endpoint> 構成名への参照。
- 内部チャネル上で ServiceContract インターフェイスのメソッドが呼び出されるメソッドの実装。
この手順の例を「方法 : HTTP トランスポートを使用します。」を参照してください。
クライアントプロジェクトを作成します。
プロジェクトに、生成されたクライアントプロキシを追加します。
生成されたプロキシコード、内には、ユーザー定義 ClientBase<TChannel> クラスに ClientBase への完全限定参照を変更します。

生成されたプロキシコードで、ユーザー定義 Call クラスの ClientBase メソッドを呼び出してメソッドの実装を追加します。

                            Public
                            Function Add(ByVal n1 AsDouble, ByVal n2 AsDouble) AsDoubleImplements ICalculatorService.Add
    Return System.Convert.ToDouble(MyBase.Call("Add", "https://fabrikam.com/CalcService/ICalculatorService/Add", NewString() {"n1", "n2"}, NewObject() {n1, n2}, GetType(Double)))

EndFunction

                            public
                            double Add(double n1, double n2)
{
    return (double)base.Call("Add", "https://fabrikam.com/CalcService/ICalculatorService/Add", newstring[] { "n1", "n2" }, newobject[] { n1, n2 }, typeof(double));
}

プロジェクトにプロキシの基本クラスを追加します。このクラスを"ClientBase"と呼びます。

ClientBase の実装を指すには、クライアントプロキシの基本クラス参照を変更します。

注意

次の使用例で CustomBodyWriterClientBase クラスは、プリミティブ型のみをサポートします。以外のプリミティブ型をサポートするには、OnWriteBodyContents メソッドを拡張です。たとえば、メッセージデータシリアル化するカスタムシリアライザーを呼び出す可能性があります。ここでは、XML シリアライザーが消費する属性に、生成されたクライアントプロキシ内のコードの属性に変換しましょう。このシナリオでは、する必要がありますまず、次スイッチ追加 SvcUtil を実行するとします。/serializer:xmlserializer http://エンドポイント。

ClientBase クラスの例を次のコードに示します。 ClientCredentials オブジェクトは、この例では、 testuser の名前は、クライアントによって使用された X.509 証明書を指定するには使用されます。

                            Public
                            Class ClientBase(Of TChannel AsClass)

    Private requestChannel As IRequestChannel
    Private messageVersion As MessageVersion


    PublicSubNew(ByVal binding As System.ServiceModel.Channels.Binding, ByVal remoteAddress As System.ServiceModel.EndpointAddress)
        'this.remoteAddress = remoteAddress;Me.messageVersion = binding.MessageVersion

        Dim parameters = New System.ServiceModel.Channels.BindingParameterCollection()

        ' Specifies the X.509 certificate used by the client.Dim cc AsNew ClientCredentials()
        cc.ClientCertificate.SetCertificate(StoreLocation.CurrentUser, StoreName.My, X509FindType.FindBySubjectName, "testuser")
        parameters.Add(cc)

        Dim channelFactory As IChannelFactory(Of IRequestChannel)
        channelFactory = binding.BuildChannelFactory(Of IRequestChannel)(parameters)
        channelFactory.Open()
        Me.requestChannel = channelFactory.CreateChannel(remoteAddress)

    EndSubPublicFunction [Call](ByVal op AsString, ByVal action AsString, ByVal varnames() AsString, ByVal varvals() AsObject, ByVal returntype As Type) AsObject
        requestChannel.Open(TimeSpan.MaxValue)

        'Message msg =        'Message.CreateMessage(MessageVersion.<FromBinding>,        '      action,        '      new CustomBodyWriter(op, varnames, varvals,        '"<ns passed in from Proxy>"));Dim msg As Message = Message.CreateMessage(Me.messageVersion, action, New CustomBodyWriter(op, varnames, varvals, "<ns passed in from Proxy>"))

        Dim reply As Message = requestChannel.Request(msg, TimeSpan.MaxValue)
        Dim reader As XmlDictionaryReader = reply.GetReaderAtBodyContents()
        reader.ReadToFollowing(op + "Result")
        Return reader.ReadElementContentAs(returntype, Nothing)

    EndFunctionEndClassFriendClass CustomBodyWriter
    Inherits BodyWriter
    Private op AsStringPrivate varnames() AsStringPrivate varvals() AsObjectPrivate ns AsStringPublicSubNew(ByVal op AsString, ByVal varnames() AsString, ByVal varvals() AsObject, ByVal ns AsString)
        MyBase.New(True)
        Me.op = op
        Me.varnames = varnames
        Me.varvals = varvals
        Me.ns = ns

    EndSubProtectedOverridesSub OnWriteBodyContents(ByVal writer As XmlDictionaryWriter)
        writer.WriteStartElement(op, ns)
        Dim i AsIntegerFor i = 0 To varnames.Length
            writer.WriteElementString(varnames(i), varvals(i).ToString())
        Next i
        writer.WriteEndElement()

    EndSubEndClass

                            public
                            class ClientBase<TChannel>
    where TChannel : class
{
    private IRequestChannel requestChannel;
    private MessageVersion messageVersion;

    public ClientBase(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress)
    {
        //this.remoteAddress = remoteAddress;this.messageVersion = binding.MessageVersion;

        BindingParameterCollection parameters = new System.ServiceModel.Channels.BindingParameterCollection();

        // Specifies the X.509 certificate used by the client.
        ClientCredentials cc = new ClientCredentials();
        cc.ClientCertificate.SetCertificate(StoreLocation.CurrentUser, StoreName.My, X509FindType.FindBySubjectName, "testuser");
        parameters.Add(cc);

        IChannelFactory<IRequestChannel> channelFactory = binding.BuildChannelFactory<IRequestChannel>(
            parameters);
        channelFactory.Open();
        this.requestChannel = channelFactory.CreateChannel(remoteAddress);
    }

    publicobject Call(string op, string action, string[] varnames, object[] varvals, Type returntype)
    {
        requestChannel.Open(TimeSpan.MaxValue);

        //Message msg =//Message.CreateMessage(MessageVersion.<FromBinding>,//      action,//      new CustomBodyWriter(op, varnames, varvals,//"<ns passed in from Proxy>"));

        Message msg =                   
        Message.CreateMessage(this.messageVersion, action,
              new CustomBodyWriter(op, varnames, varvals,               
        "<ns passed in from Proxy>"));

        Message reply = requestChannel.Request(msg, TimeSpan.MaxValue);
        XmlDictionaryReader reader = reply.GetReaderAtBodyContents();
        reader.ReadToFollowing(op + "Result");
        return reader.ReadElementContentAs(returntype, null);
    }

}

internalclass CustomBodyWriter : BodyWriter
{
    privatestring op;
    privatestring[] varnames;
    privateobject[] varvals;
    privatestring ns;

    public CustomBodyWriter(string op, string[] varnames, object[] varvals, string ns)
        : base(true)
    {
        this.op = op;
        this.varnames = varnames;
        this.varvals = varvals;
        this.ns = ns;
    }

    protectedoverridevoid OnWriteBodyContents(XmlDictionaryWriter writer)
    {
        writer.WriteStartElement(op, ns);
        for (int i = 0; i < varnames.Length; i++)
            writer.WriteElementString(varnames[i], varvals[i].ToString());
        writer.WriteEndElement();
    }
}

ClientBase.cs に次の参照を追加します。

作成し、クライアントプロキシを使用してクラスを追加します。

バインディングオブジェクトを使用して HTTPS およびクライアント証明書の認証の使用経由でトランスポートのセキュリティを指定する例を次に示します。また、クライアントプロキシを呼び出すコードを示します。

                            Class Program

    ''' <summary>    ''' The main entry point for the application.    ''' </summary>
    <MTAThread()> _
    SharedSub Main()

        Dim serverAddress AsString = CalculatorServiceClient.ServiceEndPoint.Uri.AbsoluteUri

        Dim binding AsNew BasicHttpBinding()

        ' Specifies transport security over HTTPS and the use of a        ' client certificate for authentication.
        binding.Security.Mode = BasicHttpSecurityMode.Transport
        binding.Security.Transport.ClientCredentialType = HttpClientCredentialType.Certificate

        Dim proxy = New CalculatorServiceClient(binding, New EndpointAddress(serverAddress))

        MessageBox.Show("Add 3 + 6...")
        MessageBox.Show(proxy.Add(3, 6).ToString())
        MessageBox.Show("Subtract 8 - 3...")
        MessageBox.Show(proxy.Subtract(8, 3).ToString())

    EndSubEndClass

                            static
                            class Program
{
    /// <summary>/// The main entry point for the application./// </summary>
    [MTAThread]

    staticvoid Main()
    {
        string serverAddress = CalculatorServiceClient.ServiceEndPoint.Uri.AbsoluteUri;

        BasicHttpBinding binding = new BasicHttpBinding();

        // Specifies transport security over HTTPS and the use of a// client certificate for authentication.
        binding.Security.Mode = BasicHttpSecurityMode.Transport;
        binding.Security.Transport.ClientCredentialType = HttpClientCredentialType.Certificate;

        ICalculatorService proxy = new CalculatorServiceClient(binding, new EndpointAddress(serverAddress));

        MessageBox.Show("Add 3 + 6...");
        MessageBox.Show((proxy.Add(3, 6)).ToString());
        MessageBox.Show("Subtract 8 - 3...");        
        MessageBox.Show((proxy.Subtract(8, 3)).ToString());

    }
}

クライアント証明書はデバイス上の現在のユーザーの証明書ストアに配置されていることを確認します。
クライアントアプリケーションをビルドし、デバイスに展開します。
WCF サービスが実行されていると、デバイスがネットワークに接続されている、デバイス上でクライアントアプリケーションを起動します。

コードのコンパイル方法

WCF サービスのソースコードには、次の名前空間への参照が必要です。

ClientBase クラスのソースコードには、次の名前空間への参照が必要です。

クライアントアプリケーションで Main メソッドを格納するクラスのソースコードには、次の名前空間への参照が必要です。

セキュリティ

次の使用例は、相互認証に基づくトランスポートのセキュリティを実装します。メッセージセキュリティを実装しません。

参照

その他の技術情報

Windows 通信基盤 (WCF) の開発と、.NET Framework を最適化します。

Share via

方法 : トランスポートセキュリティを使用します。

デスクトップの WCF サービスを作成するには

.NET Compact Framework クライアントを作成するには

コードのコンパイル方法

セキュリティ

参照

その他の技術情報

その他のリソース

Share via

方法 : トランスポート セキュリティを使用します。

デスクトップの WCF サービスを作成するには

.NET Compact Framework クライアントを作成するには

コードのコンパイル方法

セキュリティ

参照

その他の技術情報

その他のリソース

方法 : トランスポートセキュリティを使用します。