Yeni Edge deneyimi için TLS'yi yapılandırma

Edge for Private Cloud 4.19.01 sürümü

Varsayılan olarak, Yeni Edge deneyimine HTTP üzerinden, Yeni Edge deneyimi düğümünün IP adresini veya DNS adını ve 3001 numaralı bağlantı noktasını kullanarak erişirsiniz. Örneğin:

http://newue_IP:3001

Alternatif olarak, New Edge deneyimine TLS erişimini aşağıdaki biçimde erişebileceğiniz şekilde yapılandırabilirsiniz:

https://newue_IP:3001

TLS koşulları

Yeni Edge deneyimi yalnızca TLS 1.2 sürümünü destekler. Yeni Edge deneyiminde TLS'yi etkinleştirirseniz kullanıcıların Yeni Edge deneyimine TLS v1.2 ile uyumlu bir tarayıcı kullanarak bağlanması gerekir.

TLS yapılandırma özellikleri

Yeni Edge deneyimi 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 deneyimini yüklemek 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 deneyimi 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 deneyimine 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 deneyimine yönelik TLS isteklerinin yeni Edge deneyiminde sonlandırıldığını belirtir. MANAGEMENT_UI_TLS_KEY_FILE ve MANAGEMENT_UI_TLS_CERT_FILE. ayarlarını yapmanız gerekir.

"y" ise New Edge deneyimine yönelik TLS isteklerinin bir yük dengeleyicide sonlandırıldığını ve yük dengeleyicinin isteği HTTP kullanarak New Edge deneyimine yönlendirdiğini belirtir.

TLS'yi yük dengeleyicide sonlandırırsanız yeni Edge deneyiminin, 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. değerlerini atlayın. Yeni Edge deneyimine yönelik istekler HTTP üzerinden geldiği için bunlar yoksayılır.

 MANAGEMENT_UI_TLS_OFFLOAD=n ise evet
MANAGEMENT_UI_PUBLIC_URIS

MANAGEMENT_UI_TLS_OFFLOAD=n ise yeni Edge deneyiminin 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 "http" veya "https" protokolünü belirtir.
  • MANAGEMENT_UI_IP, yeni Edge deneyiminin IP adresini veya DNS adını belirtir.
  • MANAGEMENT_UI_PORT, yeni Edge deneyimi tarafından kullanılan bağlantı noktasını belirtir.

Bu özellikler hakkında daha fazla bilgi için Yeni Edge Deneyimini Yükleme başlıklı makaleyi inceleyin.

MANAGEMENT_UI_TLS_OFFLOAD=y ise:

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

Evet
SHOEHORN_SCHEME

Yeni Edge deneyimini yüklemeden önce, shoehorn olarak adlandırılan temel Edge kullanıcı arayüzünü yüklemeniz gerekir. Yükleme yapılandırma dosyası, temel Edge kullanıcı arayüzüne erişmek için kullanılan protokolü ("http") belirtmek üzere aşağıdaki özelliği kullanır:

SHOEHORN_SCHEME=http

Temel Edge kullanıcı arayüzü TLS'yi desteklemediğinden, yeni Edge deneyiminde TLS'yi etkinleştirseniz bile bu özelliğin "http" olarak ayarlanması gerekir.

 Evet ve "http" olarak ayarlanmış

TLS'yi yapılandırma

Yeni Edge deneyimine 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 deneyimini 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 experience:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
SHOEHORN_SCHEME=http

  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

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

    Komut dosyası, yeni Edge deneyimini yeniden başlatır.

  6. Shoehorn'u kurmak ve yeniden başlatmak için aşağıdaki komutları çalıştırın:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Yeniden başlatma işleminden sonra yeni Edge deneyimi, HTTPS üzerinden erişimi destekler. TLS'yi etkinleştirdikten sonra yeni Edge deneyimine giriş yapamıyorsanız tarayıcı önbelleğini temizleyip tekrar giriş yapmayı deneyin.

TLS, yük dengeleyicide sonlandırıldığında yeni Edge deneyimini yapılandırma

İstekleri yeni Edge deneyimine 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 deneyimine yönlendirmesini seçebilirsiniz:

TLS'yi yük dengeleyicide sonlandırma

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

TLS yük dengeleyicide sonlandırıldığında yeni Edge deneyimini yapılandırmak için:

  1. Aşağıdaki TLS özelliklerini ayarlamak için yeni Edge deneyimini 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 experience.
# The load balancer and the New Edge experience must use the same port number.
MANAGEMENT_UI_IP=3001

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

    MANAGEMENT_UI_TLS_OFFLOAD=y politikasını ayarlarsanız MANAGEMENT_UI_TLS_KEY_FILE ve MANAGEMENT_UI_TLS_CERT_FILE. politikalarını atlayın. Yeni Edge deneyimine yönelik istekler HTTP üzerinden geldiğinden bu politikalar 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

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

    Komut dosyası, yeni Edge deneyimini yeniden başlatır.

  3. Shoehorn'u kurmak ve yeniden başlatmak için aşağıdaki komutları çalıştırın:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Yeniden başlatma işleminden sonra yeni Edge deneyimi, HTTPS üzerinden erişimi destekler. TLS'yi etkinleştirdikten sonra yeni Edge deneyimine giriş yapamıyorsanız tarayıcı önbelleğini temizleyip tekrar giriş yapmayı deneyin.

Yeni Edge deneyiminde TLS'yi devre dışı bırakma

Yeni Edge deneyiminde TLS'yi devre dışı bırakmak için:

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

    # 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 experience.
MANAGEMENT_UI_IP=newue_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

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

    Komut dosyası, yeni Edge deneyimini yeniden başlatır.

  3. Shoehorn'u kurmak ve yeniden başlatmak için aşağıdaki komutları çalıştırın:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Artık yeni Edge deneyimine HTTP üzerinden erişebilirsiniz. TLS'yi devre dışı bıraktıktan sonra yeni Edge deneyimine giriş yapamıyorsanız tarayıcı önbelleğini temizleyip tekrar giriş yapmayı deneyin.