Acelere o seu fluxo de trabalho: por que os Dev Tunnels do Visual Studio superam a implantação tradicional

By Mirko Peters · 2026-08-12

Bem-vindo de volta ao podcast! Se você já ficou esperando quinze minutos por uma implantação na nuvem terminar só para testar uma única linha de código alterada, você...

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

Bem-vindo de volta ao podcast! Se você já ficou esperando quinze minutos por uma implantação na nuvem terminar só para testar uma única linha de código alterada, sabe o quanto isso drena a sua produtividade. Hoje, vamos aprofundar um tema que transformou completamente a forma como as nossas equipes de engenharia lidam com testes locais, depuração e integrações. Não deixe de conferir o episódio relacionado do podcast, Test Microsoft 365 Apps with Visual Studio Dev Tunnels, em que detalhamos esses fluxos de trabalho na prática.

Neste guia completo, vamos explorar por que os métodos tradicionais de implantação estão perdendo espaço para soluções modernas de túnel, como os Dev Tunnels do Visual Studio funcionam por dentro e como você pode integrá-los de forma transparente aos seus projetos de Microsoft 365, Teams e ASP.NET Core.

Testes locais com os Dev Tunnels do Visual Studio

Por que os testes locais são importantes

Você quer que os seus aplicativos do Microsoft 365 funcionem perfeitamente antes de compartilhá-los com os usuários. Os testes locais permitem identificar bugs cedo e ver como o seu código se comporta em um ambiente seguro. Quando você testa localmente, pode fazer alterações rapidamente e ver os resultados na hora. Esse processo economiza tempo e ajuda a evitar erros que poderiam aparecer em produção.

Os testes tradicionais em localhost têm limitações. A sua máquina local não consegue aceitar conexões vindas da internet. Isso dificulta testar recursos que precisam de acesso do mundo real, como webhooks, fluxos de autenticação ou integrações com serviços do Microsoft 365. Você pode acabar travado, sem conseguir simular como o seu aplicativo vai se comportar para os usuários reais.

Os Dev Tunnels revolucionaram a forma como desenvolvemos e testamos aplicações web, especialmente para desenvolvedores mobile, que muitas vezes enfrentam dificuldades para configurar servidores locais para testes. É um recurso que muda o jogo e que melhora a colaboração e simplifica o processo de desenvolvimento.

Com as ferramentas certas, você consegue superar esses desafios. É possível criar um ambiente realista para o seu aplicativo, mesmo trabalhando a partir do seu próprio computador.

Como os Dev Tunnels viabilizam os testes locais

Você pode testar aplicativos do Microsoft 365 a partir do localhost usando os Dev Tunnels do Visual Studio. Essa ferramenta oferece uma forma segura de expor os seus serviços locais à internet. Você não precisa implantar o seu código no Azure ou em qualquer outra plataforma de nuvem só para ver como ele funciona com o Microsoft 365.

Os Dev Tunnels do Visual Studio aprimoram os testes tradicionais em localhost ao permitir que você exponha com segurança os seus aplicativos locais à internet. Essa capacidade possibilita conexões de entrada, o que é essencial para testar aplicativos do Microsoft 365 em um ambiente mais realista, superando as limitações de ficar restrito aos testes locais.

Veja como os dev tunnels melhoram a velocidade e a segurança dos seus testes locais:

• Os dev tunnels permitem que serviços locais atuem como endpoints de nuvem seguros em menos de 3 minutos.
• Eles facilitam o acesso seguro à internet para testes locais de aplicativos do Microsoft 365.
• Uma configuração adequada é fundamental para evitar a exposição do ambiente de desenvolvimento.

Você pode configurar túneis com apenas alguns cliques ou comandos. Você escolhe o nome e a visibilidade do túnel, então controla quem pode acessar o seu aplicativo. Você pode usar autenticação para manter o seu trabalho protegido. Essa flexibilidade permite colaborar com colegas de equipe ou convidar testadores sem compartilhar o seu computador inteiro.

Os dev tunnels permitem testar recursos como autenticação OAuth, bots do Teams ou web parts do SharePoint como se estivessem rodando na nuvem. Você recebe feedback em tempo real e pode depurar problemas na hora. Esse processo torna o seu ciclo de desenvolvimento mais rápido e confiável.

Quando você usa dev tunnels, ganha confiança no seu código antes de fazer o deploy. Você sabe que o app funciona no mundo real, e não apenas na sua máquina.

Visão geral de Dev Tunnels no Visual Studio

Principais recursos

Os dev tunnels do Visual Studio oferecem uma forma poderosa de testar e depurar Apps do Microsoft 365 a partir da sua máquina local. Você pode expor os seus serviços asp.net core à internet com poucos passos. Essa ferramenta ajuda você a criar um ambiente de desenvolvimento seguro e flexível.

Estes são os principais recursos que você vai considerar úteis:

• Você pode expor APIs locais usando URLs remotas, o que facilita testar e depurar seus projetos asp.net core.
• A integração com serviços de terceiros fica simples, porque seus apps locais passam a ter URLs acessíveis publicamente.
• Você pode definir breakpoints no seu localhost e acompanhar como o código asp.net core responde quando URLs remotas são acessadas.
• Named tunnels ajudam você a compartilhar projetos ou serviços específicos sem confusão.
• Persistent tunnels permitem manter o acesso ao longo do tempo, o que é importante para projetos asp.net core em andamento.
• Você pode escolher os níveis de acesso dos seus tunnels: privado, organizacional ou público. Isso facilita controlar quem pode ver o seu trabalho.
• A autenticação do Entra ID restringe o acesso a usuários com credenciais válidas, mantendo seus dados protegidos.
• A CLI permite gerenciar e automatizar a criação e a configuração de tunnels. Você pode usar comandos para criar, listar e marcar tunnels e facilitar a gestão.

Dica: Persistent e named tunnels evitam que você precise recriar os tunnels toda vez que reiniciar o projeto asp.net core. Isso economiza tempo e reduz erros.

Como funcionam os Dev Tunnels

Os dev tunnels criam uma ponte segura entre o seu servidor asp.net core local e a internet. Você pode testar os Apps do Microsoft 365 como se estivessem rodando em um ambiente de produção.

Endpoints públicos seguros

Você começa baixando e instalando a CLI devtunnel. Depois de fazer login com sua conta do Entra ID, Microsoft ou GitHub, você inicia o servidor asp.net core local. Em seguida, hospeda ou cria um tunnel usando o comando devtunnel host –p PORT. Se quiser uma URL permanente, use o comando devtunnel create para criar um persistent tunnel.

Esse processo oferece um endpoint seguro, acessível pela internet, para o seu serviço asp.net core local. Agora você pode testar webhooks, fluxos de autenticação e integrações que exigem URLs públicas. A autenticação do Entra ID garante que apenas usuários aprovados acessem os seus tunnels, reduzindo o risco de exposição acidental de dados.

Integração com o Visual Studio e a CLI

O Visual Studio facilita a criação e o gerenciamento de dev tunnels. Você pode configurar um tunnel com poucos cliques dentro da IDE. A CLI oferece ainda mais opções, como tunnels de vida útil fixa e marcações (tags) para melhor organização. Você pode automatizar a criação de tunnels para os seus projetos asp.net core, tornando o fluxo de trabalho mais rápido e confiável.

Você também pode listar todos os seus tunnels, ver detalhes e gerenciar permissões de acesso. Essa flexibilidade ajuda você a colaborar com a sua equipe e manter o ambiente de desenvolvimento seguro.

Observação: os dev tunnels são projetados para expor com segurança os seus endpoints asp.net core locais à internet, tornando os testes e a depuração seguros e eficientes.

Hospedar ou criar um tunnel no Visual Studio

Pré-requisitos e configuração

Antes de hospedar ou criar um tunnel para testar Apps do Microsoft 365, você precisa preparar o seu ambiente. O Visual Studio oferece as ferramentas necessárias, mas antes você deve atender a alguns requisitos. A tabela a seguir mostra o que você precisa para começar:

Você deve verificar se tem a versão correta do Visual Studio. Abra o instalador e confirme que a carga de trabalho ASP.NET e desenvolvimento web está ativa. Entre com a sua conta Microsoft para acessar a janela de ferramenta dos túneis de desenvolvimento. Se você pretende conectar seu projeto ASP.NET Core ao Power Platform, certifique-se de ter acesso ao Power Automate ou ao Power Apps.

Dica: manter suas ferramentas atualizadas ajuda a evitar problemas de configuração e garante que você possa usar os recursos mais recentes na janela de ferramenta dos túneis de desenvolvimento.

Criando e nomeando um túnel

Você pode criar um túnel diretamente na janela de ferramenta dos túneis de desenvolvimento no Visual Studio. Esse processo permite expor seu serviço ASP.NET Core na internet para testes do aplicativo do Microsoft 365. Siga estas etapas para criar e nomear seu túnel:

1. No menu suspenso Depurar, selecione Túneis de Desenvolvimento > Criar um Túnel.
2. A janela de ferramenta dos túneis de desenvolvimento abre uma caixa de diálogo. Escolha a conta que você deseja usar.
3. Digite um nome para o seu túnel. Esse nome ajuda você a identificá-lo na janela de ferramenta dos túneis de desenvolvimento.
4. Escolha o tipo de túnel. Selecione Persistente se quiser o mesmo URL sempre, ou Temporário para um novo URL a cada sessão.
5. Escolha o tipo de autenticação: Privado, Organização ou Público.
6. Clique em OK para criar o túnel.

Ao criar um túnel, você facilita a conexão do seu projeto ASP.NET Core aos serviços do Microsoft 365. A janela de ferramenta dos túneis de desenvolvimento mantém seus túneis organizados e visíveis. Você sempre pode encontrar seus túneis ativos e gerenciá-los a partir dessa janela.

Observação: nomear seu túnel ajuda você e sua equipe a acompanhar qual serviço ASP.NET Core está exposto. Use nomes claros para cada túnel na janela de ferramenta dos túneis de desenvolvimento.

Definindo a visibilidade do túnel

A visibilidade do túnel controla quem pode acessar seus túneis de desenvolvimento. Você define essa opção na janela de ferramenta dos túneis de desenvolvimento ao criar um túnel. O nível de visibilidade adequado protege seu trabalho e favorece a colaboração.

Estas são as principais opções de visibilidade:

Você também pode ver essas opções como:

• Privado: somente você pode usar o túnel.
• Organização: sua equipe ou empresa pode usar o túnel.
• Público: qualquer pessoa pode usar o túnel.

A janela de ferramenta dos túneis de desenvolvimento permite alterar a visibilidade ao criar e gerenciar túneis de desenvolvimento. Escolher a visibilidade certa ajuda você a monitorar o tráfego e manter seu aplicativo do Microsoft 365 seguro. Túneis privados funcionam melhor para desenvolvimento individual. Túneis de organização ajudam equipes a testar juntas. Túneis públicos permitem testadores externos, mas exigem cuidado extra.

Atenção: túneis públicos não exigem autenticação. Use-os somente quando precisar compartilhar seu aplicativo com usuários fora da sua organização e monitore sempre o acesso na janela de ferramenta dos túneis de desenvolvimento.

A visibilidade do túnel afeta tanto a segurança quanto a colaboração. Quando você define o nível certo, garante que somente as pessoas certas possam acessar seu aplicativo. Isso reduz riscos e ajuda sua equipe a trabalhar em conjunto sem atritos.

Usando a CLI dos túneis de desenvolvimento

Você pode gerenciar túneis de desenvolvimento diretamente pela linha de comando usando a CLI dos túneis de desenvolvimento. Essa ferramenta oferece flexibilidade e agilidade, especialmente quando você quer automatizar seu fluxo de trabalho ou trabalhar fora da interface do Visual Studio. A CLI funciona bem tanto para testes rápidos quanto para configurações mais avançadas.

Para começar, você precisa instalar a CLI dos túneis de desenvolvimento. Você pode fazer isso executando o seguinte comando no terminal:

dotnet tool install -g Microsoft.DevTunnels.Cli

Após a instalação, você precisa entrar. Use sua conta Microsoft, Entra ID ou conta do GitHub. Essa etapa conecta sua sessão da CLI ao ambiente do Visual Studio e garante acesso seguro.

devtunnel login

Depois de entrar, você pode criar e gerenciar túneis. Veja uma forma simples de criar um túnel para o seu projeto local:

devtunnel host -p 5000

Este comando expõe seu serviço local em execução na porta 5000 para a internet. A CLI exibirá um URL público que você pode usar para testar seu aplicativo do Microsoft 365. Você pode compartilhar esse URL com sua equipe ou usá-lo para testes de integração.

Se você quiser um túnel persistente com um nome personalizado, use:

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

Essa abordagem ajuda você a manter a mesma URL entre as sessões, o que é importante para URIs de redirecionamento do OAuth e para testes consistentes. Você também pode definir a visibilidade do túnel diretamente pela CLI. Por exemplo, para tornar seu túnel acessível apenas à sua organização, adicione a flag --access organization:

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

Dica: use nomes claros e descritivos para os seus túneis. Isso facilita o gerenciamento de vários projetos no Visual Studio e evita confusão.

Você pode listar todos os seus túneis ativos a qualquer momento:

devtunnel list

Para interromper um túnel, use:

devtunnel close my-tunnel

A CLI também permite automatizar a criação de túneis em scripts. Esse recurso é útil quando você quer configurar dev tunnels como parte do seu processo de build ou de implantação. Você pode compartilhar os comandos da CLI com a sua equipe para que todos usem a mesma configuração, o que melhora a consistência e reduz erros.

Observação: a CLI do Dev Tunnels funciona perfeitamente com o Visual Studio. Você pode alternar entre a CLI e a interface do Visual Studio sem perder as configurações do seu túnel.

Ao dominar a CLI do Dev Tunnels, você ganha mais controle sobre o seu ambiente de desenvolvimento. Você pode criar, gerenciar e proteger túneis rapidamente para qualquer projeto de aplicativo do Microsoft 365. Essa flexibilidade ajuda você a testar e depurar seus aplicativos com eficiência, seja trabalhando sozinho ou em equipe.

Configurar aplicativos do Microsoft 365 para Dev Tunnels

Atualizar o registro do aplicativo e os URIs de redirecionamento

Você precisa atualizar o registro do seu aplicativo e os URIs de redirecionamento para conectar seu projeto local do ASP.NET Core aos serviços do Microsoft 365 pelo Visual Studio. Esse processo faz com que seu aplicativo use o endpoint seguro fornecido pelo dev tunnels. Veja uma forma simples de configurar o registro do aplicativo:

1. Abra o portal Microsoft Entra ID – Registros de aplicativo.
2. Selecione "Novo registro" e informe o nome do seu aplicativo.
3. Escolha os tipos de conta com suporte para o seu aplicativo.
4. Deixe o campo URI de redirecionamento vazio por enquanto.
5. Clique em "Registrar" para criar seu aplicativo.
6. Na página de visão geral, copie o ID do Aplicativo (cliente) e o ID do Diretório (locatário).
7. Em "Gerenciar", selecione "Expor uma API".
8. Clique no link "Definir" para gerar o URI de ID do Aplicativo.
9. Adicione um escopo chamado "access_as_user".
10. Defina "Quem pode consentir?" como "Administradores e usuários".
11. Preencha os prompts de consentimento de administrador e de usuário.
12. Verifique se o estado está definido como "Habilitado".
13. Selecione "Adicionar escopo" para concluir.

Depois de criar seu túnel no Visual Studio, você precisa atualizar o URI de redirecionamento no registro do aplicativo. Use a URL pública do seu túnel do ASP.NET Core como URI de redirecionamento. Essa etapa informa ao Microsoft 365 para onde enviar as respostas de autenticação durante os testes.

Dica: sempre salve o seu ID de cliente e o ID de locatário. Você vai precisar deles para a autenticação e a configuração do OAuth.

Conectar Teams, SharePoint e aplicativos do Power Platform

Você pode usar o Visual Studio para conectar seus serviços do ASP.NET Core ao Teams, ao SharePoint e aos aplicativos do Power Platform. Os dev tunnels tornam esse processo seguro e simples. Ao usar túneis, você recebe alertas se conectar a um endpoint de túnel. Esses alertas ajudam você a evitar ataques de phishing e o compartilhamento acidental de URLs sensíveis.

• Bots do Teams e extensões de mensagem usam dev tunnels por padrão para desenvolvimento local. Essa configuração oferece uma forma segura de testar os recursos antes de implantá-los.
• Web parts do SharePoint e conectores do Power Platform também se beneficiam de endpoints seguros. Você pode testar webhooks, autenticação e fluxos de dados em um cenário real.
• A autenticação de identidade do Microsoft 365 adiciona mais uma camada de segurança. Você precisa entrar com a sua conta do Microsoft 365 para criar e gerenciar túneis no Visual Studio.

Observação: a conscientização sobre segurança reforçada ajuda você e sua equipe a se manterem protegidos ao testar seus aplicativos ASP.NET Core.

Gerenciar autenticação e OAuth

Você precisa configurar a autenticação e o OAuth para que seus aplicativos do Microsoft 365 funcionem com dev tunnels. Veja um guia passo a passo:

1. Registre seu aplicativo no portal Microsoft Entra ID.
2. Defina o URI do aplicativo para corresponder ao endpoint do túnel no Visual Studio.
3. Crie um segredo de cliente para a troca de tokens.
4. Adicione permissões de API para acesso ao Microsoft Graph.
5. Atualize os URIs de redirecionamento para usar a URL do seu túnel do ASP.NET Core.
6. Configure dev tunnels para hospedar seu serviço local.
7. Clone o repositório do seu projeto e atualize os arquivos de configuração com seu ID de cliente, ID do locatário e segredo.
8. Abra o Visual Studio e execute seu projeto ASP.NET Core.

Essa configuração permite que seu aplicativo gerencie o logon, a troca de tokens e as chamadas de API com segurança. Você pode testar fluxos de autenticação, como o OAuth, em um ambiente seguro antes de passar para a produção.

Sempre revise com atenção seus URIs de redirecionamento e suas permissões. Essa etapa evita erros comuns de autenticação e mantém seus testes seguros.

Segurança e Boas Práticas

Opções de visibilidade de túneis

Você controla quem pode acessar seu ambiente de desenvolvimento definindo a visibilidade do túnel. Ao criar um túnel, você escolhe entre acesso privado, organizacional ou público. Túneis privados permitem que somente você se conecte. Túneis organizacionais permitem que qualquer pessoa da sua empresa use o túnel. Túneis públicos abrem o acesso para qualquer pessoa com o link. Sempre escolha o nível de visibilidade mais restrito necessário para o seu projeto.

Para maximizar a segurança durante os testes do aplicativo do Microsoft 365, siga estas boas práticas:

• Configure os túneis como privados ou organizacionais sempre que possível.
• Implemente o split tunneling para aplicativos do Office 365. Esse método melhora o desempenho e mantém seus dados seguros.
• Use as faixas de endereços IP fornecidas pela Microsoft para o split tunneling. Evite usar nomes de domínio totalmente qualificados.
• Desative a interceptação SSL para o tráfego do Office 365. Essa etapa ajuda você a cumprir as recomendações de segurança da Microsoft.
• Confirme que sua política de split tunneling funciona usando a ferramenta de teste de conectividade do Microsoft 365.
• Desative o SSL Break and Inspect para os domínios do Office 365.

Dica: revise as configurações de visibilidade do túnel antes de compartilhar qualquer URL. Esse hábito ajuda a evitar a exposição acidental do seu ambiente de desenvolvimento.

Acesso seguro com o Entra ID

Você pode proteger seus túneis exigindo autenticação com o Entra ID. Esse recurso garante que somente usuários aprovados acessem seus serviços locais. Ao habilitar a autenticação do Entra ID, você adiciona uma camada robusta de proteção aos seus túneis de desenvolvimento. Somente usuários com credenciais válidas conseguem se conectar, o que ajuda a manter seus dados protegidos.

O Entra ID também oferece suporte ao acesso organizacional. Você pode permitir que toda a sua equipe teste e depure aplicativos sem expor o túnel ao público. Essa abordagem equilibra segurança e colaboração. Use sempre a autenticação do Entra ID em projetos sensíveis ou ao lidar com informações confidenciais.

Observação: a autenticação do Entra ID funciona perfeitamente tanto na interface do Visual Studio quanto nas ferramentas de linha de comando.

Monitoramento e gerenciamento de túneis

Você precisa monitorar e gerenciar seus túneis para manter um fluxo de trabalho seguro e eficiente. O Visual Studio oferece recursos integrados para gerenciar túneis de desenvolvimento. Você pode visualizar os túneis ativos, verificar o status e ajustar as configurações de acesso diretamente na IDE. A interface de linha de comando também permite criar, listar e fechar túneis rapidamente.

As boas práticas para gerenciar túneis incluem:

• Revise periodicamente a lista de túneis ativos.
• Feche os túneis ao terminar os testes para reduzir riscos de segurança.
• Use nomes descritivos para cada túnel a fim de evitar confusão.
• Escolha entre túneis temporários ou permanentes de acordo com as necessidades do seu projeto.
• Defina controles de acesso de acordo com os seus requisitos de segurança.

Uma tabela pode ajudar você a comparar as opções de gerenciamento de túneis:

Lembre-se: um bom gerenciamento de túneis mantém seu ambiente de desenvolvimento organizado e seguro.

Armadilhas comuns a evitar

Ao usar o Visual Studio Dev Tunnels para testar aplicativos do Microsoft 365, você quer evitar erros que podem atrasar seu trabalho ou colocar seu projeto em risco. Muitos desenvolvedores enfrentam os mesmos problemas. Se você souber o que observar, pode economizar tempo e manter seu ambiente seguro.

1. Escolher a visibilidade errada do túnel

Você pode escolher um túnel público por conveniência. Essa escolha pode expor seu app a qualquer pessoa que tenha o link. Sempre verifique a visibilidade do seu túnel antes de começar os testes. Use túneis privados ou da organização na maioria dos projetos. Use túneis públicos somente quando precisar de testadores externos e sempre monitore o acesso.

Dica: Revise as configurações do seu túnel antes de compartilhar URLs com sua equipe ou com os testadores.

2. Esquecer de atualizar os URIs de redirecionamento

Se você alterar a URL do seu túnel, precisa atualizar os URIs de redirecionamento no registro do seu app. Se pular essa etapa, a autenticação vai falhar. Sempre confirme que o registro do app corresponde ao endpoint atual do seu túnel.

3. Ignorar as configurações de autenticação

Você pode esquecer de habilitar a autenticação do Entra ID para o seu túnel. Sem isso, qualquer pessoa com o link pode acessar seu serviço local. Sempre exija autenticação em projetos sensíveis. Essa etapa protege seus dados e seus usuários.

4. Deixar os túneis abertos após os testes

Se você deixar os túneis em execução depois de terminar, aumenta o risco de segurança. Túneis não utilizados podem se tornar alvos de acessos indesejados. Sempre feche os túneis quando não precisar mais deles.

5. Usar nomes de túnel genéricos ou confusos

Se você usar nomes pouco claros para os túneis, você e sua equipe podem se confundir. Use nomes descritivos que correspondam ao seu projeto ou serviço. Esse hábito ajuda a gerenciar vários túneis e evita erros.

6. Negligenciar o monitoramento de logs

Você pode não verificar os logs do seu túnel. Os logs ajudam a identificar atividades incomuns ou acessos não autorizados. Crie o hábito de revisar os logs regularmente.

Observação: Você pode evitar a maioria dos problemas seguindo uma checklist antes e depois de cada sessão de testes.

Ao ficar atento a essas armadilhas comuns, você mantém seu processo de desenvolvimento fluido e seus Microsoft 365 Apps seguros. Você cria melhores hábitos e ajuda sua equipe a evitar problemas desnecessários.

Solução de problemas e dicas avançadas

Diagnosticando problemas de conexão

Você pode enfrentar às vezes problemas de conexão ao trabalhar com túneis. Comece verificando se o serviço local está em execução e escutando na porta correta. Use a linha de comando para confirmar que o serviço responde às solicitações. Se aparecerem erros, reinicie o serviço e tente novamente.

Em seguida, verifique as configurações do firewall. Firewalls podem bloquear conexões de entrada. Permita o tráfego na porta que você usa para o túnel. Se você usar uma VPN, desconecte-a e teste novamente. VPNs podem alterar as configurações de rede e causar problemas.

Se ainda tiver dificuldades, use o comando devtunnel list para ver todos os túneis ativos. Certifique-se de usar a URL correta do túnel no seu Microsoft 365 App. Às vezes, copiar a URL errada causa falhas de conexão.

Dica: Sempre teste a URL do túnel em um navegador antes de começar os testes e a depuração. Essa etapa ajuda a identificar erros simples logo no início.

Lidando com erros de autenticação

Erros de autenticação podem impedir que seu app funcione com os serviços do Microsoft 365. Primeiro, verifique o registro do seu app no portal do Microsoft Entra ID. Confirme que os URIs de redirecionamento correspondem exatamente à URL do túnel. Até um pequeno erro de digitação pode causar falhas.

Revise seu ID do cliente e seu segredo. Esses valores devem corresponder ao que você configurou na configuração do seu app. Se você alterar o túnel ou criar um novo, atualize os URIs de redirecionamento no registro do seu app.

Se aparecer a mensagem "não autorizado", verifique a visibilidade e as configurações de autenticação do seu túnel. Em projetos sensíveis, sempre use a autenticação do Entra ID. Essa etapa mantém seus dados seguros e evita acessos indesejados.

Observação: a maioria dos erros de autenticação decorre de URLs incompatíveis ou de permissões ausentes. Revise essas configurações com atenção durante a depuração.

CLI avançada e automação

Você pode usar a CLI do Dev Tunnels para automatizar seu fluxo de trabalho. A automação economiza tempo e reduz erros. Por exemplo, você pode escrever um script que cria um túnel, inicia seu serviço local e abre a página de teste no navegador.

Aqui está um exemplo de script para o 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"

Você pode compartilhar scripts como este com sua equipe. Todos podem usar a mesma configuração para testes e depuração. Essa abordagem ajuda vocês a trabalhar juntos e evita erros de configuração.

Se você quiser fechar todos os túneis de uma só vez, use:

devtunnel close --all

Automatizar o gerenciamento de túneis torna seu processo de desenvolvimento mais fluido e confiável. Experimente usar scripts para tarefas repetitivas.

Você pode acelerar o desenvolvimento de seus apps do Microsoft 365 usando os dev tunnels do Visual Studio. Essa ferramenta torna os testes mais rápidos e seguros. Comece configurando seu primeiro túnel e siga as práticas recomendadas de visibilidade e autenticação. Explore os recursos avançados para melhorar seu fluxo de trabalho. Lembre-se de priorizar a segurança e o trabalho em equipe enquanto continua testando e criando apps melhores.

Checklist de Dev Tunnels do Visual Studio

Checklist rápido para configurar, usar e solucionar problemas nos Dev Tunnels do Visual Studio.

• Verifique se a versão do Visual Studio oferece suporte aos Dev Tunnels do Visual Studio (Visual Studio 2022 ou posterior / carga de trabalho necessária instalada)
• Instale ou atualize a extensão dev tunnels ou o componente da CLI, se necessário
• Entre com sua conta da Microsoft ou o locatário do Entra ID usado para acessar o túnel
• Crie um novo dev tunnel pelo Visual Studio ou pela CLI do dev tunnels
• Escolha e confirme o nome correto do túnel e a região para baixa latência
• Selecione e configure o endpoint local (porta) que será exposto pelo túnel
• Confirme o protocolo (HTTP/HTTPS ou TCP) e habilite TLS se estiver expondo HTTPS
• Configure e reserve domínios personalizados ou subdomínios, se necessário
• Defina as políticas de acesso: pública, usuários autenticados ou usuários/grupos específicos do Entra ID
• Valide as configurações de firewall e roteador para permitir o tráfego de saída do túnel
• Verifique se o app local está em execução e escutando na porta configurada
• Teste a conectividade do túnel a partir de um dispositivo externo ou de um colaborador
• Use HTTPS e certificados válidos em endpoints sensíveis em produção
• Renove credenciais e tokens periodicamente e revogue os tokens não utilizados
• Monitore as sessões de túnel ativas e o uso pelo Visual Studio ou pelo painel do portal
• Limite as rotas expostas e encaminhe apenas os endpoints necessários
• Ative o registro de logs e inspecione os logs do túnel para identificar erros de conexão ou problemas de desempenho
• Solucione problemas comuns: conflitos de porta, falhas de autenticação e incompatibilidade de região
• Atualize regularmente o Visual Studio e as ferramentas de dev tunnel para receber correções de segurança
• Feche ou exclua os túneis inativos para reduzir a superfície de ataque e o uso de recursos

Conclusão

Em resumo, usar os Dev Tunnels do Visual Studio em vez de implantações tradicionais na nuvem permite que desenvolvedores acelerem drasticamente os ciclos de feedback, reduzam os custos da infraestrutura em nuvem e depurem localmente com total fidelidade. Seja para criar webhooks, apps do Teams ou APIs modernas, esse recurso nativo elimina atritos. Para um aprofundamento nesses conceitos e uma demonstração ao vivo, ouça o episódio relacionado, Test Microsoft 365 Apps with Visual Studio Dev Tunnels.