在线商店
ožu 12

验证器digitalnih certiffikata - RESTful Web服务API

验证器数字证书,API restful web usluga

[英文]korisni ki priru

“X.509验证器”jrestfulweb usluga koja može poslužiti za potvrđivanje X.509 certiffikata i potpisanih PDF datoteka, kao i za provjeru usklađenosti sadržaja certificfikata sa zakonskim propisima Republike Srbije。
“X.509验证器”RESTful Web usluga sastoji使用了2 RESTful API-ja smještena na domaćinu:
http://signatureverifier.d-logic.com
putovi skripti su:

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

REST API: x509- authenticator

API: 1.0

PEM datoteka, iji sadržaj mora biti X.509证书,verzije 3, šalje se - ovom API-ju。Nakon projere证书,API vraća rezultaprojere u JSON kodiranomnizu。

Zahtjev HTTP poslužitelja

Glavno ra unalo + put:http://signatureverifier.d-logic.com/x509-verifier.php
Metoda:帖子
zaglavlja (obavezno):
Vrsta sadržaja: višedijelni/obrazac-podaci;granica = RANDOM_STRING_BOUNDARY
Tijelo:

-RANDOM_STRING_BOUNDARY
萨德尔žaj-Dispozicija: obrazac-podaci;naziv = " datoteka”;naziv datoteke = " file_name.pem "
Vrsta sadržaja: appikacija /oktet-stream

(FILE_BINARY_DATA)
——RANDOM_STRING_BOUNDARY
萨德尔žaj-Dispozicija: obrazac-podaci;naziv = " upit "

(JSON_ENCODED_PARAMETERS)
-RANDOM_STRING_BOUNDARY -
{}结束

Opis zahtjeva HTTP poslužitelja

RANDOM_STRING_BOUNDARYJe niz koji mora imati drug gaiju i, ako Je moguće, jedinstvenu vrijednost na svakom novom zahtjevu。这是一个简单的程序,你可以在javascript中使用dobra praksa和stjecanje

var granica = Math.random().toString().substring().substr(2);


(FILE_BINARY_DATA)Binarni je sadržaj odabrane datoteke "file_name.pem"。

(JSON_ENCODED_PARAMETERS)su JSON kodirani parameteri koji moraju ispuniti sljedeći格式:

{
:“operacija provjera”,
“user_id”:123年,
“security_token”:“
}

a dobra praksa je da ovaj JSON kodirani niz ne sadrži znakove razmaka, tj。

Var参数,json;
Params = {operation: "verify", user_id: 123, security_token: ""};
json = json .stringify(params);


Parametri苏:
:“operacija provjera”- Operacija "provjera" jeedina Operacija koja jetrenutno podržana。
“user_id”:123- - - - - -numeriki参数,cijeli broj, preprestavlja identifikacijski broj korisnika (ne koristi se u API verziji 1.0, ali je obvezan i rezerviran za buduću uporabu)。U API verziji 1.0 može biti 0。
“security_token”:“- niz koji bi trebao sadržavati parve heksadecimalnih znamenki bez takozvanog grani nika (nekoristi se u API verziji 1.0, ali je obavezan i rezerviran za buduću uporabu)。U API verziji 1.0 može biti prazan niz。
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *。preporu ujemo korištenje klase FormData kao primjera koji možete preuzeti iz git repozitorija na sljedećemURL-u: / / NFC-RFID-reader-SDK / signature_verifier_jc_example.git代码
postje i primjeri kako koristtii cURL podršku PHP-a za slanje zahtjeva ovim REST API-jevima
/ / digital_signature_sdk / php_example.git代码

Odgovor HTTP poslužitelja

Nakon provjere X.509证书,poslužitelj će vratii JSON kodirani niz koji (u API verziji 1.0) sadrži

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


纳扎耶夫·科吉·涅耶·瓦尔扬省长poslužitelja bit će:

Http /1.1 200 ok
Vrsta sadržaja: appikacija /json

{“状态”:“Pogreška: Pogreš倪parametri。”,“味精”:"}


Ako je provjera uspješna, STATUS_STRING:

“OK”


dok će MESSAGE_STRING sadržavati valjano oblikovani zapis koji sadrži HTML oznake oblikovanja, kao i HTML oznake za novi reak, tako da se ova poruka može izravno smjestiti u bilo koji HTML spremnik (npr。< div >)。

斯瓦基奥古斯丁州州长“OK”,斯瓦基奥古斯丁州州长“OK”neuspješ一i, u from sluadaju, ako se STATUS_STRING razlikuje od "Pogreška: pogrešni POST参数",MESSAGE_STRING sadržavat će pojedinosti o nadzoru certifikata koji bi trebali biti prikazani。

REST API: pdf- sign - authenticator

API: 1.0

PDF datoteka, iji sadržaj mora biti poppisan PDF文档,šalje se ovom API-ju。obici pot比萨mogu biti“PKCS#7 - Odvojeni”和“ekvivalent cade”。API vraća rezultaprojere JSON kodiranomnizu。

Zahtjev HTTP poslužitelja

Glavno ra unalo + put:
http://signatureverifier.d-logic.com/pdf-sgn-verifier.php Metoda:帖子
zaglavlja (obavezno):
Vrsta sadržaja: Vrsta sadržaja: multipart/form-data;边界= RANDOM_STRING_BOUNDARY
Tijelo:

-RANDOM_STRING_BOUNDARY
萨德尔žaj-Dispozicija: obrazac-podaci;naziv = " datoteka”;Naziv datoteke ="file_name.pdf"
Vrsta sadržaja: appikacija /pdf

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

(JSON_ENCODED_PARAMETERS)
-RANDOM_STRING_BOUNDARY -
{}结束

Opis zahtjeva HTTP poslužitelja

RANDOM_STRING_BOUNDARYJe niz koji mora imati drug gaiju i, ako Je moguće, jedinstvenu vrijednost na svakom novom zahtjevu。这是一个简单的程序,你可以在javascript中使用dobra praksa和stjecanje

var granica = Math.random().toString().substring().substr(2);


(FILE_BINARY_DATA)Binarni je sadržaj odabrane datoteke "file_name.pdf"。

(JSON_ENCODED_PARAMETERS)su JSON kodirani parameteri koji moraju ispuniti sljedeći格式:

{
:“operacija provjera”,
“user_id”:123年,
“security_token”:“
}

a dobra praksa je da ovaj JSON kodirani niz ne sadrži znakove razmaka, tj。

Var参数,json;
Params = {operation: "verify", user_id: 123, security_token: ""};
json = json .stringify(params);


Parametri苏:
:“operacija provjera”- Operacija "provjera" jeedina Operacija koja jetrenutno podržana。
“user_id”:123- - - - - -numeriki参数,cijeli broj, preprestavlja identifikacijski broj korisnika (ne koristi se u API verziji 1.0, ali je obvezan i rezerviran za buduću uporabu)。U API verziji 1.0 može biti 0。
“security_token”:“- niz koji bi trebao sadržavati parve heksadecimalnih znamenki bez takozvanog grani nika (nekoristi se u API verziji 1.0, ali je obavezan i rezerviran za buduću uporabu)。U API verziji 1.0 može biti prazan niz。
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *。preporu ujemo korištenje klase FormData kao primjera koji možete preuzeti iz git repozitorija na sljedećemURL-u: / / NFC-RFID-reader-SDK / signature_verifier_jc_example.git代码
postje i primjeri kako koristtii cURL podršku PHP-a za slanje zahtjeva ovim REST API-jevima
/ / digital_signature_sdk / php_example.git代码

Odgovor HTTP poslužitelja

Nakon projere PDF datoteke i sadrži potpis, poslužitelj će vratii JSON kodirani niz koji (u API verziji 1.0) sadrži 2个参数:

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


纳扎耶夫·科吉·涅耶·瓦尔扬省长poslužitelja bit će:

Http /1.1 200 ok
Vrsta sadržaja: appikacija /json

{“状态”:“Pogreška: Pogreš倪parametri。”,“味精”:"}


Ako je provjera uspješna, STATUS_STRING:

PDF potpis je VALJAN


dok će MESSAGE_STRING sadržavati valjano oblikovani zapis koji sadrži HTML oznake oblikovanja, kao i HTML oznake za novi reak, tako da se ova poruka može izravno smjestiti u bilo koji HTML spremnik (npr。< div >)。

[2] [1] [1] [1] [1] [1] [1] [1] [1] [1] [1] [1] [1] [1] [1] [1neuspješ一Rezultat provjere, ali u Tim slu ajevimaMESSAGE_STRING ne sadrži detalje。致su slu ajevi kada:

STATUS_STRING = "Pogreška: PDF je promijenjen nakon potpisivanja!"
STATUS_STRING = "Pogreška: pogrešan PDF格式(tijekom pretraživanja podataka o potpisu)"
STATUS_STRING = "Informacije: PDF datoteka ne sadrži digitalni potpis"
STATUS_STRING = "Pogreška: Pogrešan pkcs# 7格式(nedostaju podaci "za potpisivanje")"


slu aj kada je

STATUS_STRING = "Provjera valjanosti digitalnog potpisa NIJE USPJELA"

što zna i da je to proprojera PDF datoteke i sadrži potpisU potpunosti dovršen,阿里Rezultat je neuspješan。tom sluaju, MESSAGE_STRINGUvijek sadrže detalje nadzora koji bi trebali biti prikazani。U tom sluaju, MESSAGE_STRING će sadržavati valjano oblikovan zapis koji sadrži HTML oznake oblikovanja, kao i HTML oznake za novi reak, tako da se ova poruka može izravno smjestiti U bilo koji HTML spremnik (npr。< div >)。

Dodatak:“Restlet客户端”- izvezene datoteke proširenja preglednika Google Chrome:

Popratni dio ovog priru nika uklju uje i JSON datoteke koje sadrže配置文件za proširenje“Google Chrome”“Restlet客户端”。su datoteke x509- verify。Json I pdf- sign - verify。. json i sadrže profile za REST API-jeve x509- authenticator i pdf- sign - authenticator。Mogu se koristiti nakon instaliranja proširenja“Restlet客户端”“Google Chrome”。

“Restlet Client”ima poznatu grešku koja se manifest tako što uvijek, priilikom uitavanja profila, mijenja vrstu parametertra oblika tijela iz“Datoteka”u“Tekst”。Zaobilazno rješenje je vraćanje promijenjene vrste na "Datoteka", a zatim odabir željene datoteke。

Baidu
map