ÍNDICE DEL CONTENIDO

1.- ¿Qué es PFI?

La aplicación PFI (Portafirmas Electrónico) unifica el firmado electrónico de documentos para empleados de una misma organización. La aplicación está orientada para ofrecer servicios a empleados públicos, los cuales se encargarán de la creación, metadatado y firma de documentos.

Los principales objetivos del servicio son otorgar una serie de herramientas que permitan la preparación de documentos, así como su consulta y posterior firmado. Para poder utilizar los servicios que ofrece PFI desde el código, el cliente suministra la librería “PFIClient”, donde están contenidos todas las llamadas a los servicios.

2.- ¿Qué funcionalidades ofrece PFI mediante sus servicios?

Mediante los servicios web que publica el core podrás obtener las siguientes funcionalidades:

• Búsquedas y consultas de datos de firmantes y revisores.
• Envío de documentos para su firma obteniendo los datos de CCSV
• Búsqueda y modificaciones sobre los documentos almacenados
• Gestión y envío de documentos a firmar para usuarios externos. Estos usuarios no deben ser ciudadanos, si no que son usuarios relacionados con la administración pero que no pueden estar dados de alta en el Sistema de Identificación de Usuarios (SIU).
• Gestión de firmantes de los documentos.
• Gestión de la visibilidad de los documentos para los empleados.

3.- ¿Cómo funciona PFI?

3.1.- Módulos de PFI

PFI esta formado por los siguientes módulos que hacen posible la gestión de los documentos:

- Servicios / Core de Portafirmas (pfi_core): Servicios web SOAP publicados para permitir a las aplicaciones externas al sistema hacer uso de la funcionalidad proporcionada por el mismo.

- Portal de administración (pfi_admin): Aplicación con interfaz web que permite la configuración de PFI por parte del administrador.

- Portal privado (pfi_priv): Aplicación con interfaz web que permite la gestión de documento, la creación, firma, y anulación.

El siguiente diagrama muestra la interacción del core con las diversas aplicaciones (todas son paega) que utiliza:

3.2.- Cómo Integrarse con PFI

A continuación se muestra un diagrama de cómo una aplicación integradora se relaciona con PFI. El flujo descrito es para poner a disposición un documento a un empleado público para que lo firme.

1. Desde la aplicación integradora se envía el documento a CCSV. Cuando un documento se envía a CCSV con un firmante propuesto y en estado pendiente de firma, informa a PFI de que tiene un documento para firmar.
2. Para que el usuario tenga conocimiento de que tiene un documento para firmar, la aplicación integradora debe enviarle un aviso. Este aviso puede hacerlo mediante los servicios de PFI (que llaman a SGA - Sistema de Gestión de Avisos) o directamente mediante SGA. Los datos de los empleados públicos se pueden consultar en SIU - Sistema de Identificación de Usuarios
3. Una vez que el usuario ha firmado el documento (o lo ha anulado), PFI invoca a la aplicación integradora mediante un Servlet que ésta debe implementar, para indicarle el cambio de estado del documento. Esta url (incluyendo el servlet) es la que se solicita en el alta de la aplicación en el formulario de alta de la aplicación integradora. Si en el alta no indicó el servlet, solicite la modificación.

NOTAS:

Para ver cómo invocar a los servicios de PFI y sus especificaciones, puede consultar el apartado 4.- Servicios de PFI

En el apartado 5.- Casos de uso PFI de ejemplo , puede ver el código de ejemplo de esta integración.

4.- Conceptos generales

4.1.- Estados de un documento

El ciclo de vida que tiene un documento en PFI se encuentra descrito en el siguiente diagrama es el siguiente.

1. Preparación de un documento, proceso por el cual se genera un documento con los datos correspondientes, indicando los usuarios que deben firmar el documento. Si el proceso de preparación se realiza desde el portal privado de la aplicación y este proceso no finaliza, el documento se almacena en estado "Borrador" a la espera de finalizar su preparación. Si el proceso de preparación se finaliza, el documento se guarda almacenado en estado "Pendiente de firma" en PFI y se manda el documento almacenar a CCSV.
   La preparación de un documento se puede realizar por una aplicación externa. En este caso, las aplicaciones externas hacen uso de los servicios expuestos por PFI_core para añadir el documento a PFI, información adicional sobre los servicios se puede encontrar en el manual de integración.
   
   
2. Rechazo de un documento, si tras la preparación de un documento se detecta algún error en este, y no ha sido firmado por los firmantes necesario, el documentos puede ser rechazado, siendo eliminado de CCSV
   
   
3. Firma de un documento, durante este proceso, el documento es firmado en PFI. Durante la realización de este proceso, el documento queda almacenado en PFI con estado "Firma programada".
   Si el proceso finaliza correctamente y el documento tiene asignados más de un firmante, se almacena en estado "Firmando en paralelo". En caso de que se trate del último firmante del documento, este se almacenará con estado "Firmado" y se enviará el documento firmado a CCSV para su almacenamiento. 
   En caso de que se produzca algún error durante el proceso de firma, el documento volverá al estado "Pendiente de firma"
   
   
4. Anulación del documento, este proceso se puede llevar a cabo de dos formas diferentes, a través de una anulación propiamente dicha, con esta operación el documento se almacena en estado "Anulado" en PFI y se actualiza al mismo estado en CCSV. O bién a través de una sustitución, en la que el documento sustituido queda en estado "Anulado" en PFI, indicando a CCSV que ha sido sustituido por otro documento que se debe encontrar en estado "Firmado". 

4.2.- Visiblidad de documentos