Yeni Edge kullanıcı arayüzü için TLS'yi yapılandırma

Varsayılan olarak, New Edge kullanıcı arayüzüne New Edge kullanıcı arayüzü düğümünün IP adresini veya DNS adını ve 3001 bağlantı noktasını kullanarak HTTP üzerinden erişirsiniz. Örneğin:

http://edge_UI_IP:3001

Alternatif olarak, Yeni Edge kullanıcı arayüzüne TLS erişimini şu biçimde erişebileceğiniz şekilde yapılandırabilirsiniz:

https://edge_UI_IP:3001

TLS koşulları

Yeni Edge kullanıcı arayüzü, TLS v1.2 ve sonraki sürümleri destekler. Yeni Edge kullanıcı arayüzünde TLS'yi etkinleştirirseniz kullanıcıların Yeni Edge kullanıcı arayüzüne TLS v1.2 veya sonraki sürümlerle uyumlu bir tarayıcı kullanarak bağlanması gerekir.

TLS yapılandırma özellikleri

Yeni Edge kullanıcı arayüzü için TLS'yi yapılandırmak üzere aşağıdaki komutu çalıştırın:

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

configFile, yeni Edge kullanıcı arayüzünü yüklemek veya yapılandırmak için kullandığınız yapılandırma dosyasıdır.

Bu komutu yürütmeden önce, TLS'yi kontrol eden gerekli özellikleri ayarlamak için yapılandırma dosyasını düzenlemeniz gerekir. Aşağıdaki tabloda, yeni Edge kullanıcı arayüzü için TLS'yi yapılandırmak üzere kullandığınız özellikler açıklanmaktadır:

Mülk Açıklama Zorunlu mu?
MANAGEMENT_UI_SCHEME

Yeni Edge kullanıcı arayüzüne erişmek için kullanılan protokolü ("http" veya "https") ayarlar. Varsayılan değer "http"dir. TLS'yi etkinleştirmek için "https" olarak ayarlayın:

MANAGEMENT_UI_SCHEME=https
 		Evet
MANAGEMENT_UI_TLS_OFFLOAD

"n" ise yeni Edge kullanıcı arayüzüne yönelik TLS isteklerinin yeni Edge kullanıcı arayüzünde sonlandırıldığını belirtir. MANAGEMENT_UI_TLS_KEY_FILE ve MANAGEMENT_UI_TLS_CERT_FILE değerlerini ayarlamanız gerekir.

"y" ise Yeni Edge kullanıcı arayüzüne yönelik TLS isteklerinin bir yük dengeleyicide sonlandırıldığını ve yük dengeleyicinin isteği HTTP kullanarak Yeni Edge kullanıcı arayüzüne ilettiğini belirtir.

TLS'yi yük dengeleyicide sonlandırırsanız yeni Edge kullanıcı arayüzünün, orijinal isteğin TLS üzerinden geldiğini bilmesi gerekir. Örneğin, bazı çerezlerde Secure işareti bulunur.

MANAGEMENT_UI_SCHEME değerini "https" olarak ayarlamanız gerekir. Aksi takdirde MANAGEMENT_UI_TLS_OFFLOAD yoksayılır:

MANAGEMENT_UI_SCHEME=https
MANAGEMENT_UI_TLS_OFFLOAD=y
 		Evet
MANAGEMENT_UI_TLS_KEY_FILE

MANAGEMENT_UI_TLS_CERT_FILE

MANAGEMENT_UI_TLS_OFFLOAD=n ise TLS anahtarı ve sertifika dosyalarının mutlak yolunu belirtir. Dosyalar, parola içermeyen PEM dosyaları olarak biçimlendirilmeli ve "apigee" kullanıcısına ait olmalıdır.

Bu dosyalar için önerilen konum: 

/opt/apigee/customer/application/edge-management-ui

Bu dizin yoksa oluşturun.

MANAGEMENT_UI_TLS_OFFLOAD=y ise MANAGEMENT_UI_TLS_KEY_FILE ve MANAGEMENT_UI_TLS_CERT_FILE'ı atlayın. Yeni Edge kullanıcı arayüzüne yapılan istekler HTTP üzerinden geldiği için bu istekler yoksayılır.

 Evet, MANAGEMENT_UI_TLS_OFFLOAD=n ise
MANAGEMENT_UI_PUBLIC_URIS

MANAGEMENT_UI_TLS_OFFLOAD=n ise yeni Edge kullanıcı arayüzünün URL'sini belirtir.

Bu özelliği, yapılandırma dosyasındaki diğer özelliklere göre ayarlayın. Örneğin:

MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

Burada:

  • MANAGEMENT_UI_SCHEME, yukarıda açıklandığı gibi protokolü ("http" veya "https") belirtir.
  • MANAGEMENT_UI_IP, yeni Edge kullanıcı arayüzünün IP adresini veya DNS adını belirtir.
  • MANAGEMENT_UI_PORT, yeni Edge kullanıcı arayüzünün kullandığı bağlantı noktasını belirtir.

Bu özellikler hakkında daha fazla bilgi için Yeni Edge kullanıcı arayüzünü yapılandırma başlıklı makaleyi inceleyin.

Eğer MANAGEMENT_UI_TLS_OFFLOAD=y:

  • MANAGEMENT_UI_IP, New Edge kullanıcı arayüzünün değil, yük dengeleyicinin IP adresini veya DNS adını belirtir.
  • Yük dengeleyici ve yeni Edge kullanıcı arayüzü, istekler için aynı bağlantı noktası numarasını (ör. 3001) kullanmalıdır. Yük dengeleyicide ve yeni Edge kullanıcı arayüzünde bağlantı noktası numarasını belirtmek için MANAGEMENT_UI_PORT kullanın.

Evet
MANAGEMENT_UI_TLS_ALLOWED_CIPHERS

Kullanılabilir TLS şifrelerinin listesini virgülle veya boşlukla ayrılmış bir dize olarak tanımlar.

Virgülle ayrılmış dize:

MANAGEMENT_UI_TLS_ALLOWED_CIPHERS=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

Çift tırnak içine alınmış, boşlukla ayrılmış dize:

MANAGEMENT_UI_TLS_ALLOWED_CIPHERS="TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"

TLS'yi yapılandırma

Yeni Edge kullanıcı arayüzüne TLS erişimini yapılandırmak için:

  1. TLS sertifikasını ve anahtarını, parola içermeyen PEM dosyaları olarak oluşturun. Örneğin:

    mykey.pem
mycert.pem

    TLS sertifikası ve anahtarı oluşturmanın birçok yolu vardır. Örneğin, imzasız bir sertifika ve anahtar oluşturmak için aşağıdaki komutu çalıştırabilirsiniz:

    openssl req -x509 -newkey rsa:4096 -keyout mykey.pem -out mycert.pem -days 365 -nodes -subj '/CN=localhost'
  2. Anahtar ve sertifika dosyalarını /opt/apigee/customer/application/edge-management-ui dizinine kopyalayın. Bu dizin yoksa oluşturun.

  3. Sertifikanın ve anahtarın "apigee" kullanıcısına ait olduğundan emin olun:

    chown apigee:apigee /opt/apigee/customer/application/edge-management-ui/*.pem

  4. Aşağıdaki TLS özelliklerini ayarlamak için yeni Edge kullanıcı arayüzünü yüklemek üzere kullandığınız yapılandırma dosyasını düzenleyin:

    # Set to https to enable TLS.
MANAGEMENT_UI_SCHEME=https 
# Do NOT terminate TLS on a load balancer.
MANAGEMENT_UI_TLS_OFFLOAD=n

# Specify the key and cert. 
MANAGEMENT_UI_TLS_KEY_FILE=/opt/apigee/customer/application/edge-management-ui/mykey.pem
MANAGEMENT_UI_TLS_CERT_FILE=/opt/apigee/customer/application/edge-management-ui/mycert.pem

# Leave these properties set to the same values as when you installed the New Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

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

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

    Burada configFile, yapılandırma dosyasının adıdır.

    Komut dosyası, yeni Edge kullanıcı arayüzünü yeniden başlatır. Yeniden başlatmanın ardından yeni Edge kullanıcı arayüzü, HTTPS üzerinden erişimi destekler. TLS'yi etkinleştirdikten sonra Yeni Edge kullanıcı arayüzüne giriş yapamıyorsanız tarayıcı önbelleğini temizleyin ve tekrar giriş yapmayı deneyin.

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

İstekleri yeni Edge kullanıcı arayüzüne yönlendiren bir yük dengeleyiciniz varsa yük dengeleyicideki TLS bağlantısını sonlandırıp yük dengeleyicinin istekleri HTTP üzerinden yeni Edge kullanıcı arayüzüne yönlendirmesini sağlayabilirsiniz:

HTTP isteklerini 3001 numaralı bağlantı noktasındaki yeni Edge kullanıcı arayüzüne (edge-management-ui) yönlendiren bir yük dengeleyicide TLS sonlandırmasını gösteren mimari diyagramı

Bu yapılandırma desteklenir ancak yük dengeleyiciyi ve yeni Edge kullanıcı arayüzünü buna göre yapılandırmanız gerekir.

TLS yük dengeleyicide sonlandırıldığında yeni Edge kullanıcı arayüzünü yapılandırmak için:

  1. Aşağıdaki TLS özelliklerini ayarlamak için yeni Edge kullanıcı arayüzünü yüklemek üzere kullandığınız yapılandırma dosyasını düzenleyin:

    # Set to https to enable TLS
MANAGEMENT_UI_SCHEME=https
# Terminate TLS on a load balancer
MANAGEMENT_UI_TLS_OFFLOAD=y
# Set to the IP address or DNS name of the load balancer.
MANAGEMENT_UI_IP=LB_IP_DNS
# Set to the port number for the load balancer and New Edge UI.
# The load balancer and the New Edge UI must use the same port number.
MANAGEMENT_UI_PORT=3001

# Leave these properties set to the same values as when you installed the New Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

    MANAGEMENT_UI_TLS_OFFLOAD=y değerini ayarlarsanız MANAGEMENT_UI_TLS_KEY_FILE ve MANAGEMENT_UI_TLS_CERT_FILE değerlerini atlayın. Yeni Edge kullanıcı arayüzüne yapılan istekler HTTP üzerinden geldiği için bu istekler yoksayılır.

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

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

    Burada configFile, yapılandırma dosyasının adıdır.

    Komut dosyası, yeni Edge kullanıcı arayüzünü yeniden başlatır. Yeniden başlatmanın ardından, yeni Edge kullanıcı arayüzü yük dengeleyici üzerinden HTTPS ile erişimi destekler. TLS'yi etkinleştirdikten sonra yeni Edge kullanıcı arayüzüne giriş yapamıyorsanız tarayıcı önbelleğini temizleyip tekrar giriş yapmayı deneyin.

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

Yeni Edge kullanıcı arayüzünde TLS'yi devre dışı bırakmak için:

  1. Yeni Edge kullanıcı arayüzünü yüklemek için kullandığınız yapılandırma dosyasını düzenleyerek aşağıdaki TLS özelliğini ayarlayın:

    # Set to http to disable TLS.
MANAGEMENT_UI_SCHEME=http

# Only if you had terminated TLS on a load balancer,
# reset to the IP address or DNS name of the New Edge UI.
MANAGEMENT_UI_IP=edge_UI_IP_DNS

  2. TLS'yi devre dışı bırakmak için aşağıdaki komutu yürütün:

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

    Burada configFile, yapılandırma dosyasının adıdır.

    Komut dosyası, yeni Edge kullanıcı arayüzünü yeniden başlatır. Artık HTTP üzerinden yeni Edge kullanıcı arayüzüne erişebilirsiniz. TLS'yi devre dışı bıraktıktan sonra yeni Edge kullanıcı arayüzüne giriş yapamıyorsanız tarayıcı önbelleğini temizleyip tekrar giriş yapmayı deneyin.