Aplicación de ejemplo

Hemos desarrollado una aplicación de ejemplo que utiliza los principales servicios ofrecidos por Viafirma Fortress:

• Obtener el estado de un usuario (si tiene certificados y se encuentra enrolado en algún Factor de autenticación)
• Autenticación de un usuario.
• Solicitud de autorización para realizar la firma.
• Firma PAdES, XAdES.
• Firma en bucle.

Pulse aquí para descargar los fuentes

Requisitos

• JDK 1.7 o superior
• Maven 3.0+
• Descargar e instalar en maven la librería viafirma-fortress-sdk-java-4.20.0.jar

Pulse aquí para descargar la librería viafirma-fortress-sdk-java-4.20.0.jar

Una vez descargada la librería, Es necesaria instalarla en el repositorio Maven local.

Para instalar la librería viafirma-fortress-sdk-java-4.20.0.jar alojada en un PATH del equipo, deberá ejecutar el siguiente comando sustituyendo {PATH}, por la ruta al directorio donde se aloja la librería:

mvn install:install-file \
  -Dfile={PATH}/viafirma-fortress-sdk-java-4.20.0.jar \
  -DgroupId=com.viafirma \
  -DartifactId=viafirma-fortress-sdk-java \
  -Dversion=4.20.0 \
  -Dpackaging=jar

Solicitar credenciales al departamento comercial:

• client_id. En este ejemplo será sample_app
• client_secret. En este ejemplo será 12345

Cómo ejecutar la aplicación

El ejemplo usa Spring Boot para simplificar el arranque, ya que permite ejecutar la aplicación usando un servidor Tomcat embebido.

• Puedes importar la aplicación en tu IDE favorito y ejecutar la clase com.viafirma.fortress.demo.FortressDemoApplication.
• Una vez importado deberá configurar las credenciales proporcionadas en el fichero fortress-demo.properties alojado en /src/main/resource, por ejemplo:

  fortress.demo.api.url=https://sandbox.viafirma.com/fortress/
  fortress.demo.api.client_id=sample_app
  fortress.demo.api.client_secret=12345
  

  Una vez configurado, podrá:
• Iniciar la aplicación con el comando mvn spring-boot:run.
• Compilar la aplicación con mvn clean package y desplegar el WAR en un contenedor Tomcat o ejecutarlo directamente:

java -jar target/viafirma-fortress-demo.war

Cómo probar la aplicación

Una vez iniciada la aplicación, puedes acceder abriendo la siguiente URL en su explorador:

http://localhost:8080/fortress-demo/

Pantalla de login

Esta pantalla simula el login en la aplicación cliente, solo se utiliza para obtener el código de usuario a consultar en Viafirma Fortress.

Puedes acceder con el usuario 12345678Z y cualquier clave.

Pantalla de opciones

Esta pantalla muestra cómo obtener la información básica de un usuario (si tiene certificados asociados y si está enrolado en algún Factor de autenticación)

También permite probar la autenticación y distintas posibilidades de firma.

Autenticación

Se puede autenticar al usuario de pruebas 12345678Z usando el factor de autenticación PIN 1234 y el factor de autenticación OTP escaneando el siguiente QR con Google Authenticator: