Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Yönetim kullanıcı arayüzü için TLS'yi yapılandırma

Varsayılan olarak, Yönetim Sunucusu düğümünün IP adresini ve 9000 numaralı bağlantı noktasını kullanarak Edge kullanıcı arayüzüne HTTP üzerinden erişirsiniz. Örneğin:

http://ms_IP:9000

Alternatif olarak, Edge kullanıcı arayüzüne TLS erişimini yapılandırarak aşağıdaki biçimde erişebilirsiniz:

https://ms_IP:9443

Bu örnekte, TLS erişimini 9443 numaralı bağlantı noktasını kullanacak şekilde yapılandıracaksınız. Ancak bu bağlantı noktası numarası Edge için gerekli değildir. Yönetim Sunucusu'nu diğer bağlantı noktası değerlerini kullanacak şekilde yapılandırabilirsiniz. Tek şart, güvenlik duvarınızın belirtilen bağlantı noktası üzerinden trafiğe izin vermesidir.

TLS bağlantı noktanızın açık olduğundan emin olun

Bu bölümdeki prosedür, TLS'yi Yönetim Sunucusu'nda 9443 numaralı bağlantı noktasını kullanacak şekilde yapılandırır. Kullandığınız bağlantı noktasından bağımsız olarak, bağlantı noktasının Yönetim Sunucusu'nda açık olduğundan emin olmanız gerekir. Örneğin, açmak için aşağıdaki komutu kullanabilirsiniz:

iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 9443 -j ACCEPT --verbose

NOT: Bu örnekte, TLS bağlantı noktası için daha yaygın olan 443 numaralı bağlantı noktası yerine 9443 numaralı bağlantı noktası kullanılmıştır. Bunun nedeni, 1024'ün altındaki bağlantı noktalarının genellikle işletim sistemi tarafından korunması ve bunlara erişen işlemin kök erişimine sahip olmasını gerektirmesidir. Edge kullanıcı arayüzü "apigee" kullanıcısı olarak çalışır ve bu nedenle genellikle 1024'ün altındaki bağlantı noktalarına erişimi yoktur.

Alternatiflerden biri, Edge kullanıcı arayüzüyle bir yük dengeleyici kullanmak ve 443 numaralı bağlantı noktasındaki yük dengeleyicide TLS'yi sonlandırmaktır. Ardından, yük dengeleyici ile Edge kullanıcı arayüzü arasında HTTP veya HTTPS kullanabilirsiniz.

Diğer bir alternatif ise 443 numaralı bağlantı noktasına gönderilen istekleri 9443 numaralı bağlantı noktasına yönlendirmek için iptables kullanmaktır. Örneğin:

iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 9443

TLS'yi yapılandırma

Yönetim kullanıcı arayüzüne TLS erişimini yapılandırmak için aşağıdaki prosedürü kullanın:

TLS sertifikanızı ve özel anahtarınızı içeren anahtar deposu JKS dosyasını oluşturun ve Management Server düğümüne kopyalayın. Daha fazla bilgi için Edge On Premises için TLS/SSL'yi yapılandırma başlıklı makaleyi inceleyin.

TLS'yi yapılandırmak için aşağıdaki komutu çalıştırın:

/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl

HTTPS bağlantı noktası numarasını (ör. 9443) girin.
Yönetim kullanıcı arayüzüne HTTP erişimini devre dışı bırakmak isteyip istemediğinizi belirtin. Varsayılan olarak yönetim kullanıcı arayüzüne 9000 numaralı bağlantı noktasında HTTP üzerinden erişilebilir.
Anahtar deposu algoritmasını girin. Varsayılan değer JKS'dir.
Anahtar deposu JKS dosyasının mutlak yolunu girin.
Komut dosyası, dosyayı Yönetim Sunucusu düğümündeki /opt/apigee/customer/conf dizinine kopyalar ve dosyanın sahipliğini "apigee" olarak değiştirir.
Anahtar deposu şifresini düz metin olarak girin.
Komut dosyası daha sonra Edge yönetim kullanıcı arayüzünü yeniden başlatır. Yeniden başlatma işleminden sonra yönetim kullanıcı arayüzü, TLS üzerinden erişimi destekler.
Bu ayarları /opt/apigee/etc/edge-ui.d/SSL.sh bölümünde görebilirsiniz.

TLS'yi yapılandırmak için yapılandırma dosyası kullanma

Yukarıdaki prosedüre alternatif olarak, prosedürün 2. adımındaki komuta bir yapılandırma dosyası iletebilirsiniz. İsteğe bağlı TLS özelliklerini ayarlamak istiyorsanız bu yöntemi kullanmanız gerekir.

Yapılandırma dosyası kullanmak için yeni bir dosya oluşturun ve aşağıdaki özellikleri ekleyin:

HTTPSPORT=9443
DISABLE_HTTP=y
KEY_ALGO=JKS
KEY_FILE_PATH=/opt/apigee/customer/application/mykeystore.jks
KEY_PASS=clearTextKeystorePWord

Dosyayı istediğiniz adla yerel bir dizine kaydedin. Ardından TLS'yi yapılandırmak için aşağıdaki komutu kullanın:

/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl -f configFile

Burada configFile, kaydettiğiniz dosyanın tam yoludur.

TLS yük dengeleyicide sonlandırıldığında Edge kullanıcı arayüzünü yapılandırma

İstekleri Edge kullanıcı arayüzüne yönlendiren bir yük dengeleyiciniz varsa yük dengeleyicide TLS bağlantısını sonlandırıp yük dengeleyicinin istekleri HTTP üzerinden Edge kullanıcı arayüzüne yönlendirmesini sağlayabilirsiniz. Bu yapılandırma desteklenir ancak yük dengeleyiciyi ve Edge kullanıcı arayüzünü buna göre yapılandırmanız gerekir.

Kullanıcı oluşturulduğunda veya kullanıcı kayıp bir şifreyi sıfırlama isteğinde bulunduğunda Edge kullanıcı arayüzü, kullanıcılara şifrelerini ayarlamaları için e-posta gönderir. Bu durumda ek yapılandırma gerekir. Bu e-postada, kullanıcının şifre belirlemek veya sıfırlamak için seçtiği bir URL bulunur. Varsayılan olarak, Edge kullanıcı arayüzü TLS kullanacak şekilde yapılandırılmamışsa oluşturulan e-postadaki URL, HTTPS yerine HTTP protokolünü kullanır. Yük dengeleyiciyi ve Edge kullanıcı arayüzünü, HTTPS kullanan bir e-posta adresi oluşturacak şekilde yapılandırmanız gerekir.

Yük dengeleyiciyi yapılandırmak için Edge kullanıcı arayüzüne yönlendirilen isteklerde aşağıdaki üstbilgiyi ayarladığından emin olun:

X-Forwarded-Proto: https

Edge kullanıcı arayüzünü yapılandırmak için:

/opt/apigee/customer/application/ui.properties dosyasını bir düzenleyicide açın. Dosya yoksa oluşturun:
```
vi /opt/apigee/customer/application/ui.properties
```
ui.properties içinde aşağıdaki özelliği ayarlayın:
```
conf/application.conf+trustxforwarded=true
```
Değişikliklerinizi ui.properties adlı dosyaya kaydedin.

Edge kullanıcı arayüzünü yeniden başlatın:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

İsteğe bağlı TLS özelliklerini ayarlama

Edge kullanıcı arayüzü, aşağıdakileri ayarlamak için kullanabileceğiniz isteğe bağlı TLS yapılandırma özelliklerini destekler:

Varsayılan TLS protokolü
Desteklenen TLS protokollerinin listesi
Desteklenen TLS algoritmaları
Desteklenen TLS şifreleri

Bu isteğe bağlı parametreler yalnızca yapılandırma dosyasında aşağıdaki yapılandırma özelliğini ayarladığınızda kullanılabilir. Bu özellik, TLS'yi yapılandırmak için yapılandırma dosyası kullanma bölümünde açıklanmıştır:

TLS_CONFIGURE=y

NOT: Bu isteğe bağlı parametreleri yalnızca apigee-service edge-ui configure-ssl komutuna iletilen bir yapılandırma dosyasında ayarlayabilirsiniz. Bu özellikleri etkileşimli komutu kullanarak ayarlayamazsınız.

Aşağıdaki tabloda bu özellikler açıklanmaktadır:

Mülk	Açıklama
`TLS_PROTOCOL`	Edge kullanıcı arayüzü için varsayılan TLS protokolünü tanımlar. Varsayılan olarak TLS 1.2'dir. Geçerli değerler TLSv1.2, TLSv1.1, TLSv1'dir.
`TLS_ENABLED_PROTOCOL`	Etkinleştirilen protokollerin listesini virgülle ayrılmış bir dizi olarak tanımlar. Örneğin: TLS_ENABLED_PROTOCOL=[\"TLSv1.2\", \"TLSv1.1\", \"TLSv1\"] " karakterini kod dışı bırakmanız gerektiğini unutmayın. Varsayılan olarak tüm protokoller etkindir.
`TLS_DISABLED_ALGO`	Devre dışı bırakılan şifreleme paketlerini tanımlar ve TLS el sıkışması için küçük anahtar boyutlarının kullanılmasını önlemek amacıyla da kullanılabilir. Varsayılan değer yoktur. `TLS_DISABLED_ALGO` parametresine aktarılan değerler, burada açıklandığı gibi `jdk.tls.disabledAlgorithms` için izin verilen değerlere karşılık gelir. Ancak `TLS_DISABLED_ALGO` ayarını yaparken boşluk karakterlerini kodlamanız gerekir: TLS_DISABLED_ALGO=EC\ keySize\ <\ 160,RSA\ keySize\ <\ 2048
`TLS_ENABLED_CIPHERS`	Kullanılabilir TLS şifrelerinin listesini virgülle ayrılmış bir dizi olarak tanımlar. Örneğin: TLS_ENABLED_CIPHERS=[\"TLS_DHE_RSA_WITH_AES_128_CBC_SHA\", \"TLS_DHE_DSS_WITH_AES_128_CBC_SHA\"] " karakterini kod dışı bırakmanız gerektiğini unutmayın. Etkinleştirilen şifrelerin varsayılan listesi şöyledir: "TLS_DHE_RSA_WITH_AES_256_CBC_SHA", "TLS_DHE_RSA_WITH_AES_128_CBC_SHA", "TLS_DHE_DSS_WITH_AES_128_CBC_SHA", "TLS_RSA_WITH_AES_256_CBC_SHA", "TLS_RSA_WITH_AES_128_CBC_SHA", "SSL_RSA_WITH_RC4_128_SHA", "SSL_RSA_WITH_RC4_128_MD5", "TLS_EMPTY_RENEGOTIATION_INFO_SCSV" Kullanılabilir şifrelerin listesini burada bulabilirsiniz.

TLS protokollerini devre dışı bırakma

TLS protokollerini devre dışı bırakmak için TLS'yi yapılandırmak için yapılandırma dosyası kullanma bölümünde açıklanan yapılandırma dosyasını aşağıdaki gibi düzenlemeniz gerekir:

Yapılandırma dosyasını bir düzenleyicide açın.
Tek bir TLS protokolünü (ör. TLSv1.0) devre dışı bırakmak için yapılandırma dosyasına aşağıdakileri ekleyin:
```
TLS_CONFIGURE=y
TLS_DISABLED_ALGO="tlsv1"
```
Birden fazla protokolü (ör. TLSv1.0 ve TLSv1.1) devre dışı bırakmak için yapılandırma dosyasına aşağıdakileri ekleyin:
```
TLS_CONFIGURE=y
TLS_DISABLED_ALGO="tlsv1, tlsv1.1"
```
Değişikliklerinizi yapılandırma dosyasına kaydedin.
TLS'yi yapılandırmak için aşağıdaki komutu çalıştırın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl -f configFile
```
Burada configFile, yapılandırma dosyasının tam yoludur.

Edge kullanıcı arayüzünü yeniden başlatın:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Güvenli çerezler kullanma

Apigee Edge for Private Cloud, Edge kullanıcı arayüzünden gelen yanıtlar için Set-Cookie üstbilgisine secure işaretinin eklenmesini destekler. Bu işaret varsa çerez yalnızca TLS özellikli kanallar üzerinden gönderilebilir. Bu özellik yoksa çerez, güvenli olsun veya olmasın herhangi bir kanal üzerinden gönderilebilir.

secure işaretine sahip olmayan çerezler, saldırganların çerezi ele geçirip yeniden kullanmasına veya etkin bir oturumu ele geçirmesine olanak tanıyabilir. Bu nedenle, bu ayarı etkinleştirmeniz önerilir.

Edge kullanıcı arayüzü çerezleri için secure işaretini ayarlamak üzere:

Aşağıdaki dosyayı bir metin düzenleyicide açın:
```
/opt/apigee/customer/application/ui.properties
```
Dosya yoksa oluşturun.
ui.properties dosyasında conf_application_session.secure özelliğini true olarak ayarlayın. Aşağıdaki örneği inceleyin:
```
conf_application_session.secure=true
```
Değişikliklerinizi kaydedin.
Aşağıdaki örnekte gösterildiği gibi apigee-serice yardımcı programını kullanarak Edge kullanıcı arayüzünü yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

Değişikliğin çalıştığını doğrulamak için curl gibi bir yardımcı program kullanarak Edge kullanıcı arayüzünden gelen yanıt başlıklarını kontrol edin. Örneğin:

curl -i -v https://edge_UI_URL

Üstbilgide aşağıdaki gibi bir satır bulunmalıdır:

Set-Cookie: secure; ...

Edge kullanıcı arayüzünde TLS'yi devre dışı bırakma

Edge kullanıcı arayüzünde TLS'yi devre dışı bırakmak için aşağıdaki komutu kullanın:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl