{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/pki-on-prem/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Overview of the Online Verifier (VOL)","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"overview-of-the-online-verifier-vol","__idx":0},"children":["Overview of the Online Verifier (VOL)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Online Verifier (VOL)"]}," is a system that allows users to verify the validity of a digital signature applied to a document.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"This file provides a complete overview of the system's operation, its components, and the main functionalities offered by VOL."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"1-introduction","__idx":1},"children":["1. Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VOL allows you to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Install and configure a complete environment for verifying digital signatures"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use a simple and intuitive web interface"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access advanced features through an administration interface"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain detailed reports downloadable in PDF format"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify signed documents through REST APIs"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The system provides:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Application installation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The administration interface"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Management and visualization of verification responses"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"2-system-architecture","__idx":2},"children":["2. System Architecture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VOL is distributed as a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Docker"]}," application consisting of six main services:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["web"]}," — service exposed to external clients"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["gui"]}," — web interface"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["api"]}," — handles verification requests"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["fetcher"]}," — downloads remote files to be verified"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["redis"]}," — internal database"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["swagger"]}," — online API documentation"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The installation package contains the required images and a complete configuration for system operation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"3-general-operation","__idx":3},"children":["3. General Operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Interaction with VOL takes place in two steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uploading a document"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Executing one or more verifications on the uploaded document"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The system provides:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["web interface"]}," intended for users and administrators"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST API"]}," for integration with third-party systems"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All API endpoints are protected through ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token-based authentication"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"4-initial-interface","__idx":4},"children":["4. Initial Interface"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The main interface is available on the following ports:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["8180"]}," (HTTP)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["8143"]}," (HTTPS)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Users can upload a file through the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["“Select a signed file…”"]}," field."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/interfacciainiziale.940f3e5b411335e60c0972a4b327bd2099dacfce153adb1ccdef6904e6d2b12d.e17c227a.png","alt":"Initial interface","framed":false,"withLightbox":false,"width":"500","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before the first verification, the TSL lists must be updated."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"5-verification-report","__idx":5},"children":["5. Verification Report"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After uploading a document, the system produces a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["verification report"]},", composed of several sections."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"51-verification-summary","__idx":6},"children":["5.1 Verification Summary"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/sommarioreportverifica.44f477734ca45a975a9d5179ca5648e49f077653151c3dfcb70fd0f1867f70bc.e17c227a.png","alt":"Verification report - Summary","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From the summary it is possible to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the original document (CAdES/XAdES or PAdES)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the report in PDF format"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["View all signatures in the document"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consult validity, signer, signature profile, and technical information"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"52-signature-details","__idx":7},"children":["5.2 Signature Details"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/dettaglifirmareportverifica.f72df9a1916ae83106f1e2f3b8d645aec7bd6ada6c8282e01f42109d80ce6c27.e17c227a.png","alt":"Verification report – Signature details","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The system shows:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Signer's certificate"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["TSP certificate"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Technical and temporal signature parameters"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"53-signers-certificate","__idx":8},"children":["5.3 Signer's Certificate"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/certificatofirmatarioreportverifica.c1acc236c58acc0b328e3c757f61bba3d4e87d52c62bfbb225e1fa5c9620cbdd.e17c227a.png","alt":"Verification report – Signer's certificate","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"6-verification-at-a-specific-date","__idx":9},"children":["6. Verification at a Specific Date"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VOL allows verifying a signature with respect to a specific date (different from the current one)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The user selects the date and then starts the verification."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/verificadata.a939e1221180fe25a32f1e41a0fc3121782fef113d95596b0ab9b53a35c70281.e17c227a.jpeg","alt":"Verification at a specific date","framed":false,"withLightbox":false,"width":"500","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"7-first-access-and-tsl-update","__idx":10},"children":["7. First Access and TSL Update"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The administration interface is available at:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"http://:port/admin\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the first installation, the TSL must be updated manually:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access the administration interface"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/interfacciaadmin.81a28f367e6662763da51af3351033a8a29d6564b3f138c53aeb79a18c48431f.e17c227a.png","alt":"Administration interface","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authenticate"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Certificate Store → TSL"]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/accessotsl.d34f4be9bd3c66f366ff8bff0d128cec60149ab49f1ae28b414fa72b964863ce.e17c227a.png","alt":"TSL access","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Press ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refresh TSL Store"]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/aggiornamentotlsstore.c222e8993b0c15e57defb0cf3cdb95ed90e5cf3194c78af693faef2fbab2e840.e17c227a.png","alt":"TSL Store update","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"8-security","__idx":11},"children":["8. Security"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["System security is based on:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token-based authentication"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access restrictions to the console via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowers.conf"]}," file"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Root and intermediate certificate management"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["TSL and CRL updates"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The possibility of using a private Docker registry"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example tag/push to a private registry:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["docker tag vol_api docker.rete.dom:5000/vol_api"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["docker push docker.rete.dom:5000/vol_api"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"9-server-certificates","__idx":12},"children":["9. Server Certificates"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"9-server-certificates-1","__idx":13},"children":["9. Server Certificates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To configure the server TLS certificates, you need to identify the volume used by the web server. The volume is created at the first startup of the VOL, after which you can run the following command:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ docker volume ls | grep web_storage\n"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"local vol_web_storage\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, the prefix vol_ is automatically added by Docker Compose based on the value of the --project-name option."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this point, you can locate the volume path with the following command:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ docker inspect voldockerhg_web_storage | grep Mountpoint\n"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"Mountpoint\": \"/var/lib/docker/volumes/voldockerhg_web_storage/_data\",\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can then modify the files:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["server.cer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["server.key"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["located in the indicated path."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The files must be in PEM format, as required by the Nginx documentation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"10-application-startup-logs-and-shutdown","__idx":14},"children":["10. Application Startup, Logs, and Shutdown"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"startup","__idx":15},"children":["Startup"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"docker-compose --project-name vol up -d  \n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-visualization","__idx":16},"children":["Service Visualization"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"docker-compose --project-name vol ps  \n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"logs","__idx":17},"children":["Logs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Single service:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"docker-compose --project-name vol logs <service_name>  \n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All services:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"docker-compose --project-name vol logs  \n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shutdown","__idx":18},"children":["Shutdown"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"docker-compose --project-name vol down  \n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--project-name"]}," option allows defining a prefix for persistent volumes."]}]},"headings":[{"value":"Overview of the Online Verifier (VOL)","id":"overview-of-the-online-verifier-vol","depth":1},{"value":"1. Introduction","id":"1-introduction","depth":1},{"value":"2. System Architecture","id":"2-system-architecture","depth":1},{"value":"3. General Operation","id":"3-general-operation","depth":1},{"value":"4. Initial Interface","id":"4-initial-interface","depth":1},{"value":"5. Verification Report","id":"5-verification-report","depth":1},{"value":"5.1 Verification Summary","id":"51-verification-summary","depth":2},{"value":"5.2 Signature Details","id":"52-signature-details","depth":2},{"value":"5.3 Signer's Certificate","id":"53-signers-certificate","depth":2},{"value":"6. Verification at a Specific Date","id":"6-verification-at-a-specific-date","depth":1},{"value":"7. First Access and TSL Update","id":"7-first-access-and-tsl-update","depth":1},{"value":"8. Security","id":"8-security","depth":1},{"value":"9. Server Certificates","id":"9-server-certificates","depth":1},{"value":"9. Server Certificates","id":"9-server-certificates-1","depth":1},{"value":"10. Application Startup, Logs, and Shutdown","id":"10-application-startup-logs-and-shutdown","depth":1},{"value":"Startup","id":"startup","depth":2},{"value":"Service Visualization","id":"service-visualization","depth":2},{"value":"Logs","id":"logs","depth":2},{"value":"Shutdown","id":"shutdown","depth":2}],"frontmatter":{"seo":{"title":"Overview of the Online Verifier (VOL)"}},"lastModified":"2026-03-23T10:44:53.000Z","isTranslationFallback":true,"pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/pki-on-prem/vol/customer_documentation/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}