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çin
Biçim:
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çeren |
|
|
X-Forwarded-Proto |
İstemcinin dinleyiciye bağlanmak için kullandığı protokolü içeren Biçim:
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-Port |
İsteği alan dinleyici bağlantı noktasını içeren Biçim:
|
|
|
X-Forwarded-Host |
İstemci tarafından istenen orijinal ana makineyi içeren Biçim:
|
|
|
X-Forwarded-Client-srcport |
İstemcinin kaynak bağlantı noktasını içeren Biçim:
|
|
|
X-Forwarded-Clientcert-subjectdn |
ALB örneğine erişmek için kullanılan istemci sertifikasının sahibi bilgilerini almak üzere 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 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 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 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.
-
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,remoteipveyaauthority.-
Konsolda üst bilgi ekleme
Dinleyici oluşturma sırasında üst bilgi ekleme
ALB konsolunda oturum açın.
Üst gezinme çubuğunda ALB örneğinin dağıtıldığı bölgeyi seçin.
-
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.
-
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.NotBu 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:
Ekran talimatlarını izleyerek dinleyici oluşturma işlemini tamamlayın.
Mevcut bir dinleyiciye üst bilgi ekleme
ALB konsolunda oturum açın.
Üst gezinme çubuğunda ALB örneğinin dağıtıldığı bölgeyi seçin.
Instances sayfasında hedef örneğin kimliğine tıklayın.
Listener sekmesinde hedef dinleyiciyi bulun ve Actions sütununda
>Modify Listener seçeneğini belirleyin.Modify Listener iletişim kutusunda Advanced Settings öğesinin sağındaki Modify seçeneğine tıklayın.
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
HTTP isteklerini bir ALB örneği üzerinden iletmek için bkz. HTTP dinleyici ekleme.
HTTPS isteklerini bir ALB örneği üzerinden iletmek için bkz. HTTPS dinleyici ekleme.
QUIC isteklerini bir ALB örneği üzerinden iletmek için bkz. QUIC dinleyici ekleme.
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.