curl SSL, TLS ve Proxy Yapılandırma Rehberi

SSL ve Proxy Bayrakları Hızlı Referans

curl -k: SSL Sertifika Hatalarını Yoksay

Ne yapar

-k (veya --insecure) bayrağı tüm SSL/TLS sertifika doğrulamasını devre dışı bırakır. curl, sunucu sertifikasının güvenilir bir CA tarafından imzalanıp imzalanmadığını, ana bilgisayar adının eşleşip eşleşmediğini veya sertifikanın süresinin dolup dolmadığını kontrol etmez.

Ne zaman kullanılır

Kendinden imzalı sertifikalı yerel geliştirme veya test ortamları için yalnızca kullanın. Hazırlık/üretim ortamları için bunun yerine --cacert ile gerçek CA sertifikasını kullanın — hem daha güvenli hem de daha açıktır.

$ curl -k https://localhost:8443/api/health

curl --cacert: Özel CA Sertifikası Kullan

Ne yapar

--cacert bayrağı, curl'a sunucunun SSL sertifikasını sistemin varsayılan güven deposu yerine PEM formatında belirli bir CA (Sertifika Yetkilisi) paket dosyasına karşı doğrulamasını söyler.

Ne zaman kullanılır

Sunucunuz sistem güven deposunda olmayan özel veya dahili bir CA tarafından imzalanmış sertifika kullanıyorken kullanın. Bu, kurumsal ortamlarda, Kubernetes kümelerinde ve dahili PKI ile Docker yapılandırmalarında yaygındır.

$ curl --cacert /path/to/corporate-ca.pem https://internal-api.example.com/data

curl --cert: İstemci Sertifikası (Karşılıklı TLS)

Ne yapar

--cert bayrağı, karşılıklı TLS (mTLS) için istemci tarafı sertifikası sağlar. mTLS'de hem sunucu hem de istemci, birbirlerinin kimliğini doğrulamak için sertifika sunar. Sertifika dosyası PEM veya PKCS#12 formatında olmalıdır.

Ne zaman kullanılır

Sunucu istemci sertifika kimlik doğrulaması talep ettiğinde gereklidir — bankacılık API'leri, devlet hizmetleri, IoT cihaz iletişimi ve sıfır güven mimarilerinde yaygındır. Anahtar sertifika dosyasına gömülü değilse her zaman --key ile eşleştirin.

$ curl --cert client.pem --key client-key.pem https://mtls-api.example.com/secure

curl --key: İstemci Sertifikası Özel Anahtarı

Ne yapar

--key bayrağı, --cert ile sağlanan istemci sertifikasıyla eşleşen özel anahtar dosyasını belirtir. Anahtar sertifikayla eşleşmelidir. Anahtar parola korumalıysa, curl parola isteyecektir (veya --pass kullanın).

Ne zaman kullanılır

Her zaman --cert ile birlikte kullanın. Özel anahtar zaten sertifika dosyasına gömülüyse (PKCS#12 / .p12 dosyalarında yaygın), --key parametresini atlayabilirsiniz.

$ curl --cert client.pem --key client-key.pem --cacert server-ca.pem https://api.example.com/secure

curl --tlsv1.2: Minimum TLS 1.2 Zorla

Ne yapar

--tlsv1.2 bayrağı, curl'u SSL/TLS el sıkışması için kabul edilebilir minimum sürüm olarak TLS 1.2 kullanmaya zorlar. Eski protokoller (TLS 1.0, 1.1, SSLv3) reddedilir.

Ne zaman kullanılır

Minimum güvenlik standardı uygulamak için kullanın. TLS 1.2, PCI-DSS uyumluluğu için gereklidir ve tüm modern sunucular tarafından desteklenir. Çoğu modern curl derlemesi zaten varsayılan olarak TLS 1.2+ kullanır, ancak bu bayrak bunu açıkça belirtir.

$ curl --tlsv1.2 -v https://secure.example.com/api 2>&1 | grep 'SSL connection'

curl --tlsv1.3: Minimum TLS 1.3 Zorla

Ne yapar

--tlsv1.3 bayrağı, curl'u en hızlı ve en güvenli TLS sürümü olan TLS 1.3 kullanmaya zorlar. TLS 1.3, el sıkışmasındaki ekstra gidiş-dönüşü ortadan kaldırır (0-RTT desteği) ve tüm eskimiş şifre takımlarını kaldırır.

Ne zaman kullanılır

Sunucunun TLS 1.3'ü desteklediğini bildiğinizde ve en iyi performans ve güvenliği istediğinizde kullanın. Not: TLS 1.3, OpenSSL 1.1.1+ veya uyumlu bir TLS kütüphanesi gerektirir. Henüz tüm sunucular desteklememektedir.

$ curl --tlsv1.3 https://modern-api.example.com/data

Ek SSL/TLS Seçenekleri

curl -x: HTTP/HTTPS Proxy Kullan

Ne yapar

-x (veya --proxy) bayrağı, tüm curl trafiğini belirtilen proxy sunucusu üzerinden yönlendirir. Format: [protocol://]host[:port]. Desteklenen proxy protokolleri: HTTP, HTTPS, SOCKS4, SOCKS5.

Ne zaman kullanılır

Kurumsal proxy sunucuları, Fiddler, Charles veya mitmproxy gibi araçlarla hata ayıklama, coğrafi kısıtlamaları test etme veya doğrudan internet erişimi olmadığında kullanın. Alternatif olarak http_proxy / https_proxy ortam değişkenlerini ayarlayabilirsiniz.

$ curl -x http://proxy.example.com:8080 https://api.example.com/data

curl --socks5: SOCKS5 Proxy Kullan

Ne yapar

--socks5 bayrağı, curl'a TCP bağlantısı için SOCKS5 proxy kullanmasını söyler. HTTP proxy'lerinden farklı olarak SOCKS5, TCP seviyesinde çalışır ve yalnızca HTTP değil her protokolü işleyebilir. DNS çözümlemesi varsayılan olarak yerel yapılır; DNS'i proxy üzerinden çözümlemek için --socks5-hostname kullanın.

Ne zaman kullanılır

SSH tünelleri (ssh -D), Tor ağı erişimi veya proxy'nin HTTP dışı protokolleri işlemesi gerektiğinde kullanın. SOCKS5, UDP'yi destekler ve isteğe bağlı olarak DNS işleyebilir — bu da onu HTTP proxy'lerinden daha esnek kılar.

$ curl --socks5 localhost:1080 https://api.example.com/data

curl --proxy-user: Proxy Kimlik Doğrulaması

Ne yapar

--proxy-user (veya -U) bayrağı, proxy sunucusuna kimlik doğrulama bilgilerini gönderir. Format: user:password. Bu, sunucu kimlik doğrulamasından (-u) ayrıdır.

Ne zaman kullanılır

Proxy sunucusu kimlik doğrulama talep ettiğinde gereklidir — kurumsal ve enterprise ağ ortamlarında yaygındır. Kimlik bilgileri hedef sunucuya değil proxy'ye gönderilir.

$ curl -x http://proxy.corp.com:3128 -U user:pass https://external-api.com/data

curl --noproxy: Belirli Hostlar İçin Proxy'yi Atla

Ne yapar

--noproxy bayrağı, proxy'yi atlayıp doğrudan bağlanması gereken hostların, alan adlarının veya IP adreslerinin virgülle ayrılmış listesini belirtir. Joker karakterleri destekler: *.example.com tüm alt alan adlarını eşleştirir.

Ne zaman kullanılır

localhost, dahili hizmetler veya belirli alan adlarını proxy'den hariç tutmak için kullanın. Proxy ortam değişkenleri aracılığıyla global olarak ayarlandığında ancak bazı hostların (yerel hizmetler gibi) doğrudan erişime ihtiyaç duyduğunda önemlidir. Tüm hostlar için proxy'yi atlamak üzere * kullanın.

$ curl -x http://proxy:8080 --noproxy "localhost,127.0.0.1,*.internal.com" https://localhost:3000/api

Ek Proxy Seçenekleri

curl --resolve: Özel DNS Çözümlemesi

Ne yapar

--resolve bayrağı, belirli bir host:port çifti için DNS aramasını tamamen atlayarak özel bir IP adresi sağlar. Format: host:port:adres. Birden fazla --resolve girişi sağlanabilir.

Ne zaman kullanılır

DNS yayılımından önce test, yük dengeleyicinin arkasındaki belirli bir backend'i doğrulama veya SSL sertifika doğrulaması için gerçek bir ana bilgisayar adına ihtiyaç duyulan yerel geliştirme için vazgeçilmezdir. /etc/hosts düzenlemekten farklı olarak bu, istek başına ve port'a özgüdür.

$ curl --resolve api.example.com:443:127.0.0.1 https://api.example.com/health

curl --connect-to: Bağlantıyı Farklı Hosta Yönlendir

Ne yapar

--connect-to bayrağı, HTTP isteği için orijinal URL'yi (Host başlığı ve SNI dahil) korurken TCP bağlantısını farklı bir host:port çiftine yönlendirir. Format: HOST1:PORT1:HOST2:PORT2.

Ne zaman kullanılır

DNS'i veya /etc/hosts dosyasını değiştirmeden yük dengeleyicinin arkasındaki belirli bir backend sunucusunu test etmek için kullanın. --resolve'dan farklı olarak, host:port'u host:port'a eşler (IP'ye değil), bu da hedefin de bir ana bilgisayar adına sahip olduğunda faydalıdır.

$ curl --connect-to api.example.com:443:backend1.internal:8443 https://api.example.com/health

Ek Ağ Seçenekleri

Gerçek Dünya SSL ve Proxy Senaryoları

Bu örnekler, geliştirme, CI/CD ve üretim ortamlarındaki yaygın güvenlik ve ağ görevlerini ele almak için birden fazla bayrağı birleştirir.

$ curl --resolve myapp.local:443:127.0.0.1 --cacert local-ca.pem https://myapp.local/api/status

$ curl --cert client.pem --key client-key.pem --cacert server-ca.pem https://mtls-api.example.com/data

$ curl -x http://proxy.corp.com:3128 -U user:pass --noproxy "*.internal.corp" https://external-api.com/data

$ curl --cacert /etc/ssl/certs/internal-ca.crt https://service.docker.internal:8443/health

$ curl --socks5 localhost:1080 https://internal-api.example.com/status

curl SSL ve Proxy Hakkında Sık Sorulan Sorular