Documentos de Académico
Documentos de Profesional
Documentos de Cultura
AFv1 4 2 Manual Instalacion Usuarios ES
AFv1 4 2 Manual Instalacion Usuarios ES
LAS COMUNICACIONES
AutoFirma
Manual de instalacin
AutoFirma 1.4.2
Manual de usuario
ndice de contenidos
1
Introduccin ...................................................................................................................................3
Instalacin ......................................................................................................................................6
4.1
4.1.1
4.2
Desinstalacin ..................................................................................................................... 10
Linux ........................................................................................................................................ 13
4.2.1
4.2.2
4.2.3
Desinstalacin ..................................................................................................................... 15
4.3
Apple OS X ............................................................................................................................... 16
4.3.1
5
Desinstalacin ..................................................................................................................... 16
5.1
5.2
Al instalar AutoFirma se muestra el error: Error abriendo archivo para escritura .............. 16
5.3
Cuando se instala Mozilla Firefox o se crea un nuevo perfil de usuario sobre una instalacin
despus de la instalacin de AutoFirma, este no funciona en Firefox ............................................... 17
5.4
Al utilizar AutoFirma en un trmite web en Windows con un usuario distinto al que lo
instal, no se abre el dilogo de seleccin de certificados ................................................................. 17
1 Introduccin
AutoFirma es una herramienta de escritorio con interfaz grfica que permite la ejecucin de
operaciones de firma de ficheros locales en entornos de escritorio (Windows, Linux y Mac OS X).
Tambin puede utilizarse a travs de consola o ser invocada por otras aplicaciones mediante
protocolo para la ejecucin de operaciones de firma.
El presente documento gua al usuario final de AutoFirma a travs del proceso de instalacin.
El cliente AutoFirma hace uso de los certificados digitales X.509v3 y de las claves privadas asociadas
a estos que estn instalados en el repositorio o almacn de claves y certificados (KeyStore) del
sistema operativo o del navegador Web (Internet Explorer, Mozilla Firefox, etc.) en caso de
realizarse la operacin desde un trmite web. Tambin permite el uso de dispositivos externos
(tarjetas inteligentes, dispositivos USB) configurados en estos almacenes de claves (como por
ejemplo, el DNI Electrnico o DNIe).
El cliente AutoFirma hace uso de las claves privadas asociadas a los certificados del usuario y no
permite que estos salgan en ningn momento del almacn (tarjeta, dispositivo USB o navegador)
ubicado en su PC.
AutoFirma no almacena ningn tipo de informacin personal del usuario, ni hace uso de cookies ni
ningn otro mecanismo para la gestin de datos de sesin. AutoFirma s almacena trazas de su
ltima ejecucin a efectos de ofrecer soporte al usuario si se encontrase algn error. Estas trazas de
ejecucin no contienen ningn tipo de informacin personal y la aplicacin no facilita de ninguna
forma el acceso a estos datos almacenados.
AutoFirma es una aplicacin de Software Libre publicado que se puede usar, a su eleccin, bajo
licencia GNU General Public License versin 2 (GPLv2) o superior o bajo licencia European Software
License 1.1 (EUPL 1.1) o superior.
Puede consultar la informacin relativa al proyecto Cliente @firma, dentro del cual se encuentra el
AutoFirma y descargar el cdigo fuente y los binarios de la aplicacin en la siguiente direccin Web:
http://administracionelectronica.gob.es/es/ctt/clienteafirma
2 Requisitos mnimos
El uso de AutoFirma como herramienta de firma integrada dentro del proceso de firma de trmites
web tiene los siguientes requerimientos en cuanto a entorno operativo:
Sistema Operativo
o Microsoft Windows 7 o superior.
Soportado directamente en 7, 8, 8.1 y 10.
En 32 o 64 bits.
o Apple OS X Mavericks o superior.
Soportado directamente en Mavericks, Yosemite y El Capitn.
o Linux
Guadalinex, Ubuntu.
Navegadores Web (para la invocacin por protocolo)
o Microsoft Windows
Google Chrome 46 o superior.
Mozilla Firefox 41.0.1 o superior.
Microsoft Internet Explorer 11 o superior (no se admiten los modos de
compatibilidad con versiones anteriores, ni ninguna otra versin anterior).
Microsoft Edge v20.
o Linux
Mozilla Firefox 41.0.1 o superior.
o Apple OS X
Apple Safari 9.0 o superior.
3 Enlaces de descarga
Puede descargar la ltima versin disponible de AutoFirma desde la siguiente pgina web:
http://firmaelectronica.gob.es/Home/Descargas.html
4 Instalacin
La instalacin de AutoFirma en el sistema del usuario se asemeja a la instalacin de cualquier otra
aplicacin. Sin embargo, el proceso de instalacin incluye un paso de vital importancia para la
compatibilidad del aplicativo con los despliegues MiniApplet para su uso en trmites web.
La comunicacin entre la pgina web y AutoFirma se puede realizar de varias maneras, siendo la
principal a travs de un socket SSL a travs del cual la informacin viaja siempre cifrada mediante la
clave privada de un certificado generado durante el proceso de instalacin. Para que sea posible la
comunicacin entre el navegador web y AutoFirma, ser necesario que durante la instalacin se
genere el par de claves con el que se realizar la comunicacin, que este se almacene en disco y que
el certificado generado sea dado de alta en los almacenes de confianza de los navegadores del
sistema. Debido a las medidas de seguridad establecidas por cada navegador web, es posible que
esto implique la aparicin de un dilogo grfico de seguridad en el que se debe conceder permisos
para realizar esta operacin.
El proceso de instalacin y configuracin de AutoFirma registra el resultado de la operativa de
generacin del par de claves y su instalacin en los almacenes de confianza del sistema. Este fichero
se almacena por defecto en el directorio .afirma dentro del directorio de usuario del usuario que
instal
la
aplicacin.
El
nombre
del
fichero
de
trazas
es
AUTOFIRMA_CONFIGURATOR.afirma.log.xml.
En el caso de Linux y OS X, la instalacin se realiza con el usuario administrador y el log se guarda en
el directorio temporal del sistema o, si no se puede ah, en /var/tmp para facilitar su acceso.
Al pulsar sobre el botn Siguiente > seremos redirigidos a la pantalla de licencia de la aplicacin.
En esta pantalla, el usuario puede leer el texto de licencia de AutoFirma. Para continuar con el
proceso de instalacin es necesario pulsar el botn Acepto.
En la siguiente pantalla, podr seleccionar la ruta de instalacin de la aplicacin. Puede dejar la ruta
que se le muestra por defecto (recomendado) o seleccionar cualquier otra ubicacin. En caso de
modificar el directorio por defecto, asegrese de instalar AutoFirma en un directorio propio y no en
uno compartido con ms aplicaciones o documentos. A continuacin, pulse el botn Instalar.
El proceso de instalacin extrae y copia los ficheros necesarios. Una vez hecho esto se tratar de
instalar un certificado de confianza SSL generado en su almacn local de Windows, para lo cual se le
pedir confirmacin mediante una ventana como la siguiente:
Una vez finalizado el proceso, el usuario podr pulsar el botn Siguiente para conocer el resultado
de la instalacin.
10
11
Como parte del proceso de desintalacin, se le pedir permiso para la eliminacin del certificado de
confianza del almacn de certificados de Windows.
12
4.2 Linux
La instalacin de AutoFirma en Linux debe ser realizada por un usuario con permisos de
administrador. El archivo e instalacin de la aplicacin se distribuye con el nombre
AutoFirma_X.Y.Z.deb, donde X, Y y Z (opcional) son los nmeros de versin. Por ejemplo
AutoFirma_1.4.2.deb correspondera a AutoFirma versin 1.4.2.
Para poder ejecutar AutoFirma son necesarias las siguientes dependencias, as que ests se
comprueban durante el proceso de instalacin:
AutoFirma es compatible con Ubuntu y Guadalinex 32 y 64 bits. Una vez instalada, puede usarse
con los navegadores web Mozilla Firefox y Google Chrome.
Hay dos opciones de instalacin: por lnea de comandos y desde la interfaz de escritorio.
La instalacin por ambos medios dejar la aplicacin instalada por defecto en el directorio:
/usr/lib/AutoFirma
13
4.2.1
Despus de esto, se debe volver a ejecutar el comando de instalacin de AutoFirma para asegurar
su correcta instalacin:
sudo dpkg i RUTA_INSTALABLE_AUTOFIRMA
4.2.2
Para la instalacin mediante el asistente de paquetes, se debe hacer doble clic en el fichero de la
distribucin (.deb). Se abrir una ventana similar a la siguiente.
Se debe pulsar el botn instalar, que se encuentra arriba a la derecha. Si no se tienen permisos de
administracin, el sistema solicitar la clave de sper usuario para poder realizar la instalacin.
14
4.2.3 Desinstalacin
Para realizar la desinstalacin del sistema se deber escribir por consola en lnea de comandos el
siguiente comando.
sudo apt-get remove -purge autofirma
4.3 Apple OS X
La instalacin de AutoFirma en OS X debe realizarla un usuario con permisos de administrador. El
archivo de instalacin se distribuye con el nombre AutoFirma_X.Y.Z.pkg, donde X, Y y Z (opcional)
son los nmeros de la versin. Por ejemplo, AutoFirma_1.4.2.pkg correspondera a AutoFirma
versin 1.4.2.
AutoFirma es compatible con las versiones de OS X Mavericks, Yosemite y El Capitn. Los
navegadores compatibles son Apple Safari, Google Chrome y Mozilla Firefox.
Para la instalacin de la aplicacin, se debe hacer doble clic sobre el fichero. El sistema abrir un
asistente que se encargar de realizar los pasos a seguir para la correcta instalacin de la aplicacin.
4.3.1 Desinstalacin
Para desinstalar la aplicacin basta con eliminar la carpeta que se gener en el directorio
/Applications.
5 Problemas conocidos
5.1 Al instalar AutoFirma falla la instalacin de los certificados de
confianza SSL
AutoFirma requiere permisos de administrador para ser instalado y para insertar el certificado de
confianza SSL para el funcionamiento de la firma en los trmites online. Si no puede instalar
AutoFirma o el certificado de confianza, solicite al administrador de su sistema que realice la
instalacin de la aplicacin.
16
Si ya tena instalador AutoFirma, compruebe que este no se est ejecutando, en cuyo caso el
instalador no podr sobrescribir los ficheros de instalacin. Cierre AutoFirma y pulse el botn
reintentar.
Si AutoFirma no se est ejecutando, es posible que el archivo en cuestin se encuentre bloqueado
por una ejecucin o intento de instalacin previo. Reinicie su equipo y pruebe a instalar
nuevamente la aplicacin.
17
18
Seleccionaremos la opcin Colocar todos los certificados en el siguiente almacn y pulsaremos el botn
Examinar.
19
Pulsaremos el botn Siguiente > una vez hemos seleccionado el almacn al que importar el certifciado.
20
En el dilogo de seguridad que se nos muestra, confirmaremos que deseamos confiar en este certificado
pulsando el botn S.
Finalmente, se nos habr mostrado el resultado de importar el certificado.
Si el proceso finaliz correctamente, ahora podremos realizar trmites con este usuario desde los
navegadores Internet Explorer y Chrome.
21
Esta obra est bajo una licencia Creative Commons Reconocimiento-NoComercial-CompartirIgual 3.0
Unported.
22