# Configurazione di Qlik Data Gateway - Accesso diretto È possibile configurare Qlik Data Gateway - Accesso diretto sia su un server Windows sia in un ambiente containerizzato. Per una corretta configurazione, assicurarsi di avere familiarità con i prerequisiti, le istruzioni di installazione, le limitazioni e le considerazioni relative al flusso di lavoro di configurazione specifico. Nota informatica Per il pattern AWS PrivateLink per Qlik Data Gateway - Accesso diretto, consulta [Configurazione di AWS PrivateLink per Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-aws-privatelink.htm). Il pattern non sostituisce i prerequisiti standard e i requisiti di rete in questo argomento. ## Configura i flussi di lavoro Scegliere uno dei seguenti flussi di lavoro: * [Configurazione di Qlik Data Gateway - Accesso diretto su un server Windows](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) * [Configurazione di Qlik Data Gateway - Accesso diretto in un contenitore](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm) ## Prerequisiti di sistema ### Requisiti software Fare riferimento a una delle seguenti opzioni in base al metodo di configurazione: * WindowsServer[Prerequisiti di software](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software): * Containerizzato: [Requisiti software](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#SoftwareReq) ### Requisiti comuni Questi requisiti sono applicabili sia alle installazioni server Windows sia a quelle containerizzate. #### Porte e protocolli richiesti La sezione seguente elenca le porte necessarie. #### Porte in uscita HTTPS/TCP-443 deve essere aperto per la comunicazione in uscita verso <tenant-id>.<region>.qlikcloud.com. #### Porte interne Di seguito è riportato un elenco di porte utilizzate per la comunicazione dai processi interni del gateway dati. Se una di queste porte è utilizzata da un'altra applicazione, riconfigurare l'altra applicazione o disinstallarla. Porte generiche * 5050 (API REST dell'agente connettore) * 9027 (API REST DCAAS) Porte ODBC * 3005 (API REST connettore ODBC) * 50260 (gRPC connettore ODBC) Porte SAP * 3015 (SAP BW Connector REST API) * 50270 (SAP BW Connector gRPC) * 3025 (SAP SQL Connector REST API) * 50280 (SAP SQL Connector gRPC) * 3035 (API REST connettore SAP ODP) * 50290 (gRPC connettore SAP ODP) * 3035 (API REST connettore SAP Package) * 50290 (gRPC connettore SAP Package) Porte REST * 3055 (connettore REST API REST) * 50310 (connettore REST gRPC) Porte dei file * 3045 (Connettore file REST API) * 50300 (Connettore file gRPC) #### Protocollo WSS Oltre a HTTPS, il gateway di Direct Access utilizza anche il protocollo WSS (WebSocket Secure). Pertanto, assicurarsi che il proprio firewall e il server proxy (se si intende utilizzarne uno) siano configurati per consentire le connessioni WSS in uscita. ### Hardware consigliato Fare riferimento a una delle seguenti opzioni in base al metodo di configurazione: * WindowsServer[Hardware consigliato](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#RecHardware): * Containerizzato: [Hardware consigliato](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#RecHardware) ### Crittografia di sistema (Windows solo installazione server) Vedere [Crittografia di sistema](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#System). ## Installazione di Qlik Data Gateway - Accesso diretto ### Fase uno: Scarica Qlik Data Gateway - Accesso diretto Fare riferimento a una delle seguenti opzioni in base al metodo di configurazione: * WindowsServer[Passaggio uno: scaricare Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage5): * Containerizzato: [Passaggio uno: scaricare Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage1) ### Fase due: installare o distribuire Gateway di Direct Access Fare riferimento a una delle seguenti opzioni in base al metodo di configurazione: * WindowsServer[Passaggio due: installare Gateway di Direct Access su un server con firewall che protegge le sorgenti dati](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage4): * Containerizzato: [Fase due: Avviare la distribuzione eseguendo il file Docker Compose](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage2) ### Fase tre: Configura Gateway di Direct Access Questa fase include l'impostazione dell'URL del tenant Qlik Cloud, l'impostazione opzionale di un server proxy e la generazione di una chiave di registrazione. È necessario copiare la chiave nelle impostazioni del gateway dati nel centro attività Amministrazione (come descritto nel terzo passaggio di seguito). La chiave viene utilizzata per stabilire una connessione autenticata tra il gateway Accesso diretto e il tenant Qlik Cloud. Nota informatica La connessione a un tenant anonimo di Qlik (regione Svezia) non è supportata. A partire da Gateway di Direct Access 1.7.16, la regione Canada è ora supportata. Selezionare la regione Canada durante la distribuzione nel centro attività Amministrazione quando si distribuisce il file di installazione del gateway. Sulla macchina del gateway di Direct Access, eseguire una delle seguenti azioni in base al flusso di lavoro di installazione: * Windows server: Aprire un prompt dei comandi come amministratore e modificare la directory di lavoro nella sottocartella ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita). * Containerizzato: Apri una console all'interno del contenitore direct-access-agent. Quindi, continuare come descritto di seguito. #### Impostazione del tenant Qlik Cloud Impostare il tenant Qlik Cloud a cui connettersi. Per connettersi al tenant tramite un server proxy, aggiungere i parametri pertinenti al comando come mostrato di seguito. Comandi per impostare il tenant Qlik Cloud senza un server proxy: * Windows installazione del server * Sintassi:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url * Esempio: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com * Installazione containerizzata * Sintassi:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url * Esempio: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com Comandi per configurare il tenant Qlik Cloud con un server proxy: * Windows installazione del server * Sintassi:connectoragent qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password * Esempio: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@ * Installazione containerizzata * Sintassi:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url your-qlik-cloud-tenant-url --proxy\_url http://host:port --proxy\_username username --proxy\_password password * Esempio: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@ Per informazioni sulle limitazioni dei proxy, vedere [Connessione a Qlik Cloud mediante un server proxy](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Connecti). #### Impostazione del bundle CA Il bundle CA autentica l'identità del tenant di Qlik Cloud, garantendo così una connessione affidabile. Chi deve impostare il bundle CA? Il bundle CA deve essere impostato solo se si è: * Un cliente Qlik Cloud Government * Un cliente Qlik Cloud commerciale che utilizza un dispositivo di sicurezza che agisce come proxy e sostituisce le informazioni sui certificati ricevute da Internet con i propri certificati radice CA Quale bundle devo utilizzare? I clienti devono utilizzare il bundle CA Qlik o portare il proprio bundle CA, come segue: * Qlik fornisce il bundle CA: Dovrebbe essere utilizzato dai clienti Qlik Cloud Government con un ambiente standard. Un ambiente standard è un ambiente che non dispone di un dispositivo di sicurezza che funge da proxy e sostituisce le informazioni sui certificati ricevute da Internet con i propri certificati radice CA. Nell'installazione predefinita diGateway di Direct Access, il file del bundle CA è disponibile nella seguente posizione: * Windows installazione del server: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg\_ca\_bundle.pem * Installazione containerizzata: /usr/share/Qlik/Gateway/ssl/qcg\_ca\_bundle.pem Nota informaticaÈ possibile rinominare il file del bundle CA, ma assicurarsi che abbia l'estensione .pem (ad esempio, qlikcerts.pem). Eseguire quindi i comandi descritti di seguito. * I clienti forniscono il proprio bundle CA: Deve essere utilizzato se l'ambiente del cliente usa un'appliance di sicurezza che funge da proxy e sostituisce le informazioni del certificato ricevute da Internet con i propri certificati root CA. Se i certificati sono autofirmati, oltre al comando per impostare il bundle CA, è necessario eseguire anche il comando per consentire il bundle CA. Entrambi i comandi sono descritti di seguito. Questo vale sia per i clienti Qlik Cloud Government che per i clienti Qlik Cloud commerciali. Comando per l'impostazione del bundle CA Eseguire il seguente comando per impostare il bundle CA del certificato: Sintassi (installazione del server Windows): connectoragent qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file Sintassi (installazione containerizzata): dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path path-to-ca-bundle-file Esempio (installazione del server Windows): connectoragent qcs qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem Esempio (installazione containerizzata): dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_path c:\ca\cacerts.pem Comando per l'autorizzazione del bundle CA Alcuni ambienti utilizzano un dispositivo di sicurezza che funge da proxy e sostituisce le informazioni sui certificati ricevute da Internet con i propri certificati radice CA.. Questo comando deve essere eseguito solo se il dispositivo di sicurezza utilizza un certificato autofirmato. In questo caso, il bundle CA potrebbe non essere attendibile, a meno che non si esegua il seguente comando: * Windows installazione del server: connectoragent qcs set\_config --ca\_bundle\_allow\_invalid\_certs true * Installazione containerizzata: dotnet ConnectorAgent.dll qcs set\_config --ca\_bundle\_allow\_invalid\_certs true Nota informaticaSe non si è sicuri che il proprio ambiente utilizzi un dispositivo di sicurezza, contattare il proprio amministratore IT. #### Generazione e visualizzazione della chiave di registrazione La chiave viene utilizzata per stabilire una connessione autenticata tra il gateway Accesso diretto e il tenant Qlik Cloud. Comandi per la generazione della chiave di registrazione * Windows installazione del server: connectoragent qcs generate\_keys * Installazione containerizzata: dotnet ConnectorAgent.dll qcs generate\_keys Comandi per la visualizzazione della chiave di registrazione dotnet ConnectorAgent.dll qcs get\_registration * Windows installazione del server: connectoragent qcs get\_registration * Installazione containerizzata: dotnet ConnectorAgent.dll qcs get\_registration Viene mostrata la chiave. ![](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/da_reg_key.png) Copiare l'intera chiave come mostrato nell'esempio precedente. È necessario incollarla nel centro attività Amministrazione nel passaggio successivo. ### Fase quattro: Registrare il gateway dati Il passaggio successivo consiste nel registrare il gateway dati. Questa operazione può essere eseguita sia tramite il centro attività Amministrazione sia da riga di comando. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Opzione 1: Tramite il centro attività Amministrazione Nota di avvisoLa registrazione di un Gateway di Direct Access crea automaticamente una voce Identify provider (Multi-cloud) nel centro attività Amministrazione , per una comunicazione sicura da gateway a tenant. La descrizione di Identity provider include l'ID gateway (issuer gateway\_id), che consente di individuare facilmente il gateway associato nella sezione Gateway dati (del centro attività Amministrazione ). L'eliminazione di Identity provider del gateway disconnetterà il gateway, quindi è consigliabile farlo solo se si è assolutamente certi che il gateway non sia più necessario. Se è stato eliminato accidentalmente Identity provider, il riavvio di Gateway di Direct Access ripristinerà la voce e riconnetterà il gateway. 1. Nel centro attività Amministrazione, selezionare Gateway dati. Tutti i gateway di dati esistenti saranno elencati in [una tabella che riporta le informazioni di base su ciascun gateway](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing-console.htm#gateprop). 2. Fare clic sul pulsante della barra degli strumenti Crea. Si apre la finestra di dialogo Crea gateway dati. ![](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_da-gate-create.png) 3. Specificare un nome per il gateway dati. 4. Opzionalmente, fornire una descrizione del gateway dati. 5. Dall'elenco a discesa Tipo di gateway dati, selezionare Accesso diretto. 6. Dall'elenco a discesa Spazio associato, selezionare uno spazio. Quando si associa il gateway Accesso diretto a uno spazio, bisogna tenere presente quanto segue: * I gateway dati possono essere creati solo negli spazi condivisi o gestiti * Per creare una connessione dati in uno spazio che utilizza un gateway dati da un altro spazio, è necessario disporre del ruolo Può consumare dati nello spazio del gateway dati. * Per creare un gateway dati, è necessario essere proprietari dello spazio o avere il ruolo Può gestire. Per le sottoscrizioni basate sull'utente, è necessario anche un diritto utente Professional. Per ulteriori informazioni, vedere [Gestione dei diritti utente](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/SaaS-user-allocations.htm). * I gateway dati possono essere associati solo a uno spazio singolo. 7. Incollare la chiave di registrazione generata in precedenza nel campo Chiave. 8. Fare clic su Crea. Il gateway dati viene aggiunto all'elenco Gateway dati. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm)Opzione 2: registrazione automatica tramite la riga di comando È anche possibile registrare Gateway di Direct Access automaticamente dalla riga di comando, senza usare il centro attività Amministrazione. Per istruzioni, consulta uno dei seguenti argomenti in base al tuo flusso di lavoro di installazione: * Windows installazione del server: [Opzione 2: Registrazione automatica tramite la riga di comando](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#StageAuto) * Installazione containerizzata: [Opzione 2: Registrazione automatica tramite la riga di comando](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#StageAuto) ### Fase cinque: Avviare il servizio Qlik Data Gateway - Accesso diretto sul server del gateway di c Successivamente, è necessario avviare il servizio Qlik Data Gateway - Accesso diretto. Fare riferimento a una delle seguenti opzioni in base al metodo di configurazione: * Windows installazione del server: [Fase cinque: Avviare il servizio Qlik Data Gateway - Accesso diretto sul server del gateway di c](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage3) * Installazione containerizzata: [Fase cinque: Avviare il servizio Qlik Data Gateway - Accesso diretto sul server del gateway di c](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-container.htm#Stage5) ### Passaggio sei: aggiunta di una connessione alla sorgente dati Individuare il gateway nell'elencoGateway dati e verificare che lo stato sia "Connesso" (potrebbe essere necessario aggiornare il browser per vedere lo stato corrente). È quindi possibile procedere con l'aggiunta di una connessione alla propria sorgente dati. Esistono diversi modi per caricare i dati dalle sorgenti dati: * [Aggiunta e gestione delle sorgenti dati dagli spazi](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/managing-data-resources-spaces.htm) * [Caricamento e gestione dei dati con Gestione dati](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/managing-data.htm) * [Caricamento e trasformazione dei dati con lo scripting](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/introduction-data-modeling.htm) L'elenco delle sorgenti dati disponibili conterrà voci duplicate per le sorgenti dati che supportano la connettività del gateway. Le sorgenti dati conformi al gateway possono essere identificate dalla dicitura "via gateway Accesso diretto", che compare tra parentesi dopo il tipo di sorgente. Esempio di connessione alla sorgente conforme al gateway Esempio di connessione alla sorgente conforme al gateway Esempio di connessione alla sorgente conforme al gateway ![Esempio di connessione alla sorgente conforme al gateway](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/da-source-example.png) Nota informaticaLa finestra di dialogo Aggiungi connessione dati per le sorgenti dati compatibili con il gateway presenta un campo aggiuntivo Gateway Direct Access che consente di selezionare il gateway da utilizzare. ## Limiti e considerazioni generali * Gateway di Direct Access può connettersi solo a un singolo tenant. * Se, per qualsiasi motivo, il server di Gateway di Direct Access viene riavviato durante il ricaricamento di un'applicazione Qlik, il ricaricamento non verrà completato. Riavviare l'applicazione Qlik per aggiornare i dati. * Le query degli script di caricamento non possono superare i 500.000 caratteri. Per informazioni sul ricaricamento degli script, vedere [Esecuzione di script](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/ScriptEditor/reloading-scripts.htm).