Ana içeriğe geç

SSL Sonlandırma

SSL Sonlandırma, TLS'nin uygulamanın kendisi yerine bir ters proxy veya yük dengeleyici tarafından sonlandırıldığı durumlarda Emakin'in nasıl davrandığını açıklar.

Emakin, ana bilgisayar yapılandırması üzerinden doğrudan SSL sunabilir; ayrıca proxy tabanlı SSL sonlandırmayı da destekler.

Emakin için SSL sonlandırmasını gerçekleştiren ters proxy

Dağıtım Modeli

Belgelenen proxy modelinde:

  • tarayıcı ters proxy'ye HTTPS üzerinden bağlanır
  • ters proxy şunları yönetir SSL/TLS
  • proxy ile Emakin arasındaki bağlantı HTTP veya HTTPS olabilir

Emakin varsayılan olarak yalnızca döngüsel adreslerdeki proxy'lere güvenir; ters proxy harici bir IP kullandığında ek yapılandırma gerekir.

İletilen Üst Bilgiler

Emakin, özgün isteği anlamak için şu iletilen üst bilgileri kullanır:

X-Forwarded-Proto

Özgün istek şeması (http veya https).

X-Forwarded-For

Özgün istemci IP'si ve proxy zinciri.

Uyarı: Bu üst bilgi yoksa denetim günlükleri gerçek istemci IP'si yerine ters proxy IP'sini kaydedebilir.

X-Forwarded-Host

İstemci isteğindeki özgün Host üst bilgi.

İletilen Üst Bilgileri Etkinleştirme

Ters proxy bir döngüsel adres kullanmıyorsa yapılandırmayı güncelleyin.

Yapılandırma Dosyasıyla

Örnek:

1
2
3
4
5
6
7
8
{
    "Web": {
        "ForwardedHeaders": {
          "ClearProxies": true,
          "ClearKnownNetworks": true
        }
    }
}

Ortam Değişkenleriyle

Ortam değişkeni örneği:

1
2
3
AK_Web__ForwardedHeaders__ClearProxies=true
AK_Web__ForwardedHeaders__ClearKnownNetworks=true
AK_Web__ForwardedHeaders__ForwardedForHeaderName=CF-Connecting-IP

Tanılama

Emakin, uygulama geliştirme ortamında çalışırken istek üst bilgilerini incelemek için bir tanılama sayfası sunar.

Geliştirme Ortamında Başlatma

Örnek:

1
2
3
4
// Linux
export DOTNET_ENVIRONMENT=Development
// Windows
set DOTNET_ENVIRONMENT=Development

Ardından web modunu başlatın:

1
<installdir>/AltiKare.Workflow.Agent web

Docker örneği:

1
docker run -it -p 80:80 -e DOTNET_ENVIRONMENT=Development 6kare/emakin emakin web

Üst Bilgi Tanılama Sayfası

Belgelenen tanılama yolu:

1
http://my.emakin.com/httpheaders

Tanılama sayfasını incelerken şu alanlara dikkat edin:

  • İstek Şeması olmalıdır https SSL üzerinden gelen istekler için
  • Ana Bilgisayar doğru kiracıyı belirtmelidir
  • İstek RemoteIp iletme doğru yapılandırıldığında istemci IP'sini gösterir