Docway-Client

Client desktop che si interfaccia con DocWay4 per offrire funzionalità aggiuntive.

Il progetto è sviluppato con [Tauri](https://tauri.app/), un framework per la creazione di applicazioni Desktop e [Nextjs](https://nextjs.org/).

L'applicazione offre le seguenti funzionalità:

- Firma di documenti: permette all'utente di firmare digitalmente documenti utilizzando una smart card. - Anteprima di file: offre la possibilità di visualizzare un'anteprima dei file tramite il software preferinito del sistema operativo. - Scansione: permette di eseguire la scansione di documenti.

Per il funzionamento dell'applicazione, risulta necessario che l'ambiente con il quale si vuole interagire abbia sia DocWay4 che i [docway4ws](http://gitlab.bo.priv/docway4/docway4ws) installati.

Per abilitare l'interazione con il client, è necessario attivare le seguenti properties di DocWay4:

DocWay4/docway.properties

  dwclient.enabled=true

DocWay4-service/it.highwaytech.apps.xdocway.properties

  abilitaDw4Client=si

è anche fortemente consigliato disabilitare properties e configurazioni riguardanti iwx.

Se i servizi REST docway4ws sono accessibili solo tramite proxy con credenziali, è importante gestire eventuali conflitti con i nomi degli header dei token. Di default, i servizi docway4ws si aspettano di ricevere il _Bearer_ Token con la chiave “Authorization” per le chiamate protette. Tuttavia, se anche il proxy utilizza la stessa chiave per il _Basic_ token, è necessario modificare il nome della chiave per i servizi web tramite la property `jwt.header-name` da valorizzare nell'application.properties dei docway4ws.

Per garantire che i nomi dei token siano allineati e superino i controlli di sicurezza, è necessario configurare le seguenti chiavi nel docway-client:

- `APP_TOKEN_HEADER_NAME`: Nome dell'header per il token dell'applicazione. - `PROXY_TOKEN_HEADER_NAME`: Nome dell'header per il token del proxy.

Vedi [APP_CONFIG.md](APP_CONFIG.md) per ulteriori informazioni.

Di seguito è riportato un esempio per `jwt.header-name=Token-Auth` ed header proxy `Authorization`

  {
      "docway4ws":{
          "APP_TOKEN_HEADER_NAME": "Token-Auth",
          "PROXY_TOKEN_HEADER_NAME": "Authorization"
          ...
      }
  }

win: https://files.3di.it/f/6e82b1e5b7264d58a070/?dl=1 versione attuale: 0.2.3

mac: https://files.3di.it/f/9a025e51066f406f9a0d/?dl=1

È possibile eseguire l'installazione sia per tutti gli utenti che per il singolo utente della macchina. Durante l'installazione, è possibile fornire un file per l'inizializzazione delle configurazioni specifiche del cliente. Il formato del file di inizializzazione è descritto nel file APP_CONFIG.md.

Sono disponibili dei template per l'inizializzazione nella cartella boot-templates del progetto. Questi template possono essere utilizzati come punto di partenza per creare il file di configurazione personalizzato.

Se viene eseguita una singola installazione per tutti gli utenti della macchina, è importante garantire che tutti gli utenti abbiano i privilegi necessari sulla cartella di installazione. Assicurarsi di assegnare i permessi appropriati alla cartella di installazione per consentire l'utilizzo dell'applicazione a tutti gli utenti.

Per eseguire l'installer in modalità silente, utilizzare il seguente comando:

  sh docway-client-setup.exe /S /FilePath="C:\configurazione.json"

Per automatizzare l'intero processo di installazione, è fornito anche un file silent-installer.bat, lo script si occuperà di eseguire l'installazione ed aggiungere i privilegi necessari per tutti gli utenti della macchina. I parametri di input del `.bat` sono:

• exePath=: Path in cui si trova l'eseguibile.
• bootFile=: Eventuale path in cui c'è il file delle configurazioni.
• bootURL=: Eventuale URL dal quale recuperare le configurazioni.
• installDir=: Eventuale path di installazione dell'applicativo (default `C:\Program Files\docway-client`).

Eseguire il file bat con i parametri necessari come segue:

  sh silent-installer.bat exePath="C:\docway-client-setup.exe" bootURL="https://files.3di.it/f/bb83d164bb904a4e8142/?dl=1"

Qualora si dovesse utilizzare il file .bat, è necessario eseguirlo da una command line con privilegi da amministratore.

Qualora in fase di installazione si riceva l'errore: `Impossibile installare WebView2! L'applicazione non può funzionare senza. Prova a rieseguire l'installer.`

Provare ad installare manualmente WebView2. Link diretto: [https://go.microsoft.com/fwlink/p/?LinkId=2124703](https://go.microsoft.com/fwlink/p/?LinkId=2124703)

Al momento è possibile testare l'interazione della socket tramite i docway4ws: https://wiki.3di.it/doku.php?id=tecnici:manuali_tecnici:help_desk:docway4ws