Získání dat certifikátu pro vložení pečeti/podpisu

Metoda webové služby GetCertificate je určena volajícím aplikacím pro získání dat certifikátu a přípravu datového prostoru k vložení získaného podpisu/pečeti, např. do dat PDF nebo XML souboru.

V případě vzdáleného pečetění není nutné ve volání metody specifikovat UserID, CertificateID a Params.

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://rsmtest.secusign.eu/Core.asmx?op=GetCertificate.

Struktura požadavku v rozhraní SOAP 1.1

POST /Core.asmx HTTP/1.1
Host: rsmtest.secusign.eu
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://software602.com/secusign/GetCertificate"

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

Vstupní parametry metody

<UserID>
[nepovinný element]

Vstupní hodnota Popis

String

Identifikace uživatele certifikátu, pokud není basic autentizován.

<CertificateID>
[povinný element]

Vstupní hodnota Popis

String

Identifikace certifikátu pro získání dat a přípravu k vložení kvalifikované/zaručené elektronické pečeti nebo kvalifikovaného/zaručeného elektronického podpisu.

<Params>
[nepovinný element]

Vstupní hodnota Popis

String

Nepovinné, aktuálně se nevyužívá.

Struktura odpovědi v rozhraní SOAP 1.1

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

Výstupní parametry metody

<GetCertificateResult>

Návratová hodnota Popis

String

Výsledek metody GetCertificate (získání dat certifikátu). 0 = v pořádku, jinak dojde k chybě popsané ve StatusMessage.

<X509Certificate>

Návratová hodnota Popis

String

Base64 Data certifikátu ve formátu X509.

<StatusMessage>

Návratová hodnota Popis

String

Obsahuje podrobnější popis chyby v případě, že dojde k problému

Příklad volání

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sec="http://software602.com/secusign/">
   <soapenv:Header/>
   <soapenv:Body>
      <sec:GetCertificate>
         <!--Optional:-->
         <sec:UserID>012345</sec:UserID>
         <!--Optional:-->
         <sec:CertificateID>abcdef01-2345-6780-abcd-e012345678ab</sec:CertificateID>
         <!--Optional:-->
         <sec:Params/>
      </sec:GetCertificate>
   </soapenv:Body>
</soapenv:Envelope>