{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/fr/products/pki-on-prem/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Using 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":"using-the-online-verifier-vol","__idx":0},"children":["Using the Online Verifier (VOL)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"1-general-operation","__idx":1},"children":["1. General Operation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Interaction with the system follows two main steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Upload a document"]}," to the system"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Execute one or more verification operations"]}," 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":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Web interface"]}," → for users and administrators"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST APIs"]}," → for third-party applications"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All API endpoints are protected by token-based authentication."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"2-web-interface","__idx":2},"children":["2. Web Interface"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The user interface can be accessed via a browser 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":["The main interface allows users to perform a verification without authentication."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/interfacciainiziale.940f3e5b411335e60c0972a4b327bd2099dacfce153adb1ccdef6904e6d2b12d.e17c227a.png","alt":"Initial interface","framed":false,"withLightbox":false,"width":"400","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before the system can perform verifications, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TSL"]}," must be updated at least once."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"3-verification-of-a-signed-file","__idx":3},"children":["3. Verification of a Signed File"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"31-uploading-the-file","__idx":4},"children":["3.1 Uploading the File"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The user selects the document to be verified through:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["“Select a signed file…”"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The system supports documents in the following formats:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CAdES"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["XAdES"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PAdES"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"32-verification-results","__idx":5},"children":["3.2 Verification Results"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the verification is completed, the system displays a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["report divided into two sections"]},":"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"321-verification-summary","__idx":6},"children":["3.2.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":["In this section, the user can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the original document:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["signature container document (CAdES/XAdES)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["signed document (PAdES)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["verification report in PDF format"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["View the list of digital signatures present in the document"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the validity of the signatures"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["View details related to:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["signer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["signature profile"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"322-verification-details","__idx":7},"children":["3.2.2 Verification 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 details section displays technical information such as:"]},{"$$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":["Advanced signature parameters"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An additional detailed view is also available:"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/certificatofirmatarioreportverifica.c1acc236c58acc0b328e3c757f61bba3d4e87d52c62bfbb225e1fa5c9620cbdd.e17c227a.png","alt":"Signer certificate","framed":false,"withLightbox":false,"width":"700","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"4-verification-at-a-specific-date","__idx":8},"children":["4. Verification at a Specific Date"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is possible to verify a signature with respect to a date different from the current one."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dedicated interface:"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/verificadata.a939e1221180fe25a32f1e41a0fc3121782fef113d95596b0ab9b53a35c70281.e17c227a.jpeg","alt":"Verification at a specific date","framed":false,"withLightbox":false,"width":"400","align":"center"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Procedure:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the desired date"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["“Verify”"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The system will perform the verification simulating the signature validity at the selected date."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"5-first-access-and-initial-requirements","__idx":9},"children":["5. First Access and Initial Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["During the first installation, before performing any verification, it is necessary to update the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TSL (Trusted Service Status List)"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Procedure:"]},{"$$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":["Select the menu:",{"$$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":["Click ",{"$$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":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The update may take several minutes depending on network speed."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"6-security-during-use","__idx":10},"children":["6. Security During Use"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For system security:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["APIs are protected by token authentication"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the administration interface can be restricted by IP"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CRL and TSL management is automatic and can be updated manually"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifications may rely on root and intermediate certificates updated by the system"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"7-api-usage-overview","__idx":11},"children":["7. API Usage (Overview)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VOL exposes a set of REST APIs (documented through Swagger).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Access requires:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a token generated by the administrator"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a client capable of sending HTTP/HTTPS requests"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical API usage follows the same model as the web interface:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload the document"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request verification"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Receive the result in JSON"]}]}]},"headings":[{"value":"Using the Online Verifier (VOL)","id":"using-the-online-verifier-vol","depth":1},{"value":"1. General Operation","id":"1-general-operation","depth":1},{"value":"2. Web Interface","id":"2-web-interface","depth":1},{"value":"3. Verification of a Signed File","id":"3-verification-of-a-signed-file","depth":1},{"value":"3.1 Uploading the File","id":"31-uploading-the-file","depth":2},{"value":"3.2 Verification Results","id":"32-verification-results","depth":2},{"value":"3.2.1 Verification Summary","id":"321-verification-summary","depth":3},{"value":"3.2.2 Verification Details","id":"322-verification-details","depth":3},{"value":"4. Verification at a Specific Date","id":"4-verification-at-a-specific-date","depth":1},{"value":"5. First Access and Initial Requirements","id":"5-first-access-and-initial-requirements","depth":1},{"value":"6. Security During Use","id":"6-security-during-use","depth":1},{"value":"7. API Usage (Overview)","id":"7-api-usage-overview","depth":1}],"frontmatter":{"seo":{"title":"Using the Online Verifier (VOL)"}},"lastModified":"2026-03-23T10:44:53.000Z","isTranslationFallback":true,"pagePropGetterError":{"message":"","name":""}},"slug":"/fr/products/pki-on-prem/vol/customer_documentation/usage","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}