Získání vlastností certifikátů

Metoda webové služby GetCertProperty umožňuje volající aplikaci získat vlastnosti daného HSM certifikátu.

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

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

Struktura požadavku 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/GetCertProperty"

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

Vstupní parametry metody

<OrganizationID>

[nepovinný element]

Vstupní hodnota Popis

String

Identifikace organizace uživatele certifikátu. Bylo dodáno zákazníkovi při implementaci služby Vzdáleného pečetění/podepisování.

V případě neuvedení se pro identifikaci organizace využije informací z autentizace.

<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, jehož vlastnost chceme získat.

<PropertyName>

[nepovinný element]

Vstupní hodnota Popis

String

Název hledané vlastnosti. Možné hodnoty: status a authmode.

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

Výstupní parametry metody

<GetCertPropertyResult>

Návratová hodnota Popis

String

Výsledek metody GetCertProperty (získání vlastnosti certifikátů). 0 = v pořádku, jinak chyba. Viz StatusMessage.

<PropertyValue>

Návratová hodnota Popis

String

Výstupní parametr. Hodnota požadované vlastnosti certifikátu.

<StatusMessage>

Návratová hodnota Popis

String

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