Dešifrování dat pomocí certifikátu

Webová služba umožňuje dešifrovat data (např. z emailu) pomocí vybraného certifikátu z HSM služby Vzdáleného podepisování/pečetění. Tuto metodu využívá aplikace eToken, která je distribuována v rámci aplikace Signer i samostatně.

Název metody: Decrypt

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

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

<?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>
    <Decrypt xmlns="http://software602.com/secusign/">
      <CertificateID>string</CertificateID>
      <CertificatePIN>string</CertificatePIN>
      <EncryptedData>base64Binary</EncryptedData>
      <Params>string</Params>
    </Decrypt>
  </soap:Body>
</soap:Envelope>

Vstupní parametry metody

<CertificateID>

[povinný element]

Vstup Popis

String

Identifikace certifikátu pro dešifrování dat.

<CertificatePIN>

[povinný element]

Vstup Popis

String

PIN, který byl zvolen žadatelem jako přístupové heslo k privátní části certifikátu.

<EncryptedData>

[povinný element]

Vstup Popis

String

Base64 zakódovaná data, která byla šifrována pomocí zvoleného certifikátu.

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>
    <DecryptResponse xmlns="http://software602.com/secusign/">
      <DecryptResult>int</DecryptResult>
      <DecryptedData>base64Binary</DecryptedData>
      <StatusMessage>string</StatusMessage>
    </DecryptResponse>
  </soap:Body>
</soap:Envelope>

Výstupní parametry metody

<DecryptResult>

Návratová hodnota Popis

int

Výsledek metody Decrypt (dešifrování dat pomocí certifikátu). 0 = v pořádku, jinak Návratové kódy všech metod a chyba popsaná ve StatusMessage.

<DecryptedData>

Návratová hodnota Popis

Base64Binary

Base64 zakódovaná data, která byla dešifrována pomocí zvoleného certifikátu.

<StatusMessage>

Návratová hodnota Popis

String

Textová zpráva odpovídající celkovému výsledku získání pečeti/podpisu k hash. Hodnota je naplněna pouze v případě problematického výsledku.