Node.js での Relay ハイブリッド接続 HTTP 要求の概要

[アーティクル]
04/16/2024

NET
Node.js

このクイックスタートでは、HTTP プロトコルを使用してメッセージを送受信する Node.js のセンダーアプリケーションとレシーバーアプリケーションを作成します。これらのアプリケーションには、Azure Relay のハイブリッド接続機能が使用されます。 Azure Relay 全般については、Azure Relay に関するページを参照してください。

このクイックスタートでは、以下の手順を実行します。

Azure Portal を使用した Relay 名前空間の作成
Azure Portal を使用した、その名前空間内のハイブリッド接続の作成
メッセージを受信するサーバー (リスナー) コンソールアプリケーションの作成
メッセージを送信するクライアント (送信側) コンソールアプリケーションの作成
アプリケーションの実行

前提条件

Node.js。
Azure サブスクリプション。お持ちでない場合は、開始する前に無料アカウントを作成してください。

Azure Portal を使用した名前空間の作成

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

管理資格情報を取得する

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

Azure Portal を使用したハイブリッド接続の作成

名前空間の [リレー] ページで、次の手順に従ってハイブリッド接続を作成します。

左側のメニューの [エンティティ] の下で、[ハイブリッド接続] を選択し、[+ ハイブリッド接続] を選択します。
[ハイブリッド接続の作成] ページで、ハイブリッド接続の名前を入力し、[作成] を選択します。

サーバーアプリケーション (リスナー) の作成

Relay からのメッセージをリッスンおよび受信するために、Node.js コンソールアプリケーションを作成します。

Node.js アプリケーションを作成する

listener.js という新しい JavaScript ファイルを作成します。

Relay パッケージを追加する

プロジェクトフォルダーの Node のコマンドプロンプトから npm install hyco-https を実行します。

要求を処理するためのコードを記述する

listener.js ファイルの先頭に次の定数を追加します。
```
const https = require('hyco-https');
```
ハイブリッド接続の詳細に関する次の定数を listener.js ファイルに追加します。中かっこ内のプレースホルダーを、ハイブリッド接続の作成時に取得した値に置き換えます。
- const ns - Relay 名前空間。必ず完全修飾名前空間名を使用してください (たとえば、{namespace}.servicebus.windows.net)。
- const path - ハイブリッド接続の名前。
- const keyrule - 共有アクセスポリシーキーの名前 (既定では RootManageSharedAccessKey)。
- const key - 前に保存した名前空間の主キー。

次のコードを listener.js ファイルに追加します。 :

ご覧のとおり、コードは通常の createServer 関数に代わって createRelayedServer を使用しているという点を除き、Node.js の初心者向けチュートリアルで示したシンプルな HTTP サーバーの例と大きく変わりません。

var uri = https.createRelayListenUri(ns, path);
var server = https.createRelayedServer(
    {
        server : uri,
        token : () => https.createRelayToken(uri, keyrule, key)
    },
    (req, res) => {
        console.log('request accepted: ' + req.method + ' on ' + req.url);
        res.setHeader('Content-Type', 'text/html');
        res.end('<html><head><title>Hey!</title></head><body>Relayed Node.js Server!</body></html>');
    });

server.listen( (err) => {
        if (err) {
          return console.log('something bad happened', err)
        }
        console.log(`server is listening on ${port}`)
      });

server.on('error', (err) => {
    console.log('error: ' + err);
});

listener.js ファイルは次のようになります。

const https = require('hyco-https');

const ns = "{RelayNamespace}";
const path = "{HybridConnectionName}";
const keyrule = "{SASKeyName}";
const key = "{SASKeyValue}";

var uri = https.createRelayListenUri(ns, path);
var server = https.createRelayedServer(
    {
        server : uri,
        token : () => https.createRelayToken(uri, keyrule, key)
    },
    (req, res) => {
        console.log('request accepted: ' + req.method + ' on ' + req.url);
        res.setHeader('Content-Type', 'text/html');
        res.end('<html><head><title>Hey!</title></head><body>Relayed Node.js Server!</body></html>');
    });

server.listen( (err) => {
        if (err) {
          return console.log('something bad happened', err)
        }
        console.log(`server is listening on ${port}`)
      });

server.on('error', (err) => {
    console.log('error: ' + err);
});

クライアントアプリケーション (センダー) の作成

Relay にメッセージを送信するために、任意の HTTP クライアントを使用するか、Node.js コンソールアプリケーションを作成します。

Node.js アプリケーションを作成する

リレーの作成時に [クライアント認証が必要] オプションを無効にしていた場合には、ブラウザーを問わずハイブリッド接続 URL に要求を送信できます。保護されているエンドポイントにアクセスするには、ここに示したように ServiceBusAuthorization ヘッダーでトークンを作成して渡す必要があります。

最初に、sender.js という新しい JavaScript ファイルを作成します。

Relay Node パッケージマネージャーのパッケージを追加する

プロジェクトフォルダーの Node のコマンドプロンプトから npm install hyco-https を実行します。このパッケージでは、通常の https パッケージもインポートされます。クライアントにとって重要な違いは、このパッケージにはリレーの URI とトークンを構築するための関数が用意されているという点です。

メッセージを送信するコードを記述する

sender.js ファイルの先頭に次の constants を追加します。
```
const https = require('hyco-https');
```
ハイブリッド接続の詳細に関する次の定数を sender.js ファイルに追加します。中かっこ内のプレースホルダーを、ハイブリッド接続の作成時に取得した値に置き換えます。
- const ns - Relay 名前空間。必ず完全修飾名前空間名を使用してください (たとえば、{namespace}.servicebus.windows.net)。
- const path - ハイブリッド接続の名前。
- const keyrule - 共有アクセスポリシーキーの名前 (既定では RootManageSharedAccessKey)。
- const key - 前に保存した名前空間の主キー。

次のコードを sender.js ファイルに追加します。ご覧のとおり、コードは Authorization ヘッダーが追加されているだけで、通常どおり Node.js HTTPS クライアントを使用した場合と大きく変わりません。

https.get({
     hostname : ns,
     path : (!path || path.length == 0 || path[0] !== '/'?'/':'') + path,
     port : 443,
     headers : {
         'ServiceBusAuthorization' : 
             https.createRelayToken(https.createRelayHttpsUri(ns, path), keyrule, key)
     }
}, (res) => {
     let error;
     if (res.statusCode !== 200) {
         console.error('Request Failed.\n Status Code: ${statusCode}');
         res.resume();
     } 
     else {
         res.setEncoding('utf8');
         res.on('data', (chunk) => {
             console.log(`BODY: ${chunk}`);
         });
         res.on('end', () => {
             console.log('No more data in response.');
         });
     };
}).on('error', (e) => {
     console.error(`Got error: ${e.message}`);
});

sender.js ファイルは次のようになります。

const https = require('hyco-https');

const ns = "{RelayNamespace}";
const path = "{HybridConnectionName}";
const keyrule = "{SASKeyName}";
const key = "{SASKeyValue}";

https.get({
    hostname : ns,
    path : (!path || path.length == 0 || path[0] !== '/'?'/':'') + path,
    port : 443,
    headers : {
        'ServiceBusAuthorization' : 
            https.createRelayToken(https.createRelayHttpsUri(ns, path), keyrule, key)
    }
}, (res) => {
    let error;
    if (res.statusCode !== 200) {
        console.error('Request Failed.\n Status Code: ${statusCode}');
        res.resume();
    } 
    else {
        res.setEncoding('utf8');
        res.on('data', (chunk) => {
            console.log(`BODY: ${chunk}`);
        });
        res.on('end', () => {
            console.log('No more data in response.');
        });
    };
}).on('error', (e) => {
    console.error(`Got error: ${e.message}`);
});

アプリケーションの実行

Node.js コマンドプロンプトで「node listener.js」と入力して、サーバーアプリケーションを実行します。
Node.js コマンドプロンプトで「node sender.js」と入力してサーバーアプリケーションを実行し、何かテキストを入力します。
サーバーアプリケーションコンソールに、クライアントアプリケーションで入力したテキストが出力されることを確認します。

これで、Node.js を使用してエンドツーエンドのハイブリッド接続アプリケーションを作成できました。

次のステップ

このクイックスタートでは、HTTP を使用してメッセージを送受信する Node.js のクライアントアプリケーションとサーバーアプリケーションを作成しました。 Azure Relay のハイブリッド接続機能は、WebSocket を使用したメッセージの送受信もサポートしています。 Azure Relay のハイブリッド接続で WebSocket を使用する方法については、WebSocket のクイックスタートを参照してください。

このクイックスタートでは、Node.js を使用してクライアントアプリケーションとサーバーアプリケーションを作成しました。 .NET Framework を使用してクライアントアプリケーションとサーバーアプリケーションを作成する方法については、.NET WebSocket のクイックスタートまたは .NET HTTP のクイックスタートを参照してください。

次の方法で共有

Node.js での Relay ハイブリッド接続 HTTP 要求の概要

前提条件

Azure Portal を使用した名前空間の作成

管理資格情報を取得する

Azure Portal を使用したハイブリッド接続の作成

サーバーアプリケーション (リスナー) の作成

Node.js アプリケーションを作成する

Relay パッケージを追加する

要求を処理するためのコードを記述する

クライアントアプリケーション (センダー) の作成

Node.js アプリケーションを作成する

Relay Node パッケージマネージャーのパッケージを追加する

メッセージを送信するコードを記述する

アプリケーションの実行

次のステップ

フィードバック

フィードバック

その他のリソース

次の方法で共有

Node.js での Relay ハイブリッド接続 HTTP 要求の概要

前提条件

Azure Portal を使用した名前空間の作成

管理資格情報を取得する

Azure Portal を使用したハイブリッド接続の作成

サーバー アプリケーション (リスナー) の作成

Node.js アプリケーションを作成する

Relay パッケージを追加する

要求を処理するためのコードを記述する

クライアント アプリケーション (センダー) の作成

Node.js アプリケーションを作成する

Relay Node パッケージ マネージャーのパッケージを追加する

メッセージを送信するコードを記述する

アプリケーションの実行

次のステップ

フィードバック

フィードバック

その他のリソース

サーバーアプリケーション (リスナー) の作成

クライアントアプリケーション (センダー) の作成

Relay Node パッケージマネージャーのパッケージを追加する