数字认证，web RESTful API服务
[ES]手册
de usuario"X.509验证者"塞尔维亚X.509 y . los archivos PDF firmados, así como塞尔维亚证书验证者legislación de la República de塞尔维亚。
El servicio web RESTful "X.509 verifier" consta de 2 API REST ubicadas en El host:
http://signatureverifier.d-logic.com
Y las rutas de los scripts son:
API de REST: x509-验证器
Versión de la API: 1.0
El archiivo PEM, cuyo contenido debe ser un certificate X.509 de la versión 3, se envía a esta API。Después de compprobar el certificado, la API devuelve el resultado de la verificación en la cadena codificada JSON。
请求服务HTTP
Host + Ruta:http://signatureverifier.d-logic.com/x509-verifier.php
Metodo:
Encabezados POST(义务):
内容类型:多部分/格式;边界= RANDOM_STRING_BOUNDARY
身体:
-RANDOM_STRING_BOUNDARY
附加:格式;name = "文件";文件名= " file_name.pem "
内容类型:应用程序/八进制
(FILE_BINARY_DATA)
——RANDOM_STRING_BOUNDARY
附加:格式;name = "查询"
(JSON_ENCODED_PARAMETERS)
-RANDOM_STRING_BOUNDARY -
{}结束
Descripción de la solicitud del servidor HTTP
RANDOM_STRING_BOUNDARY有可能的联合国勇敢的不同之处，único在新的关怀中。Por ejemplo, en JavaScript, una buena práctica para adquirir RANDOM_STRING_BOUNDARY sería:
var boundary = Math.random().toString().substr(2);
(FILE_BINARY_DATA)Es UN contenido binario del archiivo 'file_name。pem elegido。
(JSON_ENCODED_PARAMETERS)son parámetros codificados en JSON que deben cumplir con el siguiente formato:
｛
:“operacion verificar”,
“user_id”:123年,
“security_token”:“
｝
y la buena práctica es que esta cadena codificada JSON no contenga caracteres de espacio en blanco, es decir, que se formme, en JavaScript, por ejemplo, utilizando el siguiente código:
Var params, json;
Params = {operación: "verificar"， user_id: 123, security_token: ""};
json = json .stringify(parámetros);
Los parámetros子:
“操作”:“验证”-“验证”操作única operación actualmente admitida。
“user_id”:123- - - - - -parámetro numérico, tipo entero，代表el número de identificación del usuario (no se utiliza en la versión 1.0 de la API, pero es义务和储备para el uso future)。En la api la versión 1.0 puede ser 0。
“security_token”:“- cadena que debe contere parares dígitos十六进制对未来的限制(没有使用versión 1.0 de la API，未来的义务和保留权利)。En la versión 1.0 de la API puede ser una cadena vacía。
De todos modos, en JavaScript, no es esesario administrar directamente el Contenido, es decir, el cuerpo HTTP。推荐的usar la clase FormData como ejemplo que puede descargar del repository git enla siguiente URL:
/ / NFC-RFID-reader-SDK / signature_verifier_jc_example.git代码
También hay ejemplos de cómo usar la compatibilidad con cURL desde PHP para enviar solicita estas API REST:
/ / digital_signature_sdk / php_example.git代码
服务器端HTTP
Después de la verificación del certificado X.509, el servidor devolverá la cadena codificada JSON que (en la versión 1.0 de la API)连续2个参数:
{“状态”:“STATUS_STRING”,“味精”:“MESSAGE_STRING”}
我不关心你válida，我为你服务será:
Http /1.1 200 ok
.．.
论点:应用程序/JSON
{"status":"Error: parámetros POST incorrectos."，"msg":""}
Si la verificación esexitosa， STATUS_STRING
“德acuerdo”
El archiivo PDF, cuyo contenido debe ser un documento PDF firmado, se envía a esta API。“PKCS#7 -分离”或“CAdES等效”。Después数据归档总库，数据归档总库verificación数据汇编汇编JSON。 Host + Ruta:http://signatureverifier.d-logic.com/pdf-sgn-verifier.php RANDOM_STRING_BOUNDARY有可能的联合国勇敢的不同之处，único在新的关怀中。Por ejemplo, en JavaScript, una buena práctica para adquirir RANDOM_STRING_BOUNDARY sería: y la buena práctica es que esta cadena codificada JSON no contenga caracteres de espacio en blanco, es decir, que se formme, en JavaScript, por ejemplo, utilizando el siguiente código: Después de la verificación del archiivo PDF y contiene la firma, el servidor devolverá la cadena codificada JSON que (en la versión 1.0 de la API)连续2个参数: 世界的意义verificación永恒的档案这些completada， pero elResultado no tiene éxito。En este caso, los MESSAGE_STRING我的祖国是永恒的。在这里，MESSAGE_STRING contendrá unregistro con formato válido，关于连续礼节的格式HTML, así como礼节的HTML para una nueva línea，关于在这里的mensaje se puede colacar directamente encualquier contedor HTML (por ejemplo， La parte ad军政府de este manual también incluye archivos JSON que contienen perfiles para extensión“谷歌Chrome”“Restlet客户端”。Estos archivos son x509-验证器。Json - pdf- signn -验证器。json y continenen perfiles para API de REST x509-verifier y pdf- signn -verifier respectivamente。Se pueden usar después de instalar las extensiones "Restlet客户端" "谷歌Chrome"。
mientras que el MESSAGE_STRING contendrá un registro con formato válido, que contiene礼节de formato HTML, así como礼节HTML para una nueva línea, por lo que este mensaje se puede colacar directamente en cualquier contender HTML (por ejemplo，
Cualquier respuesta cuyo STATUS_STRING海不同的"OK" se cuenta como una comprobación cuyo resultado没有什么是正确的y, en este caso, si STATUS_STRING es differente del "Error: parámetros POST incorrectos."， MESSAGE_STRING contendrá details del escrutino del certificado que debe mostrarse. "
API REST: pdf- signn -verifier
Versión de la API: 1.0
请求服务HTTP
Metodo:
Encabezados POST(义务):
内容类型:多部分/格式;边界= RANDOM_STRING_BOUNDARY
身体:
-RANDOM_STRING_BOUNDARY
附加:格式;name = "文件";文件名= " file_name.pdf "
内容类型:应用程序/ pdf
(FILE_BINARY_DATA)
-RANDOM_ STRING_BOUNDARY
附加:格式;name = "查询"
(JSON_ENCODED_PARAMETERS)
-RANDOM_STRING_BOUNDARY -
{}结束Descripción de la solicitud del servidor HTTP
var boundary = Math.random().toString().substr(2);
(FILE_BINARY_DATA)Es UN二进制文件“file_name.pdf”
(JSON_ENCODED_PARAMETERS)son parámetros codificados en JSON que deben cumplir con el siguiente formato:｛
:“operacion verificar”,
“user_id”:123年,
“security_token”:“
｝
Var params, json;
Params = {operación: "verificar"， user_id: 123, security_token: ""};
json = json .stringify(parámetros);
Los parámetros子:
“操作”:“验证”-“验证”操作única operación actualmente admitida。
“user_id”:123- - - - - -parámetro numérico, tipo entero，代表el número de identificación del usuario (no se utiliza en la versión 1.0 de la API, pero es义务和储备para el uso future)。En la api la versión 1.0 puede ser 0。
“security_token”:“- cadena que debe contere parares dígitos十六进制对未来的限制(没有使用versión 1.0 de la API，未来的义务和保留权利)。En la versión 1.0 de la API puede ser una cadena vacía。
De todos modos, en JavaScript, no es esesario administrar directamente el Contenido, es decir, el cuerpo HTTP。推荐的usar la clase FormData como ejemplo que puede descargar del repository git enla siguiente URL:
/ / NFC-RFID-reader-SDK / signature_verifier_jc_example.git代码
También hay ejemplos de cómo usar la compatibilidad con cURL desde PHP para enviar solicita estas API REST:
/ / digital_signature_sdk / php_example.git代码服务器端HTTP
{“状态”:“STATUS_STRING”,“味精”:“MESSAGE_STRING”}
我不关心你válida，我为你服务será:Http /1.1 200 ok
.．.
论点:应用程序/JSON
{"status":"Error: parámetros POST incorrectos."，"msg":""}
Si la verificación esexitosa， STATUS_STRING“La firma PDF es VÁLIDA”
mientras que el MESSAGE_STRING contendrá un registro con formato válido, que contiene礼节de formato HTML, así como礼节HTML para una nueva línea, por lo que este mensaje se puede colacar directamente en cualquier contender HTML (por ejemplo，
一个API x509-验证器，aquí tenemos respuestas con STATUS_STRING differencia de la " la firma PDF es VÁLIDA"， que contó como unresultado德Verificación fallido, pero en estos casos，MESSAGE_STRING没有连续体的细节．“我的家庭”:
STATUS_STRING = "错误:' PDF se cambió después de firmar!"
STATUS_STRING = "错误:格式PDF不正确(al buscar datos de firma)"
STATUS_STRING = "Información: el archiivo PDF no contiene firma digital"
STATUS_STRING = "错误:格式PKCS#7不正确(faltan datos "para firmar")"
El caso cuando esSTATUS_STRING = "错误en la validación de la firma digital"
"Restlet客户端" tiene unerror conocido que se manifiesta siempre, al cargar el perfil, cambiar el tipo de parámetro de forma del cuerpo de " archiivo " a "Texto"。La solución es cambiar el tipo cambiado a "Archivo" y luego elegir el archiivo deseado。
评论截止。