Accelera il tuo flusso di lavoro: perché i dev tunnel di Visual Studio battono il deployment tradizionale

By Mirko Peters · 2026-08-12

Bentornati al podcast! Se vi è mai capitato di aspettare quindici minuti che un deployment nel cloud finisse solo per testare una singola modifica al codice, sapete bene quanto questo rallenti la produttività…

Automatically translated with AI from the original post. Read the English original

Bentornati al podcast! Se vi è mai capitato di aspettare quindici minuti che un deployment nel cloud finisse solo per testare una singola modifica al codice, sapete bene quanto questo rallenti la produttività. Oggi approfondiamo un argomento che ha completamente trasformato il modo in cui i nostri team di sviluppo gestiscono test locali, debug e integrazioni. Non perdete l'episodio correlato, Test Microsoft 365 Apps with Visual Studio Dev Tunnels, in cui analizziamo nel dettaglio questi flussi di lavoro in azione.

In questa guida completa vedremo perché i metodi di deployment tradizionali stanno perdendo terreno rispetto alle moderne soluzioni di tunneling, come funzionano i dev tunnel di Visual Studio sotto il cofano e come integrarli senza attriti nei vostri progetti Microsoft 365, Teams e ASP.NET Core.

Test locali con i dev tunnel di Visual Studio

Perché il test locale è importante

Vuoi che le tue app per Microsoft 365 funzionino perfettamente prima di condividerle con gli utenti. Il test locale ti permette di individuare subito i bug e di vedere come si comporta il codice in un ambiente sicuro. Quando testi in locale, puoi apportare modifiche rapidamente e vedere i risultati immediatamente. Questo processo ti fa risparmiare tempo e ti aiuta a evitare errori che potrebbero emergere in produzione.

Il classico test su localhost ha dei limiti. La tua macchina locale non può accettare connessioni da internet. Questo rende difficile testare funzionalità che richiedono l'accesso in condizioni reali, come webhook, flussi di autenticazione o integrazioni con i servizi di Microsoft 365. Ti ritrovi bloccato, senza poter simulare il comportamento dell'app per gli utenti effettivi.

Dev Tunnels ha rivoluzionato il modo in cui sviluppiamo e testiamo le applicazioni web, soprattutto per gli sviluppatori mobile, che spesso hanno difficoltà a configurare server locali per i test. È una funzionalità che cambia le regole del gioco, migliora la collaborazione e semplifica il processo di sviluppo.

Con gli strumenti giusti puoi superare queste difficoltà. Puoi creare un ambiente realistico per la tua app, anche lavorando dal tuo computer.

Come i dev tunnel abilitano il test locale

Puoi testare le app per Microsoft 365 da localhost usando i dev tunnel di Visual Studio. Questo strumento offre un modo sicuro per esporre i servizi locali su internet. Non è necessario distribuire il codice su Azure o su un'altra piattaforma cloud solo per vedere come funziona con Microsoft 365.

I dev tunnel di Visual Studio potenziano il tradizionale test su localhost permettendoti di esporre in modo sicuro le applicazioni locali su internet. Questa capacità consente connessioni in ingresso, essenziali per testare le app per Microsoft 365 in un ambiente più realistico, superando i limiti del test confinato alla sola macchina locale.

Ecco come i dev tunnel migliorano velocità e sicurezza del test locale:

• I dev tunnel permettono ai servizi locali di comportarsi come endpoint cloud sicuri in meno di 3 minuti.
• Facilitano l'accesso sicuro a internet per il test locale delle app per Microsoft 365.
• Una configurazione corretta è fondamentale per evitare di esporre l'ambiente di sviluppo.

Puoi configurare i tunnel con pochi clic o comandi. Scegli il nome e la visibilità del tunnel, quindi controlli chi può accedere alla tua app. Puoi usare l'autenticazione per proteggere il lavoro. Questa flessibilità ti permette di collaborare con i colleghi o invitare tester senza condividere l'intero computer.

I dev tunnel ti consentono di testare funzionalità come l'autenticazione OAuth, i bot di Teams o le web part di SharePoint come se fossero in esecuzione nel cloud. Ottieni un riscontro in tempo reale e puoi fare debug dei problemi sul momento. Questo processo rende il ciclo di sviluppo più rapido e affidabile.

Quando usi i dev tunnel, acquisisci fiducia nel tuo codice prima del deployment. Sai che la tua app funziona nel mondo reale, non solo sulla tua macchina.

Panoramica di Visual Studio Dev Tunnels

Funzionalità principali

I dev tunnel di Visual Studio ti offrono un modo potente per testare e fare debug delle app di Microsoft 365 dalla tua macchina locale. Puoi esporre i tuoi servizi ASP.NET Core su internet con pochi passaggi. Questo strumento ti aiuta a creare un ambiente di sviluppo sicuro e flessibile.

Ecco alcune delle funzionalità principali che ti saranno utili:

• Puoi esporre API locali tramite URL remoti, semplificando il test e il debug dei tuoi progetti ASP.NET Core.
• L'integrazione con servizi di terze parti diventa semplice perché le tue app locali hanno URL accessibili pubblicamente.
• Puoi impostare breakpoint su localhost e osservare come il tuo codice ASP.NET Core risponde quando vengono acceduti gli URL remoti.
• I tunnel con nome ti aiutano a condividere progetti o servizi specifici senza confusione.
• I tunnel persistenti ti permettono di mantenere l'accesso nel tempo, il che è importante per progetti ASP.NET Core in corso.
• Puoi scegliere i livelli di accesso per i tuoi tunnel: privato, organizzativo o pubblico. Questo rende facile controllare chi può vedere il tuo lavoro.
• L'autenticazione con Entra ID limita l'accesso agli utenti con credenziali valide, proteggendo i tuoi dati.
• La CLI ti permette di gestire e automatizzare la creazione e la configurazione dei tunnel. Puoi usare i comandi per creare, elencare ed etichettare i tunnel, così da gestirli più facilmente.

Suggerimento: i tunnel persistenti e con nome ti evitano di ricreare i tunnel ogni volta che riavvii il progetto ASP.NET Core. Questo ti fa risparmiare tempo e riduce gli errori.

Come funzionano i dev tunnel

I dev tunnel creano un ponte sicuro tra il tuo server ASP.NET Core locale e internet. Puoi testare le app di Microsoft 365 come se fossero in esecuzione in un ambiente di produzione.

Endpoint pubblici sicuri

Inizi scaricando e installando la CLI devtunnel. Dopo aver effettuato l'accesso con il tuo account Entra ID, Microsoft o GitHub, avvii il server ASP.NET Core locale. Poi ospiti o crei un tunnel con il comando devtunnel host –p PORT. Se vuoi un URL permanente, usi il comando devtunnel create per un tunnel persistente.

Questo processo ti fornisce un endpoint sicuro, raggiungibile da internet, per il tuo servizio ASP.NET Core locale. Ora puoi testare webhook, flussi di autenticazione e integrazioni che richiedono URL pubblici. L'autenticazione con Entra ID garantisce che solo gli utenti approvati possano accedere ai tuoi tunnel, riducendo il rischio di esposizione accidentale dei dati.

Integrazione con Visual Studio e CLI

Visual Studio rende semplice la creazione e la gestione dei dev tunnel. Puoi configurare un tunnel con pochi clic direttamente nell'IDE. La CLI offre ancora più opzioni, come tunnel a durata fissa e tagging per una migliore organizzazione. Puoi automatizzare la creazione dei tunnel per i tuoi progetti ASP.NET Core, rendendo il flusso di lavoro più veloce e affidabile.

Puoi anche elencare tutti i tuoi tunnel, visualizzarne i dettagli e gestire le autorizzazioni di accesso. Questa flessibilità ti aiuta a collaborare con il team e a mantenere sicuro l'ambiente di sviluppo.

Nota: i dev tunnel sono progettati per esporre in modo sicuro i tuoi endpoint ASP.NET Core locali su internet, rendendo test e debug sicuri ed efficienti.

Ospitare o creare un tunnel in Visual Studio

Prerequisiti e configurazione

Prima di ospitare o creare un tunnel per il test delle app di Microsoft 365, devi preparare l'ambiente. Visual Studio ti fornisce gli strumenti necessari, ma prima devi soddisfare alcuni requisiti. La tabella seguente mostra cosa ti serve per iniziare:

Verifica di avere la versione corretta di Visual Studio. Apri il programma di installazione e controlla che il carico di lavoro «ASP.NET e sviluppo web» sia attivo. Accedi con il tuo account Microsoft per aprire la finestra degli strumenti dei dev tunnel. Se prevedi di collegare il tuo progetto ASP.NET Core a Power Platform, assicurati di avere accesso a Power Automate o Power Apps.

Suggerimento: tenere aggiornati gli strumenti ti aiuta a evitare problemi di configurazione e ti permette di usare le funzionalità più recenti nella finestra degli strumenti dei dev tunnel.

Creazione e denominazione di un tunnel

Puoi creare un tunnel direttamente dalla finestra degli strumenti dei dev tunnel in Visual Studio. Questo processo ti consente di esporre il servizio ASP.NET Core su internet per testare l'app di Microsoft 365. Segui questi passaggi per creare e denominare il tunnel:

1. Nel menu a discesa del debug, seleziona Dev Tunnels > Crea un tunnel.
2. La finestra degli strumenti dei dev tunnel apre una finestra di dialogo. Scegli l'account che vuoi usare.
3. Inserisci un nome per il tunnel. Questo nome ti aiuta a riconoscerlo nella finestra degli strumenti dei dev tunnel.
4. Scegli il tipo di tunnel. Seleziona Persistente se vuoi lo stesso URL ogni volta, oppure Temporaneo per un nuovo URL a ogni sessione.
5. Scegli il tipo di autenticazione: Privato, Organizzazione o Pubblico.
6. Fai clic su OK per creare il tunnel.

Quando crei un tunnel, rendi più semplice collegare il progetto ASP.NET Core ai servizi di Microsoft 365. La finestra degli strumenti dei dev tunnel mantiene i tuoi tunnel organizzati e visibili. Puoi sempre trovare i tunnel attivi e gestirli da questa finestra.

Nota: dare un nome al tunnel aiuta te e il tuo team a capire quale servizio ASP.NET Core è esposto. Usa nomi chiari per ogni tunnel nella finestra degli strumenti dei dev tunnel.

Impostazione della visibilità del tunnel

La visibilità del tunnel controlla chi può accedere ai tuoi dev tunnel. Imposti questa opzione nella finestra degli strumenti dei dev tunnel quando crei un tunnel. Il livello di visibilità giusto protegge il tuo lavoro e favorisce la collaborazione.

Ecco le principali opzioni di visibilità:

Puoi anche vedere queste opzioni come:

• Privato: solo tu puoi usare il tunnel.
• Organizzazione: il tuo team o la tua azienda può usare il tunnel.
• Pubblico: chiunque può usare il tunnel.

La finestra degli strumenti dei dev tunnel ti permette di modificare la visibilità quando crei e gestisci i dev tunnel. Scegliere il livello giusto ti aiuta a monitorare il traffico e a mantenere sicura la tua app di Microsoft 365. I tunnel privati funzionano meglio per lo sviluppo individuale. I tunnel dell'organizzazione aiutano i team a fare test insieme. I tunnel pubblici consentono ai tester esterni di accedere, ma richiedono maggiore attenzione.

Attenzione: i tunnel pubblici non richiedono l'autenticazione. Usali solo quando devi condividere la tua app con utenti esterni alla tua organizzazione e controlla sempre gli accessi nella finestra degli strumenti dei dev tunnel.

La visibilità del tunnel incide sia sulla sicurezza sia sulla collaborazione. Quando imposti il livello giusto, ti assicuri che solo le persone giuste possano accedere alla tua app. Questo riduce i rischi e aiuta il team a lavorare insieme senza intoppi.

Uso della CLI dei dev tunnel

Puoi gestire i dev tunnel direttamente dalla riga di comando usando la CLI dei dev tunnel. Questo strumento offre flessibilità e rapidità, soprattutto quando vuoi automatizzare il flusso di lavoro o lavorare al di fuori dell'interfaccia di Visual Studio. La CLI funziona bene sia per test rapidi sia per configurazioni più avanzate.

Per iniziare, devi installare la CLI dei dev tunnel. Puoi farlo eseguendo il seguente comando nel terminale:

dotnet tool install -g Microsoft.DevTunnels.Cli

Dopo l'installazione, devi effettuare l'accesso. Usa il tuo account Microsoft, Entra ID o l'account GitHub. Questo passaggio collega la sessione della CLI al tuo ambiente di Visual Studio e garantisce un accesso sicuro.

devtunnel login

Una volta effettuato l'accesso, puoi creare e gestire i tunnel. Ecco un modo semplice per creare un tunnel per il tuo progetto locale:

devtunnel host -p 5000

Questo comando espone il servizio locale in esecuzione sulla porta 5000 su internet. La CLI mostrerà un URL pubblico che puoi usare per testare la tua app di Microsoft 365. Puoi condividere questo URL con il tuo team oppure usarlo per i test di integrazione.

Se vuoi un tunnel persistente con un nome personalizzato, usa:

devtunnel create my-tunnel --persistent
devtunnel host my-tunnel -p 5000

Questo approccio ti permette di mantenere lo stesso URL tra una sessione e l'altra, il che è importante per gli URI di reindirizzamento OAuth e per test coerenti. Puoi anche impostare la visibilità del tunnel direttamente dalla CLI. Ad esempio, per rendere il tunnel accessibile solo alla tua organizzazione, aggiungi il flag --access organization:

devtunnel create my-tunnel --persistent --access organization

Suggerimento: usa nomi chiari e descrittivi per i tunnel. Così è più facile gestire più progetti in visual studio ed evitare confusione.

Puoi elencare in qualsiasi momento tutti i tunnel attivi:

devtunnel list

Per interrompere un tunnel, usa:

devtunnel close my-tunnel

La CLI permette anche di automatizzare la creazione dei tunnel negli script. Questa funzionalità è utile quando vuoi configurare i dev tunnel come parte del processo di build o di distribuzione. Puoi condividere i comandi della CLI con il tuo team, così tutti usano la stessa configurazione, il che migliora la coerenza e riduce gli errori.

Nota: la CLI di Dev Tunnels funziona senza problemi con visual studio. Puoi passare dalla CLI all'interfaccia di visual studio senza perdere le impostazioni dei tunnel.

Padroneggiando la CLI di Dev Tunnels ottieni un maggiore controllo sull'ambiente di sviluppo. Puoi creare, gestire e proteggere rapidamente i tunnel per qualsiasi progetto di Microsoft 365 App. Questa flessibilità ti aiuta a testare e fare il debug delle tue app in modo efficiente, sia che lavori da solo sia che faccia parte di un team.

Configura le app di Microsoft 365 per Dev Tunnels

Aggiorna la registrazione dell'app e gli URI di reindirizzamento

Devi aggiornare la registrazione dell'app e gli URI di reindirizzamento per collegare il tuo progetto locale di ASP.NET Core ai servizi di Microsoft 365 tramite visual studio. Questo processo permette alla tua app di usare l'endpoint sicuro fornito da dev tunnels. Ecco un modo semplice per configurare la registrazione dell'app:

1. Apri il portale Microsoft Entra ID – Registrazioni app.
2. Seleziona «Nuova registrazione» e inserisci il nome della tua app.
3. Scegli i tipi di account supportati per la tua app.
4. Per ora lascia vuoto il campo URI di reindirizzamento.
5. Fai clic su «Registra» per creare la tua app.
6. Nella pagina di panoramica, copia l'ID applicazione (client) e l'ID directory (tenant).
7. In «Gestisci» seleziona «Esponi un'API».
8. Fai clic sul collegamento «Imposta» per generare l'URI ID applicazione.
9. Aggiungi un ambito denominato «access_as_user».
10. Imposta «Chi può dare il consenso?» su «Amministratori e utenti».
11. Compila le richieste di consenso per amministratori e utenti.
12. Verifica che lo stato sia impostato su «Abilitato».
13. Seleziona «Aggiungi ambito» per completare.

Dopo aver creato il tunnel in visual studio, devi aggiornare l'URI di reindirizzamento nella registrazione dell'app. Usa l'URL pubblico del tuo tunnel ASP.NET Core come URI di reindirizzamento. Questo passaggio consente a Microsoft 365 di sapere dove inviare le risposte di autenticazione durante i test.

Suggerimento: salva sempre l'ID client e l'ID tenant. Ti serviranno per l'autenticazione e la configurazione di OAuth.

Collega Teams, SharePoint e le app di Power Platform

Puoi usare visual studio per collegare i tuoi servizi ASP.NET Core a Teams, SharePoint e alle app di Power Platform. I dev tunnel rendono questo processo sicuro e semplice. Quando usi i tunnel, ricevi avvisi se ti colleghi a un endpoint di tunnel. Questi avvisi ti aiutano a evitare attacchi di phishing e la condivisione accidentale di URL sensibili.

• I bot di Teams e le estensioni dei messaggi usano i dev tunnel per impostazione predefinita nello sviluppo locale. Questa configurazione ti offre un modo sicuro per testare le funzionalità prima di distribuirle.
• Anche le web part di SharePoint e i connettori di Power Platform beneficiano di endpoint sicuri. Puoi testare webhook, autenticazione e flussi di dati in uno scenario reale.
• L'autenticazione dell'identità di Microsoft 365 aggiunge un ulteriore livello di sicurezza. Devi accedere con il tuo account Microsoft 365 per creare e gestire i tunnel in visual studio.

Nota: una maggiore consapevolezza della sicurezza aiuta te e il tuo team a restare al sicuro mentre testate le vostre app ASP.NET Core.

Gestisci autenticazione e OAuth

Devi configurare autenticazione e OAuth per far funzionare le tue Microsoft 365 App con i dev tunnel. Ecco una guida passo passo:

1. Registra la tua app nel portale Microsoft Entra ID.
2. Imposta l'URI dell'applicazione in modo che corrisponda all'endpoint del tunnel di visual studio.
3. Crea un segreto client per lo scambio di token.
4. Aggiungi le autorizzazioni API per l'accesso a Microsoft Graph.
5. Aggiorna gli URI di reindirizzamento in modo che usino l'URL del tuo tunnel ASP.NET Core.
6. Configura i dev tunnel per ospitare il tuo servizio locale.
7. Clona il repository del progetto e aggiorna i file di configurazione con il tuo client ID, tenant ID e secret.
8. Apri Visual Studio ed esegui il progetto ASP.NET Core.

Questa configurazione consente alla tua app di gestire l'accesso, lo scambio di token e le chiamate API in modo sicuro. Puoi testare i flussi di autenticazione, come OAuth, in un ambiente sicuro prima di passare alla produzione.

Verifica sempre con attenzione i Redirect URI e le autorizzazioni. Questo passaggio previene i comuni errori di autenticazione e mantiene sicuri i tuoi test.

Sicurezza e buone pratiche

Opzioni di visibilità dei tunnel

Sei tu a decidere chi può accedere all'ambiente di sviluppo, impostando la visibilità del tunnel. Quando crei un tunnel, puoi scegliere tra accesso privato, organizzativo o pubblico. I tunnel privati consentono la connessione solo a te. I tunnel organizzativi permettono a chiunque nella tua azienda di usarli. I tunnel pubblici aprono l'accesso a chiunque abbia il link. Scegli sempre la visibilità più bassa necessaria per il tuo progetto.

Per massimizzare la sicurezza durante il test delle app di Microsoft 365, segui queste buone pratiche:

• Imposta i tunnel su privato o organizzativo ogni volta che è possibile.
• Implementa lo split tunneling per le applicazioni Office 365. Questo metodo migliora le prestazioni e mantiene sicuri i tuoi dati.
• Usa gli intervalli di indirizzi IP forniti da Microsoft per lo split tunneling. Evita di usare nomi di dominio completi (FQDN).
• Disattiva l'ispezione SSL per il traffico di Office 365. Questo passaggio ti aiuta a rispettare le raccomandazioni di sicurezza di Microsoft.
• Verifica che il criterio di split tunneling funzioni correttamente usando lo strumento di test della connettività di Microsoft 365.
• Disattiva SSL Break and Inspect per i domini di Office 365.

Suggerimento: rivedi le impostazioni di visibilità del tunnel prima di condividere qualsiasi URL. Questa abitudine aiuta a prevenire l'esposizione accidentale del tuo ambiente di sviluppo.

Proteggi l'accesso con Entra ID

Puoi proteggere i tuoi tunnel richiedendo l'autenticazione con Entra ID. Questa funzionalità garantisce che solo gli utenti approvati possano accedere ai tuoi servizi locali. Quando abiliti l'autenticazione Entra ID, aggiungi un solido livello di protezione ai tuoi dev tunnel. Solo gli utenti con credenziali valide possono connettersi, il che aiuta a tenere al sicuro i tuoi dati.

Entra ID supporta anche l'accesso organizzativo. Puoi consentire a tutto il tuo team di testare e fare debug delle app senza esporre il tunnel al pubblico. Questo approccio bilancia sicurezza e collaborazione. Usa sempre l'autenticazione Entra ID per i progetti sensibili o quando gestisci informazioni riservate.

Nota: l'autenticazione Entra ID funziona senza problemi sia con l'interfaccia di Visual Studio sia con gli strumenti da riga di comando.

Monitoraggio e gestione dei tunnel

Devi monitorare e gestire i tuoi tunnel per mantenere un flusso di lavoro sicuro ed efficiente. Visual Studio offre funzionalità integrate per la gestione dei dev tunnel. Puoi visualizzare i tunnel attivi, controllarne lo stato e modificare le impostazioni di accesso direttamente dall'IDE. L'interfaccia da riga di comando consente inoltre di creare, elencare e chiudere rapidamente i tunnel.

Le buone pratiche per la gestione dei tunnel includono:

• Controlla regolarmente l'elenco dei tunnel attivi.
• Chiudi i tunnel quando hai finito i test, per ridurre i rischi per la sicurezza.
• Usa nomi descrittivi per ogni tunnel, per evitare confusione.
• Scegli tra tunnel temporanei o permanenti in base alle esigenze del progetto.
• Imposta i controlli di accesso in base ai requisiti di sicurezza.

Una tabella può aiutarti a confrontare le opzioni di gestione dei tunnel:

Ricorda: una buona gestione dei tunnel mantiene il tuo ambiente di sviluppo ordinato e sicuro.

Errori comuni da evitare

Quando usi i Dev Tunnels di Visual Studio per testare le app di Microsoft 365, vuoi evitare errori che possono farti perdere tempo o mettere a rischio il progetto. Molti sviluppatori incontrano gli stessi problemi. Se sai a cosa prestare attenzione, puoi risparmiare tempo e mantenere sicuro il tuo ambiente.

1. Scegliere la visibilità sbagliata per il tunnel

Potresti scegliere un tunnel pubblico per comodità. Questa scelta può esporre la tua app a chiunque abbia il link. Verifica sempre la visibilità del tunnel prima di iniziare a testare. Per la maggior parte dei progetti usa tunnel privati o dell'organizzazione. Usa tunnel pubblici solo quando ti servono tester esterni e controlla sempre gli accessi.

Suggerimento: Controlla le impostazioni del tunnel prima di condividere gli URL con il tuo team o con i tester.

2. Dimenticare di aggiornare gli URI di reindirizzamento

Se cambi l'URL del tunnel, devi aggiornare gli URI di reindirizzamento nella registrazione dell'app. Se salti questo passaggio, l'autenticazione non funzionerà. Verifica sempre che la registrazione dell'app corrisponda all'endpoint del tunnel attuale.

3. Ignorare le impostazioni di autenticazione

Potresti dimenticare di abilitare l'autenticazione Entra ID per il tunnel. Senza questa impostazione, chiunque abbia il link può accedere al tuo servizio locale. Per i progetti sensibili, richiedi sempre l'autenticazione. Questo passaggio protegge i tuoi dati e i tuoi utenti.

4. Lasciare i tunnel aperti dopo i test

Se lasci in esecuzione i tunnel al termine dei test, aumenti il rischio per la sicurezza. I tunnel inutilizzati possono diventare bersagli di accessi non autorizzati. Chiudi sempre i tunnel quando non ti servono più.

5. Usare nomi di tunnel generici o poco chiari

Se usi nomi poco chiari per i tunnel, tu e il tuo team potreste confondervi. Usa nomi descrittivi che corrispondano al progetto o al servizio. Questa abitudine ti aiuta a gestire più tunnel ed evitare errori.

6. Trascurare il monitoraggio dei log

Potresti non controllare i log del tunnel. I log ti aiutano a individuare attività insolite o accessi non autorizzati. Fai l'abitudine di esaminare i log regolarmente.

Nota: Puoi prevenire la maggior parte dei problemi seguendo una checklist prima e dopo ogni sessione di test.

Restando attento a questi errori comuni, mantieni il processo di sviluppo fluido e le tue app di Microsoft 365 sicure. Costruisci abitudini migliori e aiuti il tuo team a evitare problemi inutili.

Risoluzione dei problemi e suggerimenti avanzati

Diagnosi dei problemi di connessione

Quando lavori con i tunnel, potresti incontrare problemi di connessione. Inizia verificando che il servizio locale sia in esecuzione e in ascolto sulla porta corretta. Usa la riga di comando per confermare che il servizio risponda alle richieste. Se compaiono errori, riavvia il servizio e riprova.

Controlla poi le impostazioni del firewall. I firewall possono bloccare le connessioni in ingresso. Consenti il traffico sulla porta usata per il tunnel. Se usi una VPN, disconnettila e ripeti il test. Le VPN possono modificare le impostazioni di rete e causare problemi.

Se il problema persiste, usa il comando devtunnel list per visualizzare tutti i tunnel attivi. Assicurati di usare l'URL del tunnel corretto nella tua app di Microsoft 365. A volte copiare l'URL sbagliato causa errori di connessione.

Suggerimento: Verifica sempre l'URL del tunnel in un browser prima di iniziare test e debug. Questo passaggio ti aiuta a individuare subito gli errori più semplici.

Gestione degli errori di autenticazione

Gli errori di autenticazione possono impedire alla tua app di funzionare con i servizi di Microsoft 365. Per prima cosa, controlla la registrazione dell'app nel portale Microsoft Entra ID. Assicurati che gli URI di reindirizzamento corrispondano esattamente all'URL del tunnel. Anche un piccolo errore di battitura può causare problemi.

Verifica l'ID client e il segreto. Questi valori devono corrispondere a quelli impostati nella configurazione dell'app. Se cambi tunnel o ne crei uno nuovo, aggiorna gli URI di reindirizzamento nella registrazione dell'app.

Se compare il messaggio "unauthorized", controlla la visibilità del tunnel e le impostazioni di autenticazione. Per i progetti sensibili, usa sempre l'autenticazione Entra ID. Questo passaggio protegge i tuoi dati e impedisce accessi non desiderati.

Nota: La maggior parte degli errori di autenticazione deriva da URL non corrispondenti o da autorizzazioni mancanti. Ricontrolla queste impostazioni durante il debug.

CLI avanzata e automazione

Puoi usare la CLI di Dev Tunnels per automatizzare il flusso di lavoro. L'automazione fa risparmiare tempo e riduce gli errori. Ad esempio, puoi scrivere uno script che crea un tunnel, avvia il servizio locale e apre la pagina di test nel browser.

Ecco un esempio di script per Windows PowerShell:

devtunnel create my-automation-tunnel --persistent --access organization
devtunnel host my-automation-tunnel -p 5000
Start-Process "https://my-automation-tunnel.devtunnels.ms"

Puoi condividere script come questo con il tuo team. Tutti possono usare la stessa configurazione per test e debug. Questo approccio favorisce la collaborazione ed evita errori di configurazione.

Se vuoi chiudere tutti i tunnel contemporaneamente, usa:

devtunnel close --all

Automatizzare la gestione dei tunnel rende il processo di sviluppo più fluido e affidabile. Prova a usare gli script per le attività ripetitive.

Puoi migliorare lo sviluppo delle tue app per Microsoft 365 usando i dev tunnel di Visual Studio. Questo strumento rende i test più rapidi e più sicuri. Inizia configurando il primo tunnel e segui le procedure consigliate per la visibilità e l'autenticazione. Esplora le funzionalità avanzate per migliorare il flusso di lavoro. Ricorda di concentrarti su sicurezza e collaborazione mentre continui a testare e a creare app migliori.

Checklist di Dev Tunnels di Visual Studio

Checklist rapida per configurare, usare e risolvere i problemi dei Dev Tunnels di Visual Studio.

• Verifica che la versione di Visual Studio supporti Dev Tunnels di Visual Studio (Visual Studio 2022 o versione successiva / carico di lavoro richiesto installato)
• Installa o aggiorna l'estensione dev tunnels o il componente CLI, se necessario
• Accedi con l'account Microsoft o il tenant di Microsoft Entra ID usato per l'accesso ai tunnel
• Crea un nuovo dev tunnel da Visual Studio o tramite la CLI di dev tunnels
• Scegli e conferma il nome e l'area del tunnel corretti per ridurre la latenza
• Seleziona e configura l'endpoint locale (porta) da esporre tramite il tunnel
• Conferma il protocollo (HTTP/HTTPS o TCP) e abilita TLS se esponi HTTPS
• Configura e riserva domini personalizzati o sottodomini, se necessario
• Imposta i criteri di accesso: pubblico, utenti autenticati o utenti/gruppi specifici di Entra ID
• Verifica le impostazioni del firewall e del router per consentire il traffico tunnel in uscita
• Verifica che l'app locale sia in esecuzione e in ascolto sulla porta configurata
• Testa la connettività del tunnel da un dispositivo esterno o da un collaboratore
• Usa HTTPS e certificati validi per gli endpoint con requisiti di sicurezza elevati
• Ruota periodicamente le credenziali e i token; revoca quelli non utilizzati
• Monitora le sessioni e l'utilizzo dei tunnel attivi dalla dashboard di Visual Studio o del portale
• Limita le route esposte e inoltra solo gli endpoint necessari
• Abilita la registrazione e controlla i log dei tunnel per individuare errori di connessione o problemi di prestazioni
• Risolvi i problemi più comuni: conflitti di porta, errori di autenticazione, mancata corrispondenza dell'area
• Aggiorna regolarmente Visual Studio e gli strumenti dei dev tunnel per ottenere le correzioni di sicurezza
• Chiudi o elimina i tunnel inattivi per ridurre la superficie di attacco e l'utilizzo delle risorse

Conclusione

In sintesi, usare i Dev Tunnels di Visual Studio al posto delle tradizionali distribuzioni nel cloud permette agli sviluppatori di accelerare notevolmente i cicli di feedback, ridurre i costi dell'infrastruttura cloud e fare debug in locale con piena fedeltà. Che tu stia creando webhook, app per Teams o API moderne, questa funzionalità integrata elimina gli attriti. Per approfondire questi concetti e vedere una dimostrazione dal vivo, ascolta l'episodio collegato, Test Microsoft 365 Apps with Visual Studio Dev Tunnels.