Manuale uso
Civilia Web Socket
Tipo documento: Specifiche Tecniche
Data documento: 03/12/19
Manuale uso Civilia Web Socket
Sommario
[Link]....................................................................................................................................3
[Link]...........................................................................................................................................3
[Link] manuale.....................................................................................................................4
[Link] automatica ................................................................................................................7
[Link]................................................................................................................................................8
[Link] esposti..................................................................................................................................8
2
Manuale uso Civilia Web Socket
1. Introduzione
La tecnologia Java Web Socket consente, previa installazione locale di una componente software,
Civilia Web Socket, di accedere alle periferiche del client, quali per esempio scanner, chiavette di
firma, stampanti e dischi, direttamente dal browser utilizzato, qualunque esso sia.
2. Requisiti
Per l’installazione e l’uso della componente Civilia Web Socket sono necessari:
• Windows XP o superiore
• Java 8 o superiore
N.B. Se non si dispone di una licenza d’uso Oracle, è necessario installare una versione di java
rilasciata con licenza Oracle Binary Code License (BCL), come per esempio la versione 8u202. Le
versioni più recenti, con licenza Oracle Technology Network License, sono disponibili solo per uso
personale. In alternativa, è anche possibile utilizzare una versione di OpenJDK con licenza General
Public License (GPL), come per esempio la versione 12, disponibile all’indirizzo [Link]
Solo per l’uso con gli scanner, è necessaria una versione di Java a 32 bit.
Per evitare malfunzionamenti della componente in caso di aggiornamenti automatici di Java, si
consiglia di utilizzare una versione di Java dedicata per Civilia Web Socket.
3
Manuale uso Civilia Web Socket
3. Installazione manuale
Una volta scaricato il file [Link], occorre eseguirlo con Java, tramite interfaccia
grafica:
oppure tramite terminale, con il seguente comando:
> java -jar [Link]
Una procedura guidata assisterà l’utente durante i passaggi di installazione.
4
Manuale uso Civilia Web Socket
Di default, la componente viene installata nella cartella dell'utente. Si consiglia di mantenere questa
impostazione, per evitare problemi di permessi sulle cartelle.
Di default, viene creato un collegamento nel menu Start (Esecuzione automatica). Si consiglia di
mantenere questa impostazione, per fare in modo che la componente venga avviata
automaticamente ad ogni avvio del pc.
5
Manuale uso Civilia Web Socket
Nel caso di utilizzo con browser Internet Explorer in rete locale, per abilitare l’utilizzo della
componente Civilia Web Socket è necessario, dal menu Strumenti > Opzioni Internet > Sicurezza >
Intranet Locale > Siti, deselezionare la voce “Includi tutti i siti locali (Intranet) non elencati in altre
aree”.
In alternativa, è possibile aggiungere il sito di Folium (per esempio [Link] e l’indirizzo
“[Link] tra i Siti Web attendibili della Intranet locale.
6
Manuale uso Civilia Web Socket
4. Installazione automatica
L'installazione della componente Civilia Web Socket può essere automatizzata, cioè può avvenire
senza interazione da parte dell'utente. Questa modalità può essere utile quando è necessario
installare la componente in molte postazioni di lavoro.
Per lanciare l'installazione automatica della componente, che avverrà con tutte le impostazioni di
default, è necessario utilizzare, tramite un terminale, il seguente comando:
> java -jar [Link] [Link]
dove [Link] è un file xml con il seguente contenuto:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<AutomatedInstallation langpack="ita">
<[Link] id="UNKNOWN
([Link])"/>
<[Link] id="UNKNOWN
([Link])"/>
<[Link] id="UNKNOWN
([Link])">
<pack index="0" name="Civilia-WebSocket" selected="true"/>
</[Link]>
<[Link] id="UNKNOWN
([Link])">
<installpath>$USER_HOME\Civilia-WebSocket</installpath>
</[Link]>
<[Link] id="UNKNOWN
([Link])"/>
<[Link] id="UNKNOWN
([Link])">
<programGroup name="Dedagroup\Civilia-WebSocket"/>
<shortcut KdeSubstUID="false" categories="" commandLine=""
createForAll="false" description="Avvia Civilia-WebSocket" encoding=""
group="false" icon="$INSTALL_PATH\Icons\[Link]" iconIndex="0"
initialState="1" mimetype="" name="Avvia Civilia-WebSocket"
target="$INSTALL_PATH\yajsw\bat\[Link]" terminal=""
terminalOptions="" tryexec="" type="4" url="" usertype="0"
workingDirectory="$INSTALL_PATH\yajsw\bat"/>
</[Link]>
<[Link] id="UNKNOWN
([Link])"/>
<[Link] id="UNKNOWN
([Link])"/>
</AutomatedInstallation>
7
Manuale uso Civilia Web Socket
5. Note
In alcuni file di configurazione della componente Civilia Web Socket, viene registrato il percorso
locale della Java utilizzata. In caso di aggiornamento della Java, è necessario reinstallare la
componente Civilia Web Socket.
In caso di utilizzo della componente Civilia Web Socket da un sito in modalità https, per il corretto
funzionamento della comunicazione è necessario accettare il certificato nel browser in uso, visitando
la pagina [Link] Con browser Internet Explorer o Google Chrome, per evitare
di dover riaccettare il certificato in caso di cancellazione dei dati di navigazione, è possibile scaricarlo
dalla stessa pagina [Link] ed importalo tra le autorità di certificazione radice
attendibili:
6. Servizi esposti
La componente Civilia Web Socket è un server che espone diversi servizi localmente accessibili:
• Un servizio http per la verifica dello stato, raggiungibile all’indirizzo
[Link] o [Link]
• Un socket per la scansione, disponibile all’indirizzo [Link] o
[Link] che espone i metodi “setup” e “scan”.
• Un socket per la stampa (solo pdf), disponibile all’indirizzo [Link] o
[Link] che espone i metodi “setup”, “list” e “print”.
• Un socket per la copia di file su file system, disponibile all’indirizzo [Link]
o [Link] che espone i metodi “setup” e “copy”.
• Un socket per la firma locale, disponibile all’indirizzo [Link] o
[Link] che espone i metodi “setup”, “sign_pades”, “sign_xades” e
“sign_xades”.
• Un socket per l’estrazione del certificato ANPR, disponibile all’indirizzo
[Link] o [Link]
• Un socket per l’editing dei documenti disponibile all’indirizzo [Link] o
[Link]