Add new management sample (#163)

* Add and update Management sample for 1.10.0

* Update and add md files

* add file header

* fix indention

* fix

* Remove Legacy Sample

* fix

* add another hub

* Fix

* Fix readme.md

* Add more comments

* fix doc

* Add gitignore

Author: Y-Sindo

samples/Management/.gitignore

@@ -0,0 +1 @@
+*.sln

samples/Management/LegacySample/NegotiationServer/Controllers/NegotiateController.cs

@@ -12,10 +12,10 @@ namespace Microsoft.Azure.SignalR.Samples.Management
     public class MessagePublisher
     {
         private const string Target = "Target";
-        private const string HubName = "ManagementSampleHub";
+        private const string HubName = "Message";
         private readonly string _connectionString;
         private readonly ServiceTransportType _serviceTransportType;
-        private IServiceHubContext _hubContext;
+        private ServiceHubContext _hubContext;
 
         public MessagePublisher(string connectionString, ServiceTransportType serviceTransportType)
         {
@@ -29,9 +29,12 @@ public async Task InitAsync()
             {
                 option.ConnectionString = _connectionString;
                 option.ServiceTransportType = _serviceTransportType;
-            }).Build();
+            })
+            //Uncomment the following line to get more logs
+            //.WithLoggerFactory(LoggerFactory.Create(builder => builder.AddConsole()))
+            .BuildServiceManager();
 
-            _hubContext = await serviceManager.CreateHubContextAsync(HubName, new LoggerFactory());
+            _hubContext = await serviceManager.CreateHubContextAsync(HubName, default);
         }
 
         public Task ManageUserGroup(string command, string userId, string groupName)

samples/Management/LegacySample/NegotiationServer/README.md

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>net5</TargetFramework>
     <UserSecretsId>ManagementSample</UserSecretsId>
     <RootNamespace>Microsoft.Azure.SignalR.Samples.Management</RootNamespace>
   </PropertyGroup>
@@ -14,4 +14,4 @@
     <PackageReference Include="Microsoft.Extensions.Logging" Version="2.2.0" />
   </ItemGroup>
 
-</Project>
+</Project>

samples/Management/LegacySample/NegotiationServer/appsettings.Development.json

@@ -124,7 +124,7 @@ private static void ShowHelp()
 
         private static void MissOptions()
         {
-            Console.WriteLine("Miss required options: Connection string and Hub must be set");
+            Console.WriteLine("Miss required options: Connection string must be set");
         }
     }
 }

samples/Management/LegacySample/NegotiationServer/appsettings.json

@@ -8,25 +8,27 @@ This sample shows how to use [Microsoft.Azure.SignalR.Management](https://www.nu
 ### Add Management SDK to your project
 
 ```
-dotnet add package Microsoft.Azure.SignalR.Management -v 1.0.0-*
+dotnet add package Microsoft.Azure.SignalR.Management -v 1.*
 ```
 
-### Create instance of `IServiceManager`
+### Create instance of `ServiceManager`
 
-The `IServiceManager` is able to manage your Azure SignalR Service from your connection string.
+The `ServiceManager` is able to manage your Azure SignalR Service.
 
 ```c#
-var serviceManager = new ServiceManagerBuilder()
-    .WithOptions(option =>
-    {
-        option.ConnectionString = "<Your Connection String>";
-    })
-    .Build();
+var serviceManager = new ServiceManagerBuilder().WithOptions(option =>
+{
+    option.ConnectionString = _connectionString;
+    option.ServiceTransportType = _serviceTransportType;
+})
+//Uncomment the following line to get more logs
+//.WithLoggerFactory(LoggerFactory.Create(builder => builder.AddConsole()))
+.BuildServiceManager();
 ```
 
-### Create instance of `IServiceHubContext` 
+### Create instance of `ServiceHubContext`
 
-The `IServiceHubContext` is used to publish messages to a specific hub.
+The `ServiceHubContext` is used to publish messages to a specific hub.
 
 ```C#
 var hubContext = await serviceManager.CreateHubContextAsync("<Your Hub Name>");
@@ -40,7 +42,7 @@ Once you create the `hubContext`, you can use it to publish messages to a given
 // broadcast
 hubContext.Clients.All.SendAsync("<Your SignalR Client Callback>", "<Arg1>", "<Arg2>", ...);
 
-// send to a user 
+// send to a user
 hubContext.Clients.User("<User ID>").SendAsync("<Your SignalR Client Callback>", "<Arg1>", "<Arg2>", ...);
 
 // send to users
@@ -63,7 +65,7 @@ hubContext.UserGroups.RemoveFromGroupAsync("<User ID>", "<Group Name>");
 
 All features can be found [here](<https://github.com/Azure/azure-signalr/blob/dev/docs/management-sdk-guide.md#features>).
 
-### Dispose the instance of `IServiceHubContext` 
+### Dispose the instance of `ServiceHubContext`
 
 ```c#
 await hubContext.DisposeAsync();

samples/Management/LegacySample/MessagePublisher/MessagePublisher.cs renamed to samples/Management/MessagePublisher/MessagePublisher.cs

@@ -0,0 +1,52 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Azure.SignalR.Management;
+
+namespace NegotiationServer.Controllers
+{
+    [ApiController]
+    public class NegotiateController : ControllerBase
+    {
+        private readonly ServiceHubContext _messageHubContext;
+        private readonly ServiceHubContext _chatHubContext;
+
+        public NegotiateController(IHubContextStore store)
+        {
+            _messageHubContext = store.MessageHubContext;
+            _chatHubContext = store.ChatHubContext;
+        }
+
+        [HttpPost("message/negotiate")]
+        public Task<ActionResult> MessageHubNegotiate(string user)
+        {
+            return NegotiateBase(user, _messageHubContext);
+        }
+
+        //This API is not used. Just demonstrate a way to have multiple hubs.
+        [HttpPost("chat/negotiate")]
+        public Task<ActionResult> ChatHubNegotiate(string user)
+        {
+            return NegotiateBase(user, _chatHubContext);
+        }
+
+        private async Task<ActionResult> NegotiateBase(string user, ServiceHubContext serviceHubContext)
+        {
+            if (string.IsNullOrEmpty(user))
+            {
+                return BadRequest("User ID is null or empty.");
+            }
+
+            var negotiateResponse = await serviceHubContext.NegotiateAsync(new() { UserId = user });
+
+            return new JsonResult(new Dictionary<string, string>()
+            {
+                { "url", negotiateResponse.Url },
+                { "accessToken", negotiateResponse.AccessToken }
+            });
+        }
+    }
+}