Sto creando delle web api in c#, sto integrando le api di Microsoft Graph di Teams. Come…
- User
Sto creando delle web api in c#, sto integrando le api di Microsoft Graph di Teams. Come faccio ad implementare SignalR in modo da ricevere in messaggi di teams?
- Assistant
Per ricevere messaggi da Teams utilizzando Microsoft Graph e SignalR, dovrai seguire questi passi chiave:
1. Configurare una Web API:
Iniziamo creando una Web API in ASP.NET Core che possa ricevere i dati dai webhook di Microsoft Graph.
2. Registrare l'applicazione in Azure AD:
Dovrai registrare la tua applicazione su Azure AD per ottenere le credenziali necessarie per accedere alle API Microsoft Graph. Questo include impostare i permessi richiesti (come
Chat.Read,Chat.ReadWrite, ecc.) e configurare i redirect URIs.3. Usare Microsoft Graph per Abbonarti agli eventi:
Dovrai sottoscrivere eventi per il tipo di messaggi che desideri ricevere. Ad esempio, per ricevere notifiche quando vengono inviati messaggi nei Teams, dovrai registrarti a un webhook Microsoft Graph.
Ecco un esempio di come puoi farlo:
var subscription = new Subscription { ChangeType = "created", NotificationUrl = "https://tuo-url.com/api/notifications", Resource = "teams/{team-id}/channels/{channel-id}/messages", ExpirationDateTime = DateTime.UtcNow.AddMinutes(4230), // massimo 4230 minuti ClientState = "secretClientValue" // opzionale }; // Invio della richiesta di sottoscrizione var graphClient = new GraphServiceClient(authProvider); await graphClient.Subscriptions .Request() .AddAsync(subscription);4. Configurare SignalR:
Aggiungi SignalR al tuo progetto ASP.NET Core. Puoi fare questo attraverso NuGet Package Manager, installando
Microsoft.AspNetCore.SignalR.Assicurati di aggiungere il middleware di SignalR nel metodo
ConfigureServicesnel fileStartup.cs:public void ConfigureServices(IServiceCollection services) { services.AddSignalR(); services.AddControllers(); // Altri servizi... }Nel metodo
Configure, aggiungi il routing per SignalR:public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseRouting(); app.UseEndpoints(endpoints => { endpoints.MapControllers(); endpoints.MapHub<YourHub>("/yourHub"); // Nome del tuo Hub SignalR }); }5. Creare un Hub SignalR:
Crea un hub SignalR per inviare messaggi ai client:
public class YourHub : Hub { public async Task SendMessage(string user, string message) { await Clients.All.SendAsync("ReceiveMessage", user, message); } }6. Gestire le notifiche in un Controller:
Crea un controller per gestire le notifiche inviate da Microsoft Graph e inoltrarle all'hub SignalR:
[Route("api/[controller]")] [ApiController] public class NotificationsController : ControllerBase { private readonly IHubContext<YourHub> _hubContext; public NotificationsController(IHubContext<YourHub> hubContext) { _hubContext = hubContext; } [HttpPost] public async Task<IActionResult> Post([FromBody] Notification notification) { // Processa la notifica ricevuta // Invia il messaggio tramite SignalR await _hubContext.Clients.All.SendAsync("ReceiveMessage", "System", notification.Data.Message); return Ok(); } }7. Configurare i client per SignalR:
Infine, nel tuo client (Angular, React, ecc.), configura SignalR per ricevere i messaggi. Puoi connetterti all'hub e ascoltare gli eventi:
const connection = new signalR.HubConnectionBuilder() .withUrl("/yourHub") .build(); connection.on("ReceiveMessage", (user, message) => { console.log(`${user}: ${message}`); // Aggiorna l'interfaccia utente di conseguenza }); connection.start().catch(err => console.error(err));Note Finali:
- Assicurati di gestire la sicurezza e i permessi adeguati per l'accesso alle tue API e alle notifiche.
- Gli URL di riferimento per il webhook devono essere pubblici e disponibili per Microsoft Graph; potresti dover utilizzare un servizio come ngrok durante lo sviluppo.
Seguendo questi passaggi dovresti essere in grado di ricevere messaggi di Teams utilizzando Microsoft Graph e SignalR nella tua Web API in C#.
- User
Riusciresti a spiegarmi passo per passo tutto quello che devo fare?
- Assistant
Certo! Ecco una guida passo-passo per creare una Web API in C# utilizzando SignalR e integrandola con le API di Microsoft Graph per ricevere messaggi da Microsoft Teams.
Prerequisiti
- Visual Studio o Visual Studio Code installato.
- .NET SDK installato (preferibilmente .NET 6 o superiore).
- Un account Azure Active Directory per registrare la tua applicazione.
Step 1: Creare un Progetto ASP.NET Core Web API
- Apri Visual Studio e crea un nuovo progetto.
- Seleziona "ASP.NET Core Web API".
- Fai clic su "Avanti", quindi imposta il nome del progetto e la localizzazione.
- Scegli la versione .NET, ad esempio, .NET 6.0 e assicurati che "Abilita OpenAPI Support" sia selezionato.
- Fai clic su "Creare".
Step 2: Registrare l'Applicazione in Azure AD
- Vai al Portale di Azure e accedi al tuo account.
- Seleziona “Azure Active Directory”.
- Seleziona “App registrations” (Registrazioni delle app) nel menu a sinistra.
- Clicca su "New registration" (Nuova registrazione).
- Compila il modulo:
- Nome: Scegli un nome per la tua applicazione.
- URL di reindirizzamento: impostalo su
https://localhost:5001/signin-oidc(o simile, a seconda della tua configurazione).
- Clicca su "Register".
Step 3: Impostare i Permessi per Microsoft Graph
- Dopo aver registrato l'applicazione, vai alla sezione "API permissions" (Permessi API).
- Clicca su "Add a permission" (Aggiungi un permesso).
- Seleziona "Microsoft Graph".
- Scegli "Delegated permissions" (Permessi delegati).
- Aggiungi i permessi:
Chat.ReadChat.ReadWriteChannelMessage.Read.All
- Clicca su "Add permissions" (Aggiungi permessi).
- In alcune configurazioni, potresti dover fornire un "Admin consent" per i permessi che richiedono autorizzazioni di amministratore.
Step 4: Ottieni il Client ID e il Client Secret
- Dalla pagina della tua registrazione dell'app, annota il “Application (client) ID”.
- Vai su “Certificates & secrets” (Certificati e segreti).
- Clicca su "New client secret" (Nuovo segreto cliente), impostalo su "Never Expires" (Mai scadere) e annota il valore del segreto generato (Client Secret).
Step 5: Aggiungi SignalR al Progetto
Apri il terminale della tua soluzione e installa il pacchetto NuGet per SignalR:
dotnet add package Microsoft.AspNetCore.SignalR
Step 6: Configura SignalR nell'Applicazione
Modifica il file
Startup.cs- Aggiungi i servizi di SignalR:
public void ConfigureServices(IServiceCollection services) { services.AddSignalR(); services.AddControllers(); }- Configura il middleware di SignalR:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseRouting(); app.UseEndpoints(endpoints => { endpoints.MapControllers(); endpoints.MapHub<YourHub>("/yourHub"); }); }Crea un Hub SignalR
Crea un nuovo file chiamato
YourHub.csnella cartella principale del tuo progetto:using Microsoft.AspNetCore.SignalR; public class YourHub : Hub { public async Task SendMessage(string user, string message) { await Clients.All.SendAsync("ReceiveMessage", user, message); } }
Step 7: Configura il Webhook per Microsoft Graph
Crea un Controller per Gestire le Notifiche
Crea un controller denominato
NotificationsController.cs:using Microsoft.AspNetCore.Mvc; using Microsoft.AspNetCore.SignalR; [Route("api/[controller]")] [ApiController] public class NotificationsController : ControllerBase { private readonly IHubContext<YourHub> _hubContext; public NotificationsController(IHubContext<YourHub> hubContext) { _hubContext = hubContext; } [HttpPost] public async Task<IActionResult> Post([FromBody] Notification notification) { // Invia il contenuto del messaggio analytics via SignalR await _hubContext.Clients.All.SendAsync("ReceiveMessage", "Microsoft Graph", notification.value[0].resource); return Ok(); } }L'oggetto
Notificationdeve essere definito secondo la struttura dei dati restituiti da Microsoft Graph. Puoi trovare dettagli nella documentazione ufficiale delle notifiche.
Step 8: Sottoscriversi a Eventi
Scrivi un metodo per sottoscrivere gli eventi ai messaggi all'interno della tua applicazione. Puoi farlo in un controller o in un servizio di avvio:
public async Task InitializeSubscription() { var graphClient = new GraphServiceClient(new DelegateAuthenticationProvider(async (requestMessage) => { requestMessage.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken); // Usa il token di accesso qui })); var subscription = new Subscription { ChangeType = "created", NotificationUrl = "https://tuo-url.com/api/notifications", // Deve essere pubblico Resource = "teams/{team-id}/channels/{channel-id}/messages", ExpirationDateTime = DateTime.UtcNow.AddMinutes(4230), // L'intervallo massimo delle notifiche ClientState = "secretClientValue" // Usato per la validazione }; await graphClient.Subscriptions .Request() .AddAsync(subscription); }Step 9: testare l'applicazione
- Esegui la tua applicazione API.
- Testa l'invio dei messaggi nei canali di Teams.
- Verifica che i messaggi vengano ricevuti nel tuo client SignalR.
- Puoi utilizzare un client JavaScript per connetterti al tuo hub SignalR. Aggiungi il codice per stabilire una connessione e gestire i messaggi.
Ecco un esempio di come farlo con JavaScript:
const connection = new signalR.HubConnectionBuilder() .withUrl("/yourHub") .build(); connection.on("ReceiveMessage", (user, message) => { console.log(`${user}: ${message}`); // Inserisci qui il codice per aggiornare l'interfaccia utente }); connection.start().catch(err => console.error(err));Nota Finale
Ricorda che gli URL di webhook devono essere accessibili da Microsoft Graph. Durante lo sviluppo, puoi usare strumenti come ngrok per esporre il tuo server locale su un URL pubblico.
Questo è un approccio passo-passo per configurare la tua applicazione. Assicurati di testare e apportare modifiche in base alle tue esigenze specifiche!
- User
Cosa intendi per aggiungere i servizi?
- Assistant
Quando parlo di "aggiungere i servizi" in un'applicazione ASP.NET Core, mi riferisco alla registrazione dei vari servizi necessari per il funzionamento della tua applicazione nel contenitore di inversione del controllo (IoC container). In ASP.NET Core, i servizi sono registrati nel metodo
ConfigureServicesdella classeStartup.Durante l'esecuzione della tua applicazione, ASP.NET Core utilizza queste registrazioni per creare e gestire le istanze delle classi che ti servono, come controller, hub SignalR, e altri servizi personalizzati.
Esempio di Aggiunta di Servizi
Considera il seguente esempio:
public class Startup { public void ConfigureServices(IServiceCollection services) { // Aggiungi i servizi per il framework MVC e SignalR. services.AddControllers(); // Aggiunge i servizi per i controller API services.AddSignalR(); // Aggiunge i servizi necessari per SignalR } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseRouting(); app.UseEndpoints(endpoints => { endpoints.MapControllers(); // Configura i percorsi per i controller endpoints.MapHub<YourHub>("/yourHub"); // Configura il percorso per il tuo hub SignalR }); } }Sezione
ConfigureServices-
services.AddControllers(): Registra i servizi necessari per supportare l'architettura MVC nel tuo progetto ASP.NET Core. Questo include la capacità di ricevere e gestire le richieste HTTP e restituire risposte. -
services.AddSignalR(): Registra tutto il necessario per utilizzare SignalR, che ti consente di gestire comunicazioni in tempo reale tra il server e i client.
Altri Servizi
Puoi anche registrare altri servizi personalizzati che potresti avere, ad esempio:
services.AddScoped<IMyService, MyService>();Nell'esempio sopra,
IMyServiceè un'interfaccia eMyServiceè una classe che la implementa. Registrando questo servizio, puoi iniettarlo nei tuoi controller o in altri servizi per usarlo.In Sintesi
Aggiungere servizi nel metodo
ConfigureServicesè una parte fondamentale della configurazione di un'applicazione ASP.NET Core. Permette di preparare l'applicazione a utilizzare vari servizi, inclusi framework, middleware e logiche di business definite dall'utente. Questo approccio basato sui servizi rende l'applicazione più modulare e testabile. -