Kurz: Začínáme s požadavky HTTP relay Hybrid Connections v .NET

• NET
• Node.js

V tomto rychlém startu vytvoříte aplikace odesílatele a příjemce .NET, které odesílají a přijímají zprávy pomocí protokolu HTTP. Aplikace používají funkci Hybridní připojení služby Azure Relay. Obecné informace o Azure Relay najdete v tématu Azure Relay.

V tomto rychlém startu provedete následující kroky:

1. Pomocí webu Azure Portal vytvoříte obor názvů služby Relay.
2. Pomocí webu Azure Portal vytvoříte v tomto oboru názvů hybridní připojení.
3. Napíšeme konzolovou aplikaci serveru (naslouchacího procesu) pro příjem zpráv.
4. Napíšeme konzolovou aplikaci klienta (odesílatele) pro odesílání zpráv.
5. Spusťte aplikace.

Požadavky

Pro absolvování tohoto kurzu musí být splněné následující požadavky:

• Visual Studio 2019 nebo novější Příklady v tomto kurzu používají Visual Studio 2022.
• Předplatné Azure. Pokud ho nemáte, vytvořte si bezplatný účet před tím, než začnete.

Vytvoření oboru názvů

1. Přihlaste se k portálu Azure.

2. V nabídce vlevo vyberte Všechny služby . Vyberte Možnost Integrace, vyhledejte Relays, přesuňte myš na Relays a pak vyberte Vytvořit.

   

3. Na stránce Vytvořit obor názvů postupujte takto:

   1. Zvolte předplatné Azure, ve kterém chcete vytvořit obor názvů.

   2. Pro skupinu prostředků zvolte existující skupinu prostředků, do které chcete obor názvů umístit, nebo vytvořte novou.

   3. Zadejte název oboru názvů služby Relay.

   4. Vyberte oblast, ve které má být váš obor názvů hostovaný.

   5. Vyberte Zkontrolovat a vytvořit v dolní části stránky.

      

   6. Na stránce Zkontrolovat a vytvořit vyberte Vytvořit.

   7. Po několika minutách se zobrazí stránka Relay pro obor názvů.

      

Získání přihlašovacích údajů pro správu

1. Na stránce Relay vyberte v nabídce vlevo zásady sdíleného přístupu.

2. Na stránce Zásady sdíleného přístupu vyberte RootManageSharedAccessKey.

3. V části Zásady SAS: RootManageSharedAccessKey vyberte tlačítko Kopírovat vedle primárního připojovacího řetězce. Tato akce zkopíruje připojovací řetězec do schránky pro pozdější použití. Vložte tuto hodnotu do Poznámkového bloku nebo jiného dočasného umístění.

4. Zopakujte předchozí krok, zkopírujte si hodnotu primárního klíče a vložte ji do dočasného umístění pro pozdější použití.

   

Přidání hybridního připojení

Na stránce Relay pro váš obor názvů vytvořte hybridní připojení pomocí následujícího postupu.

1. V nabídce vlevo v části Entity vyberte Hybridní připojení a pak vyberte + Hybridní připojení.

   

2. Na stránce Vytvořit hybridní připojení zadejte název hybridního připojení a vyberte Vytvořit.

   

Vytvoření serverové aplikace (naslouchací proces)

Napište v sadě Visual Studio konzolovou aplikaci v jazyce C#, která bude naslouchat a přijímat zprávy z předávací služby.

Vytvoření konzolové aplikace

V sadě Visual Studio vytvořte nový projekt Konzolová aplikace (.NET Framework).

Přidání balíčku NuGet služby Relay

1. Klikněte pravým tlačítkem na nově vytvořený projekt a vyberte možnost Spravovat balíčky NuGet.
2. Vyberte Procházet a vyhledejte Microsoft.Azure.Relay. Ve výsledcích hledání vyberte Microsoft Azure Relay.
3. Vyberte Nainstalovat a dokončete instalaci. Zavřete dialogové okno.

Napsání kódu pro přijímání zpráv

1. Na začátku souboru Program.cs nahraďte existující příkazy using následujícími příkazy using:

   using System;
   using System.IO;
   using System.Threading;
   using System.Threading.Tasks;
   using Microsoft.Azure.Relay;
   using System.Net;
   

2. Do třídy Program přidejte konstanty s podrobnostmi o hybridním připojení. Zástupné symboly v závorkách nahraďte hodnotami, které jste získali při vytváření hybridního připojení. Nezapomeňte použít plně kvalifikovaný obor názvů.

   // replace {RelayNamespace} with the name of your namespace
   private const string RelayNamespace = "{RelayNamespace}.servicebus.windows.net";
   
   // replace {HybridConnectionName} with the name of your hybrid connection
   private const string ConnectionName = "{HybridConnectionName}";
   
   // replace {SAKKeyName} with the name of your Shared Access Policies key, which is RootManageSharedAccessKey by default
   private const string KeyName = "{SASKeyName}";
   
   // replace {SASKey} with the primary key of the namespace you saved earlier
   private const string Key = "{SASKey}";
   

3. Do třídy Program přidejte metodu RunAsync:

   private static async Task RunAsync()
   {
       var cts = new CancellationTokenSource();
   
       var tokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider(KeyName, Key);
       var listener = new HybridConnectionListener(new Uri(string.Format("sb://{0}/{1}", RelayNamespace, ConnectionName)), tokenProvider);
   
       // Subscribe to the status events.
       listener.Connecting += (o, e) => { Console.WriteLine("Connecting"); };
       listener.Offline += (o, e) => { Console.WriteLine("Offline"); };
       listener.Online += (o, e) => { Console.WriteLine("Online"); };
   
       // Provide an HTTP request handler
       listener.RequestHandler = (context) =>
       {
           // Do something with context.Request.Url, HttpMethod, Headers, InputStream...
           context.Response.StatusCode = HttpStatusCode.OK;
           context.Response.StatusDescription = "OK, This is pretty neat";
           using (var sw = new StreamWriter(context.Response.OutputStream))
           {
               sw.WriteLine("hello!");
           }
   
           // The context MUST be closed here
           context.Response.Close();
       };
   
       // Opening the listener establishes the control channel to
       // the Azure Relay service. The control channel is continuously 
       // maintained, and is reestablished when connectivity is disrupted.
       await listener.OpenAsync();
       Console.WriteLine("Server listening");
   
       // Start a new thread that will continuously read the console.
       await Console.In.ReadLineAsync();
   
       // Close the listener after you exit the processing loop.
       await listener.CloseAsync();
   }
   

4. Do metody Main ve třídě Program přidejte následující řádek kódu:

   RunAsync().GetAwaiter().GetResult();
   

   Hotový soubor Program.cs by měl vypadat nějak takto:

   namespace Server
   {
       using System;
       using System.IO;
       using System.Threading;
       using System.Threading.Tasks;
       using Microsoft.Azure.Relay;
       using System.Net;
   
       public class Program
       {
           private const string RelayNamespace = "{RelayNamespace}.servicebus.windows.net";
           private const string ConnectionName = "{HybridConnectionName}";
           private const string KeyName = "{SASKeyName}";
           private const string Key = "{SASKey}";
   
           public static void Main(string[] args)
           {
               RunAsync().GetAwaiter().GetResult();
           }
   
           private static async Task RunAsync()
           {
               var tokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider(KeyName, Key);
               var listener = new HybridConnectionListener(new Uri(string.Format("sb://{0}/{1}", RelayNamespace, ConnectionName)), tokenProvider);
   
               // Subscribe to the status events.
               listener.Connecting += (o, e) => { Console.WriteLine("Connecting"); };
               listener.Offline += (o, e) => { Console.WriteLine("Offline"); };
               listener.Online += (o, e) => { Console.WriteLine("Online"); };
   
               // Provide an HTTP request handler
               listener.RequestHandler = (context) =>
               {
                   // Do something with context.Request.Url, HttpMethod, Headers, InputStream...
                   context.Response.StatusCode = HttpStatusCode.OK;
                   context.Response.StatusDescription = "OK";
                   using (var sw = new StreamWriter(context.Response.OutputStream))
                   {
                       sw.WriteLine("hello!");
                   }
   
                   // The context MUST be closed here
                   context.Response.Close();
               };
   
               // Opening the listener establishes the control channel to
               // the Azure Relay service. The control channel is continuously 
               // maintained, and is reestablished when connectivity is disrupted.
               await listener.OpenAsync();
               Console.WriteLine("Server listening");
   
               // Start a new thread that will continuously read the console.
               await Console.In.ReadLineAsync();
   
               // Close the listener after you exit the processing loop.
               await listener.CloseAsync();
           }
       }
   }
   

Vytvoření klientské aplikace (odesílatel)

Napište v sadě Visual Studio konzolovou aplikaci v jazyce C#, která bude odesílat zprávy do předávací služby.

Vytvoření konzolové aplikace

Pokud jste při vytváření služby Relay zakázali možnost Vyžadovat autorizaci klienta, můžete odesílat požadavky na adresu URL hybridních připojení pomocí libovolného prohlížeče. Pro přístup k chráněným koncovým bodům je nutné vytvořit a předat token v hlavičce ServiceBusAuthorization, která se tady zobrazí.

V sadě Visual Studio vytvořte nový projekt Konzolová aplikace (.NET Framework).

Přidání balíčku NuGet služby Relay

1. Klikněte pravým tlačítkem na nově vytvořený projekt a vyberte možnost Spravovat balíčky NuGet.
2. Vyberte možnost Zahrnout předběžné verze.
3. Vyberte Procházet a vyhledejte Microsoft.Azure.Relay. Ve výsledcích hledání vyberte Microsoft Azure Relay.
4. Vyberte Nainstalovat a dokončete instalaci. Zavřete dialogové okno.

Zápis kódu pro odesílání žádostí

1. Na začátku souboru Program.cs nahraďte existující příkazy using následujícími příkazy using:

   using System;
   using System.IO;
   using System.Threading;
   using System.Threading.Tasks;
   using System.Net.Http;
   using Microsoft.Azure.Relay;
   

2. Do třídy Program přidejte konstanty s podrobnostmi o hybridním připojení. Zástupné symboly v závorkách nahraďte hodnotami, které jste získali při vytváření hybridního připojení. Nezapomeňte použít plně kvalifikovaný obor názvů.

   // replace {RelayNamespace} with the name of your namespace
   private const string RelayNamespace = "{RelayNamespace}.servicebus.windows.net";
   
   // replace {HybridConnectionName} with the name of your hybrid connection
   private const string ConnectionName = "{HybridConnectionName}";
   
   // replace {SAKKeyName} with the name of your Shared Access Policies key, which is RootManageSharedAccessKey by default
   private const string KeyName = "{SASKeyName}";
   
   // replace {SASKey} with the primary key of the namespace you saved earlier
   private const string Key = "{SASKey}";
   

3. Do třídy Program přidejte následující metodu:

   private static async Task RunAsync()
   {
       var tokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider(
               KeyName, Key);
       var uri = new Uri(string.Format("https://{0}/{1}", RelayNamespace, ConnectionName));
       var token = (await tokenProvider.GetTokenAsync(uri.AbsoluteUri, TimeSpan.FromHours(1))).TokenString;
       var client = new HttpClient();
       var request = new HttpRequestMessage()
       {
           RequestUri = uri,
           Method = HttpMethod.Get,
       };
       request.Headers.Add("ServiceBusAuthorization", token);
       var response = await client.SendAsync(request);
       Console.WriteLine(await response.Content.ReadAsStringAsync());        Console.ReadLine();
   }
   

4. Ve třídě Program přidejte do metody Main následující řádek kódu.

   RunAsync().GetAwaiter().GetResult();
   

   Soubor Program.cs by měl vypadat nějak takto:

   using System;
   using System.IO;
   using System.Threading;
   using System.Threading.Tasks;
   using System.Net.Http;
   using Microsoft.Azure.Relay;
   
   namespace Client
   {
       class Program
       {
           private const string RelayNamespace = "{RelayNamespace}.servicebus.windows.net";
           private const string ConnectionName = "{HybridConnectionName}";
           private const string KeyName = "{SASKeyName}";
           private const string Key = "{SASKey}";
   
           static void Main(string[] args)
           {
               RunAsync().GetAwaiter().GetResult();
           }
   
           private static async Task RunAsync()
           {
              var tokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider(
               KeyName, Key);
               var uri = new Uri(string.Format("https://{0}/{1}", RelayNamespace, ConnectionName));
               var token = (await tokenProvider.GetTokenAsync(uri.AbsoluteUri, TimeSpan.FromHours(1))).TokenString;
               var client = new HttpClient();
               var request = new HttpRequestMessage()
               {
                   RequestUri = uri,
                   Method = HttpMethod.Get,
               };
               request.Headers.Add("ServiceBusAuthorization", token);
               var response = await client.SendAsync(request);
               Console.WriteLine(await response.Content.ReadAsStringAsync());
           }
       }
   }
   

Poznámka:

Ukázkový kód v tomto článku používá připojovací řetězec k ověření v oboru názvů Služby Azure Relay, aby byl kurz jednoduchý. Doporučujeme používat ověřování Microsoft Entra ID v produkčních prostředích místo použití připojovací řetězec nebo sdílených přístupových podpisů, které se dají snadněji ohrozit. Podrobné informace a vzorový kód pro použití ověřování POMOCÍ ID Microsoft Entra najdete v tématu Ověřování a autorizace aplikace pomocí Microsoft Entra ID pro přístup k entitě Azure Relay a ověření spravované identity pomocí Microsoft Entra ID pro přístup k prostředkům Azure Relay.

Spuštění aplikací

1. Spusťte serverovou aplikaci. V okně konzoly uvidíte následující text:

   Online
   Server listening
   

2. Spusťte klientskou aplikaci. Zobrazí hello! v okně klienta. Klient odeslal na server požadavek HTTP a server odpověděl na hello!.

3. K zavření oken konzoly, stiskněte ENTER v obou oknech konzoly.

Související obsah

V tomto rychlém startu jste vytvořili klientské a serverové aplikace .NET, které k odesílání a přijímání zpráv používaly protokol HTTP. Funkce Hybridní připojení služby Azure Relay také podporuje odesílání a přijímání zpráv pomocí webSocketů. Pokud se chcete dozvědět, jak používat webSocket s Azure Relay Hybrid Connections, přečtěte si rychlý start k WebSockets.

V tomto rychlém startu jste k vytváření klientských a serverových aplikací použili rozhraní .NET Framework. Informace o psaní klientských a serverových aplikací pomocí Node.js najdete v rychlém startu Node.js WebSockets nebo v rychlém startu Node.js HTTP.