Získání seznamu certifikátů

Metoda webové služby ListCerts umožňuje volající aplikaci získat seznam certifikátů daného uživatele. V případě vzdáleného pečetění není volání potřebné.

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

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

<?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>
    <ListCerts xmlns="http://software602.com/secusign/">
      <OrganizationID>string</OrganizationID>
      <UserID>string</UserID>
      <Params>string</Params>
    </ListCerts>
  </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.

<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>
    <ListCertsResponse xmlns="http://software602.com/secusign/">
      <ListCertsResult>int</ListCertsResult>
      <CertList>
        <CertInfo>
          <Alias>string</Alias>
          <X509CertData>base64Binary</X509CertData>
          <Status>string</Status>
        </CertInfo>
        <CertInfo>
          <Alias>string</Alias>
          <X509CertData>base64Binary</X509CertData>
          <Status>string</Status>
        </CertInfo>
      </CertList>
      <StatusMessage>string</StatusMessage>
    </ListCertsResponse>
  </soap:Body>
</soap:Envelope>

Výstupní parametry metody

<ListCertsResult>

Návratová hodnota Popis

String

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

<CertList>

Pole se seznamem uživatelových certifikátů obsahující:

<PKCS11CertInfo>

Informace o certifikátu

<Alias>

Návratová hodnota Popis

String

Alias neboli CertificateID uživatelského certifikátu v GUID formátu.

<X509CertData>

Návratová hodnota Popis

Base64Binary

Base64 Data certifikátu ve formátu X509.

<Status>

Návratová hodnota Popis

String

Stav uživatelského certifikátu. Hodnoty:

  • ENABLED – povolený, lze použít.

  • DISABLED – zakázaný, nelze použít.

  • REVOKED – odvolaný, nelze použít.

  • EXPIRED – vypršelý, nelze použít.

<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:ListCerts>
         <!--Optional:-->
         <sec:OrganizationID>12345678-abcd-ef01-2345-678abcdef012</sec:OrganizationID>
         <!--Optional:-->
         <sec:UserID>012345</sec:UserID>
         <!--Optional:-->
         <sec:Params/>
      </sec:ListCerts>
   </soapenv:Body>
</soapenv:Envelope>