Przyspiesz swój workflow: dlaczego tunele deweloperskie Visual Studio biją tradycyjne wdrażanie

By Mirko Peters · 2026-08-12

Witamy ponownie w podcaście! Jeśli kiedykolwiek czekałeś piętnaście minut, aż wdrożenie w chmurze się zakończy, tylko po to, by przetestować jedną zmianę w kodzie, wiesz…

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

Witamy ponownie w podcaście! Jeśli kiedykolwiek czekałeś piętnaście minut, aż wdrożenie w chmurze się zakończy, tylko po to, by przetestować jedną zmianę w kodzie, doskonale wiesz, ile czasu to kosztuje i jak bardzo obniża produktywność. Dziś rozwijamy temat, który całkowicie zmienił sposób, w jaki nasze zespoły inżynierskie prowadzą lokalne testy, debugowanie i integracje. Koniecznie zajrzyj do powiązanego odcinka podcastu Test Microsoft 365 Apps with Visual Studio Dev Tunnels, w którym szczegółowo omawiamy te dokładne procesy w praktyce.

W tym kompleksowym przewodniku przyjrzymy się, dlaczego tradycyjne metody wdrażania tracą znaczenie na rzecz nowoczesnych rozwiązań tunelowania, jak działają tunele deweloperskie Visual Studio od podszewki oraz jak możesz bezproblemowo zintegrować je z projektami Microsoft 365, Teams i ASP.NET Core.

Testowanie lokalne z tunelami deweloperskimi Visual Studio

Dlaczego testowanie lokalne ma znaczenie

Chcesz, aby Twoje aplikacje Microsoft 365 działały bezbłędnie, zanim udostępnisz je użytkownikom. Testowanie lokalne pozwala wyłapywać błędy na wczesnym etapie i sprawdzić, jak kod zachowuje się w bezpiecznym środowisku. Gdy testujesz lokalnie, możesz szybko wprowadzać zmiany i od razu widzieć efekty. Ten proces oszczędza czas i pomaga unikać błędów, które mogłyby pojawić się w środowisku produkcyjnym.

Tradycyjne testowanie na localhost ma swoje ograniczenia. Lokalny komputer nie może przyjmować połączeń z internetu. Utrudnia to testowanie funkcji wymagających dostępu z prawdziwego świata, takich jak webhooki, przepływy uwierzytelniania czy integracja z usługami Microsoft 365. Możesz utknąć, nie mogąc zasymulować tego, jak aplikacja zachowa się u rzeczywistych użytkowników.

Dev Tunnels zrewolucjonizowało sposób, w jaki tworzymy i testujemy aplikacje webowe, szczególnie dla programistów mobilnych, którzy często mierzą się z trudnościami przy konfigurowaniu lokalnych serwerów testowych. To przełomowa funkcja, która usprawnia współpracę i upraszcza proces tworzenia oprogramowania.

Dzięki odpowiednim narzędziom można pokonać te wyzwania. Możesz stworzyć realistyczne środowisko dla swojej aplikacji, nawet pracując na własnym komputerze.

Jak tunele deweloperskie umożliwiają testowanie lokalne

Aplikacje Microsoft 365 możesz testować z localhost, korzystając z tuneli deweloperskich Visual Studio. Narzędzie to zapewnia bezpieczny sposób udostępniania lokalnych usług w internecie. Nie musisz wdrażać kodu w Azure ani w żadnej innej platformie chmurowej tylko po to, by sprawdzić, jak działa z Microsoft 365.

Tunele deweloperskie Visual Studio rozszerzają tradycyjne testowanie na localhost, umożliwiając bezpieczne udostępnianie lokalnych aplikacji w internecie. Dzięki temu możliwe są połączenia przychodzące, co jest niezbędne do testowania aplikacji Microsoft 365 w bardziej realistycznym środowisku, bez ograniczeń wynikających z pracy wyłącznie lokalnie.

Oto, jak tunele deweloperskie usprawniają szybkość i bezpieczeństwo testowania lokalnego:

• Tunele deweloperskie pozwalają lokalnym usługom działać jako bezpieczne punkty końcowe w chmurze w mniej niż 3 minuty.
• Umożliwiają bezpieczny dostęp do internetu w celu lokalnego testowania aplikacji Microsoft 365.
• Prawidłowa konfiguracja ma kluczowe znaczenie, aby nie udostępnić środowiska deweloperskiego.

Tunele można skonfigurować w kilka kliknięć lub poleceń. Wybierasz nazwę i widoczność tunelu, dzięki czemu kontrolujesz, kto ma dostęp do aplikacji. Możesz użyć uwierzytelniania, aby zabezpieczyć swoją pracę. Ta elastyczność pozwala współpracować z członkami zespołu lub zapraszać testerów bez udostępniania całego komputera.

Tunele deweloperskie pozwalają testować funkcje takie jak uwierzytelnianie OAuth, boty Teams czy web parts SharePoint tak, jakby działały w chmurze. Otrzymujesz informacje zwrotne w czasie rzeczywistym i możesz od razu debugować problemy. Dzięki temu cykl tworzenia oprogramowania jest szybszy i bardziej niezawodny.

Kiedy korzystasz z dev tunnels, zyskujesz pewność co do kodu jeszcze przed wdrożeniem. Wiesz, że aplikacja działa w rzeczywistych warunkach, a nie tylko na Twoim komputerze.

Przegląd Visual Studio Dev Tunnels

Najważniejsze funkcje

Visual Studio Dev Tunnels to skuteczny sposób na testowanie i debugowanie aplikacji Microsoft 365 z lokalnego komputera. Kilkoma krokami możesz udostępnić usługi asp.net core w internecie. To narzędzie pomaga tworzyć bezpieczne i elastyczne środowisko programistyczne.

Oto kilka najważniejszych funkcji, które będą Ci przydatne:

• Możesz udostępniać lokalne interfejsy API za pomocą zdalnych adresów URL, co ułatwia testowanie i debugowanie projektów asp.net core.
• Integracja z usługami zewnętrznymi staje się prosta, ponieważ lokalne aplikacje mają publicznie dostępne adresy URL.
• Możesz ustawiać punkty przerwania na localhost i obserwować, jak kod asp.net core reaguje, gdy uzyskiwany jest dostęp do zdalnych adresów URL.
• Nazwane tunele pomagają udostępniać konkretne projekty lub usługi bez zamieszania.
• Trwałe tunele pozwalają zachować dostęp w dłuższym czasie, co jest ważne w bieżących projektach asp.net core.
• Możesz wybrać poziomy dostępu do tuneli: prywatny, organizacyjny lub publiczny. Dzięki temu łatwo kontrolować, kto może zobaczyć Twoją pracę.
• Uwierzytelnianie za pomocą Entra ID ogranicza dostęp do użytkowników z ważnymi poświadczeniami, dzięki czemu Twoje dane są bezpieczne.
• Interfejs CLI pozwala zarządzać tunelami i automatyzować je, w tym ich tworzenie i konfigurację. Za pomocą poleceń możesz tworzyć, wyświetlać listę i oznaczać tunele, co ułatwia zarządzanie nimi.

Wskazówka: trwałe i nazwane tunele pozwalają uniknąć ponownego tworzenia tuneli przy każdym uruchomieniu projektu asp.net core. Oszczędza to czas i ogranicza liczbę błędów.

Jak działają Dev Tunnels

Dev tunnels tworzą bezpieczny most między lokalnym serwerem asp.net core a internetem. Aplikacje Microsoft 365 możesz testować tak, jakby działały w środowisku produkcyjnym.

Bezpieczne publiczne punkty końcowe

Zaczynasz od pobrania i zainstalowania interfejsu CLI devtunnel. Po zalogowaniu się na konto Entra ID, Microsoft lub GitHub uruchamiasz lokalny serwer asp.net core. Następnie hostujesz lub tworzysz tunel za pomocą polecenia devtunnel host –p PORT. Jeśli potrzebujesz stałego adresu URL, używasz polecenia devtunnel create, aby utworzyć trwały tunel.

Dzięki temu otrzymujesz bezpieczny punkt końcowy dostępny z internetu dla lokalnej usługi asp.net core. Możesz teraz testować webhooki, przepływy uwierzytelniania i integracje wymagające publicznych adresów URL. Uwierzytelnianie Entra ID zapewnia, że tylko zatwierdzeni użytkownicy mogą uzyskać dostęp do tuneli, co ogranicza ryzyko przypadkowego ujawnienia danych.

Integracja z Visual Studio i CLI

Visual Studio ułatwia tworzenie i zarządzanie dev tunnels. Tunel skonfigurujesz w kilka kliknięć bezpośrednio w środowisku IDE. Interfejs CLI oferuje jeszcze więcej opcji, na przykład tunele o stałym czasie życia i oznaczanie, które ułatwia organizację. Możesz automatyzować tworzenie tuneli dla projektów asp.net core, dzięki czemu praca jest szybsza i bardziej niezawodna.

Możesz też wyświetlić listę wszystkich tuneli, sprawdzić ich szczegóły i zarządzać uprawnieniami dostępu. Ta elastyczność pomaga współpracować z zespołem i utrzymać bezpieczeństwo środowiska programistycznego.

Uwaga: dev tunnels zostały zaprojektowane tak, aby bezpiecznie udostępniać lokalne punkty końcowe asp.net core w internecie, dzięki czemu testowanie i debugowanie są bezpieczne i wydajne.

Hostowanie lub tworzenie tunelu w Visual Studio

Wymagania wstępne i konfiguracja

Zanim zaczniesz hostować lub tworzyć tunel do testowania aplikacji Microsoft 365, musisz przygotować środowisko. Visual Studio dostarcza potrzebne narzędzia, ale najpierw trzeba spełnić kilka wymagań. Poniższa tabela pokazuje, czego potrzebujesz, aby rozpocząć:

Sprawdź, czy masz odpowiednią wersję programu Visual Studio. Otwórz instalator i potwierdź, że pakiet obciążeń ASP.NET i tworzenie aplikacji internetowych jest aktywny. Zaloguj się na swoje konto Microsoft, aby uzyskać dostęp do okna narzędzia tuneli deweloperskich. Jeśli planujesz połączyć projekt ASP.NET Core z Power Platform, upewnij się, że masz dostęp do usługi Power Automate lub Power Apps.

Wskazówka: Aktualizowanie narzędzi pomaga uniknąć problemów z konfiguracją i zapewnia dostęp do najnowszych funkcji w oknie narzędzia tuneli deweloperskich.

Tworzenie i nazywanie tunelu

Tunel możesz utworzyć bezpośrednio z okna narzędzia tuneli deweloperskich w programie Visual Studio. Dzięki temu udostępnisz swoją usługę ASP.NET Core w internecie na potrzeby testowania aplikacji Microsoft 365. Aby utworzyć i nazwać tunel, wykonaj następujące kroki:

1. W liście rozwijanej debugowania wybierz pozycję Tunele deweloperskie > Utwórz tunel.
2. W oknie dialogowym, które otworzy się w oknie narzędzia tuneli deweloperskich, wybierz konto, którego chcesz użyć.
3. Wpisz nazwę tunelu. Ułatwi ona jego rozpoznanie w oknie narzędzia tuneli deweloperskich.
4. Wybierz typ tunelu. Wybierz opcję Trwały, jeśli chcesz, aby adres URL był zawsze taki sam, lub Tymczasowy, jeśli za każdym razem ma być nowy adres URL.
5. Wybierz typ uwierzytelniania: Prywatny, Organizacyjny lub Publiczny.
6. Kliknij przycisk OK, aby utworzyć tunel.

Tworząc tunel, łatwiej połączysz projekt ASP.NET Core z usługami Microsoft 365. Okno narzędzia tuneli deweloperskich pozwala zachować porządek w tunelach i mieć je zawsze na widoku. Aktywne tunele znajdziesz i zarządzisz nimi właśnie w tym oknie.

Uwaga: Nadanie tunelowi czytelnej nazwy pomaga Tobie i zespołowi śledzić, która usługa ASP.NET Core jest udostępniona. Używaj jasnych nazw dla każdego tunelu w oknie narzędzia tuneli deweloperskich.

Ustawianie widoczności tunelu

Widoczność tunelu określa, kto może uzyskać dostęp do Twoich tuneli deweloperskich. Tę opcję ustawiasz w oknie narzędzia tuneli deweloperskich podczas tworzenia tunelu. Odpowiedni poziom widoczności chroni Twoją pracę i wspiera współpracę.

Dostępne są następujące główne opcje widoczności:

Te opcje możesz również zobaczyć jako:

• Prywatny: Tylko Ty możesz korzystać z tunelu.
• Organizacyjny: Twój zespół lub firma mogą korzystać z tunelu.
• Publiczny: Każdy może korzystać z tunelu.

Okno narzędzia tuneli deweloperskich pozwala zmieniać widoczność podczas tworzenia i zarządzania tunelami deweloperskimi. Wybór właściwej widoczności pomaga kontrolować ruch i zachować bezpieczeństwo aplikacji Microsoft 365. Tunele prywatne najlepiej sprawdzają się przy pracy indywidualnej. Tunele organizacyjne ułatwiają zespołowi wspólne testowanie. Tunele publiczne umożliwiają udział zewnętrznym testerom, ale wymagają dodatkowej ostrożności.

Uwaga: Publiczne tunele nie wymagają uwierzytelniania. Używaj ich wyłącznie wtedy, gdy musisz udostępnić aplikację użytkownikom spoza organizacji, i zawsze monitoruj dostęp w oknie narzędzia tuneli deweloperskich.

Widoczność tunelu wpływa zarówno na bezpieczeństwo, jak i na współpracę. Gdy ustawisz odpowiedni poziom, masz pewność, że aplikację zobaczą tylko właściwe osoby. Ogranicza to ryzyko i pomaga zespołowi sprawnie pracować razem.

Korzystanie z interfejsu CLI tuneli deweloperskich

Tunelami deweloperskimi możesz zarządzać bezpośrednio z wiersza poleceń, korzystając z interfejsu CLI tuneli deweloperskich. To narzędzie zapewnia elastyczność i szybkość, zwłaszcza gdy chcesz zautomatyzować przepływ pracy lub pracować poza interfejsem programu Visual Studio. Interfejs CLI sprawdza się zarówno przy szybkich testach, jak i w bardziej zaawansowanych konfiguracjach.

Aby rozpocząć, musisz zainstalować interfejs CLI tuneli deweloperskich. Zrobisz to, uruchamiając następujące polecenie w terminalu:

dotnet tool install -g Microsoft.DevTunnels.Cli

Po instalacji musisz się zalogować. Użyj konta Microsoft, Entra ID lub konta GitHub. Ten krok łączy sesję interfejsu CLI ze środowiskiem programu Visual Studio i zapewnia bezpieczny dostęp.

devtunnel login

Po zalogowaniu możesz tworzyć tunele i nimi zarządzać. Oto prosty sposób na utworzenie tunelu dla lokalnego projektu:

devtunnel host -p 5000

To polecenie udostępnia lokalną usługę działającą na porcie 5000 w internecie. Interfejs CLI wyświetli publiczny adres URL, którego możesz użyć do testowania aplikacji Microsoft 365. Ten adres możesz udostępnić zespołowi lub wykorzystać do testów integracyjnych.

Jeśli chcesz utworzyć trwały tunel o własnej nazwie, użyj polecenia:

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

Takie podejście pozwala zachować ten sam adres URL między sesjami, co jest ważne dla identyfikatorów URI przekierowania OAuth i spójnych testów. Widoczność tunelu możesz też ustawić bezpośrednio z poziomu interfejsu CLI. Na przykład, aby tunel był dostępny tylko dla Twojej organizacji, dodaj flagę --access organization:

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

Wskazówka: Nadawaj tunelom jasne i opisowe nazwy. Ułatwia to zarządzanie wieloma projektami w programie Visual Studio i pozwala uniknąć pomyłek.

Listę wszystkich aktywnych tuneli możesz wyświetlić w dowolnym momencie:

devtunnel list

Aby zatrzymać tunel, użyj polecenia:

devtunnel close my-tunnel

Interfejs CLI umożliwia również automatyzację tworzenia tuneli w skryptach. Ta funkcja jest przydatna, gdy chcesz konfigurować tunele deweloperskie jako część procesu kompilacji lub wdrażania. Polecenia CLI możesz udostępnić zespołowi, aby wszyscy korzystali z tej samej konfiguracji, co zwiększa spójność i ogranicza liczbę błędów.

Uwaga: Interfejs Dev Tunnels CLI działa bezproblemowo z programem Visual Studio. Możesz przełączać się między interfejsem CLI a interfejsem programu Visual Studio bez utraty ustawień tunelu.

Opanowanie interfejsu Dev Tunnels CLI daje Ci większą kontrolę nad środowiskiem deweloperskim. Możesz szybko tworzyć, zarządzać i zabezpieczać tunele dla dowolnego projektu aplikacji Microsoft 365. Ta elastyczność pomaga efektywnie testować i debugować aplikacje, niezależnie od tego, czy pracujesz samodzielnie, czy w zespole.

Konfigurowanie aplikacji Microsoft 365 dla Dev Tunnels

Aktualizowanie rejestracji aplikacji i identyfikatorów URI przekierowania

Musisz zaktualizować rejestrację aplikacji i identyfikatory URI przekierowania, aby połączyć lokalny projekt ASP.NET Core z usługami Microsoft 365 za pośrednictwem programu Visual Studio. Dzięki temu aplikacja będzie mogła korzystać z bezpiecznego punktu końcowego udostępnianego przez Dev Tunnels. Oto prosty sposób konfiguracji rejestracji aplikacji:

1. Otwórz portal Microsoft Entra ID – Rejestracje aplikacji.
2. Wybierz „Nowa rejestracja” i wpisz nazwę aplikacji.
3. Wybierz obsługiwane typy kont dla swojej aplikacji.
4. Na razie pozostaw pole Identyfikator URI przekierowania puste.
5. Kliknij „Zarejestruj”, aby utworzyć aplikację.
6. Na stronie przeglądu skopiuj identyfikator aplikacji (klienta) i identyfikator katalogu (dzierżawy).
7. W sekcji „Zarządzaj” wybierz „Uwidocznij interfejs API”.
8. Kliknij łącze „Ustaw”, aby wygenerować identyfikator URI aplikacji.
9. Dodaj zakres o nazwie „access_as_user”.
10. Ustaw opcję „Kto może wyrazić zgodę?” na „Administratorzy i użytkownicy”.
11. Wypełnij komunikaty zgody dla administratora i użytkownika.
12. Upewnij się, że stan jest ustawiony na „Włączone”.
13. Aby zakończyć, wybierz „Dodaj zakres”.

Po utworzeniu tunelu w programie Visual Studio musisz zaktualizować identyfikator URI przekierowania w rejestracji aplikacji. Jako identyfikator URI przekierowania użyj publicznego adresu URL z tunelu ASP.NET Core. Ten krok informuje usługi Microsoft 365, dokąd mają być wysyłane odpowiedzi uwierzytelniania podczas testów.

Wskazówka: Zawsze zapisuj identyfikator klienta i identyfikator dzierżawy. Będą potrzebne do uwierzytelniania i konfiguracji OAuth.

Łączenie aplikacji Teams, SharePoint i Power Platform

Program Visual Studio umożliwia połączenie usług ASP.NET Core z aplikacjami Teams, SharePoint i Power Platform. Tunele Dev Tunnels sprawiają, że ten proces jest bezpieczny i prosty. Podczas korzystania z tuneli otrzymujesz alerty, gdy łączysz się z punktem końcowym tunelu. Alerty te pomagają uniknąć ataków phishingowych i przypadkowego udostępnienia wrażliwych adresów URL.

• Boty Teams i rozszerzenia wiadomości domyślnie korzystają z tuneli Dev Tunnels w lokalnym programowaniu. Dzięki temu możesz bezpiecznie testować funkcje przed ich wdrożeniem.
• Składniki webowe SharePoint i łączniki Power Platform również korzystają z bezpiecznych punktów końcowych. Możesz testować webhooki, uwierzytelnianie i przepływy danych w rzeczywistym scenariuszu.
• Uwierzytelnianie tożsamości Microsoft 365 zapewnia dodatkową warstwę bezpieczeństwa. Aby tworzyć i zarządzać tunelami w programie Visual Studio, musisz zalogować się na swoje konto Microsoft 365.

Uwaga: Świadomość zagrożeń bezpieczeństwa pomaga Tobie i Twojemu zespołowi zachować bezpieczeństwo podczas testowania aplikacji ASP.NET Core.

Obsługa uwierzytelniania i OAuth

Aby aplikacje Microsoft 365 mogły współpracować z tunelami Dev Tunnels, musisz skonfigurować uwierzytelnianie i OAuth. Oto przewodnik krok po kroku:

1. Zarejestruj aplikację w portalu Microsoft Entra ID.
2. Ustaw identyfikator URI aplikacji tak, aby odpowiadał punktowi końcowemu tunelu z programu Visual Studio.
3. Utwórz klucz tajny klienta do wymiany tokenów.
4. Dodaj uprawnienia interfejsu API dla dostępu do Microsoft Graph.
5. Zaktualizuj identyfikatory URI przekierowania, aby używały adresu URL tunelu ASP.NET Core.
6. Skonfiguruj Dev Tunnels do hostowania lokalnej usługi.
7. Sklonuj repozytorium projektu i zaktualizuj pliki konfiguracyjne, wpisując swój identyfikator klienta, identyfikator dzierżawy oraz sekret.
8. Otwórz program Visual Studio i uruchom swój projekt ASP.NET Core.

Taka konfiguracja pozwala aplikacji bezpiecznie obsługiwać logowanie, wymianę tokenów i wywołania interfejsów API. Przepływy uwierzytelniania, takie jak OAuth, możesz przetestować w bezpiecznym środowisku, zanim przeniesiesz aplikację na środowisko produkcyjne.

Zawsze dokładnie sprawdzaj identyfikatory URI przekierowania oraz uprawnienia. Ten krok zapobiega typowym błędom uwierzytelniania i pozwala zachować bezpieczeństwo podczas testów.

Bezpieczeństwo i najlepsze praktyki

Opcje widoczności tuneli

To Ty decydujesz, kto ma dostęp do środowiska deweloperskiego, ustawiając widoczność tunelu. Podczas tworzenia tunelu wybierasz dostęp prywatny, organizacyjny lub publiczny. Tunele prywatne mogą połączyć się wyłącznie z Tobą. Tunele organizacyjne mogą być używane przez każdego w Twojej firmie. Tunele publiczne udostępniają dostęp każdemu, kto posiada link. Zawsze wybieraj najniższy poziom widoczności, jaki jest potrzebny w projekcie.

Aby zmaksymalizować bezpieczeństwo podczas testowania aplikacji Microsoft 365, stosuj się do tych najlepszych praktyk:

• Jeśli to możliwe, ustawiaj tunele jako prywatne lub organizacyjne.
• Wdróż split tunneling dla aplikacji Office 365. Ta metoda poprawia wydajność i zapewnia bezpieczeństwo danych.
• Do split tunnelingu używaj zakresów adresów IP udostępnianych przez firmę Microsoft. Unikaj używania w pełni kwalifikowanych nazw domen.
• Wyłącz inspekcję SSL dla ruchu Office 365. Ten krok pomaga spełnić zalecenia dotyczące bezpieczeństwa firmy Microsoft.
• Sprawdź, czy zasady split tunnelingu działają, używając narzędzia do testowania łączności Microsoft 365.
• Wyłącz funkcję SSL Break and Inspect dla domen Office 365.

Wskazówka: Przed udostępnieniem jakichkolwiek adresów URL sprawdź ustawienia widoczności tuneli. Ten nawyk pomaga zapobiec przypadkowemu ujawnieniu środowiska deweloperskiego.

Zabezpieczanie dostępu za pomocą Entra ID

Tunele możesz zabezpieczyć, wymagając uwierzytelniania za pomocą Entra ID. Ta funkcja gwarantuje, że lokalne usługi mogą być dostępne wyłącznie dla zatwierdzonych użytkowników. Po włączeniu uwierzytelniania Entra ID tunele deweloperskie zyskują dodatkową, silną warstwę ochrony. Połączyć się mogą wyłącznie użytkownicy z ważnymi poświadczeniami, co pomaga chronić dane.

Entra ID umożliwia też dostęp organizacyjny. Możesz pozwolić całemu zespołowi na testowanie i debugowanie aplikacji bez udostępniania tunelu publicznie. Takie podejście łączy bezpieczeństwo ze współpracą. Zawsze używaj uwierzytelniania Entra ID w projektach wrażliwych lub podczas pracy z poufnymi informacjami.

Uwaga: Uwierzytelnianie Entra ID działa bez zakłóceń zarówno w interfejsie Visual Studio, jak i w narzędziach wiersza poleceń.

Monitorowanie i zarządzanie tunelami

Aby zachować bezpieczny i wydajny przepływ pracy, musisz monitorować i zarządzać tunelami. Visual Studio udostępnia wbudowane funkcje zarządzania tunelami deweloperskimi. Z poziomu IDE możesz przeglądać aktywne tunele, sprawdzać ich stan i zmieniać ustawienia dostępu. Interfejs wiersza poleceń pozwala również szybko tworzyć, wyświetlać listę i zamykać tunele.

Najlepsze praktyki zarządzania tunelami obejmują:

• Regularnie przeglądaj listę aktywnych tuneli.
• Zamykaj tunele po zakończeniu testów, aby ograniczyć ryzyko bezpieczeństwa.
• Nadawaj każdemu tunelowi opisowe nazwy, aby uniknąć pomyłek.
• Wybierz tunele tymczasowe lub stałe w zależności od potrzeb projektu.
• Ustaw kontrolę dostępu zgodnie z wymaganiami bezpieczeństwa.

Tabela może pomóc w porównaniu opcji zarządzania tunelami:

Pamiętaj: dobre zarządzanie tunelami utrzymuje środowisko deweloperskie w porządku i bezpieczeństwie.

Typowe pułapki, których warto unikać

Podczas korzystania z Visual Studio Dev Tunnels do testowania aplikacji Microsoft 365 warto unikać błędów, które mogą spowolnić pracę lub narazić projekt na ryzyko. Wielu deweloperów napotyka te same problemy. Jeśli wiesz, na co zwrócić uwagę, zaoszczędzisz czas i zadbasz o bezpieczeństwo środowiska.

1. Wybór niewłaściwej widoczności tunelu

Publiczny tunel może wydawać się wygodnym wyborem. Taki wybór może jednak udostępnić Twoją aplikację każdemu, kto zna link. Zanim zaczniesz testy, zawsze sprawdź widoczność tunelu. W większości projektów używaj tuneli prywatnych lub organizacyjnych. Publicznych tuneli używaj tylko wtedy, gdy potrzebujesz zewnętrznych testerów, i zawsze monitoruj dostęp.

Wskazówka: Przed udostępnieniem adresów URL zespołowi lub testerom przejrzyj ustawienia tunelu.

2. Zapomnienie o aktualizacji identyfikatorów URI przekierowania

Jeśli zmienisz adres URL tunelu, musisz zaktualizować identyfikatory URI przekierowania w rejestracji aplikacji. Jeśli pominiesz ten krok, uwierzytelnianie zakończy się niepowodzeniem. Zawsze dokładnie sprawdzaj, czy rejestracja aplikacji odpowiada bieżącemu punktowi końcowemu tunelu.

3. Ignorowanie ustawień uwierzytelniania

Możesz zapomnieć o włączeniu uwierzytelniania Entra ID dla tunelu. Bez tego każdy, kto ma link, może uzyskać dostęp do lokalnej usługi. W przypadku wrażliwych projektów zawsze wymagaj uwierzytelniania. Ten krok chroni Twoje dane i Twoich użytkowników.

4. Pozostawienie otwartych tuneli po testach

Jeśli po zakończeniu pracy pozostawisz uruchomione tunele, zwiększasz ryzyko bezpieczeństwa. Nieużywane tunele mogą stać się celem nieautoryzowanego dostępu. Zawsze zamykaj tunele, gdy nie są już potrzebne.

5. Używanie ogólnych lub mylących nazw tuneli

Jeśli nadasz tunelom niejasne nazwy, Ty i Twój zespół możecie się pogubić. Używaj opisowych nazw odpowiadających projektowi lub usłudze. Ten nawyk ułatwia zarządzanie wieloma tunelami i pozwala unikać pomyłek.

6. Pomijanie monitorowania dzienników

Możesz nie sprawdzać dzienników tuneli. Dzienniki pomagają wykrywać nietypową aktywność lub nieautoryzowany dostęp. Wyrób sobie nawyk regularnego przeglądania dzienników.

Uwaga: Większości problemów możesz zapobiec, stosując listę kontrolną przed każdą sesją testową i po niej.

Zachowując czujność wobec tych typowych pułapek, utrzymasz płynność procesu tworzenia i bezpieczeństwo aplikacji Microsoft 365. Wyrobisz lepsze nawyki i pomożesz zespołowi uniknąć zbędnych problemów.

Rozwiązywanie problemów i zaawansowane wskazówki

Diagnozowanie problemów z połączeniem

Podczas pracy z tunelami możesz czasem napotkać problemy z połączeniem. Zacznij od sprawdzenia, czy lokalna usługa działa i nasłuchuje na właściwym porcie. Użyj wiersza poleceń, aby potwierdzić, że usługa odpowiada na żądania. Jeśli pojawiają się błędy, uruchom usługę ponownie i spróbuj jeszcze raz.

Następnie sprawdź ustawienia zapory. Zapory mogą blokować połączenia przychodzące. Zezwól na ruch na porcie używanym przez tunel. Jeśli korzystasz z sieci VPN, rozłącz ją i przeprowadź test ponownie. Sieci VPN mogą zmieniać ustawienia sieciowe i powodować problemy.

Jeśli nadal masz trudności, użyj polecenia devtunnel list, aby zobaczyć wszystkie aktywne tunele. Upewnij się, że w aplikacji Microsoft 365 używasz poprawnego adresu URL tunelu. Czasami skopiowanie złego adresu URL powoduje błędy połączenia.

Wskazówka: Zawsze testuj adres URL tunelu w przeglądarce przed rozpoczęciem testów i debugowania. Ten krok pozwala wcześnie wychwycić proste błędy.

Obsługa błędów uwierzytelniania

Błędy uwierzytelniania mogą uniemożliwić działanie aplikacji z usługami Microsoft 365. Najpierw sprawdź rejestrację aplikacji w portalu Microsoft Entra ID. Upewnij się, że identyfikatory URI przekierowania dokładnie odpowiadają adresowi URL tunelu. Nawet niewielka literówka może spowodować awarie.

Sprawdź identyfikator klienta i klucz tajny. Te wartości muszą być zgodne z tym, co ustawiono w konfiguracji aplikacji. Jeśli zmienisz tunel lub utworzysz nowy, zaktualizuj identyfikatory URI przekierowania w rejestracji aplikacji.

Jeśli widzisz komunikat "unauthorized", sprawdź widoczność tunelu i ustawienia uwierzytelniania. W przypadku wrażliwych projektów zawsze używaj uwierzytelniania Entra ID. Ten krok chroni dane i zapobiega nieautoryzowanemu dostępowi.

Uwaga: Większość błędów uwierzytelniania wynika z niezgodnych adresów URL lub brakujących uprawnień. Podczas debugowania dokładnie sprawdź te ustawienia.

Zaawansowany interfejs CLI i automatyzacja

Możesz użyć interfejsu wiersza poleceń Dev Tunnels CLI, aby zautomatyzować swój przepływ pracy. Automatyzacja oszczędza czas i ogranicza liczbę błędów. Możesz na przykład napisać skrypt, który utworzy tunel, uruchomi lokalną usługę i otworzy stronę testową w przeglądarce.

Oto przykładowy skrypt dla programu 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"

Takie skrypty możesz udostępniać zespołowi. Wszyscy mogą korzystać z tej samej konfiguracji do testowania i debugowania. Takie podejście ułatwia współpracę i pozwala unikać błędów konfiguracji.

Jeśli chcesz zamknąć wszystkie tunele naraz, użyj polecenia:

devtunnel close --all

Automatyzacja zarządzania tunelami sprawia, że proces programistyczny jest płynniejszy i bardziej niezawodny. Spróbuj używać skryptów do powtarzalnych zadań.

Możesz przyspieszyć tworzenie aplikacji Microsoft 365 dzięki narzędziu Visual Studio Dev Tunnels. Ułatwia ono szybsze i bezpieczniejsze testowanie. Zacznij od skonfigurowania pierwszego tunelu i stosuj sprawdzone metody dotyczące widoczności oraz uwierzytelniania. Poznaj zaawansowane funkcje, aby usprawnić swoją pracę. Pamiętaj o bezpieczeństwie i współpracy zespołowej podczas dalszego testowania i tworzenia lepszych aplikacji.

Lista kontrolna Visual Studio Dev Tunnels

Krótka lista kontrolna konfiguracji, użytkowania i rozwiązywania problemów z Visual Studio Dev Tunnels.

• Sprawdź, czy wersja programu Visual Studio obsługuje Visual Studio Dev Tunnels (Visual Studio 2022 lub nowszy / zainstalowane wymagane obciążenie)
• Zainstaluj lub zaktualizuj rozszerzenie dev tunnels albo składnik CLI, jeśli jest wymagany
• Zaloguj się na konto Microsoft lub dzierżawę AAD używaną do dostępu do tunelu
• Utwórz nowy tunel dev tunnel w programie Visual Studio lub za pomocą interfejsu CLI dev tunnels
• Wybierz i potwierdź poprawną nazwę tunelu oraz region zapewniający niskie opóźnienia
• Wybierz i skonfiguruj lokalny punkt końcowy (port), który ma być udostępniany przez tunel
• Potwierdź protokół (HTTP/HTTPS lub TCP) i włącz TLS, jeśli udostępniasz HTTPS
• Skonfiguruj i zarezerwuj niestandardowe domeny lub subdomeny, jeśli są potrzebne
• Ustaw zasady dostępu: publiczny, dla uwierzytelnionych użytkowników lub dla określonych użytkowników bądź grup AAD
• Sprawdź ustawienia zapory i routera, aby zezwolić na ruch wychodzący tunelu
• Sprawdź, czy lokalna aplikacja jest uruchomiona i nasłuchuje na skonfigurowanym porcie
• Przetestuj łączność tunelu z zewnętrznego urządzenia lub od współpracownika
• Używaj HTTPS i prawidłowych certyfikatów dla punktów końcowych wrażliwych na bezpieczeństwo w środowisku produkcyjnym
• Regularnie zmieniaj poświadczenia i tokeny; unieważniaj nieużywane tokeny
• Monitoruj aktywne sesje tunelu i ich wykorzystanie w panelu Visual Studio lub w portalu
• Ogranicz udostępniane trasy i przekazuj tylko niezbędne punkty końcowe
• Włącz rejestrowanie i sprawdzaj dzienniki tunelu pod kątem błędów połączenia lub problemów z wydajnością
• Rozwiązuj typowe problemy: konflikty portów, błędy uwierzytelniania, niezgodność regionów
• Regularnie aktualizuj program Visual Studio i narzędzia dev tunnel, aby otrzymywać poprawki bezpieczeństwa
• Zamykaj lub usuwaj nieaktywne tunele, aby ograniczyć powierzchnię ataku i zużycie zasobów

Podsumowanie

Podsumowując, korzystanie z Visual Studio Dev Tunnels zamiast tradycyjnych wdrożeń w chmurze pozwala programistom znacznie skrócić pętle sprzężenia zwrotnego, ograniczyć koszty infrastruktury chmurowej i debugować lokalnie z pełną wiernością odwzorowania. Niezależnie od tego, czy tworzysz webhooki, aplikacje Teams, czy nowoczesne interfejsy API, ta wbudowana funkcja eliminuje tarcia. Aby zagłębić się w te zagadnienia i zobaczyć prezentację na żywo, koniecznie posłuchaj powiązanego odcinka, Test Microsoft 365 Apps with Visual Studio Dev Tunnels.