Metoda pro dávkové podepisování

Webová služba umožňuje dávkové podepisování. V této metodě je třeba předat seznam souborů a jejich hash. Hash je možné vygenerovat pomocí SignHash metody. Po potvrzení podpisu dávky uživatelem v aplikaci 602Key se vytvoří podpisový token, který se předává místo PIN ve volání metod Seal a SignHash. Token se metodám předává ve formátu Token: [hodnota vrácená CreateSigningToken]. Při podepisování s využitím podpisového tokenu se kromě obecných vracejí specifické chybové kódy:

  • 132 (BATCH_SIGN_TOO_MANY_FILES) – Překročen maximální povolený počet souborů pro dávkové podepsání.

  • 133 (BATCH_SIGN_CHECK_FAILED) – Pokus o dávkový podpis souboru, který do dávky nepatří.

  • 134 (BATCH_SIGN_TIMEOUT) – Platnost signing tokenu pro dávkový podpis vypršela.

Název metody: CreateSigningToken

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=CreateSigningToken.

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).

Vstupní parametry metody

<CertificateID>

[povinný element]

Vstup Popis

String

Identifikace certifikátu pro podepsání/pečetění.

  • U certifikátu musí být nastavena autorizace pomocí 602Key.

<Hash>

[povinný element]

Vstup Popis

Base64Binary

  • Jedná se o kódovaný binár hashe souboru base64.

  • Soubor je nejdříve nutné převést do SHA256 hash formátu.

  • Soubor ve formátu SHA256 je nutné převést z hexadecimálního formátu do binárního.

  • Soubor v binárního formátu je dále nutné převést do Base64 formátu a ten lze použít jako vstupní hodnota pro metodu CreateSigningToken.

<SignedFileInfo>

[povinný element]

Vstup Popis

String

Pole struktur SignedFileInfo s informacemi o podepisovaných souborech a jejich hash. Maximální počet souborů v dávce je 100.

<Params>

[povinný element]

Vstup Popis

String

Volitelné parametry. Středníkem oddělený seznam klíč=hodnota. Podporované parametry: id_transaction – ID transakce dávkového podepisování. Umožňuje volající aplikaci dodat si vlastní ID, např. kvůli propojení s jejími logy.

<Token>

[nepovinný element]

Vstup Popis

String

Výstupní parametr. Vytvořený podpisový token. Platnost tokenu je omezena na 60 minut, poté se při pokusu o jeho využití vrací chyba 134 (BATCH_SIGN_TIMEOUT).

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/CreateSigningToken"

<?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>
    <CreateSigningToken xmlns="http://software602.com/secusign/">
      <CertificateID>string</CertificateID>
      <FileInfo>
        <SignedFileInfo>
          <FileName>string</FileName>
          <Hash>base64Binary</Hash>
          <HashAlgorithm>string</HashAlgorithm>
        </SignedFileInfo>
        <SignedFileInfo>
          <FileName>string</FileName>
          <Hash>base64Binary</Hash>
          <HashAlgorithm>string</HashAlgorithm>
        </SignedFileInfo>
      </FileInfo>
      <Params>string</Params>
    </CreateSigningToken>
  </soap:Body>
</soap:Envelope>

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>
    <CreateSigningTokenResponse xmlns="http://software602.com/secusign/">
      <CreateSigningTokenResult>int</CreateSigningTokenResult>
      <Token>string</Token>
      <StatusMessage>string</StatusMessage>
    </CreateSigningTokenResponse>
  </soap:Body>
</soap:Envelope>

Výstupní parametry metody

Návratová hodnota Popis

String

Výstupní parametr. Podrobnosti v případě, že metoda skončí chybou.