在线商店
3月 12

数字证书验证器- API DEI SERVIZI WEB RESTful

打印友好,PDF和电子邮件

验证数字认证,API服务Web RESTful

Manuale d'uso

"X.509验证器" è un servizio Web RESTful che può serva convalidare i certificati X.509 i file PDF firmati, nonché a verificare la conformità del contuto dei certificati con la legislature della republic di Serbia。
Il servizio Web RESTful“X.509验证器”è costitito da 2 API REST定位nell'host:
http://signatureverifier.d-logic.com
I percorsi degli脚本sono:

  1. / x509-verificatore.php
  2. / pdf-sgn-verificatore.php

API REST: x509- verifier

版本API: 1.0

Il file PEM, Il cui contenuto deve essential un certificate to X.509 della version3, viene inviato a questa API。Dopo aver control to il certificate, l'API restituce il risultato della verifica nella stringcodificata JSON。

Richiesta服务器HTTP

主机+ Percorso:http://signatureverifier.d-logic.com/x509-verifier.php
Metodo:帖子
Intestazioni (obbligatorio):
内容类型:多部分/格式;边界= RANDOM_STRING_BOUNDARY
Corpo:

-RANDOM_STRING_BOUNDARY
附加:格式;name = "文件";文件名= " file_name.pem "
内容类型:应用程序/八进制

(FILE_BINARY_DATA)
——RANDOM_STRING_BOUNDARY
附加:格式;name = "查询"

(JSON_ENCODED_PARAMETERS)
-RANDOM_STRING_BOUNDARY -
{}结束

描述一个della richesta del服务器HTTP

RANDOM_STRING_BOUNDARYè琴弦上有一种不同的可能,唯一的财富。在JavaScript中,le buone pratiche per acquiire RANDOM_STRING_BOUNDARY sarebbero:

var boundary = Math.random().toString().substr(2);


(FILE_BINARY_DATA)è UN contenuto binario del file 'file_name. xml文件。pem scelto。

(JSON_ENCODED_PARAMETERS)sono parameter codificati JSON che devono soddisfare il seguente formato:

{
:“operazione verifica”,
“user_id”:123年,
“security_token”:“

e la buona pratica è che questa stringa codificata JSON non contenga caratteri di spazi bianchi cioè da formare, in JavaScript, ad esempio, usando il seguente codice:

Var params, json;
Params ={操作:"verify", user_id: 123, security_token: ""};
json = json .stringify(params);


I参数声呐:
“操作”:“验证”- L'operazione "verify" è L 'unica operazione attitude supportata。
“user_id”:123- - - - - -parameter numerico, tipo intero, rappresenta il numero di identificazione dell'utente(非è utilzzato nella versione API 1.0 ma è obbligatorio e riservato per l'uso future)。Nella版本API 1.0 può essere 0。
“security_token”:“- stringa che dovrebbe contenere coppie di ciefre esadecimali senza un cosiddetto delimitatore (non è utilizzata nella versione API 1.0 ma è obigatoria e riservata per l'uso future)。内拉版本API 1.0 può essere una stringa vuota。
在ogni caso中,在JavaScript中,非è必要的姿态direttamente il Contenuto, over vero il corpo HTTP。Si consiglia di utilzzare la类FormData来esempio che è可能的scaricare dal资源库git al seguente URL:
/ / NFC-RFID-reader-SDK / signature_verifier_jc_example.git代码
Ci sono anche esempi di come utilzzare il support to cURL da PHP per inviare richhieste a quest API REST:
/ / digital_signature_sdk / php_example.git代码

Risposta del服务器HTTP

Dopo la verifica del certificato X.509, il server restituirà la stringa codificata JSON che (nella版本API 1.0)连续2 argomenti:

{“状态”:“STATUS_STRING”,“味精”:“MESSAGE_STRING”}


在caso di rich esta not valida, la risposta del server sarà:

Http /1.1 200 ok
...
应用程序/JSON

{"status":" error: parameteri POST errati.","msg":""}


这是事实,哈esitopositivo, STATUS_STRING

“Va的野猪”


mentre il MESSAGE_STRING conterrà un record validamente formattato, che contiene tag di formattazione HTML, nonché tag HTML per una nuova riga, quindi questo messaggio può essere inserito direttamente in qualsiasi contenitore HTML (ad esempio

)。

Qualsiasi risposta il cui STATUS_STRING è diverso da "OK" viene conteggiata come un controllo il risultato non ha esitopositivoe,在questo caso, se STATUS_STRING è diverso dai parameter POST " error: error POST.", MESSAGE_STRING conterrà i dettagli del controllo del certificato che dovrebbero essere visualizzati。

API REST: pdf- signn -verifier

版本API: 1.0

Il file PDF, Il cui contentuto deve essere firmato documentento PDF, viene inviato a questa API。我格式为“PKCS#7 -分离”或“CAdES等效”。Dopo aver controllato il file firmato, l'API restituisce il risultato della verifica nella stringa codificata JSON。

Richiesta服务器HTTP

主机+ Percorso:http://signatureverifier.d-logic.com/pdf-sgn-verifier.php
Metodo:帖子
Intestazioni (obbligatorio):
内容类型:多部分/格式;边界= RANDOM_STRING_BOUNDARY
Corpo:

-RANDOM_STRING_BOUNDARY
附加:格式;name = "文件";文件名= " file_name.pdf "
内容类型:应用程序/ pdf

(FILE_BINARY_DATA)
-RANDOM_ STRING_BOUNDARY
附加:格式;name = "查询"

(JSON_ENCODED_PARAMETERS)
-RANDOM_STRING_BOUNDARY -
{}结束

描述一个della richesta del服务器HTTP

RANDOM_STRING_BOUNDARYè琴弦上有一种不同的可能,唯一的财富。在JavaScript中,le buone pratiche per acquiire RANDOM_STRING_BOUNDARY sarebbero:

var boundary = Math.random().toString().substr(2);


(FILE_BINARY_DATA)è UN contenuto二进制文件“file_name.pdf”scelto。

(JSON_ENCODED_PARAMETERS)sono parameter codificati JSON che devono soddisfare il seguente formato:

{
:“operazione verifica”,
“user_id”:123年,
“security_token”:“

e la buona pratica è che questa stringa codificata JSON non contenga caratteri di spazi bianchi cioè da formare, in JavaScript, ad esempio, usando il seguente codice:

Var params, json;
Params ={操作:"verify", user_id: 123, security_token: ""};
json = json .stringify(params);


I参数声呐:
“操作”:“验证”- L'operazione "verify" è L 'unica operazione attitude supportata。
“user_id”:123- - - - - -parameter numerico, tipo intero, rappresenta il numero di identificazione dell'utente(非è utilzzato nella versione API 1.0 ma è obbligatorio e riservato per l'uso future)。Nella版本API 1.0 può essere 0。
“security_token”:“- stringa che dovrebbe contenere coppie di ciefre esadecimali senza il cosiddetto delimitatore(非è utilizzata nella versione API 1.0 ma è obigatoria e riservata per l'uso future)。内拉版本API 1.0 può essere una stringa vuota。
在ogni caso中,在JavaScript中,非è必要的姿态direttamente il Contenuto, over vero il corpo HTTP。Si consiglia di utilzzare la类FormData来esempio che è可能的scaricare dal资源库git al seguente URL:
/ / NFC-RFID-reader-SDK / signature_verifier_jc_example.git代码
Ci sono anche esempi di come utilzzare il support to cURL da PHP per inviare richhieste a quest API REST:
/ / digital_signature_sdk / php_example.git代码

Risposta del服务器HTTP

Dopo la verifica del file PDF e contiene la firma, il server restituirà la stringa codificata JSON che (nella versione API 1.0) contiene 2 argomenti:

{“状态”:“STATUS_STRING”,“味精”:“MESSAGE_STRING”}


在caso di rich esta not valida, la risposta del server sarà:

Http /1.1 200 ok
...
应用程序/JSON

{"status":" error: parameteri POST errati.","msg":""}


这是事实,哈esitopositivo, STATUS_STRING

“La firma PDF è VALIDA”


mentre il MESSAGE_STRING conterrà un record validamente formattato, che contiene tag di formattazione HTML, nonché tag HTML per una nuova riga, quindi questo messaggio può essere inserito direttamente in qualsiasi contenitore HTML (ad esempio

)。

Contrariamente all'API x509-verifier, qui abbiamo risposte con STATUS_STRING diverso da "La firma PDF è VALIDA", che contava come risultato没有证据Riuscito, ma in questi casi,MESSAGE_STRING非连续dettagli.在崔的问题:

STATUS_STRING = "错误:PDF è statto modificato dopo la firma!"
STATUS_STRING = "错误:格式PDF错误(durante la ricerca dei dati della firma)"
STATUS_STRING = "信息:il文件PDF非连续性数据"
STATUS_STRING = "错误:formato PKCS#7 errato (mancano i dati "da firmare")"


Il caso in cui è

STATUS_STRING = "Convalida della firma digita NON RIUSCITA"

il che important che è una verifica del file PDF e continene la firmainteramente completata马伊尔Risultato non ha成功。在questo caso中,le MESSAGE_STRING我要用我的双手去控制我的爱人,我必须看到你。在questo caso中,MESSAGE_STRING conterrà un record validamente formattato, che contiene tag di formattazione HTML, nonché tag HTML per una nuova riga, quindi questo messaggio può essere inserito direttamente In qualsiasi contenitore HTML (ad esempio

)。

附录:“Restlet客户端”- File esportati dall'estensione del browser谷歌Chrome浏览器:

La parte di accompagnamento di questo manuale包括anche i文件JSON che contengono profili per l'estensione“谷歌Chrome”“Restlet客户端”。查询文件sono x509-验证器。Json - pdf- signn -验证器。json e contengono profili per le API REST x509-verifier e pdf- signn -verifier rispettivamente。“rest client”“谷歌Chrome”。

“Restlet客户端”ha un bug noto che si宣言sempre, al caricamento del profilo, cambia il tipo di参数modulo del corpo da“文件”a“Testo”。在"文件"中"解决问题的方法"和"需要的文件"。

Baidu
map