Il service Marche Temporali permette di attribuire data ed ora certa ad ogni documento informatico.
In particolare, il service consente di:
- Acquistare lotti di marche temporali InfoCert o Aruba
- Marcare un documento utilizzando i propri lotti di marche con formato tsr o m7m
- Marcare un documento con formato tsr o m7m, senza avere a disposizione un proprio lotto
- Controllare disponibilità marche residue di un lotto
- Verificare dettagli, validità e correttezza di un documento marcato
Con Openapi è possibile acquistare i lotti di marche, erogati da 2 differenti Enti Certificatori accreditati (Time-Stamping Authority - TSA): InfoCert e Aruba. I lotti disponibili sono:
- Marche Temporali InfoCert: 100, 250, 500, 1000, 2.000, 5000, 10.000, 20.000, 50.000, 100.000, 200.000, 500.000
- Marche Temporali Aruba: 20, 100, 250, 500
Le marche temporali, sia InfoCert che Aruba, hanno validità europea secondo quanto stabilito dal Regolamento eIDAS e possono essere utilizzate autonomamente, ad esempio integrate in un software, o insieme a qualsiasi dispositivo di Firma digitale.
Il service “Marche Temporali” è identificato dall’endpoint: https://ws.marchetemporali.com
La procedura di marcatura o rilascio lotti di marche temporali è immediata.
1. Elenco lotti di marche acquistati GET/marche
L’endpoint GET https://ws.marchetemporali.com/marche consente di verificare la lista di tutte le marche acquistate tramite account Openapi ed ottenere tutti i dati associati come ad esempio username e password.
ESEMPIO CHIAMATA
https://ws.marchetemporali.com/marche
L’endpoint è utile perché permette di ottenere i dati da utilizzare poi in fase di marcatura temporale con lotto proprio. Non è necessario alcun parametro per questa chiamata.
ESEMPIO RISPOSTA
La risposta fornisce i dettagli del lotto di marche selezionato: l’ID e nome Ente Certificatore Accreditato (InfoCert o Aruba), la quantità (es. 50), l’username e password scelti, l’id entità e infine la data e l’orario esatti di acquisto.
{
"data": [
{
"id_marca": "deb184df120e0487b64a2f77a4ab60c5",
"type": "aruba",
"qty_marca": "50",
"username": "FAKETxxxxltravia09",
"password": "FAKxxxB71AJHN",
"id_entita": "159xxx2274",
"timestamp_acquisto": "2020-09-10 12:04:35"
},
{
"id_marca": "79b1ab2ce4825c955ba7b99c6d1a4b5f",
"type": "infocert",
"qty_marca": "100",
"username": "FAKExxxR325",
"password": "FAKEinxxxxx2",
"id_entita": "159xxx2274",
"timestamp_acquisto": "2020-09-10 12:10:52"
}
],
"success": true,
"message": "",
"error": null
}
2. Controllo lotti di marche disponibili per l’acquisto GET/availability/{type}/{qty}
Il service consente di verificare quali lotti di marche temporali, InfoCert o Aruba, sono disponibili per l'acquisto.
ESEMPIO CHIAMATA
È possibile effettuare la chiamata a partire dai parametri ‘type’, ovvero nome dell’ente certificatore (InfoCert o Aruba), e ‘qty’ ovvero quantità cioè numero di marche del lotto (es. 100, 1000):
https://ws.marchetemporali.com/avalability/{type}/{qty}
ESEMPIO RISPOSTA
Nella risposta saranno presenti il numero di lotti disponibili:
{
"data": {
"availability": "89"
},
"success": true,
"message": "",
"error": true
}
3. Acquistare un lotto di Marche Temporali
GET/marche/{type}/{qty}
Tramite il service Marche Temporali è possibile acquistare un lotto di marche temporali, scegliendo come anticipato tra InfoCert e Aruba, l’endpoint da utilizzare è GET/marche/{type}/{qty}.
ESEMPIO CHIAMATA
La chiamata può essere effettuata a partire dai parametri ‘type’, ovvero tipo di marca, e ‘qty’ ovvero quantità:
https://ws.marchetemporali.com/marche/{type}/{qty}
ESEMPIO RISPOSTA
La risposta fornirà i dettagli del lotto di marche appena acquistato, in particolare username e password.
{
"data": {
"id_marca": "1bab897afce17bd101c54d6011851d10",
"username": "FAKETSxxxxravia10",
"password": "FAKE6GxxxxSFA"
},
"message": "Marca erogata",
"success": true,
"error": null
}
4. Verificare marche utilizzate
POST/check_lotto
È possibile in qualsiasi momento verificare il numero di marche ancora disponibili del lotto acquistato tramite l’endpoint POST https://ws.marchetemporali.com/check_lotto
ESEMPIO CHIAMATA
Nel body della chiamata POST https://ws.marchetemporali.com/check_lotto dovranno essere passati i valori ‘username’ e ‘password del lotto di cui si vuole verificare le marche residue:
{
"username": "J0xxxx57",
"password": "R6xxxh5X"
}
ESEMPIO RISPOSTA
La risposta, come anticipato, indica il numero di marche ancora disponibili e la quantità già utilizzata:
{
"data": {
"available": "249",
"used": "1"
},
"message": "DESCR = Marche per J0xxxx57; disponibili 249 consumate 1",
"success": true,
"error": true
}
5. Marcatura temporale POST/marca
L’endpoint dedicato alla marcatura temporale è POST https://ws.marchetemporali.com/marca.
Con questo endpoint è possibile effettuare la marcatura temporale del documento in due modalità:
- con lotto di marche temporali (InfoCert o Aruba) proprio
- procedere alla marcatura del documento senza essere in possesso di alcun lotto di marche
A livello di chiamata nel primo caso sarà necessario passare anche i valori username e password del lotto da utilizzare per la marcatura temporale. Nel secondo caso, "senza lotto proprio", sarà invece necessario passare esclusivamente l’url del pdf da marcare.
ESEMPIO CHIAMATA
La chiamata POST https://ws.marchetemporali.com/marca nel caso di marcatura con lotto proprio avrà nel body della richiesta i seguenti valori:
{
"username": "J0xxxx51",
"password": "5xxxxxg2",
"file": "https://esempiourl.com/test.pdf"
}
ESEMPIO RISPOSTA
La risposta fornirà specifiche sul file marcato e indicherà anche quante marche si hanno ancora a disposizione:
{
"data": {
"available": 99,
"used": 1,
"timestamp_header": "{\"Date\":\"Fri, 11 Sep 2020 09:27:19 GMT\",\"Server\":\"Apache\",\"X-Powered-By\":\"Application Server Infocert - marca4\",\"Set-Cookie\":\"JSESSIONID=A9FCAAAFFF1320E96F19AD43F7B590A2.marca4; Path=\\/; Secure\",\"ICTSA-UCTTime\":\"20200911092720Z\",\"ICTSA-SN\":\"428957893\",\"ICTSA-TSAName\":\"CN=ICEDTS02202009, OU=TSA, O=INFOCERT SPA, C=IT\",\"Content-Disposition\":\"attachment; filename=\\\"test.tsr\\\"\",\"Content-Type\":\"application\\/timestamp-reply; name=\\\"test.tsr\\\"\",\"Content-Length\":\"3584\"}",
"timestamp_body": "https://dev.ws.marchetemporali.com/MARCATURE/7fc398e761e35b0c766698b27b4e7430/test.tsr",
"transaction": "7fc398e761e35b0c766698b27b4e7430"
},
"message": "Documento Marcato Correttamente",
"success": true,
"error": null
}
6. Analisi documento POST/analisi
Il service consente in qualsiasi momento di verificare un documento marcato.
ESEMPIO CHIAMATA
Nella chiamata POST https://ws.marchetemporali.com/marca dovrà essere passato nel body l’url del file da verificare:
{
"file": "https://dev.ws.marchetemporali.com/MARCATURE/62623dd3b911198e3c67a0d836830719/test.m7m"
}
ESEMPIO RISPOSTA
Nel caso in cui il processo di marcatura abbia avuto esito positivo, nella risposta apparirà il messaggio (‘message’) “Documento verificato correttamente”, altrimenti la dicitura sarà “Wrong document URL or document unavailable”.
{
"data": {
"transaction": "691929c444e1d7d0c6c2f78d0fed3be7",
"UTCTime": "20200911131712Z",
"SN": "429027229",
"TSAName": "CN=ICEDTS02202009, OU=TSA, O=INFOCERT SPA, C=IT"
},
"message": "Documento Verificato Correttamente",
"success": true,
"error": true
}
Il service è già stato scelto da centinaia di aziende ed integrato in software di contabilità, piattaforme per la tutela dei diritti di autore, di gestione del credito, valutazioni rischi e di monitoraggio procedure aziendali.
