チュートリアル: Azure WCF Relay を使用してオンプレミスの WCF REST サービスを外部クライアントに公開する

[アーティクル]
08/11/2023

このチュートリアルでは、Azure Relay を使用して WCF Relay クライアントアプリケーションとサービスを構築する方法について説明します。元の WCF サービスと同様に、サービスは 1 つ以上のエンドポイントを公開するコンストラクトです。各エンドポイントでは 1 つ以上のサービス操作が公開されます。サービスのエンドポイントでは、サービスが見つかるアドレス、クライアントがサービスとやり取りする必要がある情報を含むバインド、サービスがそのクライアントに提供する機能を定義するコントラクトを指定します。 WCF と WCF Relay の主な違いは、エンドポイントがコンピューターのローカルではなくクラウドで公開される点です。

このチュートリアルの一連のセクションを実行すると、実行中のサービスが作成されます。また、サービスの操作を呼び出すことができるクライアントも作成されます。

このチュートリアルでは、次のタスクを行います。

このチュートリアルの前提条件をインストールする。
Relay 名前空間を作成する。
WCF サービスコントラクトを作成する。
WCF コントラクトを実装する。
リレーサービスに登録する WCF サービスをホストして実行する。
サービスコントラクト用の WCF クライアントを作成する。
WCF クライアントを構成する。
WCF クライアントを実装する。
アプリケーションを実行する。

前提条件

このチュートリアルを完了するには、次の前提条件を用意しておく必要があります。

Azure サブスクリプション。お持ちでない場合は、開始する前に無料アカウントを作成してください。
Visual Studio 2015 またはそれ以降。このチュートリアルの例では、Visual Studio 2019 を使用します。
Azure SDK for .NET。 SDK のダウンロードページからインストールします。

Relay 名前空間を作成する

最初の手順として、名前空間を作成し、Shared Access Signature (SAS) キーを取得します。名前空間により、リレーサービスが公開する各アプリケーションにアプリケーション境界が設けられます。 SAS キーは、サービスの名前空間が作成されると、システムによって自動的に生成されます。サービス名前空間と SAS キーの組み合わせが、アプリケーションへのアクセスを Azure が認証する資格情報になります。

Azure portal にサインインします。
左側のメニューから、 [すべてのサービス] を選択します。 [統合] を選択し、[リレー] を検索し、[リレー] の上にマウスポインターを移動して、[作成] を選択します。
[名前空間の作成] ページで、これらの手順を実行します。
1. 名前空間を作成する Azure サブスクリプションを選択します。
2. [リソースグループ] で、名前空間を追加する既存のリソースグループを選択するか、新しいリソースグループを作成します。
3. リレー名前空間の名前を入力します。
4. 名前空間をホストするリージョンを選択します。
5. ページ下部にある [確認と作成] を選択します。
6. [確認および作成] ページで、 [作成] を選択します。
7. 数分後に、名前空間の [リレー] ページを確認します。

管理資格情報を取得する

[リレー] ページで、左側のメニューの [共有アクセスポリシー] を選択します。 `
[共有アクセスポリシー] ページで、 [RootManageSharedAccessKey] を選択します。
[SAS ポリシー:RootManageSharedAccessKey] の下で、 [プライマリ接続文字列] の横の [コピー] ボタンを選択します。これで、後で使用できるように接続文字列がクリップボードにコピーされます。この値をメモ帳などに一時的に貼り付けます。
前の手順を繰り返し、 [主キー] の値をコピーして、後で使用するために一時的な場所に貼り付けます。

WCF サービスコントラクトを定義する

サービスコントラクトでは、サービスがサポートする操作を指定します。操作は、Web サービスのメソッドまたは関数です。コントラクトを作成するには、C++、C#、または Visual Basic インターフェイスを定義します。インターフェイスの各メソッドは、特定のサービス操作に対応しています。各インターフェイスには、ServiceContractAttribute 属性が適用されている必要があります。また、各操作には、OperationContractAttribute 属性が適用されている必要があります。 ServiceContractAttribute 属性があるインターフェイスのメソッドに OperationContractAttribute 属性がない場合、そのメソッドは公開されません。以下の手順では、これらのタスクのコード例を示します。コントラクトとサービスの概要については、「サービスの設計と実装」を参照してください。

インターフェイスを使用してリレーコントラクトを作成する

Microsoft Visual Studio を管理者として起動します。これを行うには、Visual Studio のプログラムアイコンを右クリックして [管理者として実行] を選択します。
Visual Studio で、 [新しいプロジェクトの作成] を選択します。
[新しいプロジェクトの作成] で、C# の [コンソールアプリ (.NET Framework)] を選択してから、 [次へ] を選択します。
プロジェクトに EchoService という名前を付けて、[作成] を選択します。
ソリューションエクスプローラーで、プロジェクトを右クリックし、 [NuGet パッケージの管理] を選択します。 [NuGet パッケージマネージャー] で [参照] を選択してから、WindowsAzure.ServiceBus を検索して選択します。 [インストール] を選択して、使用条件に同意します。

Service Bus ライブラリと WCF の System.ServiceModel への参照が、このパッケージによって自動的に追加されます。 System.ServiceModel は、WCF の基本機能にプログラムでアクセスできるようにする名前空間です。 Service Bus は、サービスコントラクトの定義に WCF の多くのオブジェクトと属性を使用します。
Program.cs ファイルの先頭に次の using ステートメントを追加します。
```
using System.ServiceModel;
using Microsoft.ServiceBus;
```
名前空間の名前を、既定の名前である EchoService から Microsoft.ServiceBus.Samples に変更します。

重要

このチュートリアルでは、C# の名前空間 Microsoft.ServiceBus.Samples を使用します。これは、コントラクトベースのマネージド型の名前空間で、「WCF クライアントを構成する」セクションに出てくる構成ファイルで使用されます。このサンプルをビルドするときに、任意の名前空間を指定できます。ただし、それに応じてアプリケーション構成ファイルでコントラクトとサービスの名前空間を変更しない限り、このチュートリアルは機能しません。 App.config ファイルで指定する名前空間は、C# ファイルで指定した名前空間と同じである必要があります。
Microsoft.ServiceBus.Samples 名前空間の宣言の直後 (ただし、名前空間内部) に、IEchoContract という名前の新しいインターフェイスを定義し、このインターフェイスに名前空間の値が https://samples.microsoft.com/ServiceModel/Relay/ の ServiceContractAttribute 属性を適用します。名前空間の宣言の後に次のコードを貼り付けます。
```
[ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
public interface IEchoContract
{
}
```
この名前空間の値は、コードのスコープ全体で使用する名前空間とは異なります。代わりに、この名前空間の値は、このコントラクトの一意の識別子として使用されます。名前空間を明示的に指定すると、既定の名前空間値がコントラクト名に追加されなくなります。

Note

通常、サービスコントラクトの名前空間には、バージョン情報を含む名前付けスキームが含まれています。サービスコントラクトの名前空間にバージョン情報を含めると、サービスは、新しいサービスコントラクトを新しい名前空間を使用して定義し、それを新しいエンドポイントで公開することで、主要な変更を分離できます。この方法では、クライアントは、古いサービスコントラクトを更新する必要なく、使用し続けることができます。バージョン情報は、日付またはビルド番号で構成できます。詳細については、「サービスのバージョン管理」を参照してください。このチュートリアルでは、サービスコントラクトの名前空間の名前付けスキームにバージョン情報は含まれません。
IEchoContract インターフェイス内で、IEchoContract コントラクトがインターフェイスで公開している単一操作のメソッドを宣言し、次に示すように、パブリック WCF Relay コントラクトの一部として公開するメソッドに OperationContractAttribute 属性を適用します。
```
[OperationContract]
string Echo(string text);
```
次に示すように、IEchoContract インターフェイスの定義の直後に、IEchoContract インターフェイスと IClientChannel インターフェイスの両方から継承するチャネルを宣言します。
```
public interface IEchoChannel : IEchoContract, IClientChannel { }
```
チャネルは、ホストとクライアントが相互に情報を渡すときに経由する WCF オブジェクトです。後で、2 つのアプリケーション間で情報をエコーするチャネルに対するコードを記述します。
[ビルド]>[ソリューションのビルド] の順に選択するか、Ctrl + Shift + B キーを押して、ここまでの作業に問題がないことを確認します。

WCF コントラクトの例

次のコードに、WCF Relay コントラクトを定義する基本的なインターフェイスを示します。

using System;
using System.ServiceModel;

namespace Microsoft.ServiceBus.Samples
{
    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        String Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { }

    class Program
    {
        static void Main(string[] args)
        {
        }
    }
}

これでインターフェイスが作成されたので、このインターフェイスを実装することができます。

WCF コントラクトを実装する

Azure Relay を作成するには、まずインターフェイスを使用してコントラクトを作成する必要があります。インターフェイスの作成の詳細については、前のセクションを参照してください。次の手順では、インターフェイスを実装します。このタスクには、ユーザー定義の EchoService インターフェイスを実装する IEchoContract というクラスの作成が含まれます。インターフェイスを実装したら、App.config 構成ファイルを使用してインターフェイスを構成します。この構成ファイルには、アプリケーションに必要な情報が含まれています。この情報には、サービス名、コントラクト名、リレーサービスとの通信に使用されるプロトコルの種類が含まれます。次の手順では、これらのタスクに使用するコード例を示します。サービスコントラクトの実装方法の全般的な説明については、「サービスコントラクトの実装」をご覧ください。

IEchoContract インターフェイスの定義の直後に、EchoService という新しいクラスを作成します。 EchoService クラスによって、IEchoContract インターフェイスが実装されます。
```
class EchoService : IEchoContract
{
}
```
他のインターフェイス実装と同様に、別のファイルに指定した定義を実装することができます。ただし、このチュートリアルでは、インターフェイス定義や Main() メソッドと同じファイルに実装します。
IEchoContract インターフェイスに ServiceBehaviorAttribute 属性を適用します。サービスの名前と名前空間をこの属性で指定します。指定後の EchoService クラスは次のようになります。
```
[ServiceBehavior(Name = "EchoService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
class EchoService : IEchoContract
{
}
```
EchoService クラスの IEchoContract インターフェイスで定義された Echo メソッドを実装します。
```
public string Echo(string text)
{
    Console.WriteLine("Echoing: {0}", text);
    return text;
}
```
[ビルド]>[ソリューションのビルド] の順に選択するか、Ctrl + Shift + B キーを押します。

サービスホストの構成を定義する

構成ファイルは WCF 構成ファイルと似ています。これには、サービス名、エンドポイント、およびバインドが含まれています。エンドポイントは、クライアントとホストの相互通信用に Azure Relay により公開されている場所です。バインドは、通信に使用されるプロトコルの種類です。主な違いは、構成されているこのサービスエンドポイントで、.NET Framework に含まれていない NetTcpRelayBinding バインドが参照されている点です。 NetTcpRelayBinding は、サービスによって定義されたバインドの 1 つです。

ソリューションエクスプローラーで、App.config をダブルクリックして、Visual Studio エディターでそのファイルを開きます。
<appSettings> 要素内のプレースホルダーを、Azure Relay 名前空間の名前と前の手順でコピーした SAS キーに置き換えます。
<system.serviceModel> タグ内に、<services> 要素を追加します。 1 つの構成ファイルで複数のリレーアプリケーションを定義できます。ただし、このチュートリアルで定義するのは 1 つだけです。
```
<?xmlversion="1.0" encoding="utf-8"?>
<configuration>
  <system.serviceModel>
    <services>

    </services>
  </system.serviceModel>
</configuration>
```
<services> 要素内に、サービスの名前を定義する <service> 要素を追加します。
```
<service name="Microsoft.ServiceBus.Samples.EchoService">
</service>
```
<service> 要素内で、エンドポイントコントラクトの場所に加え、エンドポイントのバインドの種類も定義します。
```
<endpoint contract="Microsoft.ServiceBus.Samples.IEchoContract" binding="netTcpRelayBinding"/>
```
エンドポイントは、クライアントがホストアプリケーションを検索する場所を定義します。このチュートリアルでは、後でこの手順を使用して、Azure Relay を介してホストを完全に公開する URI を作成します。バインドにより、リレーサービスと通信するプロトコルとして TCP を使用することを宣言します。
[ビルド]>[ソリューションのビルド] の順に選択するか、Ctrl + Shift + B キーを押して、ここまでの作業に問題がないことを確認します。

サービスコントラクトの実装例

次のコードは、サービスコントラクトの実装を示します。

[ServiceBehavior(Name = "EchoService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]

    class EchoService : IEchoContract
    {
        public string Echo(string text)
        {
            Console.WriteLine("Echoing: {0}", text);
            return text;
        }
    }

次のコードは、サービスホストに関連付けられる App.config ファイルの基本的な形式を示します。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceBus.Samples.EchoService">
        <endpoint contract="Microsoft.ServiceBus.Samples.IEchoContract" binding="netTcpRelayBinding" />
      </service>
    </services>
    <extensions>
      <bindingExtensions>
        <add name="netTcpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.NetTcpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      </bindingExtensions>
    </extensions>
  </system.serviceModel>
</configuration>

リレーサービスに登録する WCF サービスをホストして実行する

この手順では、Azure Relay サービスの実行方法について説明します。

リレー資格情報を作成する

Main() で、コンソールウィンドウから読み取った名前空間と SAS キーを格納するための 2 つの変数を作成します。
```
Console.Write("Your Service Namespace: ");
string serviceNamespace = Console.ReadLine();
Console.Write("Your SAS key: ");
string sasKey = Console.ReadLine();
```
SAS キーは、後でプロジェクトにアクセスするために使用します。名前空間は、サービスの URI を作成するために、パラメーターとして CreateServiceUri に渡されます。
TransportClientEndpointBehavior オブジェクトを使用して、資格情報の種類として SAS キーを使用することを宣言します。 1 つ前の手順で追加したコードの直後に次のコードを追加します。
```
TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);
```

サービスのベースアドレスを作成する

前のセクションで追加したコードの後に、サービスのベースアドレスの Uri インスタンスを作成します。この URI では、Service Bus スキーム、名前空間、サービスインターフェイスのパスを指定します。

Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");

"sb" は Service Bus スキームの省略形です。プロトコルとして TCP を使用していることを示します。このスキームは、以前に NetTcpRelayBinding がバインドとして指定されたときにも、構成ファイルで示されていました。

このチュートリアルでは、URI は sb://putServiceNamespaceHere.windows.net/EchoService です。

サービスホストを作成して構成する

まだ Main() で作業します。接続モードを AutoDetect に設定します。
```
ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;
```
接続モードは、サービスがリレーサービスとの通信に使用するプロトコル、つまり HTTP または TCP を表します。既定の設定である AutoDetect を使用すると、サービスは、TCP が利用できる場合は TCP 経由で、TCP が利用できない場合は HTTP 経由で Azure Relay に接続しようとします。この結果は、サービスがクライアントの通信に指定するプロトコルとは異なります。そのプロトコルは、使用されるバインドによって決まります。たとえば、サービスでは BasicHttpRelayBinding バインドを使用できますが、このバインドは、そのエンドポイントが HTTP 経由でクライアントと通信するように指定します。同じサービスで、サービスが TCP 経由で Azure Relay と通信するように ConnectivityMode.AutoDetect を指定することもできます。
このセクションで先に作成した URI を使用して、サービスホストを作成します。
```
ServiceHost host = new ServiceHost(typeof(EchoService), address);
```
サービスホストは、サービスをインスタンス化する WCF オブジェクトです。ここで、作成するサービスの種類 (EchoService 型) とサービスを公開するアドレスをサービスホストに渡します。
Program.cs ファイルの先頭に、System.ServiceModel.Description と Microsoft.ServiceBus.Description への参照を追加します。
```
using System.ServiceModel.Description;
using Microsoft.ServiceBus.Description;
```
Main() に戻り、パブリックアクセスを有効にするようにエンドポイントを構成します。
```
IEndpointBehavior serviceRegistrySettings = new ServiceRegistrySettings(DiscoveryType.Public);
```
この手順では、プロジェクトの Atom フィードを調べることでアプリケーションがパブリックに見つけられることを、リレーサービスに通知します。 DiscoveryType を private に設定した場合、クライアントは引き続きサービスにアクセスできます。ただし、Relay 名前空間を検索するときには、サービスは表示されなくなります。代わりに、クライアントは、エンドポイントのパスを事前に認識しておく必要があります。
App.config ファイルで定義されているサービスエンドポイントにサービスの資格情報を適用します。
```
foreach (ServiceEndpoint endpoint in host.Description.Endpoints)
{
    endpoint.Behaviors.Add(serviceRegistrySettings);
    endpoint.Behaviors.Add(sasCredential);
}
```
前に説明したように、構成ファイルで複数のサービスとエンドポイントを宣言しておくことができます。宣言した場合、このコードは構成ファイルを走査し、資格情報を適用する必要があるすべてのエンドポイントを検索します。このチュートリアルでは、構成ファイルのエンドポイントは 1 つだけです。

サービスホストを開く

引き続き Main() で、次の行を追加してサービスを開きます。
```
host.Open();
```
サービスが実行中であることをユーザーに通知し、サービスをシャットダウンする方法を説明します。
```
Console.WriteLine("Service address: " + address);
Console.WriteLine("Press [Enter] to exit");
Console.ReadLine();
```
完了したら、サービスホストを閉じます。
```
host.Close();
```
Ctrl + Shift + B キーを押して、プロジェクトをビルドします。

コンソールアプリケーションでサービスをホストする例

完成したサービスコードは次のようになります。このコードには、チュートリアルの前の手順で説明したサービスコントラクトと実装が含まれています。ここでは、コンソールアプリケーションでサービスをホストします。

using System;
using System.ServiceModel;
using System.ServiceModel.Description;
using Microsoft.ServiceBus;
using Microsoft.ServiceBus.Description;

namespace Microsoft.ServiceBus.Samples
{
    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        String Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { };

    [ServiceBehavior(Name = "EchoService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    class EchoService : IEchoContract
    {
        public string Echo(string text)
        {
            Console.WriteLine("Echoing: {0}", text);
            return text;
        }
    }

    class Program
    {
        static void Main(string[] args)
        {

            ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;         

            Console.Write("Your Service Namespace: ");
            string serviceNamespace = Console.ReadLine();
            Console.Write("Your SAS key: ");
            string sasKey = Console.ReadLine();

           // Create the credentials object for the endpoint.
            TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
            sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);

            // Create the service URI based on the service namespace.
            Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");

            // Create the service host reading the configuration.
            ServiceHost host = new ServiceHost(typeof(EchoService), address);

            // Create the ServiceRegistrySettings behavior for the endpoint.
            IEndpointBehavior serviceRegistrySettings = new ServiceRegistrySettings(DiscoveryType.Public);

            // Add the Relay credentials to all endpoints specified in configuration.
            foreach (ServiceEndpoint endpoint in host.Description.Endpoints)
            {
                endpoint.Behaviors.Add(serviceRegistrySettings);
                endpoint.Behaviors.Add(sasCredential);
            }

            // Open the service.
            host.Open();

            Console.WriteLine("Service address: " + address);
            Console.WriteLine("Press [Enter] to exit");
            Console.ReadLine();

            // Close the service.
            host.Close();
        }
    }
}

サービスコントラクト用の WCF クライアントを作成する

次のタスクでは、クライアントアプリケーションを作成し、後で実装するサービスコントラクトを定義します。これらの手順は、コントラクトの定義、App.config ファイルの編集、資格情報を使用したリレーサービスへの接続など、サービスの作成に使用した手順に似ています。以下の手順では、これらのタスクに使用するコード例を示します。

クライアント用の現在の Visual Studio ソリューションに新しいプロジェクトを作成します。
1. ソリューションエクスプローラーで (プロジェクトではなく) 現在のソリューションを右クリックし、[追加]>[新しいプロジェクト] の順に選択します。
2. [新しいプロジェクトの追加] で、C# の [コンソールアプリ (.NET Framework)] を選択し、[次へ] を選択します。
3. プロジェクトに「EchoClient」という名前を付けて、[作成] を選択します。
ソリューションエクスプローラーで [EchoClient] プロジェクトの Program.cs ファイルをダブルクリックしてエディターで開きます (まだ開いていない場合)。
名前空間の名前を、既定の名前である EchoClient から Microsoft.ServiceBus.Samples に変更します。
Service Bus NuGet パッケージをインストールします。
1. ソリューションエクスプローラーで [EchoClient] を右クリックし、[NuGet パッケージの管理] を選択します。
2. [参照] を選択し、WindowsAzure.ServiceBus を探して選択します。 [インストール] を選択して、使用条件に同意します。
Program.cs ファイルに、System.ServiceModel 名前空間の using ステートメントを追加します。
```
using System.ServiceModel;
```
次の例に示すように、サービスコントラクトの定義を名前空間に追加します。この定義は Service プロジェクトで使用される定義と同じです。 Microsoft.ServiceBus.Samples 名前空間の先頭に次のコードを追加します。
```
[ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
public interface IEchoContract
{
    [OperationContract]
    string Echo(string text);
}

public interface IEchoChannel : IEchoContract, IClientChannel { }
```
Ctrl + Shift + B キーを押して、クライアントをビルドします。

EchoClient プロジェクトの例

次のコードは、EchoClient プロジェクトの Program.cs ファイルの現在の状態を示します。

using System;
using Microsoft.ServiceBus;
using System.ServiceModel;

namespace Microsoft.ServiceBus.Samples
{

    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        string Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { }


    class Program
    {
        static void Main(string[] args)
        {
        }
    }
}

WCF クライアントを構成する

この手順では、このチュートリアルで前に作成したサービスにアクセスする基本的なクライアントアプリケーションの App.config ファイルを作成します。この App.config ファイルでは、エンドポイントのコントラクト、バインド、および名前を定義します。以下の手順では、これらのタスクに使用するコード例を示します。

ソリューションエクスプローラーで、[EchoClient] プロジェクトの App.config をダブルクリックし、Visual Studio エディターでファイルを開きます。
<appSettings> 要素内のプレースホルダーを、実際のサービスの名前空間名と先ほどコピーした SAS キーに置き換えます。
system.serviceModel 要素内に、<client> 要素を追加します。
```
<?xmlversion="1.0" encoding="utf-8"?>
<configuration>
  <system.serviceModel>
    <client>
    </client>
  </system.serviceModel>
</configuration>
```
このコードにより、WCF スタイルのクライアントアプリケーションを定義していることを宣言します。
client 要素内で、エンドポイントの名前、コントラクト、バインドの種類を定義します。
```
<endpoint name="RelayEndpoint"
                contract="Microsoft.ServiceBus.Samples.IEchoContract"
                binding="netTcpRelayBinding"/>
```
このコードでは、エンドポイントの名前を定義します。また、サービスで定義されたコントラクトと、クライアントアプリケーションが Azure Relay との通信に TCP を使用するという事実を定義します。エンドポイント名は、次の手順でこのエンドポイント構成をサービス URI とリンクするために使用されます。
[ファイル]>[すべて保存] を選択します。

App.config ファイルの例

次のコードは、Echo クライアントの App.config ファイルを示します。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <client>
      <endpoint name="RelayEndpoint"
                      contract="Microsoft.ServiceBus.Samples.IEchoContract"
                      binding="netTcpRelayBinding"/>
    </client>
    <extensions>
      <bindingExtensions>
        <add name="netTcpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.NetTcpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      </bindingExtensions>
    </extensions>
  </system.serviceModel>
</configuration>

WCF クライアントを実装する

このセクションでは、このチュートリアルで前に作成したサービスにアクセスする基本的なクライアントアプリケーションを実装します。サービスと同様に、クライアントでも、Azure Relay へアクセスするために多くの同じ操作が実行されます。

接続モードを設定します。
ホストサービスの場所を示す URI を作成します。
セキュリティ資格情報を定義します。
資格情報を接続に適用します。
接続を開きます。
アプリケーション固有のタスクを実行します。
接続を閉じます。

しかし、主な違いの 1 つとして、クライアントアプリケーションではリレーサービスへの接続にチャネルが使用されます。サービスでは ServiceHost の呼び出しが使用されます。以下の手順では、これらのタスクに使用するコード例を示します。

クライアントアプリケーションを実装する

接続モードを AutoDetect に設定します。 EchoClient アプリケーションの Main() メソッドの中に次のコードを追加します。
```
ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;
```

コンソールから読み取られるサービス名前空間と SAS キーの値を保持する変数を定義します。

Console.Write("Your Service Namespace: ");
string serviceNamespace = Console.ReadLine();
Console.Write("Your SAS Key: ");
string sasKey = Console.ReadLine();

Relay プロジェクトでのホストの場所を定義する URI を作成します。

Uri serviceUri = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");

サービス名前空間のエンドポイントの資格情報オブジェクトを作成します。

TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);

App.config ファイルに記述されている構成を読み込むチャネルファクトリを作成します。
```
ChannelFactory<IEchoChannel> channelFactory = new ChannelFactory<IEchoChannel>("RelayEndpoint", new EndpointAddress(serviceUri));
```
チャネルファクトリは、サービスおよびクライアントアプリケーションが通信に使用するチャネルを作成する WCF オブジェクトです。

資格情報を適用します。

channelFactory.Endpoint.Behaviors.Add(sasCredential);

サービスに対するチャネルを作成して開きます。

IEchoChannel channel = channelFactory.CreateChannel();
channel.Open();

エコーの基本的なユーザーインターフェイスと機能を記述します。

Console.WriteLine("Enter text to echo (or [Enter] to exit):");
string input = Console.ReadLine();
while (input != String.Empty)
{
    try
    {
        Console.WriteLine("Server echoed: {0}", channel.Echo(input));
    }
    catch (Exception e)
    {
        Console.WriteLine("Error: " + e.Message);
    }
    input = Console.ReadLine();
}

このコードでは、サービスのプロキシとしてチャネルオブジェクトのインスタンスを使用します。

チャネルを閉じ、ファクトリを終了します。
```
channel.Close();
channelFactory.Close();
```

このチュートリアルのコード例

完成したコードは次のようになります。このコードは、クライアントアプリケーションを作成する方法、サービスの操作を呼び出す方法、操作の呼び出しが完了した後でクライアントを終了する方法を示します。

using System;
using Microsoft.ServiceBus;
using System.ServiceModel;

namespace Microsoft.ServiceBus.Samples
{
    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        String Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { }

    class Program
    {
        static void Main(string[] args)
        {
            ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;


            Console.Write("Your Service Namespace: ");
            string serviceNamespace = Console.ReadLine();
            Console.Write("Your SAS Key: ");
            string sasKey = Console.ReadLine();



            Uri serviceUri = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");

            TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
            sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);

            ChannelFactory<IEchoChannel> channelFactory = new ChannelFactory<IEchoChannel>("RelayEndpoint", new EndpointAddress(serviceUri));

            channelFactory.Endpoint.Behaviors.Add(sasCredential);

            IEchoChannel channel = channelFactory.CreateChannel();
            channel.Open();

            Console.WriteLine("Enter text to echo (or [Enter] to exit):");
            string input = Console.ReadLine();
            while (input != String.Empty)
            {
                try
                {
                    Console.WriteLine("Server echoed: {0}", channel.Echo(input));
                }
                catch (Exception e)
                {
                    Console.WriteLine("Error: " + e.Message);
                }
                input = Console.ReadLine();
            }

            channel.Close();
            channelFactory.Close();

        }
    }
}

アプリケーションの実行

Ctrl + Shift + B キーを押して、ソリューションをビルドします。このアクションにより、前の手順で作成したサービスプロジェクトとクライアントプロジェクトの両方がビルドされます。
クライアントアプリケーションを実行する前に、サービスアプリケーションが実行されていることを確認してください。 ソリューションエクスプローラーで、[EchoService] ソリューションを右クリックし、[プロパティ] を選択します。
[プロパティページ] で、[共通プロパティ]>[スタートアッププロジェクト] の順に選択し、[マルチスタートアッププロジェクト] を選択します。 EchoService がリストの先頭に表示されていることを確認してください。
EchoService プロジェクトと EchoClient プロジェクトの両方の [アクション] ボックスを [開始] に設定します。
[プロジェクトの依存関係] を選択します。 [プロジェクト] で、[EchoClient] を選択します。 [依存先] で、[EchoService] が選択されていることを確認します。
[OK] を選択して [プロパティページ] を閉じます。
F5 キーを押して両方のプロジェクトを実行します。
両方のコンソールウィンドウが開き、名前空間名の入力が求められます。先にサービスを実行しておく必要があるので、[EchoService] コンソールウィンドウで名前空間を入力し、Enter キーを押します。
次に、コンソールで、SAS キーの入力を求められます。 SAS キーを入力し、Enter キーを押します。

コンソールウィンドウの出力例を次に示します。表示されている値は、単なる例です。

Your Service Namespace: myNamespace

Your SAS Key: <SAS key value>

次の例に示すように、サービスアプリケーションによってリッスンされているアドレスがコンソールウィンドウに出力されます。

Service address: sb://mynamespace.servicebus.windows.net/EchoService/

Press [Enter] to exit
[EchoClient] コンソールウィンドウに、先ほどサービスアプリケーションについて入力したものと同じ情報を入力します。クライアントアプリケーションに対して、同じサービス名前空間と SAS キーの値を入力します。
これらの値を入力すると、クライアントはサービスに対するチャネルを開き、次のコンソール出力例に示すように、なんらかのテキストを入力するよう求めます。

Enter text to echo (or [Enter] to exit):

サービスアプリケーションに送信するテキストを入力し、Enter キーを押します。このテキストは、Echo サービス操作を介してサービスに送信され、次の出力例のように、サービスコンソールウィンドウに表示されます。

Echoing: My sample text

クライアントアプリケーションは、Echo 操作の戻り値を受け取ります。これは元のテキストで、コンソールウィンドウに出力されます。クライアントコンソールウィンドウの出力例のテキストを次に示します。

Server echoed: My sample text
この方法で、クライアントからサービスにテキストメッセージの送信を続けることができます。終了したら、クライアントコンソールウィンドウとサービスコンソールウィンドウで Enter キーを押して両方のアプリケーションを終了します。

次のステップ

次のチュートリアルに進みます。

オンプレミスの WCF REST サービスをネットワーク外部のクライアントに公開する

次の方法で共有

チュートリアル: Azure WCF Relay を使用してオンプレミスの WCF REST サービスを外部クライアントに公開する

前提条件

Relay 名前空間を作成する

管理資格情報を取得する

WCF サービスコントラクトを定義する

インターフェイスを使用してリレーコントラクトを作成する

WCF コントラクトの例

WCF コントラクトを実装する

サービスホストの構成を定義する

サービスコントラクトの実装例

リレーサービスに登録する WCF サービスをホストして実行する

リレー資格情報を作成する

サービスのベースアドレスを作成する

サービスホストを作成して構成する

サービスホストを開く

コンソールアプリケーションでサービスをホストする例

サービスコントラクト用の WCF クライアントを作成する

EchoClient プロジェクトの例

WCF クライアントを構成する

App.config ファイルの例

WCF クライアントを実装する

クライアントアプリケーションを実装する

このチュートリアルのコード例

アプリケーションの実行

次のステップ

フィードバック

その他のリソース

次の方法で共有

チュートリアル: Azure WCF Relay を使用してオンプレミスの WCF REST サービスを外部クライアントに公開する

前提条件

Relay 名前空間を作成する

管理資格情報を取得する

WCF サービス コントラクトを定義する

インターフェイスを使用してリレー コントラクトを作成する

WCF コントラクトの例

WCF コントラクトを実装する

サービス ホストの構成を定義する

サービス コントラクトの実装例

リレー サービスに登録する WCF サービスをホストして実行する

リレー資格情報を作成する

サービスのベース アドレスを作成する

サービス ホストを作成して構成する

サービス ホストを開く

コンソール アプリケーションでサービスをホストする例

サービス コントラクト用の WCF クライアントを作成する

EchoClient プロジェクトの例

WCF クライアントを構成する

App.config ファイルの例

WCF クライアントを実装する

クライアント アプリケーションを実装する

このチュートリアルのコード例

アプリケーションの実行

次のステップ

フィードバック

その他のリソース

WCF サービスコントラクトを定義する

インターフェイスを使用してリレーコントラクトを作成する

サービスホストの構成を定義する

サービスコントラクトの実装例

リレーサービスに登録する WCF サービスをホストして実行する

サービスのベースアドレスを作成する

サービスホストを作成して構成する

サービスホストを開く

コンソールアプリケーションでサービスをホストする例

サービスコントラクト用の WCF クライアントを作成する

クライアントアプリケーションを実装する