# Configurazione di Qlik Data Gateway - Accesso diretto su un server Windows Questo argomento descrive come configurare Qlik Data Gateway - Accesso diretto su un server Windows. Fornisce i prerequisiti e le istruzioni di installazione e descrive le limitazioni e le considerazioni che è importante ricordare quando si utilizza Qlik Data Gateway - Accesso diretto su un server Windows. ## Procedure consigliate quando si utilizza Qlik Data Gateway - Accesso diretto Per un'esperienza ottimale quando si utilizza Qlik Data Gateway - Accesso diretto, si consiglia vivamente di seguire le seguenti procedure consigliate: * Non usare lo stesso Gateway di Direct Access per lo sviluppo, il testing dell'accettazione degli utenti e la produzione, poiché così facendo aumenterà il rischio di sovraccaricare le risorse disponibili con conseguenze negative sulla stabilità del sistema. Da una prospettiva aziendale, la combinazione di risorse insufficienti e stabilità ridotta, possono causare un ritardo negli aggiornamenti dei dati di applicazione di produzione. * Per ottenere prestazioni ottimali, installare Gateway di Direct Access su un server il più vicino possibile alla sorgente dati. * È necessario installare Gateway di Direct Access su un server Windows Server dedicato, come indicato nei requisiti di sistema riportati di seguito. Non installare sul server del database corrente o insieme ad altri prodotti Qlik, inclusi ma non limitati a, Qlik DataTransfer, Qlik Sense Desktop e Qlik Sense Enterprise. ## Prerequisiti di sistema Questa sezione descrive i requisiti software, delle porte e hardware per l'utilizzo di Qlik Data Gateway - Accesso diretto su un server Windows. ### Prerequisiti di software * Il gateway Accesso diretto deve essere installato su un computer Windows Server dietro il firewall. Il server deve essere in grado di accedere alla sorgente dati. Edizioni di Windows Server supportate: * 2016 * 2019 * 2022 * 2025 Windows Server 2025 richiede Qlik Data Gateway - Accesso diretto 1.7.0 o versione successiva. * È necessario installare tre differenti versioni di .NET. Installare solo le seguenti versioni di .NET: * .NET 4.8: richiesto per l'installazione * .NET 6.0.x Runtime (x64) e ASP.NET Core Runtime 6.0.x (x64) (patch più recente) Nota notizieDal Gateway di Direct Access 1.6.8, .NET 6.0.x non è più richiesto. * .NET 8.0.x Runtime (x64) e ASP.NET Core Runtime 8.0.x (x64) (patch più recente) Nota informatica * L'installazione di versioni di .NET runtime successive a quella 8.0.x non è supportata. * L'esecuzione del Gateway di Direct Access 1.6.6 e 1.6.7 richiede le versioni 6.0.x e 8.0.x di .NET e ASP.NET Core Runtime. Per istruzioni su come verificare la versione di .NET attualmente installata, vedere https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed. * Microsoft Visual C++ 2015-2022 Redistribuibile (x64). La configurazione di Gateway di Direct Access richiede l'installazione del ridistribuibile se rileva che non è ancora installato. #### Prerequisiti di software aggiuntivi quando si utilizzano sorgenti dati SAP * Installare il SAP NetWeaver RFC SDK sul computer Qlik Data Gateway - Accesso diretto come descritto in [Installazione del SAP NetWeaver RFC SDK per Qlik Data Gateway - Accesso diretto](https://help.qlik.com/en-US/cloud-services/Subsystems/SAP_Connectors_Help/Content/Connectors_SAP/Installation/Installing-sap-connectors-for-direct-access-gw.htm) (solo in lingua inglese). * Installare Microsoft Visual C++ 2013 Redistributable (x64) sul computer Qlik Data Gateway - Accesso diretto. ### Porte e protocolli richiesti Per le porte e i protocolli richiesti, vedere [Porte e protocolli richiesti](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Ports). ### Hardware consigliato * 8 core * 32 GB di memoria * 5 GB di spazio di archiviazione #### Requisiti hardware minimi I requisiti hardware minimi sono adatti solo per scenari specifici che utilizzano distribuzioni del server dedicate più piccole (sviluppo, test e produzione), con volumi di dati costantemente bassi e un numero limitato di ricaricamenti simultanei. * 4 core * 8 GB di memoria * 5 GB di spazio di archiviazione Potrebbero essere necessarie più risorse per garantire un'elaborazione coerente di volumi di dati crescenti e un numero più elevato di ricaricamenti simultanei. Il punto in cui le prestazioni diventano inaccettabili dipende dal caso d'uso e dalla configurazione di ciascun ambiente. ### Crittografia di sistema Qlik Cloud Government supporta l'utilizzo di Qlik Data Gateway - Direct Access solo quando Windows è configurato per l'esecuzione in una modalità di funzionamento approvata da FIPS 140-2 (modalità FIPS). Per attivare la modalità FIPS, abilitare il criterio Windows: [Crittografia di sistema: Utilizzare algoritmi conformi a FIPS per crittografia, hashing e firma](https://learn.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/system-cryptography-use-fips-compliant-algorithms-for-encryption-hashing-and-signing). Per ulteriori informazioni, vedere il punto 3 della procedura [Utilizzo di Windows in una modalità operativa approvata da FIPS 140-2](https://learn.microsoft.com/en-us/windows/security/threat-protection/fips-140-validation#using-windows-in-a-fips-140-2-approved-mode-of-operation). Nota informaticaNon è necessario installare altri moduli. Qlik Data Gateway - Direct Access utilizza solo i moduli già forniti da Windows e inclusi nell'[elenco dei moduli convalidati](https://learn.microsoft.com/en-us/windows/security/threat-protection/fips-140-validation#microsoft-fips-140-2-validated-cryptographic-modules). Qlik Data Gateway - Direct Access impone l'uso di soli algoritmi crittografici convalidati da FIPS tramite .NET Runtime. ## Installazione di Qlik Data Gateway - Accesso diretto La configurazione del gateway di Direct Access comporta procedure che devono essere eseguite sia nel centro attività Amministrazione sia sul server del gateway di Direct Access. Nota informaticaLe procedure per il gateway dati che è necessario eseguire nel centro attività Amministrazione richiedono l'autorizzazione dell'amministratore tenant. Passaggi di configurazione di Qlik Data Gateway - Accesso diretto — Installazione su un server Windows Passaggi di configurazione di Qlik Data Gateway - Accesso diretto — Installazione su un server Windows Passaggi di configurazione di Qlik Data Gateway - Accesso direttoQlik Data Gateway - Accesso diretto — Installazione su un server WindowsWindows ![Diagramma di flusso del gateway Accesso diretto - passaggi di configurazione per la configurazione su un server Windows.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/direct-access-gateway_setup.png) ### Passaggio uno: scaricare Qlik Data Gateway - Accesso diretto 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 Distribuisci. Si apre la finestra di dialogo Distribuisci gateway dati. 3. Seleziona Data Gateway - Accesso diretto (Windows), accetta il Contratto con il cliente Qlik e fai clic su Scarica. Il file di installazione del gateway di Direct Access (qlik-data-gateway-direct-access.exe) verrà scaricato sul computer. ### Passaggio due: installare Gateway di Direct Access su un server con firewall che protegge le sorgenti dati Questa fase prevede l'installazione del Gateway di Direct Access. È possibile installare Gateway di Direct Access automaticamente o in modo interattivo. Nota informaticaLa disinstallazione di Gateway di Direct Access non rimuove le impostazioni di configurazione. In altre parole, se si disinstalla una versione del Gateway di Direct Access e poi si installa una versione diversa, la nuova versione installata utilizzerà la stessa configurazione della versione disinstallata. Nota informaticaPer sovrascrivere l'account di servizio predefinito di Windows è necessario Gateway di Direct Access 1.7.4 o versione successiva. #### Installazione di Gateway di Direct Access in modo interattivo 1. Al termine del download, copiare il file di installazione su un computer Windows Server dietro il firewall. Assicurarsi che il computer possa comunicare con le proprie sorgenti dati. 2. Aprire il file qlik-data-gateway-direct-access.exe per avviare la procedura guidata di installazione. Nota informatica * Gateway di Direct Access richiede Microsoft .NET 6.x e .NET 8.x. Se la configurazione rileva che è installata una versione precedente, verrà richiesto di installare la versione richiesta. Al termine dell'installazione di .NET, è necessario riavviare il computer del Gateway di Direct Access ed eseguire nuovamente la configurazione del Gateway di Direct Access. * La configurazione chiederà di installare Microsoft Visual C++ 2015-2022 Redistributabella (x64) se rileva che non è ancora installato. Nota informatica * Durante la configurazione, è possibile sovrascrivere le seguenti impostazioni predefinite: * Il percorso di installazione(C:\Program Files\Qlik\ConnectorAgent). * L'account di servizio di Windows con il quale verrà installato Gateway di Direct Access (LocalSystem) L'account di servizio specificato deve avere sia il diritto di "accesso come servizio" che l'autorizzazione di "scrittura" sulla cartella di installazione di Gateway di Direct Access. 3. Continuare a fare clic su Avanti fino al completamento dell'installazione. #### Installazione, aggiornamento e disinstallazione in modo automatico del Gateway di Direct Access Nota informaticaAzioni supportate a partire da Gateway di Direct Access 1.6.4. L'installazione automatica del Gateway di Direct Access, può essere utile, ad esempio, se è necessario installare il Gateway di Direct Access su più computer in tutta l'organizzazione. Se necessario, è possibile anche sovrascrivere l'account di servizio predefinito di Windows (LocalSystem). Prerequisiti Prima di avviare l'installazione automatica, assicurarsi di installare le versioni corrette di tutti i [software indispensabili](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Software) poiché, a differenza dell'installazione interattiva, non è possibile farlo durante l'installazione. Installazione o aggiornamento del Gateway di Direct Access Aprire un prompt CMD come amministratore ed eseguire il seguente comando dalla cartella contenente l'eseguibile del Gateway di Direct Access: qlik-data-gateway-direct-access.exe /S InstallPath="full-path" AcceptEula=yes Nei casi in cui è necessario sostituire full-path con il percorso di installazione effettivo racchiuso da virgolette, ad esempio, C:\TMP\Qlik. Nota informaticaÈ richiesta l'impostazione del parametro AcceptEula su "sì". Impostando il parametro AcceptEula su "sì", l'utente accetta i termini dell'[QlikAccordo cliente](https://www.qlik.com/us/legal/legal-agreements). Sovrascrivere l'account di servizio predefinito di Windows Per impostazione predefinita, Gateway di Direct Access è installato in LocalSystem nell'account del servizio Windows . Per installare Gateway di Direct Access con un altro account, includere i seguenti parametri nel comando: * ServiceAccount: il proprietario dell'account di servizio. Nota informaticaL'account di servizio specificato deve avere sia il diritto di "accesso come servizio" che l'autorizzazione di "scrittura" sulla cartella di installazione di Gateway di Direct Access. * ServicePassword: la password dell'account di servizio specificato. Esempio di comando con parametri per sovrascrivere l'account di servizio di Windows qlik-data-gateway-direct-access.exe /S InstallPath="C:\TMP\Qlik" AcceptEula=yes ServiceAccount="qliktech.com\user" ServicePassword=kZmbkb8m8BGGz91 Disinstallazione di Gateway di Direct Access Aprire un prompt CMD come amministratore ed eseguire il seguente comando dalla cartella contenente l'eseguibile del Gateway di Direct Access: qlik-data-gateway-direct-access.exe /S /uninstall #### Risoluzione dei problemi di installazione I file di registro dell'installazione possono essere utili per la risoluzione dei problemi con l'installazione o l'aggiornamento: Da Gateway di Direct Access 1.7.7, il percorso completo ai file di registro è: <Gateway di Direct Access cartella di installazione>\data\logs\Qlik Data Gateway - Accesso diretto\_<Timestamp>.log Se la tua Gateway di Direct Access versione è precedente alla 1.7.7, il percorso completo dei file di log è: C:\Users\<user>\AppData\Local\Temp\Qlik Data Gateway - Accesso diretto\_<Timestamp>.log ### Fase tre: Configurazione di Gateway di Direct Access Per istruzioni dettagliate sulla configurazione, vedere [Fase tre: Configura Gateway di Direct Access](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage3). ### Fase quattro: Registrare il gateway dati Il passaggio successivo consiste nel registrare il gateway dati. È possibile eseguire questa operazione sia tramite il centro attività Amministrazione sia dalla riga di comando. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) #### Opzione 1: tramite il centro attività Amministrazione È possibile registrare il gateway utilizzando il centro attività Amministrazione. Vedere [Opzione 1: Tramite il centro attività Amministrazione](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#StageConsole). [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm) #### Opzione 2: Registrazione automatica tramite la riga di comando È inoltre possibile registrare Gateway di Direct Access automaticamente dalla riga di comando, senza usare il centro attività Amministrazione. Questo metodo utilizza un token di sessione di breve durata generato da un client OAuth. Nota informaticaLa registrazione automatica è supportata solo tramite riga di comando. Un'API REST per la registrazione automatica del gateway non è attualmente disponibile. Prerequisiti Una chiave API con l'autorizzazione di amministratore del tenant per creare e gestire client OAuth. [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)Registrazione del gateway tramite registrazione automatica 1. Genera una JSON Web Key (JWK) sulla macchina Gateway di Direct Access. Questo comando crea chiavi private sulla macchina Gateway di Direct Access: ConnectorAgent.exe qcs generate\_jwk 2. Copia il JWK restituito dal comando. 3. Utilizzando la chiave API, crea un client OAuth per il gateway tramite l'API admin del tenant, fornendo il JWK copiato nel passaggio precedente. curl "https://<tenant-url>/api/v1/oauth-clients" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '{"appType":"web","clientName":"<client-name>","description":"","allowedScopes":["admin.direct-access-gateways:register\_gateway","admin.direct-access-gateways:delete\_gateway"],"allowedAuthMethods":["private\_key\_jwt"],"publicKeys":[<jwk>],"allowedGrantTypes":["client\_credentials"]}' 4. Copia il valore client\_id restituito nella risposta. 5. Imposta il metodo di consenso del client OAuth su attendibile. curl "https://<tenant-url>/api/v1/oauth-clients/<client-id>/connection-configs/me" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '[{"op":"replace","path":"/consentMethod","value":"trusted"}]' 6. Crea un'asserzione di registrazione sulla macchina Gateway di Direct Access: ConnectorAgent.exe qcs generate\_registration\_assertion --tenant\_url <tenant-url> --client-id <client-id> 7. Richiedi un token di accesso. Questo attiva anche la creazione automatica dell'account utente bot utilizzato dal gateway. curl "https://<tenant-url>/oauth/token" -X POST -H 'content-type: application/x-www-form-urlencoded' -d "grant\_type=client\_credentials" -d "client\_id=<client-id>" -d "client\_assertion\_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer" -d "client\_assertion=<assertion>" -d "scope=admin.direct-access-gateways:register\_gateway admin.direct-access-gateways:delete\_gateway" 8. Cerca l'utente bot creato automaticamente. curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>' 9. Copia l'ID di my-bot-client. 10. Creare un ruolo "DAG Registration". curl "https://<tenant-url>/api/v1/roles" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer API-key' -d '{"name":"DAG Registration","description":"Role for registering a gateway","assignedScopes":["admin.direct-access-gateways:register\_gateway", "admin.direct-access-gateways:delete\_gateway"]}' 11. Assegna ruoli a livello di tenant all'utente bot. curl "https://<tenant-url>/api/v1/users/<bot-user-ID>" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d ' [ { "op": "replace", "path": "/assignedRoles", "value": [ { "name": "DAG Registration" } ] } ]' 12. Recupera lo spazio del Direct Access Gateway. curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>' 13. Copia l'ID dello spazio di Direct Access Gateway. 14. Aggiungi l'utente bot allo spazio con l'autorizzazione Può modificare. curl "https://<tenant-url>/api/v1/spaces/<DAG-space-ID>/assignments" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '{"assigneeId": "<Bot-user-ID>","roles": ["consumer","dataconsumer","producer"], "type": "user"}' 15. Nel caso in cui l'asserzione esistente sia scaduta, generarne una nuova. ConnectorAgent.exe qcs generate\_registration\_assertion --tenant\_url <tenant-url> --client-id <client-ID> 16. Registrare il gateway: ConnectorAgent.exe qcs register\_gateway --tenant\_url <tenant-url> --gateway\_name <gateway-name> --gateway\_description <gateway-description> --space\_name <space-name> --client-id <client-ID> --assertion <assertion> [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm)Rimozione di un gateway registrato automaticamente Seguire i passaggi seguenti per annullare la registrazione di un gateway registrato utilizzando il metodo automatico basato su token di sessione descritto sopra. Questi passaggi rimuovono anche il client OAuth, l'utente bot e il ruolo creati per esso. 1. Genera un'asserzione, come descritto nel [passaggio sei di Registrazione automatica del gateway mediante un token di sessione](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#AutoRegister). 2. Elimina il gateway: ConnectorAgent.exe qcs delete\_gateway --tenant\_url <tenant-url> --gateway\_name <gateway-name> --client-id <client-ID> --assertion <assertion> 3. Elimina il JWK. ConnectorAgent.exe qcs delete\_jwk 4. Cerca l'account utente del bot creato per il gateway. curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>' 5. Copia l'ID del bot. 6. Elimina questo account utente bot. curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>" 7. Cerca il ruolo “DAG Registration” creato per il gateway. curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name eq \"DAG Registration\")" -H "Authorization: Bearer <api-key>" 8. Copia l'ID del ruolo. 9. Elimina questo ruolo. curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID>" -H "Authorization: Bearer <api-key>" 10. Elimina il client OAuth. curl -X DELETE "https://<tenant-url>/api/v1/oauth-clients/<client-ID>" -H "qlik-confirm-delete: <client-ID>" -H "Authorization: Bearer <api-key>" ### Fase cinque: Avviare il servizio Qlik Data Gateway - Accesso diretto sul server del gateway di c Sul server del gateway Accesso diretto, eseguire una delle seguenti azioni per avviare il servizio: * Aprire la console Servizi di Windows e avviare il servizio Qlik Data Gateway - Accesso diretto. * Aprire un prompt dei comandi come amministratore e cambiare la directory di lavoro nella sottocartella di ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent con un'installazione predefinita). Eseguire quindi il seguente comando: connectoragent service start Viene visualizzata la conferma che il servizio è stato avviato correttamente. Vedere anche: [Esecuzione del servizio con un altro account.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Running) ### Passaggio sei: aggiunta di una connessione alla sorgente dati Vedere [Passaggio sei: aggiunta di una connessione alla sorgente dati](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setup-win.htm#Stage6). ## Sorgenti dati supportate I seguenti connettori ODBC sono supportati per le installazioni del server Windows: * Sorgenti ODBC. Per maggiori informazioni, vedere [Database ODBC - Qlik Cloud](https://help.qlik.com/en-US/cloud-services/Subsystems/ODBC_Connector_help/Content/Connectors_ODBC/Introduction/ODBC-connector.htm) (solo in lingua inglese). * Sorgenti REST. Per maggiori informazioni, vedere [Sorgenti REST - Qlik Cloud](https://help.qlik.com/en-US/cloud-services/Subsystems/REST_Connector_help/Content/Connectors_REST/REST-connector.htm) (solo in lingua inglese). * Sorgenti SAP BW, SAP SQL e SAP ODP. Richiede Gateway di Direct Access 1.2.0 o versione successiva. Per informazioni sull'impostazione della connettività a queste sorgenti, vedere [SAP NetWeaver](https://help.qlik.com/en-US/cloud-services/Subsystems/SAP_Connectors_Help/Content/Connectors_SAP/SAP-SQL-connector.htm) (solo in lingua inglese). ## Ulteriori informazioni * [Configurazione di Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.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)