Yerel HTTPS

Bazı özellikler yalnızca HTTPS üzerinde çalışır: güvenli çerezler, ödeme sağlayıcılarının test modları, service worker, bazı OAuth girişleri. Coduva her proje için tek tıkla HTTPS açar ve tarayıcının bu sertifikalara güvenmesini sağlar.

Nasıl çalışır?

1. Coduva bilgisayarınıza özel bir sertifika otoritesi (CA) üretir. Bu CA yalnızca sizin bilgisayarınızda vardır.
2. HTTPS açtığınız her proje için CA ile imzalanmış bir sertifika üretilir (ad.test adına, 825 gün geçerli). Süresinin dolmasına 30 günden az kalan sertifikayı Coduva, web sunucusu yapılandırmasını yazarken kendiliğinden yeniler.
3. CA'yı Windows'un güvenilen sertifikalarına eklediğinizde tarayıcılar bu sertifikaları geçerli sayar.

CA, Windows'un kullanıcı sertifika deposuna eklenir (certutil -user). Bu yüzden yönetici izni gerekmez ve yalnızca sizin Windows hesabınızı etkiler.

1. Projede HTTPS'i açın

Üç yoldan birini kullanın:

• Yeni proje oluştururken: HTTPS kullan kutusunu işaretleyin.
• Var olan bir projede: proje sayfasında Genel sekmesini açın ve HTTPS kullan anahtarını açın.
• Toplu olarak: Yerel HTTPS ekranındaki Projeler listesinde projenin satırındaki anahtarı açın. Listenin üstünde kaç projede HTTPS açık olduğu yazar (ör. 2/5 HTTPS).

CA henüz yoksa Coduva onu ilk HTTPS açılışında oluşturur. Ardından proje sertifikasını üretir ve Nginx'i kesintisiz yeniden yükler. Projenin adresi https://ad.test/ olur.

HTTPS'i kapattığınızda projenin sertifikası silinir; yeniden açtığınızda yenisi üretilir.

2. Sertifika otoritesini güvenilir yapın

Bunu yalnızca bir kez yapmanız gerekir.

1. Yerel HTTPS ekranını açın.
2. Coduva yerel sertifika otoritesi kartında durumun Güvenilir değil: tarayıcı uyarı gösterir olduğunu görürsünüz. CA henüz oluşturulmadıysa kartta "Henüz oluşturulmadı" yazar; aşağıdaki düğme CA'yı önce oluşturur.
3. Güvenilir yap düğmesine tıklayın.
4. Windows bir güvenlik uyarısı penceresi gösterir ve sertifikayı yüklemek isteyip istemediğinizi sorar. Evet deyin.

Durum Windows tarafından güvenilir olarak değişir ve düğmenin yerini Güvenilenlerden kaldır alır. Kartta CA'nın Parmak izi (SHA-1) değeri de yazar; yanındaki kopyalama düğmesiyle alıp Windows'un uyarı penceresindeki parmak iziyle karşılaştırabilirsiniz.

Açık olan tarayıcı sekmelerini yenileyin. Uyarı sürerse tarayıcıyı kapatıp yeniden açın.

Edge ve Chrome

Microsoft Edge ve Google Chrome Windows'un sertifika deposunu kullanır; başka bir ayar gerekmez.

Firefox

Firefox kendi sertifika deposunu kullanabilir. Coduva sertifikalarında uyarı görürseniz Firefox'un Windows'taki güvenilen sertifikaları okumasını sağlayın:

1. Firefox'un adres çubuğuna about:config yazın ve uyarıyı kabul edin.
2. security.enterprise_roots.enabled ayarını arayın.
3. Değerini true yapın.
4. Firefox'u yeniden başlatın.

HTTPS portu

HTTPS 443 portunu kullanır. Bu port başka bir program tarafından tutuluyorsa Kontrol merkezi uyarır: "HTTPS portu 443 de dolu. Yerel HTTPS etkinleştirildiğinde çakışma olur." Hata teşhisi de aynı durumu, HTTPS kullanan bir proje varsa hata olarak bildirir.

0.2.0 sürümünde HTTPS portu Ayarlar ekranında yer almaz; yalnızca Nginx HTTP portu ve MariaDB portu değiştirilebilir. 443'ü tutan programı (çoğunlukla IIS veya başka bir yerel sunucu) kapatmanız gerekir.

Bkz. Portlar.

Güveni kaldırma

CA'yı artık kullanmıyorsanız güvenilenlerden kaldırabilirsiniz:

1. Yerel HTTPS ekranını açın.
2. Sertifika otoritesi kartındaki Güvenilenlerden kaldır düğmesine tıklayın. Bu düğme yalnızca CA güvenilirken görünür.

Bundan sonra tarayıcılar Coduva sertifikalarında yeniden uyarı gösterir. Projeleriniz çalışmaya devam eder, ancak HTTPS açık projeler "güvenli değil" olarak görünür.

CA anahtarını koruyun

CA'nın özel anahtarı C:\Coduva\etc\ssl\ca klasöründedir. Bu anahtara sahip olan biri, bu bilgisayarın güvendiği herhangi bir alan adı için sertifika üretebilir. Bu klasörü kimseyle paylaşmayın, yedeklerinizi buluta yüklerken dışarıda bırakın. HTTPS'i kullanmadığınız dönemlerde CA'yı güvenilenlerden kaldırın.

Sorun giderme

Belirti	Neden ve çözüm
Tarayıcı "Bağlantınız gizli değil" diyor	CA güvenilir değil. Yerel HTTPS → Güvenilir yap
Yalnızca Firefox uyarı veriyor	security.enterprise_roots.enabled = true yapın
Nginx başlamıyor, günlükte SSL_CTX_use_PrivateKey	Proje sertifikası bozuk. Projede HTTPS'i kapatıp yeniden açın; Coduva sertifikayı yeniden üretir
https:// adresi hiç açılmıyor	HTTPS portu dolu olabilir. Hata teşhisi → Kontrolleri çalıştır

Sonraki adım: Veritabanıyla çalışmak.