Acelera tu flujo de trabajo: por qué los túneles de desarrollo de Visual Studio superan al despliegue tradicional
By Mirko Peters ·
¡Bienvenido de nuevo al podcast! Si alguna vez te has encontrado esperando quince minutos a que termine un despliegue en la nube solo para probar un cambio de una sola línea de código, tú…
Automatically translated with AI from the original post. Read the English original
¡Bienvenido de nuevo al podcast! Si alguna vez te has encontrado esperando quince minutos a que termine un despliegue en la nube solo para probar un cambio de una línea de código, sabes lo mucho que lastra tu productividad. Hoy ampliamos un tema que ha transformado por completo la forma en que nuestros equipos de ingeniería abordan las pruebas locales, la depuración y las integraciones. No te pierdas el episodio relacionado, Test Microsoft 365 Apps with Visual Studio Dev Tunnels, donde desglosamos estos flujos de trabajo en acción.
En esta guía completa veremos por qué los métodos de despliegue tradicionales están perdiendo terreno frente a las soluciones de túneles modernas, cómo funcionan los túneles de desarrollo de Visual Studio por dentro y cómo puedes integrarlos sin fricciones en tus proyectos de Microsoft 365, Teams y ASP.NET Core.
Pruebas locales con los túneles de desarrollo de Visual Studio
Por qué importan las pruebas locales
Quieres que tus aplicaciones de Microsoft 365 funcionen perfectamente antes de compartirlas con los usuarios. Las pruebas locales te permiten detectar errores pronto y ver cómo se comporta tu código en un entorno seguro. Cuando pruebas en local, puedes hacer cambios rápidamente y ver los resultados al momento. Este proceso te ahorra tiempo y te ayuda a evitar errores que podrían aparecer en producción.
Las pruebas tradicionales en localhost tienen limitaciones. Tu equipo local no puede aceptar conexiones desde Internet. Esto dificulta probar funciones que requieren acceso en el mundo real, como webhooks, flujos de autenticación o la integración con servicios de Microsoft 365. Puedes quedarte bloqueado, sin poder simular cómo se comportará tu aplicación con usuarios reales.
Dev Tunnels ha revolucionado la forma en que desarrollamos y probamos aplicaciones web, especialmente para los desarrolladores móviles, que a menudo tienen dificultades para configurar servidores locales para las pruebas. Es una función que cambia las reglas del juego, mejora la colaboración y simplifica el proceso de desarrollo.
Con las herramientas adecuadas, puedes superar estos desafíos. Puedes crear un entorno realista para tu aplicación, incluso cuando trabajas desde tu propio equipo.
Cómo los túneles de desarrollo permiten las pruebas locales
Puedes probar aplicaciones de Microsoft 365 desde localhost con los túneles de desarrollo de Visual Studio. Esta herramienta te ofrece una forma segura de exponer tus servicios locales a Internet. No necesitas desplegar tu código en Azure ni en ninguna otra plataforma en la nube solo para ver cómo funciona con Microsoft 365.
Los túneles de desarrollo de Visual Studio mejoran las pruebas tradicionales en localhost al permitirte exponer de forma segura tus aplicaciones locales a Internet. Esta capacidad permite conexiones entrantes, algo esencial para probar aplicaciones de Microsoft 365 en un entorno más realista, superando las limitaciones de las pruebas exclusivamente locales.
Así es como los túneles de desarrollo mejoran la velocidad y la seguridad de tus pruebas locales:
- Los túneles de desarrollo permiten que los servicios locales actúen como endpoints seguros en la nube en menos de 3 minutos.
- Facilitan el acceso seguro a Internet para las pruebas locales de aplicaciones de Microsoft 365.
- Una configuración adecuada es fundamental para evitar exponer el entorno de desarrollo.
Puedes configurar los túneles con solo unos clics o comandos. Eliges el nombre y la visibilidad de tu túnel, así que tú controlas quién puede acceder a tu aplicación. Puedes usar la autenticación para proteger tu trabajo. Esta flexibilidad te permite colaborar con compañeros de equipo o invitar a probadores sin compartir todo tu equipo.
Los túneles de desarrollo te permiten probar funciones como la autenticación OAuth, los bots de Teams o las web parts de SharePoint como si se estuvieran ejecutando en la nube. Obtienes comentarios en tiempo real y puedes depurar los problemas en el momento. Así, tu ciclo de desarrollo es más rápido y fiable.
Cuando usas dev tunnels, ganas confianza en tu código antes de desplegarlo. Sabes que tu aplicación funciona en el mundo real, no solo en tu equipo.
Visión general de Visual Studio Dev Tunnels
Características principales
Visual Studio Dev Tunnels te ofrece una forma potente de probar y depurar aplicaciones de Microsoft 365 desde tu equipo local. Puedes exponer tus servicios de ASP.NET Core a internet en solo unos pasos. Esta herramienta te ayuda a crear un entorno de desarrollo seguro y flexible.
Estas son algunas de las funciones principales que te resultarán útiles:
- Puedes exponer API locales mediante URL remotas, lo que facilita probar y depurar tus proyectos de ASP.NET Core.
- La integración con servicios de terceros resulta sencilla porque tus aplicaciones locales tienen URL de acceso público.
- Puedes definir puntos de interrupción en tu localhost y observar cómo responde tu código de ASP.NET Core cuando se accede a las URL remotas.
- Los túneles con nombre te ayudan a compartir proyectos o servicios específicos sin confusiones.
- Los túneles persistentes te permiten mantener el acceso a lo largo del tiempo, algo importante en proyectos de ASP.NET Core que están en curso.
- Puedes elegir los niveles de acceso de tus túneles: privado, organizativo o público. Así es fácil controlar quién puede ver tu trabajo.
- La autenticación con Entra ID restringe el acceso a usuarios con credenciales válidas, lo que mantiene tus datos a salvo.
- La CLI te permite administrar y automatizar la creación y configuración de túneles. Puedes usar comandos para crear, listar y etiquetar túneles y gestionarlos más fácilmente.
Consejo: los túneles persistentes y con nombre te evitan tener que volver a crearlos cada vez que reinicias tu proyecto de ASP.NET Core. Así ahorras tiempo y reduces errores.
Cómo funcionan los Dev Tunnels
Los dev tunnels crean un puente seguro entre tu servidor local de ASP.NET Core e internet. Puedes probar aplicaciones de Microsoft 365 como si se ejecutaran en un entorno de producción.
Endpoints públicos seguros
Empiezas descargando e instalando la CLI de devtunnel. Tras iniciar sesión con tu cuenta de Entra ID, Microsoft o GitHub, arrancas tu servidor local de ASP.NET Core. Después, alojas o creas un túnel con el comando devtunnel host –p PORT. Si quieres una URL permanente, usas el comando devtunnel create para crear un túnel persistente.
Este proceso te proporciona un endpoint seguro y accesible desde internet para tu servicio local de ASP.NET Core. Ahora puedes probar webhooks, flujos de autenticación e integraciones que requieren URL públicas. La autenticación con Entra ID garantiza que solo los usuarios aprobados puedan acceder a tus túneles, lo que reduce el riesgo de exposición accidental de datos.
Integración con Visual Studio y la CLI
Visual Studio facilita la creación y gestión de dev tunnels. Puedes configurar un túnel con solo unos clics desde el IDE. La CLI ofrece aún más opciones, como túneles de vida fija y etiquetado para una mejor organización. Puedes automatizar la creación de túneles para tus proyectos de ASP.NET Core, lo que hace tu flujo de trabajo más rápido y fiable.
También puedes listar todos tus túneles, ver sus detalles y gestionar los permisos de acceso. Esta flexibilidad te ayuda a colaborar con tu equipo y a mantener tu entorno de desarrollo seguro.
Nota: los dev tunnels están diseñados para exponer de forma segura tus endpoints locales de ASP.NET Core a internet, lo que hace que las pruebas y la depuración sean seguras y eficientes.
Alojar o crear un túnel en Visual Studio
Requisitos previos y configuración
Antes de alojar o crear un túnel para probar aplicaciones de Microsoft 365, debes preparar tu entorno. Visual Studio te proporciona las herramientas necesarias, pero primero debes cumplir algunos requisitos. En la siguiente tabla se indica lo que necesitas para empezar:
| Requisito previo | Descripción |
|---|---|
| Visual Studio 2022 Preview | Descarga la versión 17.6 o posterior. Asegúrate de que la carga de trabajo ASP.NET y desarrollo web esté instalada. Inicia sesión para usar los túneles de desarrollo. |
| Entorno de Power Platform | Necesitas Power Automate o Power Apps. |
Comprueba que tienes la versión correcta de Visual Studio. Abre el instalador y confirma que la carga de trabajo ASP.NET y desarrollo web está activa. Inicia sesión con tu cuenta de Microsoft para acceder a la ventana de herramientas de túneles de desarrollo. Si planeas conectar tu proyecto de asp.net core a Power Platform, asegúrate de tener acceso a Power Automate o Power Apps.
Consejo: Mantener las herramientas actualizadas te ayuda a evitar problemas de configuración y garantiza que puedes usar las últimas funciones de la ventana de herramientas de túneles de desarrollo.
Crear y nombrar un túnel
Puedes crear un túnel directamente desde la ventana de herramientas de túneles de desarrollo de Visual Studio. Este proceso te permite exponer tu servicio asp.net core a Internet para probar la aplicación de Microsoft 365. Sigue estos pasos para crear y nombrar tu túnel:
- En el menú desplegable de depuración, selecciona Dev Tunnels > Create A Tunnel.
- La ventana de herramientas de túneles de desarrollo abre un cuadro de diálogo. Elige la cuenta que quieres usar.
- Escribe un nombre para tu túnel. Este nombre te ayuda a identificarlo en la ventana de herramientas de túneles de desarrollo.
- Elige el tipo de túnel. Selecciona Persistent si quieres la misma URL siempre, o Temporary para obtener una URL nueva en cada sesión.
- Elige el tipo de autenticación: Private, Organization o Public.
- Haz clic en OK para crear el túnel.
Al crear un túnel, facilitas la conexión de tu proyecto asp.net core con los servicios de Microsoft 365. La ventana de herramientas de túneles de desarrollo mantiene tus túneles organizados y visibles. Siempre puedes encontrar tus túneles activos y administrarlos desde esta ventana.
Nota: Asignar un nombre a tu túnel te ayuda a ti y a tu equipo a saber qué servicio asp.net core está expuesto. Usa nombres claros para cada túnel en la ventana de herramientas de túneles de desarrollo.
Configurar la visibilidad del túnel
La visibilidad del túnel controla quién puede acceder a tus túneles de desarrollo. Configuras esta opción en la ventana de herramientas de túneles de desarrollo al crear un túnel. El nivel de visibilidad adecuado protege tu trabajo y favorece la colaboración.
Estas son las principales opciones de visibilidad:
| Opción de visibilidad | Descripción |
|---|---|
| Private | Solo tú puedes acceder al túnel. |
| Organization | Cualquier persona de tu organización puede acceder al túnel. En cuentas personales, equivale a Private. |
| Public | Cualquier persona en Internet puede acceder al túnel. Úsala con precaución. |
También puedes ver estas opciones como:
- Private: solo tú puedes usar el túnel.
- Organization: tu equipo o empresa puede usar el túnel.
- Public: cualquiera puede usar el túnel.
La ventana de herramientas de túneles de desarrollo te permite cambiar la visibilidad al crear y administrar túneles. Elegir la visibilidad adecuada te ayuda a supervisar el tráfico y a mantener segura tu aplicación de Microsoft 365. Los túneles privados funcionan mejor para el desarrollo en solitario. Los túneles de organización ayudan a los equipos a probar juntos. Los túneles públicos permiten probar con usuarios externos, pero requieren más cuidado.
Precaución: Los túneles públicos no requieren autenticación. Úsalos solo cuando necesites compartir tu aplicación con usuarios fuera de tu organización y supervisa siempre el acceso desde la ventana de herramientas de túneles de desarrollo.
La visibilidad del túnel afecta tanto a la seguridad como a la colaboración. Cuando eliges el nivel adecuado, aseguras que solo las personas correctas puedan acceder a tu aplicación. Esto reduce el riesgo y ayuda a tu equipo a trabajar juntos sin problemas.
Usar la CLI de Dev Tunnels
Puedes administrar los túneles de desarrollo directamente desde la línea de comandos con la CLI de Dev Tunnels. Esta herramienta ofrece flexibilidad y rapidez, sobre todo cuando quieres automatizar tu flujo de trabajo o trabajar fuera de la interfaz de Visual Studio. La CLI funciona bien tanto para pruebas rápidas como para configuraciones más avanzadas.
Para empezar, necesitas instalar la CLI de Dev Tunnels. Puedes hacerlo ejecutando el siguiente comando en tu terminal:
dotnet tool install -g Microsoft.DevTunnels.CliDespués de la instalación, debes iniciar sesión. Usa tu cuenta de Microsoft, Entra ID o tu cuenta de GitHub. Este paso conecta tu sesión de la CLI con tu entorno de Visual Studio y garantiza un acceso seguro.
devtunnel loginUna vez que inicies sesión, puedes crear y administrar túneles. Esta es una forma sencilla de crear un túnel para tu proyecto local:
devtunnel host -p 5000Este comando expone tu servicio local que se ejecuta en el puerto 5000 a Internet. La CLI mostrará una URL pública que puedes usar para probar tu aplicación de Microsoft 365. Puedes compartir esta URL con tu equipo o usarla para pruebas de integración.
Si quieres un túnel persistente con un nombre personalizado, usa:
devtunnel create my-tunnel --persistent
devtunnel host my-tunnel -p 5000Este enfoque te ayuda a mantener la misma URL entre sesiones, lo que es importante para los URI de redireccionamiento de OAuth y para realizar pruebas coherentes. También puedes definir la visibilidad del túnel directamente desde la CLI. Por ejemplo, para que tu túnel solo sea accesible para tu organización, añade la marca --access organization:
devtunnel create my-tunnel --persistent --access organizationConsejo: usa nombres claros y descriptivos para tus túneles. Así será más fácil gestionar varios proyectos en Visual Studio y evitar confusiones.
Puedes consultar en cualquier momento la lista de todos tus túneles activos:
devtunnel listPara detener un túnel, usa:
devtunnel close my-tunnelLa CLI también te permite automatizar la creación de túneles en scripts. Esta función resulta útil cuando quieres configurar túneles de desarrollo como parte de tu proceso de compilación o de implementación. Puedes compartir los comandos de la CLI con tu equipo para que todos usen la misma configuración, lo que mejora la coherencia y reduce los errores.
Nota: Dev Tunnels CLI funciona perfectamente con Visual Studio. Puedes alternar entre la CLI y la interfaz de Visual Studio sin perder la configuración de tus túneles.
Al dominar Dev Tunnels CLI, ganas más control sobre tu entorno de desarrollo. Puedes crear, gestionar y proteger túneles con rapidez para cualquier proyecto de Microsoft 365 App. Esta flexibilidad te ayuda a probar y depurar tus aplicaciones de forma eficiente, tanto si trabajas solo como si formas parte de un equipo.
Configurar aplicaciones de Microsoft 365 para Dev Tunnels

Actualizar el registro de aplicaciones y los URI de redireccionamiento
Necesitas actualizar el registro de la aplicación y los URI de redireccionamiento para conectar tu proyecto local de ASP.NET Core con los servicios de Microsoft 365 a través de Visual Studio. Este proceso permite que tu aplicación use el punto de conexión seguro que proporcionan los túneles de desarrollo. Esta es una forma sencilla de configurar el registro de la aplicación:
- Abre el portal de Microsoft Entra ID: Registros de aplicaciones.
- Selecciona "Nuevo registro" e introduce el nombre de tu aplicación.
- Elige los tipos de cuenta compatibles con tu aplicación.
- Deja el campo URI de redireccionamiento vacío por ahora.
- Haz clic en "Registrar" para crear tu aplicación.
- En la página de información general, copia el Id. de aplicación (cliente) y el Id. de directorio (inquilino).
- En "Administrar", selecciona "Exponer una API".
- Haz clic en el vínculo "Establecer" para generar el URI de identificador de aplicación.
- Agrega un ámbito llamado "access_as_user".
- Establece "¿Quién puede dar su consentimiento?" en "Administradores y usuarios".
- Completa los mensajes de consentimiento de administrador y de usuario.
- Asegúrate de que el estado esté en "Habilitado".
- Selecciona "Agregar ámbito" para terminar.
Después de crear el túnel en Visual Studio, debes actualizar el URI de redireccionamiento en el registro de la aplicación. Usa la URL pública de tu túnel de ASP.NET Core como URI de redireccionamiento. Este paso permite a Microsoft 365 saber a dónde enviar las respuestas de autenticación durante las pruebas.
Consejo: guarda siempre tu Id. de cliente y tu Id. de inquilino. Los necesitarás para la autenticación y la configuración de OAuth.
Conectar aplicaciones de Teams, SharePoint y Power Platform
Puedes usar Visual Studio para conectar tus servicios de ASP.NET Core con Teams, SharePoint y aplicaciones de Power Platform. Los túneles de desarrollo hacen que este proceso sea seguro y sencillo. Cuando usas túneles, recibes alertas si te conectas a un punto de conexión de túnel. Estas alertas te ayudan a evitar ataques de phishing y el uso compartido accidental de URL sensibles.
- Los bots de Teams y las extensiones de mensajes usan túneles de desarrollo de forma predeterminada para el desarrollo local. Esta configuración te ofrece una forma segura de probar las funciones antes de implementarlas.
- Las web parts de SharePoint y los conectores de Power Platform también se benefician de los puntos de conexión seguros. Puedes probar webhooks, autenticación y flujos de datos en un escenario real.
- La autenticación de identidad de Microsoft 365 añade otra capa de seguridad. Debes iniciar sesión con tu cuenta de Microsoft 365 para crear y administrar túneles en Visual Studio.
Nota: la concienciación sobre seguridad te ayuda a ti y a tu equipo a mantenerse a salvo mientras prueban tus aplicaciones de ASP.NET Core.
Gestionar la autenticación y OAuth
Debes configurar la autenticación y OAuth para que tus aplicaciones de Microsoft 365 funcionen con los túneles de desarrollo. Esta es una guía paso a paso:
- Registra tu aplicación en el portal de Microsoft Entra ID.
- Establece el URI de la aplicación para que coincida con el punto de conexión del túnel de Visual Studio.
- Crea un secreto de cliente para el intercambio de tokens.
- Agrega permisos de API para el acceso a Microsoft Graph.
- Actualiza los URI de redireccionamiento para usar la URL de tu túnel de ASP.NET Core.
- Configura túneles de desarrollo para alojar tu servicio local.
- Clona el repositorio de tu proyecto y actualiza los archivos de configuración con tu ID de cliente, ID de inquilino y secreto.
- Abre Visual Studio y ejecuta tu proyecto de ASP.NET Core.
Esta configuración permite que tu aplicación gestione el inicio de sesión, el intercambio de tokens y las llamadas a la API de forma segura. Puedes probar flujos de autenticación, como OAuth, en un entorno seguro antes de pasar a producción.
Revisa siempre dos veces tus URI de redirección y tus permisos. Este paso evita errores de autenticación habituales y mantiene tus pruebas seguras.
Seguridad y buenas prácticas
Opciones de visibilidad de los túneles
Tú controlas quién puede acceder a tu entorno de desarrollo mediante la visibilidad del túnel. Al crear un túnel, eliges entre acceso privado, de organización o público. Los túneles privados permiten conectarse solo a ti. Los túneles de organización permiten usarlos a cualquier persona de tu empresa. Los túneles públicos abren el acceso a cualquiera que tenga el enlace. Elige siempre la visibilidad más restrictiva que necesite tu proyecto.
Para maximizar la seguridad durante las pruebas de la aplicación de Microsoft 365, sigue estas buenas prácticas:
- Configura los túneles como privados o de organización siempre que sea posible.
- Implementa split tunneling para las aplicaciones de Office 365. Este método mejora el rendimiento y mantiene tus datos seguros.
- Usa los intervalos de direcciones IP proporcionados por Microsoft para el split tunneling. Evita usar nombres de dominio completos.
- Desactiva la interceptación SSL para el tráfico de Office 365. Este paso te ayuda a cumplir las recomendaciones de seguridad de Microsoft.
- Confirma que tu directiva de split tunneling funciona utilizando la herramienta de prueba de conectividad de Microsoft 365.
- Desactiva SSL Break and Inspect para los dominios de Office 365.
Consejo: Revisa la configuración de visibilidad de tus túneles antes de compartir cualquier URL. Este hábito ayuda a evitar la exposición accidental de tu entorno de desarrollo.
Acceso seguro con Entra ID
Puedes proteger tus túneles exigiendo autenticación con Entra ID. Esta función garantiza que solo los usuarios aprobados puedan acceder a tus servicios locales. Cuando habilitas la autenticación de Entra ID, añades una capa sólida de protección a tus túneles de desarrollo. Solo pueden conectarse los usuarios con credenciales válidas, lo que ayuda a mantener tus datos seguros.
Entra ID también admite el acceso de organización. Puedes permitir que todo tu equipo pruebe y depure las aplicaciones sin abrir tu túnel al público. Este enfoque equilibra seguridad y colaboración. Utiliza siempre la autenticación de Entra ID en proyectos sensibles o cuando manejes información confidencial.
Nota: La autenticación de Entra ID funciona sin problemas tanto con la interfaz de Visual Studio como con las herramientas de línea de comandos.
Supervisión y gestión de túneles
Necesitas supervisar y gestionar tus túneles para mantener un flujo de trabajo seguro y eficiente. Visual Studio incluye funciones integradas para gestionar los túneles de desarrollo. Puedes ver los túneles activos, comprobar su estado y ajustar la configuración de acceso desde el propio IDE. La interfaz de línea de comandos también te permite crear, enumerar y cerrar túneles con rapidez.
Las buenas prácticas para gestionar los túneles incluyen:
- Revisa periódicamente la lista de túneles activos.
- Cierra los túneles cuando termines las pruebas para reducir los riesgos de seguridad.
- Usa nombres descriptivos para cada túnel y evitar confusiones.
- Elige entre túneles temporales o permanentes según las necesidades de tu proyecto.
- Configura los controles de acceso según tus requisitos de seguridad.
Una tabla puede ayudarte a comparar las opciones de gestión de túneles:
| Herramienta de gestión | Funciones |
|---|---|
| IDE de Visual Studio | Ver, crear, editar y cerrar túneles |
| Línea de comandos (CLI) | Automatizar la creación y gestión de túneles |
Recuerda: una buena gestión de túneles mantiene tu entorno de desarrollo organizado y seguro.
Errores comunes que debes evitar
Cuando usas Visual Studio Dev Tunnels para probar aplicaciones de Microsoft 365, conviene evitar errores que pueden ralentizarte o poner en riesgo tu proyecto. Muchos desarrolladores tropiezan con los mismos problemas. Si sabes qué vigilar, puedes ahorrar tiempo y mantener tu entorno seguro.
1. Elegir una visibilidad de túnel incorrecta
Puede que elijas un túnel público por comodidad. Esta elección puede exponer tu aplicación a cualquiera que tenga el enlace. Comprueba siempre la visibilidad de tu túnel antes de empezar las pruebas. Para la mayoría de los proyectos, usa túneles privados o de la organización. Usa túneles públicos solo cuando necesites probadores externos y supervisa siempre el acceso.
Consejo: Revisa la configuración de tu túnel antes de compartir las URL con tu equipo o con los probadores.
2. Olvidar actualizar los URI de redirección
Si cambias la URL de tu túnel, debes actualizar los URI de redirección en el registro de tu aplicación. Si omites este paso, la autenticación fallará. Comprueba siempre que el registro de tu aplicación coincide con el endpoint actual de tu túnel.
3. Ignorar la configuración de autenticación
Puede que olvides habilitar la autenticación de Entra ID para tu túnel. Sin ella, cualquiera que tenga el enlace puede acceder a tu servicio local. Exige siempre autenticación en los proyectos sensibles. Este paso protege tus datos y a tus usuarios.
4. Dejar los túneles abiertos después de las pruebas
Si dejas los túneles en ejecución cuando terminas, aumentas el riesgo para la seguridad. Los túneles sin uso pueden convertirse en objetivos de accesos no deseados. Cierra siempre los túneles cuando ya no los necesites.
5. Usar nombres de túnel genéricos o confusos
Si usas nombres poco claros para tus túneles, tú y tu equipo podéis confundiros. Usa nombres descriptivos que coincidan con tu proyecto o servicio. Este hábito te ayuda a gestionar varios túneles y a evitar errores.
6. Pasar por alto la supervisión de registros
Puede que no revises los registros de tu túnel. Los registros te ayudan a detectar actividad inusual o accesos no autorizados. Haz del hábito revisarlos con regularidad.
| Problema | Cómo evitarlo |
|---|---|
| Túnel público para una aplicación privada | Configura el túnel como privado o de la organización |
| URI de redirección desactualizado | Actualiza el registro de la aplicación tras los cambios en el túnel |
| Sin autenticación | Habilita la autenticación de Entra ID |
| Túneles sin cerrar | Cierra los túneles después de las pruebas |
| Nombres de túnel poco claros | Usa nombres claros y descriptivos |
| Ignorar los registros | Supervisa los registros por si hay actividad sospechosa |
Nota: Puedes evitar la mayoría de los problemas siguiendo una lista de comprobación antes y después de cada sesión de pruebas.
Si estás atento a estos errores habituales, mantendrás tu proceso de desarrollo fluido y tus aplicaciones de Microsoft 365 seguras. Adquirirás mejores hábitos y ayudarás a tu equipo a evitar problemas innecesarios.
Solución de problemas y consejos avanzados
Diagnóstico de problemas de conexión
Puede que a veces tengas problemas de conexión al trabajar con túneles. Empieza comprobando si tu servicio local se está ejecutando y escucha en el puerto correcto. Usa la línea de comandos para confirmar que tu servicio responde a las solicitudes. Si aparecen errores, reinicia el servicio e inténtalo de nuevo.
A continuación, revisa la configuración del firewall. Los firewalls pueden bloquear las conexiones entrantes. Permite el tráfico en el puerto que usas para el túnel. Si usas una VPN, desconéctala y vuelve a probar. Las VPN pueden modificar la configuración de red y causar problemas.
Si sigues teniendo problemas, usa el comando devtunnel list para ver todos los túneles activos. Asegúrate de usar la URL correcta del túnel en tu aplicación de Microsoft 365. A veces, copiar la URL incorrecta provoca fallos de conexión.
Consejo: Prueba siempre la URL de tu túnel en un navegador antes de empezar las pruebas y la depuración. Este paso te ayuda a detectar errores sencillos desde el principio.
Gestión de errores de autenticación
Los errores de autenticación pueden impedir que tu aplicación funcione con los servicios de Microsoft 365. Primero, revisa el registro de tu aplicación en el portal de Microsoft Entra ID. Asegúrate de que los URI de redirección coinciden exactamente con la URL del túnel. Incluso un pequeño error tipográfico puede causar fallos.
Revisa tu id. de cliente y tu secreto. Estos valores deben coincidir con los que configuraste en la configuración de tu aplicación. Si cambias de túnel o creas uno nuevo, actualiza los URI de redirección en el registro de tu aplicación.
Si aparece el mensaje «unauthorized», comprueba la visibilidad y la configuración de autenticación de tu túnel. En los proyectos sensibles, usa siempre la autenticación de Entra ID. Este paso mantiene tus datos seguros y evita accesos no deseados.
Nota: La mayoría de los errores de autenticación se deben a URL que no coinciden o a permisos que faltan. Revisa estos ajustes con atención durante la depuración.
CLI avanzada y automatización
Puedes usar la CLI de Dev Tunnels para automatizar tu flujo de trabajo. La automatización ahorra tiempo y reduce errores. Por ejemplo, puedes escribir un script que cree un túnel, inicie tu servicio local y abra la página de pruebas en el navegador.
Este es un script de ejemplo para 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"Puedes compartir scripts como este con tu equipo. Todos pueden usar la misma configuración para pruebas y depuración. Este enfoque facilita el trabajo en equipo y evita errores de configuración.
Si quieres cerrar todos los túneles a la vez, usa:
devtunnel close --allAutomatizar la gestión de túneles hace que tu proceso de desarrollo sea más fluido y fiable. Prueba a usar scripts para las tareas repetitivas.
Puedes impulsar el desarrollo de tus aplicaciones de Microsoft 365 usando dev tunnels de Visual Studio. Esta herramienta hace que las pruebas sean más rápidas y seguras. Empieza configurando tu primer túnel y sigue las prácticas recomendadas en cuanto a visibilidad y autenticación. Explora las funciones avanzadas para mejorar tu flujo de trabajo. Recuerda centrarte en la seguridad y el trabajo en equipo mientras sigues probando y creando mejores aplicaciones.
Lista de verificación de Dev Tunnels de Visual Studio
Lista de verificación rápida para configurar, usar y solucionar problemas de Dev Tunnels de Visual Studio.
- Verifica que tu versión de Visual Studio admita Dev Tunnels de Visual Studio (Visual Studio 2022 o posterior, con la carga de trabajo necesaria instalada)
- Instala o actualiza la extensión o el componente de CLI dev tunnels si es necesario
- Inicia sesión con tu cuenta de Microsoft o con el inquilino de Microsoft Entra ID (AAD) que uses para acceder a los túneles
- Crea un nuevo dev tunnel desde Visual Studio o mediante la CLI de dev tunnels
- Elige y confirma el nombre y la región correctos del túnel para obtener baja latencia
- Selecciona y configura el extremo local (puerto) que quieres exponer a través del túnel
- Confirma el protocolo (HTTP/HTTPS o TCP) y habilita TLS si expones HTTPS
- Configura y reserva dominios personalizados o subdominios si los necesitas
- Define las directivas de acceso: público, usuarios autenticados o usuarios/grupos específicos de AAD
- Valida la configuración del firewall y del router para permitir el tráfico de salida del túnel
- Verifica que la aplicación local se está ejecutando y escuchando en el puerto configurado
- Prueba la conectividad del túnel desde un dispositivo externo o desde un colaborador
- Usa HTTPS y certificados válidos en los extremos sensibles de producción
- Rota las credenciales y los tokens periódicamente y revoca los tokens que no uses
- Supervisa las sesiones de túnel activas y su uso desde Visual Studio o el panel del portal
- Limita las rutas expuestas y reenvía solo los extremos necesarios
- Habilita el registro y revisa los registros del túnel por si hay errores de conexión o problemas de rendimiento
- Soluciona los problemas habituales: conflictos de puertos, errores de autenticación y discrepancias de región
- Actualiza Visual Studio y las herramientas de dev tunnels con regularidad para aplicar las correcciones de seguridad
- Cierra o elimina los túneles inactivos para reducir la superficie de ataque y el uso de recursos
Conclusión
En resumen, aprovechar Dev Tunnels de Visual Studio en lugar de los despliegues tradicionales en la nube permite a los desarrolladores acelerar drásticamente los ciclos de retroalimentación, reducir los costes de infraestructura en la nube y depurar en local con total fidelidad. Tanto si estás creando webhooks, aplicaciones de Teams o APIs modernas, esta función integrada elimina fricciones. Para profundizar en estos conceptos y ver una demostración en vivo, no dejes de escuchar el episodio relacionado, Test Microsoft 365 Apps with Visual Studio Dev Tunnels.