# Webová služba Certificate verze 3.0.0 (Obecné webové služby) - popis rozhraní služby

Marbes Consulting s.r.o.

EOS4

Vygenerováno z verze 4.21.0.19.0.

Podmínky omezující zveřejnění

Autorem tohoto dokumentu je společnost MARBES CONSULTING s.r.o. Dokument obsahuje informace důvěrného charakteru a ve smyslu definice autorského práva (viz § 2, odst. 1 Zákona č. 121/2000 Sb., zákon o právu autorském) je duševním vlastnictvím autora a předmětem práva autorského. Dokument smí být použit výhradně za účelem, za kterým byl poskytnut a nesmí být bez předchozího souhlasu autora citován, kopírován, vytěžován1 nebo předán třetí fyzické či právnické osobě.

© 2009 MARBES CONSULTING s.r.o.

1 Vytěžováním se podle zákona č. 121/2000 Sb. rozumí trvalý nebo dočasný přepis celého obsahu nebo jeho podstatné části na jiný podklad, a to jakýmikoli prostředky nebo jakýmkoli způsobem.

## Obsah

- Obecné informace
- Seznam poskytovaných metod
- Seznam struktur dat
- Výjimky
- Popis poskytovaných metod
- Popis struktur dat

## Obecné informace

Webová služba pro správu certifikátů v EOS.

## Seznam poskytovaných metod

Název | Popis
--- | ---
importCertificateInfo | Metoda pro aktualizaci nebo import certifikátů do EOS.
isCertificateImportEnable | Zjistí, jestli je povolen import certifikátů přes webovou službu.

## Seznam struktur dat

Název | Popis
--- | ---
EosCertificate | WS objekt certifikátu se základními údaji o certifikátu.
EosCertificates | Objekt obsahuje seznam certifikátů.

## Výjimky

### EosCertificateImportDisabledException

Výjimka vyvolána, pokud je vyvolána služba importu certifikátů, i když je zakázán v nastavení.

### EosInternalException

Neočekávaná výjimka při volání webových služeb.

### EosObjectNotFoundException

Objekt nebyl nalezen.

## Popis poskytovaných metod

### importCertificateInfo

Metoda pro aktualizaci nebo import certifikátů do EOS. Pro správnou funkci metody musí být v EOS nastavení povolen import certifikátů!
Certifikáty jsou porovnávány podle uniqueKey klíče.

- Pokud je certifikát v databázi, proběhne pouze aktualizace počtu dní k upozornění před vypršením platnosti.
- Pokud certifikát v databázi ještět není, je vytvořen ze získaných dat a jeho správci jsou ti, kteří jsou určeni v nastavení EOS

#### Předpis

void importCertificateInfo (EosCertificates certificates)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
certificates | EosCertificates | Ano | seznam certifikátů pro aktualizaci / import

#### Výjimky

EosInternalException - vnitřní chyba systému v eos
EosCertificateImportDisabledException - pokud není povolen import certifikátů
EosObjectNotFoundException - pokud není nalezena osoba certifikátu v EOS

### isCertificateImportEnable

Zjistí, jestli je povolen import certifikátů přes webovou službu. Import certifikátů se nastavuje v obecném nastavení EOSU.

#### Předpis

boolean isCertificateImportEnable ()

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---

#### Výstup

boolean - true, pokud je import povolen, jinak false

#### Výjimky

EosInternalException - vnitřní chyba systému v eos

## Popis struktur dat

### EosCertificate

WS objekt certifikátu se základními údaji o certifikátu.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
name | String | Ne | Název certifikátu.
validFrom | Date | Ne | Datum, od kterého (včetně) je certifikát platný.
validTo | Date | Ne | Datum, do kterého (včetně) je certifikát platný.
certificateFileName | String | Ne | Soubor certifikátu.
certificatePersonId | String | Ne | Osoba přiřazená k certifikátu.
uniqueKey | String | Ne | Unikátní klíč certifikátu.

### EosCertificates

Objekt obsahuje seznam certifikátů.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
certificate | List<EosCertificate> | Ne | Seznam certifikátů.