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

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

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

The details section displays technical information such as:

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


An additional detailed view is also available:

# 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:

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


1. Authenticate
2. Select the menu:
**Settings → Certificate Store → TSL**


1. Click **“Refresh TSL Store”**


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