DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y

LAS COMUNICACIONES
AutoFirma

Manual de instalacin
AutoFirma 1.4.2
Manual de usuario

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

ndice de contenidos
1

Introduccin ...................................................................................................................................3

Requisitos mnimos ........................................................................................................................4

Enlaces de descarga .......................................................................................................................5

Instalacin ......................................................................................................................................6

4.1

Microsoft Windows ....................................................................................................................6

4.1.1
4.2

Desinstalacin ..................................................................................................................... 10
Linux ........................................................................................................................................ 13

4.2.1

Instalacin por lnea de comandos ..................................................................................... 14

4.2.2

Instalacin mediante el asistente de paquetes de Ubuntu/Guadalinex............................. 14

4.2.3

Desinstalacin ..................................................................................................................... 15

4.3

Apple OS X ............................................................................................................................... 16

4.3.1
5

Desinstalacin ..................................................................................................................... 16

Problemas conocidos .................................................................................................................. 16

5.1

Al instalar AutoFirma falla la instalacin de los certificados de confianza SSL ....................... 16

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

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

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

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

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.

En entornos OS X y Windows no es necesario que el usuario tenga instalado un entorno de

ejecucin de Java. En Linux se necesita un entorno de ejecucin de Java de Oracle u OpenJDK
(marcado como dependencia en el instalador integrado de AutoFirma).
Es obligatorio que AutoFirma sea instalado antes de iniciar el trmite web en el que se usar para
ejecutar las operaciones de firma.

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

3 Enlaces de descarga
Puede descargar la ltima versin disponible de AutoFirma desde la siguiente pgina web:
http://firmaelectronica.gob.es/Home/Descargas.html

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

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.

4.1 Microsoft Windows

La instalacin de AutoFirma sobre Microsoft Windows debe ser realizada por un usuario con
permisos de administrador. El archivo instalador que debe ejecutarse se distribuye con el nombre
AutoFirma1.4.2.exe. La versin 1.4.2 de AutoFirma habilita la comunicacin SSL slo para el
usuario que realiza la instalacin.
El proceso de instalacin le guiar a travs de unos sencillos pasos:

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

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.

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

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:

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Es obligatorio que el usuario conceda este permiso pulsando el botn S / Yes.

Una vez finalizado el proceso, el usuario podr pulsar el botn Siguiente para conocer el resultado
de la instalacin.

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Cuando el asistente termina, la instalacin habr finalizado.

Tenga en cuenta que si se deneg el permiso para la instalacin de certificados, es posible que la
aplicacin le indique que la instalacin ha finalizado correctamente. Esto le permitir utilizar
AutoFirma como aplicacin local de firma, pero no podr utilizarlo en procesos de firma de trmites
web.
4.1.1 Desinstalacin
La desinstalacin de Autofirma puede realizarse desde la opcin Desinstalar AutoFirma que
aparece en el men inicio de Windows bajo el grupo AutoFirma:

Una vez lanzado, el desinstalador presenta un sencillo asistente:

10

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Al pulsar el botn Siguiente > se mostrar la opcin de desintalacin.

11

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Al pulsar el botn de Desintalar se iniciar el proceso de desintalacin.

Como parte del proceso de desintalacin, se le pedir permiso para la eliminacin del certificado de
confianza del almacn de certificados de Windows.

12

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Pulse el botn S / Yes para eliminar este certificado.

Cuando el proceso termina, la aplicacin ha sido correctamente desinstalada de Windows.

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:

JRE (Java Runtine Environment) de Oracle u OpenJDK.

Biblioteca libnss3-tools.

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

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

4.2.1

Instalacin por lnea de comandos

Para instalacin por lnea de comandos, en una consola ejecutaremos:

sudo dpkg i RUTA_INSTALABLE_AUTOFIRMA

Donde RUTA_INSTALABLE_AUTOFIRMA es la ruta al instalador en funcin de la distribucin

escogida.
Si no tenemos instaladas las dependencias anteriormente listadas, se nos mostrarn mensajes de
advertencia al respecto. En caso de ser as, podremos instalar estas bibliotecas con el comando:
sudo apt-get f install

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

Instalacin mediante el asistente de paquetes de Ubuntu/Guadalinex

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

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Si no ha ocurrido ningn problema, se mostrar un mensaje de confirmacin.

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

Cuando el proceso termina, la aplicacin ha sido correctamente desinstalada del sistema.

15

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

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

5.2 Al instalar AutoFirma se muestra el error: Error abriendo archivo

para escritura
Es posible que durante la instalacin se le muestre un error como el que sigue:

16

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

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.

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
Durante el momento de la instalacin de AutoFirma, se genera un certificado para la comunicacin
entre la pgina web y la aplicacin, y lo instala en los almacenes de confianza del sistema y de
Firefox. Si se crea un perfil de usuario de Firefox o se instala el propio Firefox despus de la
instalacin de AutoFirma, este no contar con el certificado entre los que considera de confianza.
Para resolver este problema deber desinstalar AutoFirma y volverlo a instalar. Tenga en cuenta, sin
embargo, que esto implicar que se pierda la configuracin personalizada establecida en
AutoFirma.

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
La versin 1.4.2 de AutoFirma Windows instala los certificados de confianza SSL nicamente para el
usuario que instal la aplicacin. Por ese motivo el resto de usuarios no pueden utilizar AutoFirma
para ejecutar las operaciones de firma dentro de trmites online.
Se puede habilitar manualmente el uso de AutoFirma para el resto de usuarios en los navegadores
Internet Explorer y Google Chrome. Para ello, ser necesario instalar como autoridad raz de
confianza el certificado generado durante la instalacin.
El fichero del certificado se llama autofirma.cer y puede encontrarse en el subdirectorio
AutoFirma dentro del directorio en el que se haya instalado de AutoFirma. Por defecto:

C:\Program Files (x86)\AutoFirma

C:\Program Files\AutoFirma

(En equipos de 64 bits)

(En equipos de 32 bits)

17

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Para instalarlo, haremos doble clic sobre este certificado:

A continuacin, pulsaremos el botn Instalar certificado.

18

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Pulsaremos el botn Siguiente >.

Seleccionaremos la opcin Colocar todos los certificados en el siguiente almacn y pulsaremos el botn
Examinar.

19

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Seleccionaremos el almacn Entidades de certificacin raz de confianza y pulsaremos Aceptar.

Pulsaremos el botn Siguiente > una vez hemos seleccionado el almacn al que importar el certifciado.

20

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Pulsaremos el botn Finalizar de la nueva ventana.

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

DIRECCIN DE TECNOLOGAS DE LA INFORMACIN Y LAS

COMUNICACIONES
AutoFirma

Esta obra est bajo una licencia Creative Commons Reconocimiento-NoComercial-CompartirIgual 3.0
Unported.

22