Vai al contenuto
Ultimo aggiornamento

Using the Online Verifier (VOL)

This document describes in detail how to use the Online Verifier (VOL) to verify digitally signed documents, understand how the user interface works, and correctly manage the verification operations provided by the system.

1. General Operation

Interaction with the system follows two main steps:

  1. Upload a document to the system
  2. Execute one or more verification operations on the uploaded document

The system provides:

  • Web interface → for users and administrators
  • REST APIs → for third-party applications

All API endpoints are protected by token-based authentication.

2. Web Interface

The user interface can be accessed via a browser on the following ports:

  • 8180 → HTTP
  • 8143 → HTTPS

The main interface allows users to perform a verification without authentication.

Initial interface

Before the system can perform verifications, the TSL must be updated at least once.

3. Verification of a Signed File

3.1 Uploading the File

The user selects the document to be verified through:

“Select a signed file…”

The system supports documents in the following formats:

  • CAdES
  • XAdES
  • PAdES

3.2 Verification Results

Once the verification is completed, the system displays a report divided into two sections:

3.2.1 Verification Summary

Verification report – Summary

In this section, the user can:

  • Download the original document:
    • signature container document (CAdES/XAdES)
    • signed document (PAdES)
  • Download the verification report in PDF format
  • View the list of digital signatures present in the document
  • Check the validity of the signatures
  • View details related to:
    • signer
    • signature profile

3.2.2 Verification Details

Verification report – Signature details

The details section displays technical information such as:

  • Signer's certificate
  • TSP certificate
  • Advanced signature parameters

An additional detailed view is also available:

Signer certificate

4. Verification at a Specific Date

It is possible to verify a signature with respect to a date different from the current one.

Dedicated interface:

Verification at a specific date

Procedure:

  1. Select the desired date
  2. Click “Verify”

The system will perform the verification simulating the signature validity at the selected date.

5. First Access and Initial Requirements

During the first installation, before performing any verification, it is necessary to update the TSL (Trusted Service Status List).

Procedure:

  1. Access the administration interface
Administration interface
  1. Authenticate
  2. Select the menu:
    Settings → Certificate Store → TSL
TSL access
  1. Click “Refresh TSL Store”
TSL Store update

The update may take several minutes depending on network speed.

6. Security During Use

For system security:

  • APIs are protected by token authentication
  • Access to the administration interface can be restricted by IP
  • CRL and TSL management is automatic and can be updated manually
  • Verifications may rely on root and intermediate certificates updated by the system

7. API Usage (Overview)

VOL exposes a set of REST APIs (documented through Swagger).
Access requires:

  • a token generated by the administrator
  • a client capable of sending HTTP/HTTPS requests

Typical API usage follows the same model as the web interface:

  1. Upload the document
  2. Request verification
  3. Receive the result in JSON