Tüm Ürünler
Search
Belge Merkezi

Server Load Balancer:HTTP headers

Son Güncelleme:Oct 02, 2026

Bu konu, Application Load Balancer (ALB) tarafından desteklenen ek HTTP üst bilgilerini açıklar ve bunların bir dinleyici için nasıl yapılandırılacağını gösterir. İhtiyaçlarınıza göre belirli özellikleri uygulamak amacıyla bu üst bilgileri kullanabilirsiniz.

Desteklenen ALB üst bilgileri

HTTP üst bilgileri, bir HTTP isteği veya yanıt mesajının başlık bölümünde yer alan alanlardır. Belirli gereksinimlere yönelik olarak üst bilgileri özelleştirebilir; bu durum web sunucularının ve tarayıcıların ek HTTP üst bilgilerini kullanmasına neden olabilir. Aşağıdaki tabloda ALB'nin desteklediği ek HTTP üst bilgileri ve işlevleri açıklanmaktadır.

Üst bilgi alanı

Açıklama

Dinleyici protokolleri

X-Forwarded-For

Dinleyicinin istemci IP adresini almak içinX-Forwarded-For üst bilgisini kullanmasını sağlar.

  • X-Forwarded-For üst bilgisi etkinleştirildiğinde:

    ALB, bir isteği arka uç sunucusuna iletmeden önceX-Forwarded-For üst bilgisini isteğe ekler veya kaldırır.

    • Add (Varsayılan)

      Varsayılan olarak ALB, istemci IP adresini X-Forwarded-For üst bilgi alanında kaydeder ve bu alanı arka uç sunucusuna gönderir. Orijinal istekte bir X-Forwarded-For üst bilgi alanı yoksa ALB, istemci IP adresini içeren bir X-Forwarded-For üst bilgi alanı oluşturur. Aksi takdirde ALB, istemci IP adresini mevcut X-Forwarded-For üst bilgi alanına ekler ve ardından alanı arka uç sunucusuna gönderir. X-Forwarded-For istek üst bilgi alanı birden fazla virgülle ayrılmış IP adresi içerebilir.

    • Remove

      ALB, isteği arka uç sunucusuna iletmeden önceX-Forwarded-For üst bilgisini istekten kaldırır.

  • X-Forwarded-For üst bilgisi devre dışı bırakıldığında:

    ALB, isteği arka uç sunucusuna iletmeden önce istektekiX-Forwarded-For üst bilgisini değiştirmez.

Biçim:

X-Forwarded-For: <client-ip-address>, <proxy1>, <proxy2>, …

Seçilen eyleme (Ekle, Kaldır veya Devre Dışı Bırak) bağlı olarak arka uç sunucusu tarafından alınanX-Forwarded-For üst bilgisine ilişkin bir örnek görmek için tıklayın.

Bu örnekte, ALB'ye bağlanan istemci IP adresi127.0.0.1'dir.

İstek açıklaması

Örnek istek

Etkinleştir X-Forwarded-For üst bilgi alanı

Devre dışı bırakX-Forwarded-For üst bilgi alanı

Ekle

Kaldır

Orijinal istekte birX-Forwarded-For üst bilgisi bulunmuyor

GET /index.html HTTP/1.1

Host: example.com

X-Forwarded-For: 127.0.0.1

Yok

Yok

Orijinal istekte tek bir istemci IP adresi içeren birX-Forwarded-For üst bilgisi bulunuyor

GET /index.html HTTP/1.1

Host: example.com

X-Forwarded-For: 127.0.0.2

X-Forwarded-For: 127.0.0.2, 127.0.0.1

Yok

X-Forwarded-For: 127.0.0.2

Orijinal istekte birden çok istemci IP adresi içeren birX-Forwarded-For üst bilgisi bulunuyor

GET /index.html HTTP/1.1

Host: example.com

X-Forwarded-For: 127.0.0.2, 127.0.0.3

X-Forwarded-For: 127.0.0.2, 127.0.0.3, 127.0.0.1

Yok

X-Forwarded-For: 127.0.0.2, 127.0.0.3

Gerçek istemci IP adresinin nasıl alınacağına ilişkin talimatlar için bkz. Arka uç sunucusunda istemci IP'sini alma.

SLB-ID

ALB örneğinin kimliğini içerenSLB-ID üst bilgisini ekler.

  • HTTP

  • HTTPS

  • QUIC

X-Forwarded-Proto

İstemcinin dinleyiciye bağlanmak için kullandığı protokolü içerenX-Forwarded-Proto üst bilgisini ekler. Uygulamanız, istekleri hedef URL'ye yönlendirmek içinX-Forwarded-Proto üst bilgisinde depolanan protokolü kullanabilir.

Biçim:

X-Forwarded-Proto: <originatingProtocol>

Tipik bir kullanım durumu: Bir ALB örneği HTTPS dinleyici kullanır ve dinleyici ile arka uç sunucu grubu arasındaki iletişim HTTP üzerinden gerçekleşir. Bu senaryoda arka uç sunucu isteği HTTP protokolüyle alır. Arka uç sunucuda HTTP'den HTTPS'ye otomatik yönlendirme yapan bir kural yapılandırılmışsa, sunucu istemcinin HTTP kullandığını yanlışlıkla belirleyebilir ve bu durum bir yönlendirme döngüsüne yol açabilir. X-Forwarded-Proto üst bilgisini etkinleştirerek arka uç sunucunun istemciden gelen orijinal istek protokolünü alması sağlanır ve bu yanlış tetiklenen yönlendirme önlenir. Arka uç sunucunun istemcinin orijinal istek bağlantı noktasını elde edebilmesi için X-Forwarded-Port üst bilgisinin de etkinleştirilmesini öneririz.

  • HTTP

  • HTTPS

  • QUIC

X-Forwarded-Port

İsteği alan dinleyici bağlantı noktasını içerenX-Forwarded-Port üst bilgisini ekler.

Biçim:

X-Forwarded-Port: <port>
  • HTTP

  • HTTPS

  • QUIC

X-Forwarded-Host

İstemci tarafından istenen orijinal ana makineyi içerenX-Forwarded-Host üst bilgisini ekler.

Biçim:

X-Forwarded-Host: <host>
  • HTTP

  • HTTPS

  • QUIC

X-Forwarded-Client-srcport

İstemcinin kaynak bağlantı noktasını içerenX-Forwarded-Client-srcport üst bilgisini ekler.

Biçim:

X-Forwarded-Client-srcport: <port>

X-Forwarded-Clientcert-subjectdn

ALB örneğine erişmek için kullanılan istemci sertifikasının sahibi bilgilerini almak üzere X-Forwarded-Clientcert-subjectdn üst bilgi alanını etkinleştirin.

Bu üst bilgiyi etkinleştirdikten sonra özel bir HTTP üst bilgi adı girmeniz gerekir.

HTTPS

X-Forwarded-Clientcert-issuerdn

ALB örneğine erişmek için kullanılan istemci sertifikasının veren bilgilerini almak üzere X-Forwarded-Clientcert-issuerdn üst bilgi alanını etkinleştirin.

Bu üst bilgiyi etkinleştirdikten sonra özel bir HTTP üst bilgi adı girmeniz gerekir.

HTTPS

X-Forwarded-Clientcert-fingerprint

ALB örneğine erişmek için kullanılan istemci sertifikasının parmak izi değerini almak üzere X-Forwarded-Clientcert-fingerprint üst bilgi alanını etkinleştirin.

Bu üst bilgiyi etkinleştirdikten sonra özel bir HTTP üst bilgi adı girmeniz gerekir.

HTTPS

X-Forwarded-Clientcert-clientverify

ALB örneğine erişmek için kullanılan istemci sertifikasının doğrulama sonucunu almak üzere X-Forwarded-Clientcert-clientverify üst bilgi alanını etkinleştirin.

Bu üst bilgiyi etkinleştirdikten sonra özel bir HTTP üst bilgi adı girmeniz gerekir.

HTTPS

Yukarıda bahsedilen ek HTTP üst bilgileri, dinleyici düzeyindeki anahtarlar kullanılarak yapılandırılır. Etkinleştirildiğinde ALB, arka uç sunucusuna iletilen isteklere ilgili üst bilgileri otomatik olarak ekler. Üst bilgi değerlerini özelleştirmeniz gerekiyorsa (örneğin, orijinal istek protokolünü veya bağlantı noktasını belirtmek gibi) bunu bir yönlendirme kuralındaki Üst Bilgi Ekle eylemini kullanarak manuel olarak ayarlayabilirsiniz. Dinleyici düzeyindeki anahtarlar çoğu geçiş senaryosu için uygundur; yönlendirme kuralları ise üst bilgi değerleri üzerinde ince ayarlı kontrol gerektiren senaryolar için idealdir. Bu ayarlar sırasıyla dinleyici yapılandırmasının Gelişmiş Ayarlar bölümünde ve yönlendirme kuralı düzenleyicisinde bulunur.

Not
  • Arka uç sunucularınızın HTTP teknik özelliklerine uyması ve HTTP üst bilgi anahtarlarını büyük/küçük harfe duyarlı olmayan şekilde ele alması önerilir.

    • ALB'nin arka uç sunucularına ilettiği X-Forwarded-For üst bilgisi her zaman büyük harfle başlar.

    • Diğer ek HTTP üst bilgileri için, istemci isteğinde bu üst bilgilerden biri zaten varsa ALB, onu iletirken orijinal büyük/küçük harf kullanımını korur. Aksi takdirde ALB, üst bilgiyi yukarıdaki tabloda gösterilen büyük/küçük harf kullanımıyla ekler.

  • X-Forwarded-Clientcert-subjectdn, X-Forwarded-Clientcert-issuerdn, X-Forwarded-Clientcert-fingerprint veya X-Forwarded-Clientcert-clientverify seçeneklerini etkinleştirdiğinizde özel HTTP üst bilgi adını aşağıdaki ayrılmış alanlardan hiçbiri olarak ayarlayamazsınız: slb-id, slb-ip, x-forwarded-for, x-forwarded-proto, x-forwarded-eip, x-forwarded-port, x-forwarded-client-srcport, x-forwarded-host, connection, upgrade, content-length, transfer-encoding, keep-alive, te, host, cookie, remoteip veya authority.

  • İstemci sertifikalarıyla ilgili ek HTTP üst bilgilerinin açıklaması

    Aşağıdaki ek HTTP üst bilgileri yalnızca bir HTTPS dinleyici için karşılıklı kimlik doğrulama etkinleştirildiğinde geçerli olur.

    X-Forwarded-Clientcert-subjectdn

    • Amaç: İstemci sertifikasından Konu Ayırt Edici Adı (Subject DN) içerir.

    • İçerik: Sertifika sahibinin kimlik bilgileri.

    • Örnek biçim: X-Forwarded-Clientcert-Subjectdn: CN=client.example.com,O=Example Corp,C=US

    • Şunları içerir:

      • CN (Ortak Ad)

      • O (Kuruluş)

      • OU (Organizasyon Birimi)

      • C (Ülke)

      • ST (Eyalet)

      • L (Yerellik)

    X-Forwarded-Clientcert-issuerdn

    • Amaç: İstemci sertifikasından Veren Ayırt Edici Adı (Issuer DN) içerir.

    • İçerik: Sertifikayı veren Sertifika Yetkilisi (CA) hakkında bilgi.

    • Örnek biçim: X-Forwarded-Clientcert-Issuerdn: CN=Example CA,O=Example Corp,C=US

    • Kullanım durumu: Sertifikayı güvenilir bir CA'nın verip vermediğini doğrulayın.

    X-Forwarded-Clientcert-fingerprint

    • Amaç: İstemci sertifikasının dijital parmak izini içerir.

    • İçerik: Sertifika parmak izi. Bu, SHA-1 veya SHA-256 gibi bir karma algoritması kullanılarak sertifikanın tüm içeriğinden hesaplanan sabit uzunlukta bir karma değeridir ve sertifika için benzersiz bir tanımlayıcı görevi görür.

    • Örnek biçim: X-Forwarded-Clientcert-Fingerprint: SHA256=1234567890abcdef...

    • Kullanım durumu: Doğrulama ve denetim amaçlarıyla bir sertifikayı benzersiz şekilde tanımlayın.

    X-Forwarded-Clientcert-clientverify

    • Amaç: İstemci sertifikasının doğrulama sonucunu içerir.

    • İçerik: Sertifika doğrulama durumu.

    • Olası değerler:

      • SUCCESS: Sertifika doğrulandı.

      • FAILED: Sertifika doğrulaması başarısız oldu.

      • NONE: Hiçbir istemci sertifikası sunulmadı.

      • EXPIRED: Sertifikanın süresi doldu.

      • REVOKED: Sertifika iptal edildi.

Konsolda üst bilgi ekleme

Dinleyici oluşturma sırasında üst bilgi ekleme

  1. ALB konsolunda oturum açın.

  2. Üst gezinme çubuğunda ALB örneğinin dağıtıldığı bölgeyi seçin.

  3. Dinleyici yapılandırma sihirbazını açmak için aşağıdaki yöntemlerden birini kullanın:

    • Instances sayfasında yönetmek istediğiniz örneği bulun ve Actions sütununda Create Listener seçeneğine tıklayın.

    • Instances sayfasında hedef örneğin kimliğine tıklayın. Listener sekmesinde Create Listener seçeneğine tıklayın.

  4. Configure Listener sihirbazında aşağıdaki parametreleri yapılandırın ve Next seçeneğine tıklayın.


    Parametre


    Açıklama


    Listener Protocol


    Dinleyici için bir protokol seçin.


    Advanced Settings


    Gelişmiş ayarları genişletmek için Modify seçeneğine tıklayın.


    Custom HTTP Header


    İş gereksinimlerinize göre etkinleştirmek istediğiniz ek HTTP üst bilgilerini seçin.

    Not

    Bu bölümde yalnızca üst bilgilerle ilgili parametreler açıklanmaktadır. Diğer parametreler hakkında daha fazla bilgi için aşağıdaki konulara bakın:

  5. Ekran talimatlarını izleyerek dinleyici oluşturma işlemini tamamlayın.

Mevcut bir dinleyiciye üst bilgi ekleme

  1. ALB konsolunda oturum açın.

  2. Üst gezinme çubuğunda ALB örneğinin dağıtıldığı bölgeyi seçin.

  3. Instances sayfasında hedef örneğin kimliğine tıklayın.

  4. Listener sekmesinde hedef dinleyiciyi bulun ve Actions sütununda 更多>Modify Listener seçeneğini belirleyin.

  5. Modify Listener iletişim kutusunda Advanced Settings öğesinin sağındaki Modify seçeneğine tıklayın.

  6. Custom HTTP Header bölümünde gerektiği şekilde üst bilgileri etkinleştirin veya devre dışı bırakın ve ardından Save seçeneğine tıklayın.

API kullanarak üst bilgi ekleme

Bir dinleyici oluştururken ek üst bilgileri yapılandırabilir veya mevcut bir dinleyici için üst bilgi yapılandırmasını değiştirebilirsiniz.

  • Dinleyici oluşturun: CreateListener API işlemini çağırın ve XForwardedForConfig parametresini yapılandırın.

  • Mevcut bir dinleyiciyi değiştirin: XForwardedForConfig parametresini güncellemek için UpdateListenerAttribute API işlemini çağırın.

Kaynaklar

Konsol

API

  • CreateListener: Bir HTTP, HTTPS veya QUIC dinleyici oluşturur. XForwardedForConfig parametresini ayarlayarak HTTP üst bilgileri ekleyebilirsiniz.

  • UpdateListenerAttribute: Bir dinleyicinin yapılandırmasını günceller. Üst bilgi yapılandırmasını değiştirmek için XForwardedForConfig parametresini güncelleyebilirsiniz.