You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 5
Next »
Introduction
Below will be detailed the SOAP request for verify signatures, certificates and timestamps
All the methods described are on interface:
https://<IP-APPLIANCE>:8080/SignEngineWeb/verify-services?wsdl
The SOAP request examples are generated using SoapUI, you can use this guide to configure SoapUI on your pc.
In this guide will be described the example of Soap Requests.
Verify Signatures
For verify the signatures, you can use the method "verifyWithPreferences", like in this example:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.ws.nam/">
<soapenv:Header/>
<soapenv:Body>
<ser:verifyWithPreferences>
<!--Optional:-->
<signedContent>BASE_64_ASSOCIATED_TO_SIGNED_FILE</signedContent>
<!--Optional:-->
<preferences>
<language>COUNTRY_CODE_2_DIGIT</language>
</preferences>
</ser:verifyWithPreferences>
</soapenv:Body>
</soapenv:Envelope>
For all input of verify preferences, you can see this link
The output of this SOAP request will be a complex object SignedDocumentReportBean described at this link
Verify Timestamp
SWS offer two differents methods for verify TSD (TimestampData) and TSR (TimestampResponse):
- verifyTimeStampData
- verifyTimeStampResponse
Below will be described how make the SOAP request
Verify TSD
Below an example of SOAP request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.ws.nam/">
<soapenv:Header/>
<soapenv:Body>
<ser:verifyTimeStampData>
<tsd>BASE_64_OF_TSD</tsd>
</ser:verifyTimeStampData>
</soapenv:Body>
</soapenv:Envelope>
The response will be a list of complex objects: "TimestampReportBean" described in this section
Verify TSR
Below an example of SOAP request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.ws.nam/">
<soapenv:Header/>
<soapenv:Body>
<ser:verifyTimeStampResponse>
<tsr>BASE_64_OF_TSR</tsr>
<!--Optional:-->
<content>BASE_64_OF_ORIGINAL_FILE</content>
</ser:verifyTimeStampResponse>
</soapenv:Body>
</soapenv:Envelope>
The response will be a list of complex objects: "TimestampReportBean" described in this section
Verify Certificate
For verify the certificate, you can use the method "verifyCertificate", like in this example:
Request
Fields
Field name | Description | IN/OUT | Mandatory |
---|
certificate | base64 encoded certificate | IN | ✔️ |
An example xml request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.ws.nam/">
<soapenv:Header/>
<soapenv:Body>
<ser:verifyCertificate>
<certificate>BASE_64_OF_CERTIFICATE</certificate>
</ser:verifyCertificate>
</soapenv:Body>
</soapenv:Envelope>
In output will obtain a complex object "CertificateReportBean" described in this link
An example output can be found below:
Response
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:verifyCertificateResponse xmlns:ns2="http://service.ws.nam/">
<return>
<issuerRevoked>false</issuerRevoked>
<issuerValid>false</issuerValid>
<subjectRevoked>false</subjectRevoked>
<subjectValid>true</subjectValid>
<trusted>false</trusted>
</return>
</ns2:verifyCertificateResponse>
</soap:Body>
</soap:Envelope>