Què necessito per utilitzar l’Aplicació Nativa?
L’aplicació nativa és una aplicació d’escriptori que s’instal·la en la màquina del client i s’executa com a servei (en segon pla).
1. Sistemes operatius
Donem suport a la instal·lació i execució de l’aplicació nativa en els següents sistemes operatius:
- Ubuntu – Versions 12.04 i superiors
- Windows – Versions client Vista i superiors
- Windows – Versions servidor Server2003 R2 i superiors – Windows server 2016 encara no està suportat >> estàra suportat de cara 31/03/2018
- MAC OS X – Versions OS.X 10.9 i superiors
Nota: Igual que en el cas dels navegadors pot funcionar en altres versions de sistemes operatius (e.g. altres distribucions de Linux com pot ser Mint), però també igual que en el cas dels navegadors, aquestes altres versions no rebran suport per part nostra en cas de problemes d’execució.
1.1 Connectivitat
L’aplicació nativa és una aplicació en segon pla que respon les crides que el navegador realitza contra el domini nativa.aoclocal.cat
. En els nostres servidors de DNS aquesta adreça resol contra 127.0.0.1 (localhost)
. En cas d’entorns corporatius amb firewall, proxies, etc s’hauria de validar la resolució correcte d’aquest domini ja que d’altra manera el servei no podrà conectar amb l’aplicació nativa i sempre presentarà el JNLP com a opció per a realitzar la signatura.
2. Descarrega
Per poder-la utilitzar cal que alhora de donar-se d’alta al servei, s’informi que es vol utilitzar la nativa (allow Native). Un cop el procés d’alta s’hagi realitzat, ja es pot descarregar la versió de l’aplicació corresponent segons l’entorn que es vulgui utilitzar:
En la pàgina d’instal·lació de la nativa l’usuari pot escollir la versió del Sistema Operatiu (tal i com es veu en la següent imatge).
Nota: Per defecte el navegador detecta el Sistema Operatiu i es descarrega la versió adequada.
3. Instal·lació
Un cop descarregat l’executable procedim a realitzar la instal·lació.
Per instal.lar segueixi els següents passos de l’assistent d’instal·lació:
Un cop s’hagi instal·lat i arranqui l’aplicació, en cas que ho fagis en Windows li apareixerà el següent missatge:
Pel correcte funcionament de l’aplicació ha d’acceptar la instal·lació del certificat.
4. Validació
Un cop s’hagi instal·lat l’aplicació nativa, es pot realitzar un simple test de funcionament per comprovar que la instal·lació s’ha realitzat correctament.
Si el procés s’ha realitzat correctament la pàgina de test ens mostrarà la següent imatge:
En cas contrari, es mostrarà el següent error:
NOTES:
- Si acabes d’instal·lar l’aplicació nativa revisa el següent apartat d’instal·lar el cerfiticat.
- Si el problema persisteix posa’t en contacte amb el Suport a Usuari del Consorci AOC.
5. Instal·lar Certificat
Perquè funcioni l’aplicació nativa és obligatori que s’instal·li el certificat en el seu navegador o sistema operatiu.
5.1 Windows
La càrrega del certificat al magatzem de Windows permet el correcte funcionament de l’aplicació amb Internet explorer, Edge i Chrome.
A més a més en el magatzem de Windows s’instal·la automàticament, tot i que s’ha d’acceptar la instal·lació del certificat mitjançant un popup que apareix durant aquesta.
En cas que no s’hagi cancel·lat l’instal·lació en aquest popup serà necessari que l’usuari ho faci manualment seguint els següents passos:
- Cerca en el buscador de windows: Opcions d’internet
- Obre les Opcions d’internet –> accedeix a la pestanya Contingut –> Certificats
- En la pantalla de certificats, accedir a la pestanya Entitats de Certificació arrel de confiança i clicar a Importar
- En la pantalla d’assistent per la importació de certificats cliqui a següent:
- Clica a examinar per escollir el certificat a Importar
- Escull el certificat a importar. El certificat a instal·lar, root.crt, es troba a la carpeta a on s’ha instal·lat l’aplicació nativa, per defecte és a: C:\Program Files (x86)\Signador\lib\certificate
- Un cop seleccionat el certificat clica a següent
- En la següent pantalla torna a clicar següent
- Clica a Finalitzar per importar el certificat
- Torna a realitzar una validació.
5.2 Firefox
Firefox disposa del seu propi magatzem de claus, per tant independentment del sistema operatiu sobre el que s’estigui executant, si vols fer servir l’aplicació amb Firefox serà necessari carregar el certificat segueint els següents passos que apliquen per qualsevol sistema operatiu:
- Obrir Firefox –> Accedir a Opcions
- Avançat –> Certificats –> Visualitza els Certificats
- En la pantalla de certificats, accedir a la pestanya Entitats i clicar a Importar
- Escull el certificat a importar. El certificat a instal·lar, root.crt, es troba a la carpeta a on s’ha instal·lat l’aplicació nativa, per defecte és a:
- Windows 32 bits C:\Program Files (x86)\Signador\lib\certificate
- Windows 64 bits C:\Program Files\Signador\lib\certificate
- Linux 32 bits /usr/local/signador
- Linux 64 bits /usr/local/signador
- MACOSX /Applications/Signador.app/Contents/Resources/app/lib/certificate
- Un cop seleccionat el certificat, marca a confiar per identificar a llocs web
- Torna a realitzar una validació.
5.3 MAC OS X
Per a MAC OS X el certificat és carrega de forma automàtica però l’usuari ha de procedir a acceptar-lo manualment amb les passes que es descriuen a continuació:
- Cerca en el buscador de MAC: llaveros
- A llaveros escull la categoria certificats, i del llistat escull root de prova
- En el certificat, escull la opció confiar sempre.
- Torna a realitzar una validació.
Nota: Si el problema persisteix posa’t en contacte amb el Suport a Usuari del Consorci AOC.
6. Funcionament
Un cop s’ha instal·lat l’aplicació i aquesta funciona correctament, el canvi del funcionament de la versió JNLP a la Nativa és totalment transparent per l’usuari.
Els únics canvis són visuals, ja que no es descarrega cap fitxer com en el cas de la versió JNLP. A l’usuari se li mostra un llistat dels certificats dels que disposa i només ha d’escollir el que vol per signar. A continuació es mostra un exemple de la pantalla de funcionament del signador en cas de tenir la nativa instal·lada.
Desinstal·lació
En cas que es vulgui desinstal·lar, s’ha d’accedir a la carpeta a on s’hagi instal·lat la aplicació, executar el fitxer uninstall.exe i seguir els següents passos:
Troubleshooting
En cas de problemes amb l’execució de l’aplicació nativa pots obrir una petició a través del nostre portal de suport fent una descripció del problema, i afegint la següent informació: sistema operatiu, navegador, i si és possible els fitxers amb els logs de l’execució que pots trobar en el path de la instal·lació de la nativa a $SIGNADOR_HOME/log/webappTemp.log
i $SIGNADOR_HOMER/error.log
.
En el cas de sistemes operatius Windows, seguint la instal·lació per defecte, la variable $SIGNADOR_HOME
pren el valor C:\Program Files (x86)\Signador
per a l’instal·lable de 32-bit i C:\Program Files\Signador
per al de 64-bit. Per tant els fitxers de logs els trobareu a C:\Program Files (x86)\Signador\log\webappTemp.log
,C:\Program Files (x86)\Signador\error.log
i C:\Program Files\Signador\log\webappTemp.log
i C:\Program Files\Signador\error.log
respectivament.
0 Comentaris