The timestamping service

The service allows to attach a qualified time stamp to an input document (data). A time stamp can only be provided for the documents (data) that contain an electronic signature/seal. For PDF files, it is possible to attach a qualified time stamp even to unsigned documents.

The qualified time stamp is drawn using an authentication certificate or basic authentication (name/password) from the time stamp provider’s URI specified in SecuSign SDK configuration.

The default SecuSign SDK configuration receives a qualified PostSignum QTSP time stamp from a 602 ID user account where SecuSign SDK license certificate is set.

Method name: Timestamp

Service description including WSDL schema, and an example request and response for SOAP 1.1 and SOAP 1.2 are located at https://localhost/secusign/default.asmx?op=Timestamp.

Localhost is the name used for the local computer; write the SDK server name/IP address instead (according to the settings in IIS).

Request in SOAP 1.1 interface

POST /secusign/default.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://software602.com/secusign/Timestamp"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Timestamp xmlns="http://software602.com/secusign/">
      <FileName>string</FileName>
      <Input>base64Binary</Input>
      <ExternalSignature>base64Binary</ExternalSignature>
      <FileType>UNKNOWN or CMSPKCS7 or CMSPKCS7Ext or PDF or XML or XML602FORM or XMLISDOC or ASiC_S_CAdES or ASiC_S_XAdES or ASiC_S_Tst or ASiC_E_CAdES_Tst or ASiC_E_XAdES or MS_WORD or MS_EXCEL or MS_PWR_PNT or ODF</FileType>
      <ForRegistration>boolean</ForRegistration>
      <Params>string</Params>
    </Timestamp>
  </soap:Body>
</soap:Envelope>

Input parameters of the method

<FileName>

[mandatory element]

Input Description

string

Name of input file (including extension) to be provided with a qualified time stamp. Example: Document.pdf.

Max. 260 characters.

<Input>

[mandatory element]

Input Description

Base64Binary

Input file data encoded in base64

<ExternalSignature>

[optional element]

Input Description

Base64Binary

External signature data encoded in base64, if the time stamp is to be attached to an external signature.

<FileType>

[mandatory element]

Type of document or data to be signed

Input

Description

UNKNOWN

Unknown document type

CMSPKCS7

Document signed with an internal CMS/PKCS7 signature, e.g. Data messages from the Data Mailbox Information System.

CMSPKCS7Ext

Document signed with an external CMS/PKCS7 signature, e.g. Data messages from the Data Mailbox Information System.

PDF

Signed PDF document.

XML

Signed XML data.

XML602FORM

FO/ZFO forms for Software602 Form Filler.

XMLISDOC

Signed XML ISDOC data.

ASiC_S_CAdES

ASiC-Simple with CAdES signature.

ASiC_S_XAdES

ASiC-Simple with XAdES signature.

ASiC_S_Tst

ASiC-Simple with Timestamp.

ASiC_E_CAdES_Tst

ASiC-Extended with CAdES signature or Timestamp.

ASiC_E_XAdES

ASiC-Extended with XAdES signature.

MS_WORD

Signed MS Word document.

MS_EXCEL

Signed MS Excel document.

MS_PWR_PNT

Signed MS PowerPoint document.

ODF

Signed OpenDocumentFormat (OpenOffice).

<ForRegistration>

[mandatory element]

Input Description

String

Parameter to get the corresponding time stamp. Possible values:

  • False – standard qualified time stamp.

  • True – preliminary time stamp (to be followed by registration to preserve the document).

  • Default value: false.

<Params>

[optional element]

Input Description

String

Optional, contains other parameters. Not in use yet.

Response structure

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TimestampResponse xmlns="http://software602.com/secusign/">
      <TimestampResult>int</TimestampResult>
      <Output>base64Binary</Output>
      <StatusMessage>string</StatusMessage>
    </TimestampResponse>
  </soap:Body>
</soap:Envelope>

Output parameters of the method

<TimestampResult>

Return value Description

int

Result of the Timestamp method (document timestamping).

0 = OK, otherwise see Return codes of all methods and error described in StatusMessage.

<Output>

Return value Description

base64Binary

Output data of the timestamped file encoded in Base64.

<StatusMessage>

Return value Description

String

Text statement corresponding to the overall result of document timestamping. The value is only filled if the result is complicated.