Percepat Alur Kerja Anda: Mengapa Dev Tunnels di Visual Studio Lebih Unggul daripada Deployment Tradisional
By Mirko Peters ·
Selamat datang kembali di podcast! Jika Anda pernah menunggu lima belas menit hingga deployment ke cloud selesai hanya untuk menguji satu baris perubahan kode, Anda…
Automatically translated with AI from the original post. Read the English original
Selamat datang kembali di podcast! Jika Anda pernah menunggu lima belas menit hingga deployment ke cloud selesai hanya untuk menguji satu baris perubahan kode, Anda tahu betapa besar beban yang itu berikan pada produktivitas Anda. Hari ini, kita akan membahas lebih jauh topik yang telah sepenuhnya mengubah cara tim engineering kami menangani pengujian lokal, debugging, dan integrasi. Pastikan Anda juga menyimak episode podcast terkait, Test Microsoft 365 Apps with Visual Studio Dev Tunnels, tempat kami mengupas alur kerja ini secara langsung.
Dalam panduan komprehensif ini, kita akan membahas mengapa metode deployment tradisional mulai tertinggal dibandingkan solusi tunneling modern, bagaimana Visual Studio Dev Tunnels bekerja di balik layar, dan bagaimana Anda dapat mengintegrasikannya secara mulus ke dalam proyek Microsoft 365, Teams, dan ASP.NET Core Anda.
Pengujian Lokal dengan Visual Studio Dev Tunnels
Mengapa Pengujian Lokal Penting
Anda ingin aplikasi Microsoft 365 Anda berfungsi dengan sempurna sebelum dibagikan kepada pengguna. Pengujian lokal memungkinkan Anda menangkap bug sejak dini dan melihat bagaimana kode Anda berperilaku di lingkungan yang aman. Saat menguji secara lokal, Anda dapat melakukan perubahan dengan cepat dan langsung melihat hasilnya. Proses ini menghemat waktu dan membantu Anda menghindari kesalahan yang mungkin muncul di production.
Pengujian localhost tradisional memiliki keterbatasan. Mesin lokal Anda tidak dapat menerima koneksi dari internet. Hal ini membuat sulit untuk menguji fitur yang membutuhkan akses dunia nyata, seperti webhook, alur autentikasi, atau integrasi dengan layanan Microsoft 365. Anda mungkin merasa terhambat dan tidak dapat mensimulasikan bagaimana aplikasi Anda akan berperilaku bagi pengguna sebenarnya.
Dev Tunnels telah merevolusi cara kami mengembangkan dan menguji aplikasi web, terutama bagi pengembang mobile yang sering menghadapi kendala saat menyiapkan server lokal untuk pengujian. Ini adalah fitur yang mengubah permainan dan memperkuat kolaborasi serta menyederhanakan proses pengembangan.
Dengan alat yang tepat, Anda dapat mengatasi tantangan ini. Anda dapat membuat lingkungan yang realistis untuk aplikasi Anda, bahkan saat bekerja dari komputer Anda sendiri.
Cara Dev Tunnels Memungkinkan Pengujian Lokal
Anda dapat menguji aplikasi Microsoft 365 dari localhost menggunakan visual studio dev tunnels. Alat ini memberi Anda cara yang aman untuk mengekspos layanan lokal Anda ke internet. Anda tidak perlu men-deploy kode ke Azure atau platform cloud lain hanya untuk melihat cara kerjanya bersama Microsoft 365.
Visual Studio Dev Tunnels meningkatkan pengujian localhost tradisional dengan memungkinkan Anda mengekspos aplikasi lokal ke internet secara aman. Kemampuan ini memungkinkan koneksi masuk, yang penting untuk menguji aplikasi Microsoft 365 dalam lingkungan yang lebih realistis, sekaligus mengatasi keterbatasan pengujian yang hanya terbatas pada lokal.
Berikut cara dev tunnels meningkatkan kecepatan dan keamanan pengujian lokal Anda:
- Dev tunnels memungkinkan layanan lokal berfungsi sebagai endpoint cloud yang aman dalam waktu kurang dari 3 menit.
- Dev tunnels memfasilitasi akses internet yang aman untuk pengujian lokal aplikasi Microsoft 365.
- Konfigurasi yang tepat sangat penting untuk menghindari tereksposnya lingkungan pengembangan.
Anda dapat menyiapkan tunnel hanya dengan beberapa klik atau perintah. Anda memilih nama dan visibilitas tunnel, sehingga Anda mengontrol siapa yang dapat mengakses aplikasi Anda. Anda dapat menggunakan autentikasi untuk menjaga keamanan pekerjaan Anda. Fleksibilitas ini berarti Anda dapat berkolaborasi dengan rekan tim atau mengundang penguji tanpa membagikan seluruh komputer Anda.
Dev tunnels memungkinkan Anda menguji fitur seperti autentikasi OAuth, bot Teams, atau web part SharePoint seolah-olah berjalan di cloud. Anda mendapatkan umpan balik secara real-time dan dapat men-debug masalah seketika itu juga. Proses ini membuat siklus pengembangan Anda lebih cepat dan lebih andal.
Saat Anda menggunakan dev tunnels, Anda membangun kepercayaan diri terhadap kode Anda sebelum di-deploy. Anda tahu aplikasi Anda berfungsi di dunia nyata, bukan hanya di mesin Anda.
Ikhtisar Visual Studio Dev Tunnels
Fitur Utama
Visual Studio Dev Tunnels memberi Anda cara yang ampuh untuk menguji dan men-debug aplikasi Microsoft 365 dari mesin lokal Anda. Anda dapat mengekspos layanan asp.net core ke internet hanya dengan beberapa langkah. Alat ini membantu Anda membuat lingkungan pengembangan yang aman dan fleksibel.
Berikut beberapa fitur utama yang akan berguna bagi Anda:
- Anda dapat mengekspos API lokal menggunakan URL jarak jauh, sehingga mudah menguji dan men-debug proyek asp.net core Anda.
- Integrasi dengan layanan pihak ketiga menjadi sederhana karena aplikasi lokal Anda memiliki URL yang dapat diakses publik.
- Anda dapat mengatur breakpoint pada localhost dan melihat bagaimana kode asp.net core Anda merespons ketika URL jarak jauh diakses.
- Tunnel bernama membantu Anda berbagi proyek atau layanan tertentu tanpa membingungkan.
- Tunnel persisten memungkinkan Anda mempertahankan akses dari waktu ke waktu, yang penting untuk proyek asp.net core yang berkelanjutan.
- Anda dapat memilih tingkat akses untuk tunnel Anda: privat, organisasi, atau publik. Dengan begitu, Anda mudah mengontrol siapa saja yang dapat melihat pekerjaan Anda.
- Autentikasi Entra ID membatasi akses hanya bagi pengguna dengan kredensial yang valid, sehingga data Anda tetap aman.
- CLI memungkinkan Anda mengelola dan mengotomatiskan pembuatan dan konfigurasi tunnel. Anda dapat menggunakan perintah untuk membuat, mencantumkan, dan memberi tag pada tunnel agar pengelolaannya lebih mudah.
Tips: Tunnel persisten dan tunnel bernama membantu Anda menghindari pembuatan ulang tunnel setiap kali Anda memulai ulang proyek asp.net core. Ini menghemat waktu dan mengurangi kesalahan.
Cara Kerja Dev Tunnels
Dev tunnels membuat jembatan yang aman antara server asp.net core lokal Anda dan internet. Anda dapat menguji aplikasi Microsoft 365 seolah-olah aplikasi tersebut berjalan di lingkungan produksi.
Endpoint Publik yang Aman
Anda mulai dengan mengunduh dan memasang devtunnel CLI. Setelah masuk dengan akun Entra ID, Microsoft, atau GitHub, Anda menjalankan server asp.net core lokal. Kemudian, Anda meng-host atau membuat tunnel menggunakan perintah devtunnel host –p PORT. Jika Anda menginginkan URL permanen, gunakan perintah devtunnel create untuk membuat tunnel persisten.
Proses ini memberi Anda endpoint yang aman dan dapat diakses internet untuk layanan asp.net core lokal Anda. Sekarang Anda dapat menguji webhook, alur autentikasi, dan integrasi yang memerlukan URL publik. Autentikasi Entra ID memastikan hanya pengguna yang disetujui dapat mengakses tunnel Anda, sehingga risiko paparan data yang tidak disengaja berkurang.
Integrasi dengan Visual Studio dan CLI
Visual Studio memudahkan pembuatan dan pengelolaan dev tunnels. Anda dapat menyiapkan tunnel hanya dengan beberapa klik di dalam IDE. CLI menawarkan lebih banyak opsi, seperti tunnel dengan masa berlaku tetap dan pemberian tag untuk pengorganisasian yang lebih baik. Anda dapat mengotomatiskan pembuatan tunnel untuk proyek asp.net core Anda, sehingga alur kerja Anda menjadi lebih cepat dan andal.
Anda juga dapat mencantumkan semua tunnel Anda, melihat detailnya, dan mengelola izin akses. Fleksibilitas ini membantu Anda berkolaborasi dengan tim dan menjaga lingkungan pengembangan tetap aman.
Catatan: Dev tunnels dirancang untuk mengekspos endpoint asp.net core lokal Anda secara aman ke internet, sehingga pengujian dan debugging menjadi aman dan efisien.
Membuat atau Meng-host Tunnel di Visual Studio
Prasyarat dan Penyiapan
Sebelum Anda meng-host atau membuat tunnel untuk pengujian aplikasi Microsoft 365, Anda perlu menyiapkan lingkungan Anda. Visual Studio menyediakan alat yang Anda butuhkan, tetapi Anda harus memenuhi beberapa persyaratan terlebih dahulu. Tabel berikut menunjukkan apa yang Anda perlukan untuk memulai:
| Prasyarat | Deskripsi |
|---|---|
| Visual Studio 2022 Preview | Unduh versi 17.6 atau yang lebih baru. Pastikan workload ASP.NET dan pengembangan web sudah terinstal. Masuk untuk menggunakan dev tunnels. |
| Lingkungan Power Platform | Anda memerlukan Power Automate atau Power Apps. |
Anda perlu memeriksa apakah Anda memiliki versi Visual Studio yang benar. Buka installer dan pastikan workload ASP.NET dan pengembangan web aktif. Masuk dengan akun Microsoft Anda untuk mengakses jendela alat dev tunnels. Jika Anda berencana menghubungkan proyek asp.net core ke Power Platform, pastikan Anda memiliki akses ke Power Automate atau Power Apps.
Tip: Menjaga alat Anda tetap diperbarui membantu Anda menghindari masalah pengaturan dan memastikan Anda dapat menggunakan fitur terbaru di jendela alat dev tunnels.
Membuat dan Memberi Nama Tunnel
Anda dapat membuat tunnel langsung dari jendela alat dev tunnels di Visual Studio. Proses ini memungkinkan Anda mengekspos layanan asp.net core ke internet untuk pengujian Microsoft 365 App. Ikuti langkah-langkah berikut untuk membuat dan memberi nama tunnel Anda:
- Pada dropdown debug, pilih Dev Tunnels > Create A Tunnel.
- Jendela alat dev tunnels akan membuka sebuah dialog. Pilih akun yang ingin Anda gunakan.
- Masukkan nama untuk tunnel Anda. Nama ini membantu Anda mengenalinya di jendela alat dev tunnels.
- Pilih jenis tunnel. Pilih Persistent jika Anda ingin URL yang sama setiap saat, atau Temporary untuk URL baru setiap sesi.
- Pilih jenis autentikasi: Private, Organization, atau Public.
- Klik OK untuk membuat tunnel.
Saat Anda membuat tunnel, Anda mempermudah penghubungan proyek asp.net core ke layanan Microsoft 365. Jendela alat dev tunnels menjaga tunnel Anda tetap teratur dan terlihat. Anda selalu dapat menemukan tunnel aktif dan mengelolanya dari jendela ini.
Catatan: Memberi nama tunnel membantu Anda dan tim Anda melacak layanan asp.net core mana yang diekspos. Gunakan nama yang jelas untuk setiap tunnel di jendela alat dev tunnels.
Mengatur Visibilitas Tunnel
Visibilitas tunnel mengontrol siapa yang dapat mengakses dev tunnels Anda. Anda mengatur opsi ini di jendela alat dev tunnels saat membuat tunnel. Tingkat visibilitas yang tepat melindungi pekerjaan Anda dan mendukung kolaborasi.
Berikut opsi visibilitas utama:
| Opsi Visibilitas | Deskripsi |
|---|---|
| Private | Hanya Anda yang dapat mengakses tunnel. |
| Organization | Siapa pun di organisasi Anda dapat mengakses tunnel. Untuk akun pribadi, ini sama dengan Private. |
| Public | Siapa pun di internet dapat mengakses tunnel. Gunakan opsi ini dengan hati-hati. |
Anda juga dapat melihat opsi ini sebagai:
- Private: Hanya Anda yang dapat menggunakan tunnel.
- Organization: Tim atau perusahaan Anda dapat menggunakan tunnel.
- Public: Siapa pun dapat menggunakan tunnel.
Jendela alat dev tunnels memungkinkan Anda mengubah visibilitas saat membuat dan mengelola dev tunnels. Memilih visibilitas yang tepat membantu Anda memantau lalu lintas dan menjaga keamanan Microsoft 365 App Anda. Tunnel Private paling cocok untuk pengembangan solo. Tunnel Organization membantu tim menguji bersama. Tunnel Public memungkinkan penguji dari luar, tetapi memerlukan kehati-hatian ekstra.
Perhatian: Tunnel Public tidak memerlukan autentikasi. Gunakan hanya saat Anda perlu membagikan aplikasi kepada pengguna di luar organisasi Anda, dan selalu pantau akses di jendela alat dev tunnels.
Visibilitas tunnel memengaruhi keamanan dan kolaborasi. Saat Anda menetapkan tingkat yang tepat, Anda memastikan hanya orang yang tepat yang dapat mengakses aplikasi Anda. Ini mengurangi risiko dan membantu tim Anda bekerja sama dengan lancar.
Menggunakan CLI Dev Tunnels
Anda dapat mengelola dev tunnels langsung dari command line menggunakan Dev Tunnels CLI. Alat ini memberi Anda fleksibilitas dan kecepatan, terutama saat Anda ingin mengotomatiskan alur kerja atau bekerja di luar antarmuka Visual Studio. CLI cocok untuk pengujian cepat maupun pengaturan yang lebih lanjut.
Untuk memulai, Anda perlu menginstal Dev Tunnels CLI. Anda dapat melakukannya dengan menjalankan perintah berikut di terminal Anda:
dotnet tool install -g Microsoft.DevTunnels.CliSetelah instalasi, Anda harus masuk. Gunakan akun Microsoft, Entra ID, atau akun GitHub Anda. Langkah ini menghubungkan sesi CLI Anda ke lingkungan Visual Studio dan memastikan akses yang aman.
devtunnel loginSetelah masuk, Anda dapat membuat dan mengelola tunnel. Berikut cara sederhana untuk membuat tunnel bagi proyek lokal Anda:
devtunnel host -p 5000Perintah ini mengekspos layanan lokal Anda yang berjalan di port 5000 ke internet. CLI akan menampilkan URL publik yang dapat Anda gunakan untuk menguji Microsoft 365 App Anda. Anda dapat membagikan URL ini kepada tim Anda atau menggunakannya untuk pengujian integrasi.
Jika Anda ingin terowongan persisten dengan nama kustom, gunakan:
devtunnel create my-tunnel --persistent
devtunnel host my-tunnel -p 5000Pendekatan ini membantu Anda mempertahankan URL yang sama di setiap sesi, yang penting untuk URI pengalihan OAuth dan pengujian yang konsisten. Anda juga dapat mengatur visibilitas terowongan langsung dari CLI. Misalnya, untuk membuat terowongan hanya dapat diakses oleh organisasi Anda, tambahkan flag --access organization:
devtunnel create my-tunnel --persistent --access organizationTips: Gunakan nama yang jelas dan deskriptif untuk terowongan Anda. Hal ini memudahkan pengelolaan banyak proyek di visual studio dan menghindari kebingungan.
Anda dapat membuat daftar semua terowongan aktif kapan saja:
devtunnel listUntuk menghentikan terowongan, gunakan:
devtunnel close my-tunnelCLI juga memungkinkan Anda mengotomatiskan pembuatan terowongan dalam skrip. Fitur ini berguna ketika Anda ingin menyiapkan dev tunnels sebagai bagian dari proses build atau deployment. Anda dapat membagikan perintah CLI kepada tim agar semua orang menggunakan konfigurasi yang sama, yang meningkatkan konsistensi dan mengurangi kesalahan.
Catatan: Dev Tunnels CLI bekerja dengan lancar bersama visual studio. Anda dapat beralih antara CLI dan antarmuka visual studio tanpa kehilangan pengaturan terowongan.
Dengan menguasai Dev Tunnels CLI, Anda memperoleh kendali lebih besar atas lingkungan pengembangan Anda. Anda dapat dengan cepat membuat, mengelola, dan mengamankan terowongan untuk proyek Microsoft 365 App apa pun. Fleksibilitas ini membantu Anda menguji dan men-debug aplikasi secara efisien, baik saat bekerja sendiri maupun dalam tim.
Mengonfigurasi Microsoft 365 Apps untuk Dev Tunnels

Memperbarui Pendaftaran Aplikasi dan URI Pengalihan
Anda perlu memperbarui pendaftaran aplikasi dan URI pengalihan agar proyek asp.net core lokal Anda terhubung ke layanan Microsoft 365 melalui visual studio. Proses ini membantu aplikasi Anda menggunakan endpoint aman yang disediakan oleh dev tunnels. Berikut cara sederhana untuk menyiapkan pendaftaran aplikasi:
- Buka portal Microsoft Entra ID – App Registrations.
- Pilih "New Registration" lalu masukkan nama aplikasi Anda.
- Pilih jenis akun yang didukung untuk aplikasi Anda.
- Biarkan kolom Redirect URI kosong untuk sementara.
- Klik "Register" untuk membuat aplikasi Anda.
- Pada halaman ikhtisar, salin Application (client) ID dan ID Direktori (penyewa).
- Di bawah "Manage," pilih "Expose an API."
- Klik tautan "Set" untuk membuat Application ID URI.
- Tambahkan scope bernama "access_as_user."
- Atur "Who can consent?" ke "Admins and users."
- Isi prompt persetujuan admin dan pengguna.
- Pastikan status diatur ke "Enabled."
- Pilih "Add scope" untuk menyelesaikan.
Setelah Anda membuat terowongan di visual studio, Anda perlu memperbarui Redirect URI di pendaftaran aplikasi. Gunakan URL publik dari terowongan asp.net core Anda sebagai Redirect URI. Langkah ini memberi tahu Microsoft 365 ke mana harus mengirim respons autentikasi selama pengujian.
Tips: Selalu simpan client ID dan ID penyewa Anda. Anda akan membutuhkannya untuk autentikasi dan pengaturan OAuth.
Menghubungkan Aplikasi Teams, SharePoint, dan Power Platform
Anda dapat menggunakan visual studio untuk menghubungkan layanan asp.net core Anda ke Teams, SharePoint, dan Power Platform Apps. Dev tunnels membuat proses ini aman dan sederhana. Saat menggunakan terowongan, Anda akan menerima peringatan jika terhubung ke endpoint terowongan. Peringatan ini membantu Anda menghindari serangan phishing dan pembagian URL sensitif secara tidak sengaja.
- Bot Teams dan message extension secara default menggunakan dev tunnels untuk pengembangan lokal. Pengaturan ini memberi Anda cara yang aman untuk menguji fitur sebelum di-deploy.
- Web part SharePoint dan konektor Power Platform juga mendapat manfaat dari endpoint yang aman. Anda dapat menguji webhook, autentikasi, dan alur data dalam skenario nyata.
- Autentikasi identitas Microsoft 365 menambah lapisan keamanan lain. Anda harus masuk dengan akun Microsoft 365 untuk membuat dan mengelola terowongan di visual studio.
Catatan: Kesadaran keamanan yang baik membantu Anda dan tim tetap aman saat menguji aplikasi asp.net core.
Menangani Autentikasi dan OAuth
Anda harus mengonfigurasi autentikasi dan OAuth agar Microsoft 365 Apps dapat bekerja dengan dev tunnels. Berikut panduan langkah demi langkah:
- Daftarkan aplikasi Anda di portal Microsoft Entra ID.
- Atur application URI agar sesuai dengan endpoint terowongan dari visual studio.
- Buat client secret untuk pertukaran token.
- Tambahkan izin API untuk akses Microsoft Graph.
- Perbarui Redirect URI agar menggunakan URL terowongan asp.net core Anda.
- Siapkan dev tunnels untuk menghosting layanan lokal Anda.
- Clone repositori proyek Anda dan perbarui file konfigurasi dengan client ID, tenant ID, dan secret Anda.
- Buka Visual Studio dan jalankan proyek ASP.NET Core Anda.
Penyiapan ini memungkinkan aplikasi Anda menangani sign-in, pertukaran token, dan panggilan API secara aman. Anda dapat menguji alur autentikasi, seperti OAuth, di lingkungan yang aman sebelum beralih ke produksi.
Selalu periksa ulang Redirect URI dan izin Anda. Langkah ini mencegah kesalahan autentikasi yang umum terjadi dan menjaga pengujian Anda tetap aman.
Keamanan dan Praktik Terbaik
Opsi Visibilitas Tunnel
Anda mengontrol siapa yang dapat mengakses lingkungan pengembangan Anda dengan mengatur visibilitas tunnel. Saat membuat tunnel, Anda memilih antara akses privat, organisasi, atau publik. Tunnel privat hanya memungkinkan Anda sendiri untuk terhubung. Tunnel organisasi memungkinkan siapa pun di perusahaan Anda menggunakan tunnel tersebut. Tunnel publik membuka akses bagi siapa saja yang memiliki tautannya. Selalu pilih tingkat visibilitas terendah yang dibutuhkan proyek Anda.
Untuk memaksimalkan keamanan selama pengujian Aplikasi Microsoft 365, ikuti praktik terbaik berikut:
- Atur tunnel ke privat atau organisasi bila memungkinkan.
- Terapkan split tunneling untuk aplikasi Office 365. Metode ini meningkatkan performa dan menjaga keamanan data Anda.
- Gunakan rentang alamat IP yang disediakan Microsoft untuk split tunneling. Hindari penggunaan fully qualified domain name.
- Nonaktifkan intersepsi SSL untuk lalu lintas Office 365. Langkah ini membantu Anda mematuhi rekomendasi keamanan Microsoft.
- Pastikan kebijakan split tunneling Anda berfungsi dengan menggunakan alat uji konektivitas Microsoft 365.
- Matikan SSL Break and Inspect untuk domain Office 365.
Tips: Tinjau pengaturan visibilitas tunnel Anda sebelum membagikan URL apa pun. Kebiasaan ini membantu mencegah terbukanya lingkungan pengembangan Anda secara tidak sengaja.
Mengamankan Akses dengan Entra ID
Anda dapat mengamankan tunnel dengan mewajibkan autentikasi menggunakan Entra ID. Fitur ini memastikan hanya pengguna yang disetujui yang dapat mengakses layanan lokal Anda. Saat Anda mengaktifkan autentikasi Entra ID, Anda menambahkan lapisan perlindungan yang kuat pada dev tunnel Anda. Hanya pengguna dengan kredensial yang valid yang dapat terhubung, sehingga data Anda tetap aman.
Entra ID juga mendukung akses organisasi. Anda dapat mengizinkan seluruh tim untuk menguji dan men-debug aplikasi tanpa membuka tunnel Anda ke publik. Pendekatan ini menyeimbangkan keamanan dan kolaborasi. Selalu gunakan autentikasi Entra ID untuk proyek sensitif atau ketika menangani informasi rahasia.
Catatan: Autentikasi Entra ID bekerja dengan mulus baik pada antarmuka Visual Studio maupun alat command-line.
Memantau dan Mengelola Tunnel
Anda perlu memantau dan mengelola tunnel untuk menjaga alur kerja yang aman dan efisien. Visual Studio menyediakan fitur bawaan untuk mengelola dev tunnel. Anda dapat melihat tunnel yang aktif, memeriksa statusnya, dan menyesuaikan pengaturan akses dari dalam IDE. Antarmuka command-line juga memungkinkan Anda membuat, mencantumkan, dan menutup tunnel dengan cepat.
Praktik terbaik untuk mengelola tunnel meliputi:
- Tinjau daftar tunnel aktif Anda secara berkala.
- Tutup tunnel saat Anda selesai menguji untuk mengurangi risiko keamanan.
- Gunakan nama yang deskriptif untuk setiap tunnel agar tidak membingungkan.
- Pilih antara tunnel sementara atau permanen sesuai kebutuhan proyek Anda.
- Atur kontrol akses agar sesuai dengan persyaratan keamanan Anda.
Tabel berikut dapat membantu Anda membandingkan opsi pengelolaan tunnel:
| Alat Pengelolaan | Fitur |
|---|---|
| Visual Studio IDE | Melihat, membuat, mengedit, dan menutup tunnel |
| Command-Line (CLI) | Mengotomatisasi pembuatan dan pengelolaan tunnel |
Ingat: Pengelolaan tunnel yang baik menjaga lingkungan pengembangan Anda tetap teratur dan aman.
Kesalahan Umum yang Perlu Dihindari
Saat Anda menggunakan Visual Studio Dev Tunnels untuk pengujian Aplikasi Microsoft 365, hindari kesalahan yang dapat memperlambat pekerjaan Anda atau membahayakan proyek. Banyak pengembang mengalami masalah yang sama. Jika Anda mengetahui hal yang perlu diwaspadai, Anda dapat menghemat waktu dan menjaga lingkungan Anda tetap aman.
1. Memilih Visibilitas Tunnel yang Salah
Anda mungkin memilih tunnel publik demi kemudahan. Pilihan ini bisa membuat aplikasi Anda terbuka bagi siapa pun yang memiliki tautannya. Selalu periksa visibilitas tunnel Anda sebelum mulai menguji. Untuk sebagian besar proyek, gunakan tunnel privat atau tunnel organisasi. Gunakan tunnel publik hanya jika Anda membutuhkan penguji dari luar, dan selalu pantau aksesnya.
Tip: Tinjau pengaturan tunnel Anda sebelum membagikan URL kepada rekan tim atau penguji.
2. Lupa Memperbarui Redirect URI
Jika Anda mengubah URL tunnel, Anda harus memperbarui redirect URI di pendaftaran aplikasi Anda. Jika langkah ini terlewat, autentikasi akan gagal. Selalu pastikan pendaftaran aplikasi Anda sesuai dengan endpoint tunnel Anda saat ini.
3. Mengabaikan Pengaturan Autentikasi
Anda mungkin lupa mengaktifkan autentikasi Entra ID untuk tunnel Anda. Tanpa ini, siapa pun yang memiliki tautannya dapat mengakses layanan lokal Anda. Selalu wajibkan autentikasi untuk proyek yang sensitif. Langkah ini melindungi data dan pengguna Anda.
4. Membiarkan Tunnel Tetap Terbuka Setelah Pengujian
Jika Anda membiarkan tunnel tetap berjalan setelah selesai, risiko keamanan Anda akan meningkat. Tunnel yang tidak digunakan bisa menjadi sasaran akses yang tidak diinginkan. Selalu tutup tunnel saat Anda tidak lagi membutuhkannya.
5. Menggunakan Nama Tunnel yang Umum atau Membingungkan
Jika Anda menggunakan nama tunnel yang tidak jelas, Anda dan tim Anda bisa keliru. Gunakan nama deskriptif yang sesuai dengan proyek atau layanan Anda. Kebiasaan ini membantu Anda mengelola beberapa tunnel dan menghindari kesalahan.
6. Mengabaikan Pemantauan Log
Anda mungkin tidak memeriksa log tunnel Anda. Log membantu Anda mengenali aktivitas yang tidak biasa atau akses yang tidak sah. Jadikan kebiasaan untuk meninjau log secara rutin.
| Jebakan | Cara Menghindarinya |
|---|---|
| Tunnel publik untuk aplikasi privat | Atur tunnel menjadi privat atau organisasi |
| Redirect URI usang | Perbarui pendaftaran aplikasi setelah tunnel berubah |
| Tanpa autentikasi | Aktifkan autentikasi Entra ID |
| Tunnel yang tidak ditutup | Tutup tunnel setelah pengujian |
| Nama tunnel yang kurang jelas | Gunakan nama yang jelas dan deskriptif |
| Mengabaikan log | Pantau log untuk aktivitas mencurigakan |
Catatan: Sebagian besar masalah dapat dicegah dengan mengikuti daftar periksa sebelum dan sesudah setiap sesi pengujian.
Dengan selalu waspada terhadap jebakan umum ini, proses pengembangan Anda akan berjalan lancar dan aplikasi Microsoft 365 Anda tetap aman. Anda juga membangun kebiasaan yang lebih baik dan membantu tim Anda menghindari masalah yang tidak perlu.
Pemecahan Masalah dan Tips Lanjutan
Men-debug Masalah Koneksi
Anda terkadang mungkin menghadapi masalah koneksi saat bekerja dengan tunnel. Mulailah dengan memeriksa apakah layanan lokal Anda berjalan dan mendengarkan pada port yang benar. Gunakan command line untuk memastikan layanan Anda merespons permintaan. Jika muncul kesalahan, mulai ulang layanan Anda lalu coba lagi.
Berikutnya, periksa pengaturan firewall Anda. Firewall dapat memblokir koneksi masuk. Izinkan lalu lintas pada port yang Anda gunakan untuk tunnel. Jika Anda menggunakan VPN, putuskan sambungannya lalu uji kembali. VPN dapat mengubah pengaturan jaringan Anda dan menimbulkan masalah.
Jika masih mengalami kendala, gunakan perintah devtunnel list untuk melihat semua tunnel yang aktif. Pastikan Anda menggunakan URL tunnel yang benar di aplikasi Microsoft 365 Anda. Terkadang, penyalinan URL yang salah menyebabkan kegagalan koneksi.
Tip: Selalu uji URL tunnel Anda di browser sebelum mulai menguji dan men-debug. Langkah ini membantu Anda menemukan kesalahan sederhana sejak awal.
Menangani Kesalahan Autentikasi
Kesalahan autentikasi dapat menghentikan aplikasi Anda bekerja dengan layanan Microsoft 365. Pertama, periksa pendaftaran aplikasi Anda di portal Microsoft Entra ID. Pastikan redirect URI Anda sama persis dengan URL tunnel. Bahkan salah ketik kecil dapat menyebabkan kegagalan.
Periksa client ID dan secret Anda. Nilai-nilai ini harus sesuai dengan yang Anda atur dalam konfigurasi aplikasi. Jika Anda mengubah tunnel atau membuat yang baru, perbarui redirect URI di pendaftaran aplikasi Anda.
Jika muncul pesan "unauthorized", periksa visibilitas dan pengaturan autentikasi tunnel Anda. Untuk proyek yang sensitif, selalu gunakan autentikasi Entra ID. Langkah ini menjaga keamanan data Anda dan mencegah akses yang tidak diinginkan.
Catatan: Sebagian besar kesalahan autentikasi berasal dari URL yang tidak cocok atau izin yang hilang. Periksa ulang pengaturan ini saat proses debugging.
Advanced CLI dan Otomatisasi
Anda dapat menggunakan CLI Dev Tunnels untuk mengotomatiskan alur kerja Anda. Otomatisasi menghemat waktu dan mengurangi kesalahan. Misalnya, Anda dapat menulis skrip untuk membuat tunnel, menjalankan layanan lokal, lalu membuka halaman pengujian di browser.
Berikut contoh skrip untuk 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"Anda dapat membagikan skrip seperti ini kepada tim Anda. Semua orang dapat menggunakan pengaturan yang sama untuk pengujian dan debugging. Pendekatan ini membantu Anda bekerja sama dan menghindari kesalahan konfigurasi.
Jika Anda ingin menutup semua tunnel sekaligus, gunakan:
devtunnel close --allMengotomatiskan pengelolaan tunnel membuat proses pengembangan Anda lebih lancar dan lebih andal. Cobalah menggunakan skrip untuk tugas yang berulang.
Anda dapat meningkatkan pengembangan aplikasi Microsoft 365 dengan menggunakan Visual Studio dev tunnels. Alat ini membuat pengujian lebih cepat dan lebih aman. Mulailah dengan menyiapkan tunnel pertama Anda, lalu ikuti praktik terbaik untuk visibilitas dan autentikasi. Jelajahi fitur lanjutan untuk meningkatkan alur kerja Anda. Ingatlah untuk memprioritaskan keamanan dan kerja sama tim saat Anda terus menguji dan membangun aplikasi yang lebih baik.
Daftar Periksa Visual Studio Dev Tunnels
Daftar periksa singkat untuk mengonfigurasi, menggunakan, dan memecahkan masalah Visual Studio Dev Tunnels.
- Pastikan versi Visual Studio mendukung Visual Studio Dev Tunnels (Visual Studio 2022 atau yang lebih baru / workload yang diperlukan sudah terpasang)
- Pasang atau perbarui ekstensi atau komponen CLI dev tunnels jika diperlukan
- Masuk dengan akun Microsoft atau penyewa AAD Anda yang digunakan untuk akses tunnel
- Buat dev tunnel baru dari Visual Studio atau melalui CLI dev tunnels
- Pilih dan pastikan nama tunnel dan wilayah yang tepat untuk latensi rendah
- Pilih dan konfigurasikan endpoint lokal (port) yang akan diekspos melalui tunnel
- Pastikan protokol (HTTP/HTTPS atau TCP) dan aktifkan TLS jika mengekspos HTTPS
- Konfigurasikan dan pesan domain khusus atau subdomain jika diperlukan
- Atur kebijakan akses: publik, pengguna terautentikasi, atau pengguna/grup AAD tertentu
- Validasi pengaturan firewall dan router agar lalu lintas tunnel keluar diizinkan
- Pastikan aplikasi lokal sedang berjalan dan mendengarkan pada port yang dikonfigurasi
- Uji konektivitas tunnel dari perangkat eksternal atau kolaborator
- Gunakan HTTPS dan sertifikat yang valid untuk endpoint yang sensitif di lingkungan produksi
- Rotasi kredensial dan token secara berkala; cabut token yang tidak digunakan
- Pantau sesi dan penggunaan tunnel aktif dari dasbor Visual Studio atau portal
- Batasi rute yang diekspos dan hanya teruskan endpoint yang diperlukan
- Aktifkan logging dan periksa log tunnel untuk melihat kesalahan koneksi atau masalah performa
- Atasi masalah umum: konflik port, kegagalan autentikasi, dan ketidaksesuaian wilayah
- Perbarui Visual Studio dan alat dev tunnel secara berkala untuk perbaikan keamanan
- Tutup atau hapus tunnel yang tidak aktif untuk mengurangi permukaan serangan dan penggunaan sumber daya
Kesimpulan
Singkatnya, memanfaatkan Visual Studio Dev Tunnels sebagai pengganti penerapan cloud tradisional memungkinkan pengembang untuk mempercepat siklus umpan balik secara drastis, meminimalkan biaya infrastruktur cloud, dan melakukan debugging secara lokal dengan fidelitas penuh. Baik Anda membangun webhook, aplikasi Teams, maupun API modern, fitur bawaan ini menghilangkan hambatan. Untuk pembahasan yang lebih mendalam tentang konsep-konsep ini dan panduan langsung, pastikan Anda mendengarkan episode terkait kami, Test Microsoft 365 Apps with Visual Studio Dev Tunnels.