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

Management API için TLS'yi yapılandırma

Varsayılan olarak, yönetim API'si için TLS devre dışıdır ve Edge yönetim API'sine, Yönetim Sunucusu düğümünün IP adresini ve 8080 bağlantı noktasını kullanarak HTTP üzerinden erişirsiniz. Örneğin:

http://ms_IP:8080

Alternatif olarak, yönetim API'sine TLS erişimini şu biçimde erişebileceğiniz şekilde yapılandırabilirsiniz:

https://ms_IP:8443

Bu örnekte, TLS erişimini 8443 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 sunucusunu diğer bağlantı noktası değerlerini kullanacak şekilde yapılandırabilirsiniz. Tek koşul, güvenlik duvarınızın belirtilen bağlantı noktası üzerinden trafiğe izin vermesidir.

Yönetim API'nize gelen ve giden trafiğin şifrelenmesini sağlamak için /opt/apigee/customer/application/management-server.properties dosyasındaki ayarları yapılandırın.

TLS yapılandırmasına ek olarak, management-server.properties dosyasını değiştirerek şifre doğrulamasını (şifre uzunluğu ve gücü) da kontrol edebilirsiniz.

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

Bu bölümdeki prosedür, TLS'yi Yönetim Sunucusu'nda 8443 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 8443 -j ACCEPT --verbose

NOT: Bu örnekte, TLS bağlantı noktası için daha yaygın olan 443 numaralı bağlantı noktası yerine 8443 numaralı bağlantı noktası kullanılmıştır.

Bunun nedeni, 1024'ten küçük bağlantı noktalarının genellikle işletim sistemi tarafından korunması ve bunlara erişen sürecin kök erişimine sahip olmasının gerekmesidir. Edge Yönetim Sunucusu, "apigee" kullanıcısı olarak çalışır ve bu nedenle genellikle 1024'ün altındaki bağlantı noktalarına erişimi yoktur.

Alternatif olarak, Edge API ile bir yük dengeleyici kullanabilir ve TLS'yi yük dengeleyicide 443 numaralı bağlantı noktasında sonlandırabilirsiniz. Ardından, yük dengeleyici ile Edge API arasında HTTP veya HTTPS kullanabilirsiniz.

Diğer bir alternatif ise 443 numaralı bağlantı noktasına gönderilen istekleri 8443 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 8443

TLS'yi yapılandırma

Yönetim API'nize gelen ve giden trafikte TLS kullanımını kontrol etmek için /opt/apigee/customer/application/management-server.properties dosyasını düzenleyin. Bu dosya yoksa oluşturun.

Yönetim API'sine TLS erişimini yapılandırmak için:

TLS sertifikanızı ve özel anahtarınızı içeren anahtar deposu JKS dosyasını oluşturun. Daha fazla bilgi için Configuring TLS/SSL for Edge On Premises (Şirket içi Edge için TLS/SSL'yi yapılandırma) başlıklı makaleyi inceleyin.
Anahtar deposu JKS dosyasını, Yönetim Sunucusu düğümündeki bir dizine (ör. /opt/apigee/customer/application) kopyalayın.
JKS dosyasının sahipliğini "apigee" kullanıcısına değiştirin:
```
chown apigee:apigee keystore.jks
```
keystore.jks, anahtar deposu dosyanızın adıdır.
Aşağıdaki özellikleri ayarlamak için /opt/apigee/customer/application/management-server.properties dosyasını düzenleyin. Bu dosya yoksa oluşturun:
```
conf_webserver_ssl.enabled=true
# Leave conf_webserver_http.turn.off set to false
# because many Edge internal calls use HTTP.
conf_webserver_http.turn.off=false
conf_webserver_ssl.port=8443
conf_webserver_keystore.path=/opt/apigee/customer/application/keystore.jks
# Enter the obfuscated keystore password below.
conf_webserver_keystore.password=OBF:obfuscatedPassword
```
Burada keyStore.jks, anahtar deposu dosyanız, obfuscatedPassword ise gizlenmiş anahtar deposu şifrenizdir. Gizlenmiş şifre oluşturma hakkında bilgi için Edge On Premises için TLS/SSL'yi yapılandırma başlıklı makaleyi inceleyin.

Aşağıdaki komutu kullanarak Edge Management Server'ı yeniden başlatın:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Yönetim API'si artık TLS üzerinden erişimi destekliyor.

Not: TLS'yi etkinleştirdikten sonra $APIGEE_ROOT/customer/defaults.sh dosyasındaki APIGEE_PORT_HTTP_MS değerinin doğru olduğundan emin olun. Doğru değilse defaults.sh değerini değiştirin.

Yeni Edge kullanıcı arayüzünü, Edge API'ye erişmek için TLS kullanacak şekilde yapılandırma

Yukarıdaki prosedürde Apigee, yeni Edge kullanıcı arayüzünün HTTP üzerinden Edge API çağrıları yapmaya devam edebilmesi için conf_webserver_http.turn.off=false değerini olduğu gibi bırakmanızı önerdi.

Yeni Edge kullanıcı arayüzünü bu çağrıları yalnızca HTTPS üzerinden yapacak şekilde yapılandırmak için aşağıdaki prosedürü uygulayın:

Yönetim API'sine TLS erişimini yukarıda açıklandığı şekilde yapılandırın.
TLS'nin Management API için çalıştığını onayladıktan sonra /opt/apigee/customer/application/management-server.properties dosyasını düzenleyerek aşağıdaki özelliği ayarlayın:
```
conf_webserver_http.turn.off=true
```
Aşağıdaki komutu çalıştırarak Edge Management Server'ı yeniden başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart 
```
Yönetim Sunucusu'na HTTPS üzerinden bağlanmak için yeni Edge kullanıcı arayüzü yapılandırmasını güncelleyin. Yeni Edge kullanıcı arayüzü yapılandırma dosyanızda aşağıdaki özellikleri ayarlayın:
```
APIGEE_PORT_HTTP_MS=port
MS_SCHEME=https
```
Burada port, daha önce conf_webserver_ssl.port tarafından belirtilen bağlantı noktasıdır (örneğin, 8443).
Güncellenen yapılandırmayı yeni Edge kullanıcı arayüzüne uygulayın:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
```
Yeni Edge kullanıcı arayüzü yapılandırma dosyası hakkında daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yapılandırma başlıklı makaleyi inceleyin. Yeni Edge kullanıcı arayüzüne HTTPS erişimini yapılandırmak için Yeni Edge kullanıcı arayüzü için TLS'yi yapılandırma başlıklı makaleyi inceleyin.

Yönetim sunucusu için TLS özellikleri

Aşağıdaki tabloda, management-server.properties içinde ayarlayabileceğiniz tüm TLS/SSL özellikleri listelenmektedir:

Özellikler	Açıklama
`conf_webserver_http.port=8080`	Varsayılan değer 8080'dir.
`conf_webserver_ssl.enabled=false`	TLS/SSL'yi etkinleştirmek veya devre dışı bırakmak için. TLS/SSL etkinleştirildiğinde (true) ssl.port ve keystore.path özelliklerini de ayarlamanız gerekir.
`conf_webserver_http.turn.off=true`	https ile birlikte http'yi etkinleştirmek/devre dışı bırakmak için kullanılır. Yalnızca HTTPS kullanmak istiyorsanız varsayılan değeri `true` olarak bırakın.
`conf_webserver_ssl.port=8443`	TLS/SSL bağlantı noktası. TLS/SSL etkinleştirildiğinde (`conf_webserver_ssl.enabled=true`) gereklidir.
`conf_webserver_keystore.path=path`	Anahtar deposu dosyanızın yolu. TLS/SSL etkinleştirildiğinde (`conf_webserver_ssl.enabled=true`) gereklidir.
`conf_webserver_keystore.password=password`	Şu biçimde gizlenmiş bir şifre kullanın: OBF:xxxxxxxxxx
`conf_webserver_cert.alias=alias`	İsteğe bağlı anahtar deposu sertifikası takma adı
`conf_webserver_keymanager.password=password`	Anahtar yöneticinizin şifresi varsa şifrenin karartılmış bir sürümünü şu biçimde girin: OBF:xxxxxxxxxx
`conf_webserver_trust.all=[false \| true]` `conf_webserver_trust.store.path=path` `conf_webserver_trust.store.password=password`	Güvenilir sertifika deposu ayarlarınızı yapılandırın. Tüm TLS/SSL sertifikalarını (ör. standart olmayan türleri kabul etmek için) kabul etmek isteyip istemediğinizi belirleyin. Varsayılan değer: `false`. Güvenilir sertifika deposunun yolunu belirtin ve şu biçimde karartılmış bir güvenilir sertifika deposu şifresi girin: OBF:xxxxxxxxxx
`conf_http_HTTPTransport.ssl.cipher.suites.blacklist=CIPHER_SUITE_1, CIPHER_SUITE_2` `conf_http_HTTPTransport.ssl.cipher.suites.whitelist=`	Dahil etmek veya hariç tutmak istediğiniz şifreleme paketlerini belirtin. Örneğin, bir şifrede güvenlik açığı tespit ederseniz bu şifreyi buradan hariç tutabilirsiniz. Birden fazla şifreyi virgülle ayırın. Engellenenler listesini kullanarak kaldırdığınız tüm şifreler, izin verilenler listesinde yer alan tüm şifrelere göre önceliklidir. Not: Varsayılan olarak, herhangi bir kara liste veya beyaz liste belirtilmezse aşağıdaki Java normal ifadesiyle eşleşen şifreler varsayılan olarak hariç tutulur. ^._(MD5\|SHA\|SHA1)$ ^TLS_RSA_.$ ^SSL_.$ ^._NULL_.$ ^._anon_.*$ Ancak bir kara liste belirtirseniz bu filtre geçersiz kılınır ve tüm şifreleri tek tek kara listeye eklemeniz gerekir. Şifreleme paketleri ve şifreleme mimarisi hakkında bilgi edinmek için JDK 8 için Java Şifreleme Mimarisi Oracle Sağlayıcıları Belgeleri'ne bakın.
`conf_webserver_ssl.session.cache.size=` `conf_webserver_ssl.session.timeout=`	Aşağıdakileri belirleyen tam sayılar: Birden fazla istemcinin oturum bilgilerini depolamak için TLS/SSL oturum önbelleği boyutu (bayt cinsinden). TLS/SSL oturumlarının zaman aşımına uğramadan önce sürebileceği süre (milisaniye cinsinden).