Bagikan melalui

Mulai dengan Relay Hybrid Connections WebSockets di Node.js

  • Artikel

Dalam mulai cepat ini, Anda membuat aplikasi pengirim dan penerima Node.js yang mengirim dan menerima pesan menggunakan Hybrid Connections WebSockets di Azure Relay. Untuk mempelajari tentang Azure Relay secara umum, lihat Azure Relay.

Dalam mulai cepat ini, Anda melakukan langkah-langkah berikut:

  1. Buat namespace Relay dengan menggunakan portal Azure.
  2. Buat koneksi hibrida di namespace tersebut dengan menggunakan portal Azure.
  3. Tulis aplikasi konsol server (listener) untuk menerima pesan.
  4. Tulis aplikasi konsol klien (pengirim) untuk mengirim pesan.
  5. Jalankan aplikasi.

Prasyarat

  • Node.js.
  • Langganan Azure. Jika Anda tidak memilikinya, buat akun gratis sebelum memulai.

Membuat namespace

  1. Masuk ke portal Azure.

  2. Pilih Semua layanan di menu sebelah kiri. Pilih Integrasi, cari Relay, gerakkan mouse di atas Relay, lalu pilih Buat.

    Cuplikan layar memperlihatkan pilihan tombol Relay -> Buat.

  3. Pada halaman Buat namespace layanan, ikuti langkah-langkah berikut:

    1. Pilih langganan Azure untuk membuat namespace.

    2. Untuk Grup sumber daya, pilih grup sumber daya yang ada tempat namespace akan aktif, atau buat grup baru.

    3. Masukkan nama untuk namespace Relay.

    4. Pilih wilayah tempat namespace layanan Anda harus dihosting.

    5. Pilih Tinjau + buat di bagian bawah halaman.

      Cuplikan layar memperlihatkan halaman Buat namespace layanan.

    6. Pada halaman Tinjau + buat, pilih Buat.

    7. Setelah beberapa menit, Anda akan melihat halaman Relay untuk namespace.

      Cuplikan layar memperlihatkan halaman beranda untuk namespace Relay.

Mendapatkan info masuk manajemen

  1. Pada halaman Relay , pilih Kebijakan akses bersama di menu sebelah kiri. `

  2. Pada halaman Kebijakan akses bersama, pilih RootManageSharedAccessKey.

  3. Di bawah Kebijakan SAS: RootManageSharedAccessKey, pilih tombol Salin di sebelah String Koneksi Primer. Tindakan ini menyalin string koneksi ke clipboard untuk digunakan nanti. Tempelkan nilai ini ke Notepad atau beberapa lokasi sementara lainnya.

  4. Ulangi langkah sebelumnya untuk menyalin dan menempelkan nilai Kunci primer ke lokasi sementara untuk digunakan nanti.

    Cuplikan layar memperlihatkan info koneksi untuk namespace Relay.

Buat koneksi hibrid

Pada halaman Relay untuk namespace Anda, ikuti langkah-langkah ini untuk membuat koneksi hibrid.

  1. Di menu sebelah kiri, Di bawah Entitas, pilih Koneksi Hibrid, lalu pilih + Koneksi Hibrid.

    Cuplikan layar memperlihatkan halaman Koneksi Hibrid.

  2. Pada halaman Buat Koneksi Hibrid, masukkan nama untuk koneksi hibrid, dan pilih Buat.

    Cuplikan layar memperlihatkan halaman Buat Koneksi Hibrid.

Membuat aplikasi server (pendengar)

Untuk mendengarkan dan menerima pesan dari Relay, tulis aplikasi konsol Node.js.

Membuat aplikasi Node.js baru

Buat file JavaScript baru yang disebut listener.js.

Menambahkan paket Relay

Jalankan npm install hyco-ws dari perintah Simpul di folder proyek Anda.

Menulis beberapa kode untuk menerima pesan

  1. Tambahkan konstanta berikut ke bagian atas file listener.js.

    const WebSocket = require('hyco-ws');

  2. Tambahkan konstanta berikut ke file listener.js untuk detail koneksi hibrid. Ganti tempat penampung dalam tanda kurung siku dengan nilai yang Anda peroleh saat membuat koneksi hibrid.

    • const ns - Namespace layanan Relay. Pastikan untuk menggunakan nama namespace layanan yang sepenuhnya memenuhi syarat; misalnya, {namespace}.servicebus.windows.net.
    • const path - Nama koneksi hibrid.
    • const keyrule - Nama kunci Kebijakan Akses Bersama Anda, yang secara RootManageSharedAccessKey default.
    • const key - Kunci utama namespace layanan yang Anda simpan sebelumnya.

  3. Tambahkan kode berikut ke file listener.js:

    var wss = WebSocket.createRelayedServer(
{
    server : WebSocket.createRelayListenUri(ns, path),
    token: WebSocket.createRelayToken('http://' + ns, keyrule, key)
}, 
function (ws) {
    console.log('connection accepted');
    ws.onmessage = function (event) {
        console.log(event.data);
    };
    ws.on('close', function () {
        console.log('connection closed');
    });       
});

console.log('listening');

wss.on('error', function(err) {
    console.log('error' + err);
});

    Berikut tampilan file listener.js Anda:

    const WebSocket = require('hyco-ws');

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

var wss = WebSocket.createRelayedServer(
    {
        server : WebSocket.createRelayListenUri(ns, path),
        token: WebSocket.createRelayToken('http://' + ns, keyrule, key)
    }, 
    function (ws) {
        console.log('connection accepted');
        ws.onmessage = function (event) {
            console.log(event.data);
        };
        ws.on('close', function () {
            console.log('connection closed');
        });       
});

console.log('listening');

wss.on('error', function(err) {
    console.log('error' + err);
});

Membuat aplikasi klien (pengirim)

Untuk mengirim pesan ke Relay, tulis aplikasi konsol Node.js.

Membuat aplikasi Node.js baru

Buat file JavaScript baru yang disebut sender.js.

Menambahkan paket Pengelola Paket Simpul Relay

Jalankan npm install hyco-ws dari perintah Simpul di folder proyek Anda.

Menulis kode untuk mengirim pesan

  1. Tambahkan constants berikut ini ke bagian atas file sender.js.

    const WebSocket = require('hyco-ws');
const readline = require('readline')
    .createInterface({
        input: process.stdin,
        output: process.stdout
    });;

  2. Tambahkan konstanta berikut ke file sender.js untuk detail koneksi hibrid. Ganti tempat penampung dalam tanda kurung siku dengan nilai yang Anda peroleh saat membuat koneksi hibrid.

    • const ns - Namespace layanan Relay. Pastikan untuk menggunakan nama namespace layanan yang sepenuhnya memenuhi syarat; misalnya, {namespace}.servicebus.windows.net.
    • const path - Nama koneksi hibrid.
    • const keyrule - Nama kunci Kebijakan Akses Bersama Anda, yang secara RootManageSharedAccessKey default.
    • const key - Kunci utama namespace layanan yang Anda simpan sebelumnya.

  3. Tambahkan kode berikut ke file sender.js:

    WebSocket.relayedConnect(
    WebSocket.createRelaySendUri(ns, path),
    WebSocket.createRelayToken('http://'+ns, keyrule, key),
    function (wss) {
        readline.on('line', (input) => {
            wss.send(input, null);
        });

        console.log('Started client interval.');
        wss.on('close', function () {
            console.log('stopping client interval');
            process.exit();
        });
    }
);

    Berikut tampilan file sender.js Anda:

    const WebSocket = require('hyco-ws');
const readline = require('readline')
    .createInterface({
        input: process.stdin,
        output: process.stdout
    });;

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

WebSocket.relayedConnect(
    WebSocket.createRelaySendUri(ns, path),
    WebSocket.createRelayToken('http://'+ns, keyrule, key),
    function (wss) {
        readline.on('line', (input) => {
            wss.send(input, null);
        });

        console.log('Started client interval.');
        wss.on('close', function () {
            console.log('stopping client interval');
            process.exit();
        });
    }
);

Catatan

Kode sampel dalam artikel ini menggunakan string koneksi untuk mengautentikasi ke namespace Azure Relay agar tutorial tetap sederhana. Kami menyarankan agar Anda menggunakan autentikasi ID Microsoft Entra di lingkungan produksi, daripada menggunakan string koneksi atau tanda tangan akses bersama, yang dapat lebih mudah disusupi. Untuk informasi terperinci dan kode sampel untuk menggunakan autentikasi ID Microsoft Entra, lihat Mengautentikasi dan mengotorisasi aplikasi dengan ID Microsoft Entra untuk mengakses entitas Azure Relay dan Mengautentikasi identitas terkelola dengan ID Microsoft Entra untuk mengakses sumber daya Azure Relay.

Menjalankan aplikasi

  1. Jalankan aplikasi server: dari jenis perintah Node.js node listener.js.

  2. Jalankan aplikasi klien: dari jenis perintah Node.js node sender.js dan masukkan beberapa teks.

  3. Pastikan bahwa aplikasi konsol server mengeluarkan teks yang dimasukkan dalam aplikasi klien.

    Jendela konsol menguji aplikasi server dan klien.

Selamat, Anda telah membuat aplikasi Hybrid Connections end-to-end menggunakan Node.js!

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat aplikasi klien dan server Node.js yang menggunakan HTTP untuk mengirimkan dan menerima pesan. Fitur Koneksi Hibrida Azure Relay juga mendukung penggunaan WebSocket untuk mengirim dan menerima pesan. Untuk mempelajari cara menggunakan HTTP dengan Azure Relay Hybrid Connections, lihat mulai cepat HTTP Node.js.

Dalam mulai cepat ini, Anda menggunakan Node.js untuk membuat aplikasi klien dan server. Untuk mempelajari cara menulis aplikasi klien dan server menggunakan .NET Framework, lihat panduan mulai cepat .NET WebSockets atau panduan mulai cepat .NET HTTP.