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

Metoda webové služby GetCertificate slouží 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.

Dostupnost metody ve webové definici je závislá na verzi webové služby SecuSign SDK (viz Konfigurace).

Název metody: GetCertificate

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

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/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/">
      <CertificateID>string</CertificateID>
      <Params>string</Params>
    </GetCertificate>
  </soap:Body>
</soap:Envelope>

Vstupní parametry metody

<CertificateID>

[povinný element]

Vstup Popis

String

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

V případě in-house rozhraní SecuSign SDK je možné použít formáty:

  • prázdný řetězec

  • pokud je v konfiguraci webové služby nastaven konfigurační klíč Seal_DefaultToQStore, pak se použije výchozí certifikát ze služby Vzdáleného pečetění.

Výchozí hodnota: prázdný řetězec

<Params>

[nepovinný element]

Vstup Popis

String

Nepovinné, aktuálně 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>
    <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

Int

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

<X509Certificate>

Návratová hodnota Popis

Base64Binary

Base64 Data certifikátu ve formátu X509.

<StatusMessage>

Návratová hodnota Popis

String

Textová zpráva odpovídající celkovému výsledku získání dat certifikátu. Hodnota je naplněna pouze v případě problematického výsledku.