# Qlik Data Gateway - Doğrudan Erişim uygulaması kurulumu Qlik Data Gateway - Doğrudan Erişim kurulumunu ya bir Windows sunucusunda ya da konteynerleştirilmiş bir ortamda yapabilirsiniz. Başarılı bir kurulum için, özel kurulum iş akışınıza yönelik önkoşulları, yükleme talimatlarını, sınırlamaları ve dikkate alınması gereken hususları bildiğinizden emin olun. Bilgi notu Qlik Data Gateway - Doğrudan Erişim için AWS PrivateLink deseni için bkz. [Qlik Data Gateway - Doğrudan Erişim için AWS PrivateLink'i Yapılandırma](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-aws-privatelink.htm). Bu model, bu konudaki standart önkoşulların ve ağ gereksinimlerinin yerini almaz. ## İş akışlarını ayarlama Aşağıdaki iş akışlarından birini seçin: * [Bir Windows sunucusunda Qlik Data Gateway - Doğrudan Erişim kurulumu](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) * [Bir kapsayıcıda Qlik Data Gateway - Doğrudan Erişim kurulumu](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm) ## Sistem önkoşulları ### Yazılım gereksinimleri Kurulum yönteminize bağlı olarak aşağıdakilerden birine başvurun: * WindowsSunucu[Yazılım önkoşulları](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software): * Kapsayıcıya alınmış: [Yazılım gereksinimleri](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#SoftwareReq) ### Ortak gereksinimler Bu gereksinimler hem Windows sunucu hem de konteynerleştirilmiş kurulumlar için geçerlidir. #### Gerekli bağlantı noktaları ve protokoller Aşağıdaki bölüm gerekli bağlantı noktalarını listelemektedir. #### Giden bağlantı noktaları HTTPS/TCP-443, <tenant-id>.<region>.qlikcloud.com ile giden iletişim için açılmalıdır. #### Dahili bağlantı noktaları Dahili veri ağ geçidi işlemleri tarafından iletişim için kullanılan bağlantı noktalarının bir listesi aşağıda verilmiştir. Bu bağlantı noktalarından herhangi bir başka bir uygulama tarafından kullanılıyorsa diğer uygulamayı yeniden yapılandırın veya kaldırın. Genel bağlantı noktaları * 5050 (Bağlayıcı Aracısı REST API'si) * 9027 (DCAAS REST API'si) ODBC bağlantı noktaları * 3005 (ODBC Bağlayıcısı REST API'si) * 50260 (ODBC Bağlayıcısı gRPC'si) SAP bağlantı noktaları * 3015 (SAP BW Bağlayıcı REST API) * 50270 (SAP BW Bağlayıcı gRPC) * 3025 (SAP SQL Bağlayıcı REST API) * 50280 (SAP SQL Bağlayıcı gRPC) * 3035 (SAP ODP Bağlayıcı REST API) * 50290 (SAP ODP Bağlayıcı gRPC) * 3035 (SAP Package Bağlayıcı REST API) * 50290 (SAP Package Bağlayıcı gRPC) REST bağlantı noktaları * 3055 (REST Bağlayıcısı REST API'si) * 50310 (REST Bağlayıcısı gRPC) Dosya bağlantı noktaları * 3045 (Dosya Bağlayıcısı REST API'si) * 50300 (Dosya Bağlayıcısı gRPC) #### WSS protokolü Doğrudan Erişim ağ geçidi, HTTPS'ye ek olarak WSS (WebSocket Secure) protokolünü de kullanır. Bu nedenle, güvenlik duvarınızın ve proxy sunucunuzun (kullanmayı düşünüyorsanız) giden WSS bağlantılarına izin verecek şekilde ayarlandığından emin olun. ### Önerilen donanım Kurulum yönteminize bağlı olarak aşağıdakilerden birine başvurun: * WindowsSunucu[Önerilen donanım](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#RecHardware): * Kapsayıcıya alınmış: [Önerilen donanım](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#RecHardware) ### Sistem şifrelemesi (yalnızca Windows sunucu kurulumu) Bkz. [Sistem şifreleme](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#System). ## Qlik Data Gateway - Doğrudan Erişim yükleme ### 1. Aşama: İndir Qlik Data Gateway - Doğrudan Erişim Kurulum yönteminize bağlı olarak aşağıdakilerden birine başvurun: * WindowsSunucu[Birinci aşama: Qlik Data Gateway - Doğrudan Erişim indirme](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage5): * Kapsayıcıya alınmış: [Birinci aşama: Qlik Data Gateway - Doğrudan Erişim indirme](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage1) ### Aşama iki: Yükleyin veya dağıtın Doğrudan Erişim ağ geçidi Kurulum yönteminize bağlı olarak aşağıdakilerden birine başvurun: * WindowsSunucu[İkinci aşama: Doğrudan Erişim ağ geçidi öğesini veri kaynaklarınızı koruyan güvenlik duvarının arkasındaki bir sunucuya yükleyin](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage4): * Kapsayıcıya alınmış: [İkinci aşama: Docker Compose dosyasını çalıştırarak dağıtımı başlatın](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage2) ### 3. Aşama: Doğrudan Erişim ağ geçidi kurulumu Bu aşama Qlik Cloud kiracı URL'nizi ayarlamayı, isteğe bağlı olarak bir proxy sunucu ayarlamayı ve bir kayıt anahtarı oluşturmayı içerir. Anahtarı, Yönetim etkinlik merkezinde veri ağ geçidi anahtarı ayarlarına kopyalamanız gerekir (aşağıdaki 3. aşama). Anahtar Doğrudan Erişim ağ geçidi ile Qlik Cloud kiracısı arasında kimlik doğrulamalı bir bağlantı kurmak için kullanılır. Bilgi notu Qlik Anonim kiracısına (İsveç bölgesi) bağlanma işlemi desteklenmez. Doğrudan Erişim ağ geçidi 1.7.16 sürümünden itibaren Kanada bölgesi artık desteklenmektedir. Ağ geçidi kurulum dosyasını dağıtırken Yönetim etkinlik merkezindeki dağıtım sırasında Kanada bölgesini seçin. Direct Access gateway makinesinde, kurulum iş akışınıza bağlı olarak aşağıdakilerden birini yapın: * Windows sunucusu: Komut İstemi'ni yönetici olarak açın ve çalışma dizinini ConnectorAgent alt klasörüne (varsayılan bir kurulumda C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) değiştirin. * Kapsayıcıya alınmış: direct-access-agent kapsayıcısının içinde bir konsol açın. Ardından aşağıda açıklandığı gibi devam edin. #### Qlik Cloud kiracıyı ayarlama Bağlanılacak Qlik Cloud kiracısını seçin. Kiracıya bir proxy sunucusu aracılığıyla bağlanmak için ilgili parametreleri komut satırına aşağıda gösterildiği gibi ekleyin. Proxy sunucusu olmadan Qlik Cloud kiracısını ayarlamak için komutlar: * Windows sunucu kurulumu * Söz Dizimi:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url * Örnek: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com * Konteynerleştirilmiş kurulum * Söz Dizimi:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url * Örnek: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com Qlik Cloud kiracısını bir proxy sunucusuyla ayarlama komutları: * Windows sunucu kurulumu * Söz Dizimi:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password * Örnek: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@ * Konteynerleştirilmiş kurulum * Söz Dizimi:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password * Örnek: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@ Proxy sınırlamaları hakkında bilgi için bkz. [Qlik Cloud uygulamasına proxy sunucu üzerinden bağlanma](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Connecti). #### CA paketini ayarlama CA paketi, Qlik Cloud kiracısının kimliğini doğrular ve böylece güvenilir bir bağlantı sağlar. CA paketini kimin ayarlaması gerekir? CA paketinin yalnızca aşağıdaki olmanız durumunda ayarlanması gerekir: * Bir Qlik Cloud Government müşterisi * Proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı kullanan Qlik Cloud ticari müşterisi Hangi paketi kullanmalıyım? Müşteriler ya Qlik CA paketini kullanmalı ya da kendi CA paketlerini aşağıdaki şekilde getirmelidir: * Qlik CA paketle sağlar: Standart bir ortama sahip Qlik Cloud Government müşterileri tarafından kullanılmalıdır. Standart ortam, proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı içermeyen ortamdır. Varsayılan Doğrudan Erişim ağ geçidi yüklemesinde, CA paketi dosyası aşağıdaki konumda bulunabilir: * Windows sunucu kurulumu: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg\_ca\_bundle.pem * Kapsayıcılı kurulum: /usr/share/Qlik/Gateway/ssl/qcg\_ca\_bundle.pem Bilgi notuCA paket dosyasını yeniden adlandırabilirsiniz ancak dosyanın .pem uzantısına sahip olduğundan emin olun (örneğin, qlikcerts.pem). Ardından aşağıda açıklanan komutları çalıştırın. * Müşteriler kendi CA paketle getirir: Müşteriye ait ortam, proxy işlevi gören ve İnternet'ten alınan sertifika bilgilerini kendi CA kök sertifikalar ile değiştiren bir güvenlik cihazı kullanıyorsa kullanılmalıdır. Bu sertifikalar otomatik olarak imzalanmışsa CA paketini ayarlama komutuna ek olarak CA paketine izin verme komutunu da çalıştırmanız gerekir. Bu komutların her ikisi de aşağıda açıklanmaktadır. Bu hem Qlik Cloud Government müşterileri hem de Qlik Cloud ticari müşterileri için geçerlidir. CA paketini ayarlama komutu CA sertifika paketini ayarlamak için aşağıdaki komutu çalıştırın: Söz dizimi (Windows sunucu kurulumu): connectoragent qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file Sözdizimi (kapsayıcılı kurulum): dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file Örnek (Windows sunucu kurulumu): connectoragent qcs qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem Örnek (kapsayıcılı kurulum): dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem CA paketine izin verme komutu Bazı ortamlar proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı kullanır. Bu komutun yalnızca güvenlik cihazının kendisinin otomatik olarak imzalanmış bir sertifika kullanması durumunda çalıştırılması gerekir. Böyle bir durumda, aşağıdaki komutu çalıştırmazsanız CA paketine güvenilmeyebilir: * Windows sunucu kurulumu: connectoragent qcs set\_config --ca\_bundle\_allow\_invalid\_certs true * Kapsayıcılı kurulum: dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_allow\_invalid\_certs true Bilgi notuOrtamınızın bu tür bir güvenlik cihazı kullanıp kullanmadığından emin değilseniz lütfen BT yöneticinize başvurun. #### Kayıt anahtarını oluşturma ve gösterme Anahtar Doğrudan Erişim ağ geçidi ile Qlik Cloud kiracısı arasında kimlik doğrulamalı bir bağlantı kurmak için kullanılır. Kayıt anahtarını oluşturma komutları * Windows sunucu kurulumu: connectoragent qcs generate\_keys * Konteynerleştirilmiş kurulum: dotnet ConnectorAgent.dll qcs generate\_keys Kayıt anahtarını gösterme komutları dotnet ConnectorAgent.dll qcs get\_registration * Windows sunucu kurulumu: connectoragent qcs get\_registration * Konteynerleştirilmiş kurulum: dotnet ConnectorAgent.dll qcs get\_registration Anahtar gösterilir. ![](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/da_reg_key.png) Anahtarın tamamını yukarıdaki örnekte gösterildiği gibi kopyalayın. Sonraki aşamada anahtarı Yönetim etkinlik merkezine yapıştırmanız gerekecek. ### Dördüncü aşama: Veri ağ geçidini kaydetme Bir sonraki adım, veri ağ geçidini kaydetmektir. Bu işlem, Yönetim etkinlik merkezi üzerinden veya komut satırından yapılabilir. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Seçenek 1: Yönetim etkinlik merkezi üzerinden Uyarı notuDoğrudan Erişim ağ geçidi kaydetmek, güvenli ağ geçidi-kiracı iletişimi için Kimlik sağlayıcı (Çoklu bulut) girişini Yönetim etkinlik merkezinde otomatik olarak oluşturur. Kimlik sağlayıcı açıklaması, ilgili ağ geçidini Veri ağ geçitleri bölümünde (Yönetim etkinlik merkezinin) kolayca bulmanızı sağlayan ağ geçidi kimliğini (veren gateway\_id) içerir. Ağ geçidi Kimlik sağlayıcı'yı silmek, ağ geçidinin bağlantısını kesecektir, bu nedenle bunu yalnızca ağ geçidinin artık gerekli olmadığından kesinlikle eminseniz yapmalısınız. Yanlışlıkla Kimlik sağlayıcı'yı sildiyseniz, Doğrudan Erişim ağ geçidi'yi yeniden başlatmak girişi geri yükleyecek ve ağ geçidini yeniden bağlayacaktır. 1. Yönetim etkinlik merkezindeki Veri ağ geçitleri öğesini seçin. Mevcut veri ağ geçitleri [her ağ geçidi hakkında temel bilgiler gösteren bir tabloda](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop) listelenir. 2. Oluştur araç çubuğu düğmesine tıklayın. Veri ağ geçidi oluştur diyalog penceresi açılır. ![](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_da-gate-create.png) 3. Veri ağ geçidi için bir ad belirtin. 4. İsteğe bağlı olarak veri ağ geçidi için bir açıklama girebilirsiniz. 5. Veri ağ geçidi tür açılır listesinden Doğrudan Erişim'i seçin. 6. İlişkili alan açılır listesinden bir alan seçin. Doğrudan Erişim ağ geçidini bir alan ile ilişkilendirirken aşağıdakilerin farkında olmalısınız: * Veri ağ geçitleri yalnızca paylaşılan veya yönetilen alanlarda oluşturulabilir * Başka bir alandan veri ağ geçidi kullanan bir alandan veri bağlantısı oluşturmak için veri ağ geçidi alanında Veri tüketebilir rolüne sahip olmanız gerekir. * Veri ağ geçidi oluşturmak için bir alan sahibi olmanız veya Yönetebilir rolüne sahip olmanız gerekir. Kullanıcı tabanlı abonelikler için ayrıca Profesyonel yetkisine ihtiyacınız vardır. Daha fazla bilgi için şuraya bakın: [Kullanıcı yetkilendirmelerini yönetme](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-user-allocations.htm). * Veri ağ geçitleri yalnızca tek bir alanla ilişkilendirilebilir. 7. Daha önce oluşturduğunuz anahtarı Anahtar alanına yapıştırın. 8. Oluştur'a tıklayın. Veri ağ geçidi Veri ağ geçitleri listesine eklenir ve etkinleştirilir. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Seçenek 2: Komut satırını kullanarak otomatik kayıt Ayrıca Yönetim etkinlik merkezini kullanmadan, komut satırından otomatik olarak Doğrudan Erişim ağ geçidi kaydı yapabilirsiniz. Bilgi notu Ağ geçitlerini otomatik olarak kaydetmek ve otomatik olarak kaydedilen ağ geçitlerini kaldırmak için aşağıdaki izinlere sahip olmanız gerekir: * Otomatik kayıt: Direct Access gateway kaydet yönetici izninin İzin Verildi olarak ayarlanmış olması gerekir. * Otomatik olarak kaydedilen gateway'leri kaldırma: Direct Access gateway kaydet yönetici izninin İzin Verildi olarak ayarlanmış olması gerekir. İzinler hakkında daha fazla bilgi için bkz. [Varsayılan izinler ve özel roller](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/permissions-scopes-capacity-model.htm). Talimatlar için kurulum iş akışınıza bağlı olarak aşağıdakilerden birine bakın: * Windows sunucu kurulumu: [Seçenek 2: Komut satırını kullanarak otomatik kayıt](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#StageAuto) * Kapsayıcılı kurulum: [Seçenek 2: Komut satırını kullanarak otomatik kayıt](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#StageAuto) ### Beşinci aşama: Doğrudan Erişim ağ geçidi sunucusunda Qlik Data Gateway - Doğrudan Erişim hizmetini başlatın Ardından, Qlik Data Gateway - Doğrudan Erişim hizmetini başlatmanız gerekir. Kurulum yönteminize bağlı olarak aşağıdakilerden birine başvurun: * Windows sunucu kurulumu: [Beşinci aşama: Doğrudan Erişim ağ geçidi sunucusunda Qlik Data Gateway - Doğrudan Erişim hizmetini başlatın](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage3) * Kapsayıcılı kurulum: [Beşinci aşama: Doğrudan Erişim ağ geçidi sunucusunda Qlik Data Gateway - Doğrudan Erişim hizmetini başlatın](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage5) ### Altıncı aşama: Veri kaynağına bir bağlantı ekleyin Ağ geçidinizi Veri ağ geçitleri listesinde bulun ve Durum'unun "Bağlandı" olduğundan emin olun (geçerli durumu görmek için tarayıcınızı yenilemeniz gerekebilir). Bundan sonra veri kaynağınıza bir bağlantı eklemeye geçebilirsiniz. Veri kaynağından veri yüklemenin birkaç yolu vardır: * [Alanlardaki veri kaynaklarını ekleme ve yönetme](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/managing-data-resources-spaces.htm) * [Veri Yöneticisi ile veri yükleme ve yönetme](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/managing-data.htm) * [Kodlarla veri yükleme ve dönüştürme](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/introduction-data-modeling.htm) Mevcut veri kaynaklarının listesi, ağ geçidi bağlantılarını destekleyen veri kaynakları için yinelenen girişler içerecektir. Ağ geçidi uyumlu veri kaynakları, kaynağından adından sonra ayraçlar içinde görünen "Doğrudan Erişim ağ geçidi üzerinden" ifadesiyle tanınabilir. Ağ geçidi uyumlu kaynak bağlantısı örneği Ağ geçidi uyumlu kaynak bağlantısı örneği Ağ geçidi uyumlu kaynak bağlantısı örneği ![Ağ geçidi uyumlu kaynak bağlantısı örneği](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/da-source-example.png) Bilgi notuAğ geçidi uyumlu veri kaynakları için Veri bağlantısı ekle diyalog penceresinde, kullanılacak ağ geçidini seçmenize izin veren ilave bir Doğrudan Erişim ağ geçidi alanı bulunur. ## Genel sınırlamalar ve dikkat edilmesi gereken noktalar * Doğrudan Erişim ağ geçidi yalnızca tek bir kiracıya bağlanabilir. * Herhangi bir nedenle Qlik uygulamasının yeniden yüklenmesi sırasında Doğrudan Erişim ağ geçidi sunucusu yeniden başlatılırsa yeniden yükleme başarısız olur. Verileri yenilemek için Qlik uygulama yeniden yüklemesini yeniden başlatın. * Yeniden yükleme komut dosyası sorguları 500.000 karakteri aşamaz. Komut dosyalarını yeniden yükleme hakkında bilgi için bkz. [Kod çalıştırma](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/reloading-scripts.htm).