ASP.NET Web Forms veya MVC projeleri geliştirirken yerel ortamda test yapmak için alışagelmiş yöntem bellidir: Visual Studio açılır, çözüm dosyası yüklenir, ardından F5 veya Ctrl + F5 tuşlarına basılarak proje IIS Express üzerinde ayağa kaldırılır.
Ancak üzerinde aktif geliştirme yapmadığınız, yalnızca yönetim panelini veya sayfalarını araç olarak kullandığınız projeler için her defasında koca IDE’yi açıp beklemek zaman kaybettirir.
Bu rehberde, Visual Studio’yu hiç açmadan bir ASP.NET projesini masaüstünden tek tıkla doğrudan tarayıcıda çalıştırmayı ve bu süreçte karşılaşabileceğiniz kritik SSL/port yetki hatalarını nasıl aşacağınızı adım adım inceleyeceğiz.
Sorun: IDE’ye Bağımlı Çalışma Zorunluluğu
Geliştirilen yönetim paneli veya yerel araç sayfası http://localhost:[PORT]/Default.aspx adresinde çalışmaktadır. Bu adrese tarayıcıdan doğrudan gitmek istediğinizde web sunucusu (IIS Express) aktif olmadığı için bağlantı sağlanamaz.
Hedef, masaüstüne konulacak bir kısayol ile arka planda sunucuyu başlatıp aynı anda tarayıcıda ilgili sayfayı otomatik açmaktır.
Yaşanan Hatalar ve Teknik Sebepleri
Masaüstü otomasyonu için .bat (Batch) dosyası kurgulandığında karşımıza çıkan aşamalar ve çözümleri:
1. Hata: ERR_SSL_PROTOCOL_ERROR
İlk denemede IIS Express doğrudan /path ve /port parametreleriyle ayağa kaldırıldığında varsayılan olarak HTTP protokolünü dinler. Ancak komut sonrasında tarayıcıya https://localhost:44313/... çağrısı yapıldığında, SSL el sıkışması gerçekleşemez ve tarayıcıda ERR_SSL_PROTOCOL_ERROR (Bu site güvenli bağlantı sağlayamıyor) hatası döner.
2. Hata: Yetki Engeli (0x80070005)
Projenin Visual Studio ayarlarındaki applicationhost.config dosyası referans verildiğinde IIS Express konsolunda şu çıktı görülebilir:
Failed to register URL "https://localhost:44313/" for site "...". Error description: Erişim engellendi. (0x80070005)
Successfully registered URL "http://localhost:64447/" for site "..." application "/"
Windows HTTP API (http.sys), SSL portunu bağlamak için standart kullanıcı oturumunda yönetici (Administrator) izni arar. Ancak dikkat edilirse standart HTTP portu (64447) sorunsuz bir şekilde tescil edilmiştir.
Yerel bir yönetim aracı için gereksiz SSL zorunluluğu ve yönetici izni pop-up’ları ile uğraşmak yerine, başarıyla bağlanan yerel HTTP portunu kullanmak en pratik ve kalıcı çözümdür.
Çözüm Adımları
1. Adım: Projenin HTTP Portunu ve Yolunu Belirleyin
Projenizin çalıştığı fiziksel klasör yolunu (Web.config ve Default.aspx dosyalarının bulunduğu dizin) ve projenize atanmış standart HTTP portunu not edin:
-
Fiziksel Yol:
D:\TFS\BlogSitelerim\BlogSitelerim -
HTTP Portu:
64447
2. Adım: Masaüstü Başlatıcı (.bat) Dosyasını Oluşturun
-
Masaüstünde boş bir alana sağ tıklayın: Yeni -> Metin Belgesi oluşturun.
-
Dosyanın içerisine aşağıdaki komut satırlarını yapıştırın:
@echo off
:: IIS Express'i projenin fiziksel yolu ve HTTP portuyla başlat
start "" "C:\Program Files\IIS Express\iisexpress.exe" /path:"D:\TFS\BlogSitelerim\BlogSitelerim" /port:64447
:: Sunucunun ayağa kalkması için 2 saniye bekle ve sayfayı tarayıcıda aç
timeout /t 2 /nobreak >nul
start http://localhost:64447/Default.aspx
exit
-
Dosyayı kaydedin ve adını uzantısıyla birlikte
PaneliBaslat.batolarak değiştirin (uzantının.txtkalmadığından emin olun).
3. Adım: Test Edin
Oluşturduğunuz .bat dosyasına çift tıkladığınızda;
-
IIS Express arka planda devreye girer,
-
2 saniye içinde varsayılan web tarayıcınız açılarak doğrudan sayfanızı yükler,
-
Visual Studio’yu açıp derleme bekleme ihtiyacı tamamen ortadan kalkar.