====== 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/).

==== Funzionalità ====

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.

==== Prerequisiti funzionamento ====

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.

==== Abilitazione DocWay4 ====

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.

==== Configurazione proxy con credenziali dominio (Es. IIS) ====

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**.

=== Configurazione lato docway-client ===

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.

=== Esempio di Configurazione ===

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"
            ...
        }
    }

==== Link prima installazione ====

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

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

==== Installazione ====

È 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 **[[http://gitlab.bo.priv/docway4/docway-client/-/tree/main/boot-templates | boot-templates]]** del progetto. Questi template possono essere utilizzati come punto di partenza per creare il file di configurazione personalizzato.

==== Utilizzo multiutente ====

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.

=== Esecuzione dell'Installer in modalità silente ===

<WRAP center round important 25%>
**Richiede l'avvio come admin**

Gli utenti standard non possono fare la silent install
</WRAP>

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

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

==== Utilizzo del File .bat per installazione automatica ====

Per automatizzare l'intero processo di installazione, è fornito anche un file [[http://gitlab.bo.priv/docway4/docway-client/-/raw/main/src-tauri/nsis/silent-installer.bat | 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`).

=== Esempio di Utilizzo del File Bat ===

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"

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

==== Errori installazione ====

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)

==== Pagina Test Client ====

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