Název metody: ListCerts2

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

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

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

Vstupní parametry metody

Stejné jako u metody ListCerts.

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

Výstupní parametry metody

Stejné jako u metody ListCerts s tím rozdílem, že se vrací ListCerts2Result a PKCS11CertInfo2, a v rámci PKCS11CertInfo2 je navíc element:

<AuthMode>

Návratová hodnota Popis

String

Zabezpečení přístupu k uživatelskému certifikátu. Hodnoty:

  • PIN – uživatelským heslem (zvoleným při generování žádosti nebo poslední změně).

  • 602KEY – druhým faktorem přes mobilní aplikaci 602®Key (zvoleným při nastavení ve správcovské aplikaci – typicky Sofa).

V případě, že je u certifikátu nastaveno zabezpečení 602KEY, pak při podepsání certifikátem s tímto zabezpečením je zapotřebí ve volající aplikaci zobrazit dialog, který informuje uživatele o nutnosti potvrzení v mobilní aplikaci 602®Key, a s vhodným timeout (např. 1 minuta) vyčkat na odpověď služby.

Pro potvrzování pomocí 602KEY je potřebné mít nastavenou vhodnou adresu webové služby HSM WS, viz Konfigurace.