Služba razítkování

Služba umožňuje opatřit vstupní dokument (data) kvalifikovaným časovým razítkem. Časovým razítkem lze opatřit pouze ty dokumenty (data), které obsahují elektronický podpis/pečeť. U souborů typu PDF je možné kvalifikovaným časovým razítkem opatřit i nepodepsané dokumenty.

Kvalifikované časové razítko je odebíráno pomocí autentizačního certifikátu, nebo basic autentizací (jméno/heslo), z URI poskytovatele časových razítek, které je definováno v konfiguraci SecuSign SDK.

Výchozí konfigurace SecuSign SDK získává kvalifikované časové razítko QTSP PostSignum z uživatelského 602 ID účtu, u kterého je nastaven licenční certifikát SecuSign SDK.

Název metody: Timestamp

Popis služby včetně WSDL schématu a příklad požadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na https://localhost/secusign/default.asmx?op=Timestamp.

Localhost je název používaný pro lokální počítač; namísto něj zvolte jméno/IP adresu SDK serveru (dle nastavení v IIS).

Požadavek v rozhraní SOAP 1.1

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>

Vstupní parametry metody

<FileName>

[povinný element]

Vstup Popis

string

Název vstupního souboru (včetně přípony), který bude opatřen kvalifikovaným časovým razítkem.

Příklad: Dokument.pdf

Max. 260 znaků.

<Input>

[povinný element]

Vstup Popis

Base64Binary

Data vstupního souboru kódovaná v base64.

<ExternalSignature>

[nepovinný element]

Vstup Popis

Base64Binary

Data externího podpisu kódovaná v base64, pokud je chtěno připojit razítko k externímu podpisu.

<FileType>

[povinný element]

Typ podepisovaného dokumentu nebo dat

Vstup

Popis

UNKNOWN

Neznámý typ dokumentu.

CMSPKCS7

Dokument podepsaný interním CMS/PKCS7 podpisem např.: Datové zprávy z Informačního systému datových schránek.

CMSPKCS7Ext

Dokument podepsaný externím CMS/PKCS7 podpisem např.: Datové zprávy z Informačního systému datových schránek.

PDF

PDF dokument.

XML

Podepsaná XML data.

XML602FORM

FO/ZFO formuláře aplikace Software602 Form Filler.

XMLISDOC

Podepsaná XML ISDOC data.

ASiC_S_CAdES

ASiC-Simple s CAdES podpisem.

ASiC_S_XAdES

ASiC-Simple s XAdES podpisem.

ASiC_S_Tst

ASiC-Simple s Timestamp.

ASiC_E_CAdES_Tst

ASiC-Extended s CAdES podpisem nebo s Timestamp.

ASiC_E_XAdES

ASiC-Extended s XAdES podpisem.

MS_WORD

Podepsaný dokument aplikace MS Word.

MS_EXCEL

Podepsaný dokument aplikace MS Excel.

MS_PWR_PNT

Podepsaný dokument aplikace MS Powerpoint.

ODF

Podepsaný OpenDocumentFormat (OpenOffice).

<ForRegistration>

[povinný element]

Vstup Popis

String

Parametr pro získání odpovídajícího razítka. Možné hodnoty:

  • False – standardní kvalifikované časové razítko.

  • True – přípravné kvalifikované časové razítko (pro následnou registraci k uchování dokumentu).

Výchozí hodnota: false

<Params>

[nepovinný element]

Vstup Popis

String

Volitelné, obsahuje další parametry. Zatím se nevyužívá.

Struktura odpovědi na požadavek

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>

Výstupní parametry metody

<TimestampResult>

Návratová hodnota Popis

int

Výsledek metody Timestamp (orazítkování dokumentu). 0 = v pořádku, jinak Návratové kódy všech metod a chyba popsaná ve StatusMessage.

<Output>

Návratová hodnota Popis

base64Binary

Výstupní data orazítkovaného dokumentu kódovaná v Base64.

<StatusMessage>

Návratová hodnota Popis

String

Textová zpráva odpovídající celkovému výsledku orazítkování dokumentu. Hodnota je naplněna pouze v případě problematického výsledku.