<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="cs">
	<id>https://prirucky.ksprogram.cz/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Wikisysop</id>
	<title>Prirucky - Příspěvky [cs]</title>
	<link rel="self" type="application/atom+xml" href="https://prirucky.ksprogram.cz/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Wikisysop"/>
	<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Speci%C3%A1ln%C3%AD:P%C5%99%C3%ADsp%C4%9Bvky/Wikisysop"/>
	<updated>2026-10-16T23:38:16Z</updated>
	<subtitle>Příspěvky</subtitle>
	<generator>MediaWiki 1.37.2</generator>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Slu%C4%8Dov%C3%A1n%C3%AD_u%C5%BEivatel%C5%AF&amp;diff=44623</id>
		<title>Slučování uživatelů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Slu%C4%8Dov%C3%A1n%C3%AD_u%C5%BEivatel%C5%AF&amp;diff=44623"/>
		<updated>2023-03-07T10:07:09Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Slučování uživatelů''&lt;br /&gt;
[[Image: Slucovani uzivatelu.png|700px|right]]&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Systém &amp;gt; Správa uživatelů &amp;gt; Slučování uživatelů &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;Název okna: Sloučení uživatelských účtů &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!-- [[Image: Slucovani uzivatelu priklad 1.png|250px]] --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Image: Slucovani uzivatelu-Moznosti slouceni.png|350px]]&lt;br /&gt;
&lt;br /&gt;
Okno Sloučení uživatelských účtů prohledá seznam všech uživatelů, kteří jsou v databázi uložení (i historicky), a pro případy, kdy se názvy uživatelů překrývají, nabídne možnost jejich sloučení. (Jinak řečeno, vyhledá různé tvary přihlašovacího jména (loginu) potencionálně téhož uživatele a nabídne jejich sloučení pod jeden obsluhou zvolený tvar.)&lt;br /&gt;
&lt;br /&gt;
Tuto utilitu lze použít v případech, kdy jsou v databázi historicky uživatelé zavedení s jinou velikostí písmen nebo s běžným lomítkem místo zpětného. &lt;br /&gt;
&lt;br /&gt;
Tuto utilitu aktuálně NELZE použít pro převod loginů s doménou na loginy bez domény nebo naopak! Nelze použít ani pro hromadný převod (obsluha u každého řádku vybírá požadovaný tvar), pro hromadný převod loginů na nový tvar dle předem připraveného TXT souboru lze použít funkcionalitu [[Hromadné přečíslování (jednorázová funkce 34)]].&lt;br /&gt;
&lt;br /&gt;
Při slučování dojde ke spojení všech přístupových práv slučovaných uživatelů cílovému uživateli. Řeší se tím stavy, kdy je uživatel evidován v databázi vícekrát a pokaždé má přidělena jiná práva.&lt;br /&gt;
&lt;br /&gt;
V některých případech je možné, že se slučování nezdaří a zobrazí se chybová hláška. V takových případech je nutné uživatelům, kteří mají být sloučeni pod jiného uživatele, odebrat všechna přístupová práva (na moduly i osobní čísla) a následně spustit slučování znova.&lt;br /&gt;
&lt;br /&gt;
Na závěr se zobrazí některá ze tří hlášení o tom, že:&lt;br /&gt;
# sloučení se nezdařilo&lt;br /&gt;
# sloučení se zdařilo částečně&lt;br /&gt;
# sloučení proběhlo beze zbytku a původní uživatelé byli zcela přepsáni.&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Systémová příručka]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Slu%C4%8Dov%C3%A1n%C3%AD_u%C5%BEivatel%C5%AF&amp;diff=44622</id>
		<title>Slučování uživatelů</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Slu%C4%8Dov%C3%A1n%C3%AD_u%C5%BEivatel%C5%AF&amp;diff=44622"/>
		<updated>2023-03-07T09:38:53Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Slučování uživatelů''&lt;br /&gt;
[[Image: Slucovani uzivatelu.png|700px|right]]&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Systém &amp;gt; Správa uživatelů &amp;gt; Slučování uživatelů &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;Název okna: Sloučení uživatelských účtů &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!-- [[Image: Slucovani uzivatelu priklad 1.png|250px]] --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Image: Slucovani uzivatelu-Moznosti slouceni.png|350px]]&lt;br /&gt;
&lt;br /&gt;
Okno Sloučení uživatelských účtů prohledá seznam všech uživatelů, kteří jsou v databázi uložení (i historicky), a pro případy, kdy se názvy uživatelů překrývají, nabídne možnost jejich sloučení. (Jinak řečeno, vyhledá různé tvary přihlašovacího jména (loginu) potencionálně téhož uživatele a nabídne jejich sloučení pod jeden obsluhou zvolený tvar.)&lt;br /&gt;
&lt;br /&gt;
Tuto utilitu lze použít v případech, kdy jsou v databázi historicky uživatelé zavedení s jinou velikostí písmen nebo s běžným lomítkem místo zpětného. &lt;br /&gt;
&lt;br /&gt;
Tuto utilitu aktuálně NELZE použít pro převod loginů s doménou na loginy bez domény nebo naopak! Nelze použít ani pro hromadný převod (obsluha u každého řádku vybírá požadovaný tvar).&lt;br /&gt;
&lt;br /&gt;
Při slučování dojde ke spojení všech přístupových práv slučovaných uživatelů cílovému uživateli. Řeší se tím stavy, kdy je uživatel evidován v databázi vícekrát a pokaždé má přidělena jiná práva.&lt;br /&gt;
&lt;br /&gt;
V některých případech je možné, že se slučování nezdaří a zobrazí se chybová hláška. V takových případech je nutné uživatelům, kteří mají být sloučeni pod jiného uživatele, odebrat všechna přístupová práva (na moduly i osobní čísla) a následně spustit slučování znova.&lt;br /&gt;
&lt;br /&gt;
Na závěr se zobrazí některá ze tří hlášení o tom, že:&lt;br /&gt;
# sloučení se nezdařilo&lt;br /&gt;
# sloučení se zdařilo částečně&lt;br /&gt;
# sloučení proběhlo beze zbytku a původní uživatelé byli zcela přepsáni.&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Systémová příručka]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=SC-Vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD&amp;diff=44604</id>
		<title>SC-Vyúčtování</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=SC-Vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD&amp;diff=44604"/>
		<updated>2023-02-28T15:30:10Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Vyúčtování služební cesty'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Evidence/Služební cesty/Cestovní příkazy - záložka Vyúčtování&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Záložka Vyúčtování slouží k sesumírování jednotlivých nákladů a záloh služební cesty, vyčíslení částky k výplatě nebo k inkasu a volbě způsobu proplacení.&lt;br /&gt;
&lt;br /&gt;
== Postup ==&lt;br /&gt;
# Kliknout na záložku Vyúčtování. [[Image: Sc-vyuctovani-priklad-1-pred.png|50px]]&lt;br /&gt;
# Zvolit měnu vyrovnání.&lt;br /&gt;
# Stisknout tlačítko '''''Přepočti'''''.&lt;br /&gt;
# Zvolit způsob proplacení. [[Image: Sc-vyuctovani-priklad-1-zvolit-zpusob-proplaceni.png|50px]]&lt;br /&gt;
# Uložit. [[Image: Sc-vyuctovani-priklad-1-po-ulozeni.png|50px]]&lt;br /&gt;
&lt;br /&gt;
== Volby a editační položky ==&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-1-pred.png|right|800px]]&lt;br /&gt;
=== Vyrovnání v měně ===&lt;br /&gt;
* '''''Vše v tuzemské měně''''' - všechny zálohy a výdaje se přepočtou na tuzemskou měnu a vznikne 1 řádek&lt;br /&gt;
* '''''Nepřevádět na jinou měnu''''' - za každou měnu zálohy či výdaje vznikne samostaný řádek a každou měnu lze proplatit jiným způsobem&lt;br /&gt;
* '''''Přeplatek v měně zálohy, doplatek v tuz. měně''''' - vznikne-li přeplatek z důvodu zálohy, zůstane přeplatek v měně zálohy, vznikne-li doplatek, převede se na tuzemskou měnu&lt;br /&gt;
&lt;br /&gt;
=== Přepočti ===&lt;br /&gt;
Na základě předchozí volby se vygeneruje 1 nebo více řádků s částkou k výplatě nebo k inkasu a volbě způsobu proplacení.&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-1-po-ulozeni.png|right|800px]]&lt;br /&gt;
&lt;br /&gt;
=== Do období ===&lt;br /&gt;
Předvyplní se aktuální mzdové období. Je možno posunout na následující období, pokud se má přeplatek/nedoplatek vyplatit/srazit až v následujícím období. Má efekt jen při způsobu proplacení &amp;quot;ve mzdě&amp;quot;&lt;br /&gt;
[[Image: Sc-vyuctovani-do-mzdy-volba-obdobi.png|150px]]&lt;br /&gt;
&lt;br /&gt;
=== K výplatě/k inkasu ===&lt;br /&gt;
Automaticky vypočtenou částku je možno upravit, ale preferována je korekce přes řádek ve výdajích a v případě nespokojenosti se zaokrouhlováním nastavit požadavovaný způsob zaokrouhlování přes parametr slc_zaok_vyuct. Způsob zaokrohlování je popsán zde [[Výpočty_(Služební_cesty)#Zaokrouhlování_konečného_vyúčtování]]&lt;br /&gt;
&lt;br /&gt;
=== Způsob proplacení ===&lt;br /&gt;
Možné hodnoty &lt;br /&gt;
* '''''v hotovosti'''''&lt;br /&gt;
*  '''''ve mzdě''''' - zaměstnanci se vygeneruje záznam na příslušnou mzdovou položku až v rámci výpočtu mzdy (ne ihned).&lt;br /&gt;
* '''''na účet''''' - následný hromadný příkaz k úhradě vytvoříte v sestavě [[SC-Sestavy-Na účet|Na účet]]&lt;br /&gt;
&lt;br /&gt;
=== Nákladové středisko ===&lt;br /&gt;
[[Image: Sluzcesta-vyuctovani-hlaska-nakladove-stredisko-neni-pracovni.png|thumb|right|Upozornění na změnu nákl. střediska]]&lt;br /&gt;
Možnost určit jiné [[nákladové středisko]], než je středisko zaměstnance. Tuto možnost má i zadavatel služební cesty na portále v části [[Výdaje (služební cesta)]]. Pokud tam stanoví jiné středisko než je standardní (pracovní středisko), dojde zde k zobrazení informativní hlášky.&lt;br /&gt;
&lt;br /&gt;
=== Změnit stav na ===&lt;br /&gt;
Možnost změnit stav je pro případ cestovního příkazu vzniklého z procesu požadavků. Nabízí se výběr stavů z následujícího kroku vzhledem k aktuálnímu kroku, v němž je požadavek. Pokud se služební cesta nachází v kroku, ve kterém se nabízí workflow stav s názvem '''''vyuctovano''''', je tento stav automaticky předvyplněn po stisknutí tlačítka Přepočti.&lt;br /&gt;
&lt;br /&gt;
=== Uložení ===&lt;br /&gt;
Po stisknutí tlačítka Uložit v horní liště dojde k uložení vyúčtování a pokud je vybrán workflow stav (uživatelem nebo systémem), pak systém provede změnu stavu požadavku spolu s těmi akcemi, které k tomu přísluší (přechod do dalšího kroku, emailové notifikace).&lt;br /&gt;
Po uložení vyúčtování jsou doplněny údaje:&lt;br /&gt;
* ''Vyúčtování provedl''&lt;br /&gt;
* ''Dne''&lt;br /&gt;
* ''V období''&lt;br /&gt;
&lt;br /&gt;
=== Storno vyúčtování ===&lt;br /&gt;
Vyúčtovaný cestovní příkaz nelze editovat. Pokud je potřeba provést změnu, stiskněte tlačítko '''''Storno vyúčtování''''' a poté proveďte vyúčtování znovu.&lt;br /&gt;
&lt;br /&gt;
Při stornu vyúčtování jsou řádky s částkou již vyplacenou na účet ponechány, aby nebyla ztracena informace o vyplacené částce. Při novém přepočtu je nová částka ponížena o již vyplacenou částku. U řádku s již vyplacenou částkou jsou vynulovány sloupce ''náhrady'', ''zálohy'', aby součet za všechny řádky vyúčtování byl správný.&lt;br /&gt;
[[Image: Sc-storno-vyuctovani-hlaska.png|100px]]&lt;br /&gt;
&lt;br /&gt;
Pokud cestovní příkaz vznikl ze systému požadavků a v právě aktuálním kroku existuje stav s názvem '''''vyucstorno''''', tak je automaticky nastaven tento stav.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Needitační položky ==&lt;br /&gt;
* '''Výběr fi.k.''' - '''[[V (způsob platby)]]'''&lt;br /&gt;
* '''Platby fi.k.''' - '''[[F (způsob platby)]]'''&lt;br /&gt;
* '''Náklady''' - úhrn částek stejně nazvaných sloupců ze záložky ''Výdaje'', přepočtený na tuzemskou měnu&lt;br /&gt;
* '''DPH''' - obdobně jako ''Náklady''&lt;br /&gt;
Napravo od ''způsobu proplacení'' se zobrazuje datum odeslání na účet (respektive datum vytvoření hromadného příkazu).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Zahraniční služební cesta ==&lt;br /&gt;
Pro každý rozdíl zálohy a náhrad v příslušné měně lze zadat rozdílný způsob vyplacení (např. EUR hotově, CZK do mezd). Pro případ, kdy zaměstnanec dostal např. zálohu v EUR a část směnil na RUB a zadal výdaje v RUB, lze u řádku s RUB pomocí rozbalovátka změnit měnu na EUR, vybrat typ kurzu &amp;quot;dle směny&amp;quot; a zadat [[kurzy měn|kurz]], který zaměstnanec doložil. &lt;br /&gt;
&lt;br /&gt;
[[Image: Sc-vyuctovani-zahranicni-priklad-po.png|200px]]&lt;br /&gt;
[[Image: Sc-vyuctovani-zahranicni-priklad-2.png|200px]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Kurzovní lístek ===&lt;br /&gt;
[[Kurzy měn]] jsou uloženy v samostatném číselníku. Při požadavku na převod měny (např. v této záložce ''Vyúčtování'') a v případě, že není nalezen kurz k danému dni, systém provedě automaticky (skrytě) aktualizaci a doplnění údajů do číselníku z internetu.&lt;br /&gt;
&lt;br /&gt;
== Obrázky ==&lt;br /&gt;
Před vyúčtováním - Záložka Vyúčtování (před stisknutím tlačítka Přepočti):&lt;br /&gt;
&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-pred.png|450px]]&lt;br /&gt;
&lt;br /&gt;
Před vyúčtováním - Údaje SC v seznamu cestovních příkazů před vyúčtováním:&lt;br /&gt;
[[Image: Sc-seznam-pred-vyuctovanim.png|450px]]&lt;br /&gt;
&lt;br /&gt;
Po vyúčtování - záložka Vyúčtování s uloženými údaji a provedenou změnou stavu.&lt;br /&gt;
&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-po.png|450px]]&lt;br /&gt;
&lt;br /&gt;
Po vyúčtování - Údaje SC v seznamu cestovních příkazů po vyúčtování&lt;br /&gt;
[[Image: Sc-seznam-po-vyuctovani.png|450px]]&lt;br /&gt;
&lt;br /&gt;
== Kontroly ==&lt;br /&gt;
=== Kontrola na vyúčtování bez dokončení workflow ===&lt;br /&gt;
Výstražné hlášení při vyúčtování CP bez celého workflow. Při vyúčtování probíhá kontrola, zda se uživatel nesnaží vyúčtovat cestu předčasně - pokud ano, zobrazí se hlášení:&lt;br /&gt;
: ''Workflow stav Vyúčtováno nelze nastavit, buď cesta ještě není ve workflow kroku pro vyúčtování, nebo nemáte právo stav měnit!	(Pokud vyúčtování uložíte, nebude mít cesta korespondující workflow stav, ten ale můžete změnit později.)''&lt;br /&gt;
&amp;lt;!-- helpdesk id 31119 – Pavel R – později pro všechny --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Kontrola na neexistenci vozidla v číselníku ===&lt;br /&gt;
Pokud '''SPZ vlastního''' vozidla (zadaného uživatelem v portálu v hlavičce služební cesty) není v číselníku vozidel, je zobrazeno upozornění. &amp;lt;small&amp;gt;Toto upozornění se nezobrazuje v případě, že v číselníku vozidel není naveden žádný záznam - tedy spotřeba je kontrolována u každého cestovního příkazu. &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Image: Vozidlo-neni-v-ciselniku-vozidel.png|450px]]&lt;br /&gt;
&lt;br /&gt;
== Technické detaily ==&lt;br /&gt;
Při přenosu do mezd se berou záznamy, jejichž '''období vyúčtování = aktuální období ve mzdách'''. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt; Pokud je tedy nastaveno období ve mzdách na 2013/02, záznam o služební cestě je vyúčtován dne 13.3.2013, ale v období 2013/02, pak v rámci výpočtu mezd bude zaměstnanci částka proplacena. &lt;br /&gt;
&lt;br /&gt;
V DB tabulce ''sluz_cesty'' jsou rozhodujícím pro proplácení příznaky: zp_vypl = 'm', dále hodnoty v poli ''vyuct_dne'', ''vyuct_castka'', ''nahrady_zvys''. Do zpracovaných mezd do tab. ''pichacky'' se přenese do pole ''c_dokladu'' evidenční číslo cestovního příkazu (např. sluz_cesty.ev_cislo); příznakem přenosu ze služebních cest bude písmeno Y zobrazitelné v agendě [[Zpracování brutto]]. &lt;br /&gt;
&lt;br /&gt;
Pokud se odpovědný uživatel pokusí uložit vyúčtování s proplacením do mezd a jiný uživatel mezitím provede [[měsíční uzávěrka|měsíční závěrku]], zobrazí aplikace upozornění &amp;quot;''Během vaší práce někdo provedl uzávěrku mezd, data nelze uložit, restartujte aplikaci!''&amp;quot; Ovšem toto hlášení neupozorní na situaci, kdy uzávěrka ještě běží. Je doporučeno ošetřit vnitrofiremními mechanismy způsob práce tak, aby nedošlo k současnému zpracovávání obou těchto procesů. V rovině technické lze využít agendu [[Zámek]].&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Různé ==&lt;br /&gt;
* Pokud SC nespadá do aktuálního období - zobrazí se uživateli dotaz, zda má být SC vyúčtována do následujícho období. &lt;br /&gt;
* Zápis do agendy [[Archiv spuštěných výpočtů]] probíhá:&lt;br /&gt;
:: - při způsobu vyplacení částky do mezd&lt;br /&gt;
:: - při generování mzdové položky ([[kod_cest_strav (sk.15)]]) pro krácení stravenek.&lt;br /&gt;
Záznamy se zapisují do období, určeného položkou ''Do období''.&lt;br /&gt;
* '''[[Zámek]]''':&lt;br /&gt;
:: - ''Evidence &amp;gt;&amp;gt; Služební cesty &amp;gt;&amp;gt; Cestovní příkazy'' - zámek na celou agendu&lt;br /&gt;
:: - ''Evidence &amp;gt;&amp;gt; Služební cesty &amp;gt;&amp;gt; Cestovní příkazy &amp;gt;&amp;gt; Vyúčtování'' - zámek pouze na záložku Vyúčtování&lt;br /&gt;
:: - ''Evidence &amp;gt;&amp;gt; Služební cesty &amp;gt;&amp;gt; Cestovní příkazy &amp;gt;&amp;gt; Vyúčt. do akt. obd.'' - zámek, který nedovolí uložit vyúčtování do aktuálního období (vyúčtování do následujícího období je povoleno)&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Archiv spuštěných výpočtů]]&lt;br /&gt;
* [[Služební cesty]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=SC-Vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD&amp;diff=44603</id>
		<title>SC-Vyúčtování</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=SC-Vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD&amp;diff=44603"/>
		<updated>2023-02-28T13:48:13Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Zaokrouhlování (CZ) */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Vyúčtování služební cesty'''&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-1-pred.png|right|800px]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Evidence &amp;gt; Služební cesty &amp;gt; Cestovní příkazy &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Postup ==&lt;br /&gt;
# Kliknout do záložky. [[Image: Sc-vyuctovani-priklad-1-pred.png|50px]]&lt;br /&gt;
# Stisknout tlačítko '''''Přepočti'''''.&lt;br /&gt;
# Zvolit způsob proplacení. [[Image: Sc-vyuctovani-priklad-1-zvolit-zpusob-proplaceni.png|50px]]&lt;br /&gt;
# Uložit. [[Image: Sc-vyuctovani-priklad-1-po-ulozeni.png|50px]]&lt;br /&gt;
&lt;br /&gt;
== Položky ==&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-1-po-ulozeni.png|right|800px]]&lt;br /&gt;
&lt;br /&gt;
* '''Výběr fi.k.''' - '''[[V (způsob platby)]]'''&lt;br /&gt;
* '''Platby fi.k.''' - '''[[F (způsob platby)]]'''&lt;br /&gt;
* '''Náklady''' - úhrn částek stejně nazvaných sloupců ze záložky ''Výdaje'', přepočtený na tuzemskou měnu&lt;br /&gt;
* '''DPH''' - obdobně jako ''Náklady''&lt;br /&gt;
&lt;br /&gt;
=== Způsob proplacení ===&lt;br /&gt;
Možné hodnoty &lt;br /&gt;
* '''''v hotovosti'''''&lt;br /&gt;
*  '''''ve mzdě''''' - zaměstnanci se vygeneruje záznam na příslušnou mzdovou položku až v rámci výpočtu mzdy (ne ihned).&lt;br /&gt;
Při přenosu do mezd se berou záznamy, jejichž '''období vyúčtování = aktuální období ve mzdách'''. &lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt; Pokud je tedy nastaveno období ve mzdách na 2013/02, záznam o služební cestě je vyúčtován dne 13.3.2013, ale v období 2013/02, pak v rámci výpočtu mezd bude zaměstnanci částka proplacena. &lt;br /&gt;
&lt;br /&gt;
V DB tabulce ''sluz_cesty'' jsou rozhodujícím pro proplácení příznaky: zp_vypl = 'm', dále hodnoty v poli ''vyuct_dne'', ''vyuct_castka'', ''nahrady_zvys''. Do zpracovaných mezd do tab. ''pichacky'' se přenese do pole ''c_dokladu'' evidenční číslo cestovního příkazu (např. sluz_cesty.ev_cislo); příznakem přenosu ze služebních cest bude písmeno Y zobrazitelné v agendě [[Zpracování brutto]]. &lt;br /&gt;
&lt;br /&gt;
Pokud se odpovědný uživatel pokusí uložit vyúčtování s proplacením do mezd a jiný uživatel mezitím provede [[měsíční uzávěrka|měsíční závěrku]], zobrazí aplikace upozornění &amp;quot;''Během vaší práce někdo provedl uzávěrku mezd, data nelze uložit, restartujte aplikaci!''&amp;quot; Ovšem toto hlášení neupozorní na situaci, kdy uzávěrka ještě běží. Je doporučeno ošetřit vnitrofiremními mechanismy způsob práce tak, aby nedošlo k současnému zpracovávání obou těchto procesů. V rovině technické lze využít agendu [[Zámek]].&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''Proplacení v budoucím období''' - je možno nastavením volby data - je funkční pouze při volbě ''ve mzdě'' (a není možno volit minulé období - jen aktuální nebo budoucí).&lt;br /&gt;
[[Image: Sc-vyuctovani-do-mzdy-volba-obdobi.png|150px]]&lt;br /&gt;
&lt;br /&gt;
* '''''na účet''''' - následný hromadný příkaz k úhradě vytvoříte v sestavě [[SC-Sestavy-Na účet|Na účet]]&lt;br /&gt;
&lt;br /&gt;
Napravo od ''způsobu proplacení'' se zobrazuje datum odeslání na účet (respektive datum vytvoření hromadného příkazu).&lt;br /&gt;
&lt;br /&gt;
=== Nákladové středisko ===&lt;br /&gt;
[[Image: Sluzcesta-vyuctovani-hlaska-nakladove-stredisko-neni-pracovni.png|thumb|right|Upozornění na změnu nákl. střediska]]&lt;br /&gt;
Možnost před přenosem určit jiné [[nákladové středisko]], než je středisko zaměstnance. Tuto možnost má i zadavatel služební cesty na portále v části [[Výdaje (služební cesta)]]. Pokud tam stanoví jiné středisko než je standardní (pracovní středisko), dojde zde k zobrazení informativní hlášky.&lt;br /&gt;
&lt;br /&gt;
=== Storno vyúčtování ===&lt;br /&gt;
Vyúčtovaný cestovní příkaz nelze editovat. Pokud je potřeba provést změnu, stiskněte tlačítko '''''Storno vyúčtování''''' a poté proveďte vyúčtování znovu.&lt;br /&gt;
&lt;br /&gt;
Při stornu vyúčtování jsou řádky s částkou již vyplacenou na účet ponechány, aby nebyla ztracena informace o vyplacené částce. Při novém přepočtu je nová částka ponížena o již vyplacenou částku. U řádku s již vyplacenou částkou jsou vynulovány sloupce ''náhrady'', ''zálohy'', aby součet za všechny řádky vyúčtování byl správný.&lt;br /&gt;
[[Image: Sc-storno-vyuctovani-hlaska.png|100px]]&lt;br /&gt;
&lt;br /&gt;
Podmínky pro automatickou změnu stavu požadavku&lt;br /&gt;
# Záznam vznikl ze systému požadavků.&lt;br /&gt;
# V právě aktuálním kroku existuje stav s názvem '''''vyucstorno'''''.&lt;br /&gt;
&lt;br /&gt;
=== Zaokrouhlování (CZ) ===&lt;br /&gt;
[[Výpočty_(Služební_cesty)#Zaokrouhlování_konečného_vyúčtování]]&lt;br /&gt;
&lt;br /&gt;
=== Kurzovní lístek ===&lt;br /&gt;
[[Kurzy měn]] jsou uloženy v samostatném číselníku. Při požadavku na převod měny (např. v této záložce ''Vyúčtování'') a v případě, že není nalezen kurz k danému dni, systém provedě automaticky (skrytě) aktualizaci a doplnění údajů do číselníku z internetu.&lt;br /&gt;
&lt;br /&gt;
=== Změnit stav požadavku ===&lt;br /&gt;
Možnost změnit stav je pro případ záznamu vzniklého z procesu požadavků. Nabízí se výběr stavů z následujícího kroku vzhledem k aktuálnímu kroku, v němž je požadavek. Změna může být provedena:&lt;br /&gt;
* uživatelsky&lt;br /&gt;
* automaticky systémem (v případě uložení zaúčtování nebo storna zaúčtování).&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
[[Soubor:E_sc_vyuctovani.png|500px]]&lt;br /&gt;
[[Soubor:E_sc_vyuctovani_1.png|500px]]&lt;br /&gt;
* '''Vyplacená záloha''' - needitovatelné pole, částka je převzatá z hlavičky cestovního příkazu.&lt;br /&gt;
* '''Vrácená záloha''' - editovatelné pole pro možno zadání částky vrácené zálohy zaměstnancem.&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
Dřívější funkcionalita: Vyúčtovaný cestovní příkaz nelze editovat (kromě uživatele který vyúčtování provedl, ten jej může editovat pokud opravu provádí v ten samý den).&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Zahraniční služební cesta ==&lt;br /&gt;
Pro každý rozdíl zálohy a náhrad v příslušné měně lze zadat rozdílný způsob vyplacení (např. EUR hotově, CZK do mezd). Pro případ, kdy zaměstnanec dostal např. zálohu v EUR a část směnil na RUB a zadal výdaje v RUB, lze u řádku s RUB pomocí rozbalovátka změnit měnu na EUR, vybrat typ kurzu &amp;quot;dle směny&amp;quot; a zadat [[kurzy měn|kurz]], který zaměstnanec doložil. &lt;br /&gt;
&lt;br /&gt;
[[Image: Sc-vyuctovani-zahranicni-priklad-po.png|200px]]&lt;br /&gt;
[[Image: Sc-vyuctovani-zahranicni-priklad-2.png|200px]]&lt;br /&gt;
&lt;br /&gt;
== Automatická změna stavu požadavku při vyúčtování ==&lt;br /&gt;
Podmínky:&lt;br /&gt;
# Záznam vznikl ze systému požadavků.&lt;br /&gt;
# V právě aktuálním kroku existuje stav s názvem '''''vyuctovano'''''.&lt;br /&gt;
&lt;br /&gt;
Pokud jsou tyto podmínky splněny, pak systém provede změnu stavu požadavku na ''vyuctovano'' spolu s těmi akcemi, které k tomu přísluší (přechod do dalšího kroku, emailové notifikace).&lt;br /&gt;
&lt;br /&gt;
=== Před vyúčtováním ===&lt;br /&gt;
Před vyúčtováním jsou prázdné údaje:&lt;br /&gt;
* ''Vyúčtování provedl''&lt;br /&gt;
* ''Dne''&lt;br /&gt;
* ''V období''&lt;br /&gt;
&lt;br /&gt;
A je nastaven určitý stav požadavku (pokud záznam prošel systémem požadavků).&lt;br /&gt;
&lt;br /&gt;
Tomu odpovídají i údaje v seznamu cestovních příkazů zaměstnance (druhý obrázek).&lt;br /&gt;
&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-pred.png|450px]]&lt;br /&gt;
[[Image: Sc-seznam-pred-vyuctovanim.png|450px]]&lt;br /&gt;
&lt;br /&gt;
=== Po vyúčtování ===&lt;br /&gt;
Po vyúčtování jsou vyplněny údaje:&lt;br /&gt;
* ''Vyúčtování provedl''&lt;br /&gt;
* ''Dne''&lt;br /&gt;
* ''V období''&lt;br /&gt;
&lt;br /&gt;
A systém se pokusí automaticky změnit stav požadavku.&lt;br /&gt;
&lt;br /&gt;
[[Image: Sc-vyuctovani-priklad-po.png|450px]]&lt;br /&gt;
[[Image: Sc-seznam-po-vyuctovani.png|450px]]&lt;br /&gt;
&lt;br /&gt;
== Kontroly ==&lt;br /&gt;
=== Kontrola na vyúčtování bez dokončení workflow ===&lt;br /&gt;
Výstražné hlášení při vyúčtování CP bez celého workflow. Při vyúčtování probíhá kontrola, zda se uživatel nesnaží vyúčtovat cestu předčasně - pokud ano, zobrazí se hlášení:&lt;br /&gt;
: ''Workflow stav Vyúčtováno nelze nastavit, buď cesta ještě není ve workflow kroku pro vyúčtování, nebo nemáte právo stav měnit!	(Pokud vyúčtování uložíte, nebude mít cesta korespondující workflow stav, ten ale můžete změnit později.)''&lt;br /&gt;
&amp;lt;!-- helpdesk id 31119 – Pavel R – později pro všechny --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Kontrola na neexistenci vozidla v číselníku ===&lt;br /&gt;
Pokud '''SPZ vlastního''' vozidla (zadaného uživatelem v portálu v hlavičce služební cesty) není v číselníku vozidel, je zobrazeno upozornění. &amp;lt;small&amp;gt;Toto upozornění se nezobrazuje v případě, že v číselníku vozidel není naveden žádný záznam - tedy spotřeba je kontrolována u každého cestovního příkazu. &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[Image: Vozidlo-neni-v-ciselniku-vozidel.png|450px]]&lt;br /&gt;
&lt;br /&gt;
== Různé ==&lt;br /&gt;
* Pokud SC nespadá do aktuálního období - zobrazí se uživateli dotaz, zda má být SC vyúčtována do následujícho období. &lt;br /&gt;
* Zápis do agendy [[Archiv spuštěných výpočtů]] probíhá:&lt;br /&gt;
:: - při způsobu vyplacení částky do mezd&lt;br /&gt;
:: - při generování mzdové položky ([[kod_cest_strav (sk.15)]]) pro krácení stravenek.&lt;br /&gt;
Záznamy se zapisují do období, určeného položkou ''Do období''.&lt;br /&gt;
* '''[[Zámek]]''':&lt;br /&gt;
:: - ''Evidence &amp;gt;&amp;gt; Služební cesty &amp;gt;&amp;gt; Cestovní příkazy'' - zámek na celou agendu&lt;br /&gt;
:: - ''Evidence &amp;gt;&amp;gt; Služební cesty &amp;gt;&amp;gt; Cestovní příkazy &amp;gt;&amp;gt; Vyúčtování'' - zámek pouze na záložku Vyúčtování&lt;br /&gt;
:: - ''Evidence &amp;gt;&amp;gt; Služební cesty &amp;gt;&amp;gt; Cestovní příkazy &amp;gt;&amp;gt; Vyúčt. do akt. obd.'' - zámek, který nedovolí uložit vyúčtování do aktuálního období (vyúčtování do následujícího období je povoleno)&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Archiv spuštěných výpočtů]]&lt;br /&gt;
* [[Služební cesty]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=V%C3%BDpo%C4%8Dty_(Slu%C5%BEebn%C3%AD_cesty)&amp;diff=44602</id>
		<title>Výpočty (Služební cesty)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=V%C3%BDpo%C4%8Dty_(Slu%C5%BEebn%C3%AD_cesty)&amp;diff=44602"/>
		<updated>2023-02-28T13:44:53Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Zaokrouhlování konečného vyúčtování */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Výpočty (Služební cesty)'''&lt;br /&gt;
&lt;br /&gt;
== Zaokrouhlování ==&lt;br /&gt;
=== Zaokrouhlování jednotlivých položek ===&lt;br /&gt;
'''CZ: na 2 místa dolů''' - na 2 místa z důvodu počtu desetinných míst v databázi, směrem dolů &amp;lt;small&amp;gt;(při zaokrouhlení nahoru by zaměstnanec dostal více než dovoluje zákon). Příklad stravné 40 EUR - 2/3 = 13,33333...: po zaokrouhlení dolů 13,33 EUR, kdyby bylo nahoru 13,34 EUR (rozdíl 0,27 Kč). &amp;lt;/small&amp;gt;&lt;br /&gt;
&amp;lt;!-- Směrem nahoru, aby zaměstnanec neobdržel větší částku, než dovoluje zákon (což by bylo i předmětem daně). Zákon zaokrouhlování jednotlivých náhrad neřeší, v ideálním případě by se tedy měl zaokrouhlovat až celkový nárok. Zaokrouhlování stravného, základní náhrady, ceny PH uvedené v §189 odst. 3 je určeno pouze pro Ministerstvo práce a sociálních věcí při stanovování nových sazeb. --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''SK: na 2 místa nahoru''' - zaokrouhlování jednotlivých náhrad je určeno v zákoně o cestovných náhradách (§5 odst 9, §7 odst. 9).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt; K zaokrouhlení může dojít např. po úpravě zahraniční sazby (1/3, 2/3), nebo při krácení stravného za bezplatně poskytnuté jídlo (%) &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Zaokrouhlování konečného vyúčtování ===&lt;br /&gt;
Konečné vyúčtování (k výplatě/k inkasu) se zaokrouhluje&lt;br /&gt;
&lt;br /&gt;
'''Tuzemská měna:'''&lt;br /&gt;
&lt;br /&gt;
'''Legislativa CZ: na celé koruny nahoru''' (z § 183 262/2006 zákoníka práce - Částka, kterou má zaměstnanec zaměstnavateli vrátit v české měně, se zaokrouhlí na celé koruny směrem nahoru. Částka, kterou má zaměstnavatel zaměstnanci poskytnout v české měně, se zaokrouhlí na celé koruny směrem nahoru.)&lt;br /&gt;
&lt;br /&gt;
'''Legislativa SK: k výplatě - na eurocenty nahoru, k inkasu na eurocenty dolů''' (z § 35 283/2002 zákon o cestovných náhradách - preplatok v eurách alebo jeho časť v eurách na najbližší eurocent nadol, nedoplatok v eurách alebo jeho časť v eurách na najbližší eurocent nahor)&lt;br /&gt;
&lt;br /&gt;
'''Cizí měna:'''&lt;br /&gt;
&lt;br /&gt;
'''Legislativa CZ i SK:''' - pro zaokrouhlení doplatku/přeplatku v cizí měně se používá stejný způsob zaokrouhlení jako pro tuzemskou měnu, jiný lze nastavit pomocí rozšiřujícího parametru slc_zaok_vyuct viz nastavení.&lt;br /&gt;
&lt;br /&gt;
== Stravné a kapesné ==&lt;br /&gt;
=== 2. denní cesta s krácením za stravu ===&lt;br /&gt;
Při rozhodování, zda využít ''§163 odst. 4'' se porovnávají sazby nikoliv před krácením, ale po krácení, aby to bylo pro zaměstnance výhodnější.&lt;br /&gt;
&lt;br /&gt;
=== 2. denní cesta a přerušení ===&lt;br /&gt;
Při rozhodování, zda využít ''§163 odst. 4'', se posuzuje, zda SC skončila následující den po zahájení SC, tj. spadá do 2 kalendářních dnů. Přerušení má vliv pouze na počet hodin v jednotlivých dnech, které se případně sečtou dle ''§163 odst. 4'', pokud je to pro zaměstnance výhodnější.&lt;br /&gt;
&lt;br /&gt;
=== Kapesné a krácení za stravu ===&lt;br /&gt;
Kapesné se počítá ze sazby před krácením (ne po krácení).&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Služební cesty]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=SC-Stravn%C3%A9&amp;diff=44601</id>
		<title>SC-Stravné</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=SC-Stravn%C3%A9&amp;diff=44601"/>
		<updated>2023-02-28T13:32:55Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;small&amp;gt;Menu: Evidence/Služební cesty/Cestovní příkazy - záložka Stravné&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Ovládání ==&lt;br /&gt;
Použijte tlačítko Generuj, následně můžete záznamy editovat, mazat nebo vkládat vlastní.&lt;br /&gt;
* '''Generuj''' - tlačítko vygeneruje záznamy se stravným za jednotlivé dny a země dle údajů v záložce &amp;quot;Průběh cesty&amp;quot;.&lt;br /&gt;
&lt;br /&gt;
[[Soubor:E_sc_stravne.png|700px]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
* '''Krácení''' - zatrhává se počet &amp;quot;bezplatných jídel&amp;quot; obdržených na služební cestě (S-snídaně, O-oběd, V-večeře). Procenta krácení pro tuzemské stravné jsou nastavena v číselníku [[Tuzemské stravné]] a pro zahraniční stravné v rozšiřujících parametrech strav_krac_z* (skupina mzdy - ostatní).&lt;br /&gt;
: ''Hromadné krácení'' - obvyklým windows způsobem - ''označení prvního záznamu + Shift + klik na poslední záznam'' (stejného typu, např. S-snídaně) [[Image: Stravne-hromadne-kraceni-cs-aplikace.png|70px]]&lt;br /&gt;
&lt;br /&gt;
* '''[[Kapesné]]'''&lt;br /&gt;
&lt;br /&gt;
* '''Poznámka''' - Do tohoto pole systém pro snazší kontrolu automaticky vyplní čas od - do a případně použití specifického paragrafu, který použil pro výpočet stravného.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== [[Soubor:Paragraf05.png]] Legislativa ==&lt;br /&gt;
&amp;lt;small&amp;gt; Zákon č. 262/2006Sb. &amp;amp;sect; 163 &amp;lt;br&amp;gt;&lt;br /&gt;
'''Krácení''' - Bylo-li zaměstnanci během pracovní cesty poskytnuto jídlo, které má charakter snídaně, oběda nebo večeře, na které zaměstnanec finančně nepřispívá (dále jen &amp;quot;bezplatné jídlo&amp;quot;), přísluší zaměstnanci stravné snížené za každé bezplatné jídlo až o hodnotu&lt;br /&gt;
* 70% stravného, trvá-li pracovní cesta 5 až 12 hodin,&lt;br /&gt;
* 35% stravného, trvá-li pracovní cesta déle než 12 hodin, nejdéle však 18 hodin.&lt;br /&gt;
* 25% stravného, trvá-li pracovní cesta déle než 18 hodin.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''Zahraniční stravné - částka''' Zákon č. 262/2006Sb. &amp;amp;sect; 170&lt;br /&gt;
* nad 18 hod: plná sazba&lt;br /&gt;
* více než 12 hod a méně nebo rovno 18 hod: 2/3 sazby&lt;br /&gt;
* více než 5 hod a méně nebo rovno 12 hod; a pokud vzniklo právo i na tuzemské stravné: 1/3 sazby&lt;br /&gt;
* více nebo rovno 1 hod a méně nebo rovno 12 hod; a pokud nevzniklo právo na tuzemské stravné: 1/3 sazby&lt;br /&gt;
* méně než 1 hod: nic&lt;br /&gt;
&lt;br /&gt;
Krácení za poskytnutí každého bezplatného jídla až o hodnotu:&lt;br /&gt;
* 70% zahraničního stravného, jde-li o zahraniční stravné v třetinové výši základní sazby,&lt;br /&gt;
* 35% zahraničního stravného, jde-li o zahraniční stravné ve dvoutřetinové výši základní sazby,&lt;br /&gt;
* 25% zahraničního stravného, jde-li o zahraniční stravné ve výši základní sazby.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Služební cesty|zpět]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=V%C3%BDpo%C4%8Dty_(Slu%C5%BEebn%C3%AD_cesty)&amp;diff=44600</id>
		<title>Výpočty (Služební cesty)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=V%C3%BDpo%C4%8Dty_(Slu%C5%BEebn%C3%AD_cesty)&amp;diff=44600"/>
		<updated>2023-02-28T13:06:04Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Výpočty (Služební cesty)'''&lt;br /&gt;
&lt;br /&gt;
== Zaokrouhlování ==&lt;br /&gt;
=== Zaokrouhlování jednotlivých položek ===&lt;br /&gt;
'''CZ: na 2 místa dolů''' - na 2 místa z důvodu počtu desetinných míst v databázi, směrem dolů &amp;lt;small&amp;gt;(při zaokrouhlení nahoru by zaměstnanec dostal více než dovoluje zákon). Příklad stravné 40 EUR - 2/3 = 13,33333...: po zaokrouhlení dolů 13,33 EUR, kdyby bylo nahoru 13,34 EUR (rozdíl 0,27 Kč). &amp;lt;/small&amp;gt;&lt;br /&gt;
&amp;lt;!-- Směrem nahoru, aby zaměstnanec neobdržel větší částku, než dovoluje zákon (což by bylo i předmětem daně). Zákon zaokrouhlování jednotlivých náhrad neřeší, v ideálním případě by se tedy měl zaokrouhlovat až celkový nárok. Zaokrouhlování stravného, základní náhrady, ceny PH uvedené v §189 odst. 3 je určeno pouze pro Ministerstvo práce a sociálních věcí při stanovování nových sazeb. --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
'''SK: na 2 místa nahoru''' - zaokrouhlování jednotlivých náhrad je určeno v zákoně o cestovných náhradách (§5 odst 9, §7 odst. 9).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt; K zaokrouhlení může dojít např. po úpravě zahraniční sazby (1/3, 2/3), nebo při krácení stravného za bezplatně poskytnuté jídlo (%) &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Zaokrouhlování konečného vyúčtování ===&lt;br /&gt;
Konečné vyúčtování (k výplatě/k inkasu) se zaokrouhluje&lt;br /&gt;
&lt;br /&gt;
'''CZ: na celé koruny nahoru''' (z § 183 262/2006 zákoníka práce - Částka, kterou má zaměstnanec zaměstnavateli vrátit v české měně, se zaokrouhlí na celé koruny směrem nahoru. Částka, kterou má zaměstnavatel zaměstnanci poskytnout v české měně, se zaokrouhlí na celé koruny směrem nahoru.)&lt;br /&gt;
&lt;br /&gt;
'''SK: k výplatě - na eurocenty nahoru, k inkasu na eurocenty dolů''' (z § 35 283/2002 zákon o cestovných náhradách - preplatok v eurách alebo jeho časť v eurách na najbližší eurocent nadol, nedoplatok v eurách alebo jeho časť v eurách na najbližší eurocent nahor)&lt;br /&gt;
&lt;br /&gt;
'''CZ i SK:''' - pro zaokrouhlení doplatku/přeplatku v cizí měně se používá stejný způsob zaokrouhlení, jiný lze nastavit pomocí rozšiřujícího parametru slc_zaok_vyuct viz nastavení.&lt;br /&gt;
&lt;br /&gt;
== Stravné a kapesné ==&lt;br /&gt;
=== 2. denní cesta s krácením za stravu ===&lt;br /&gt;
Při rozhodování, zda využít ''§163 odst. 4'' se porovnávají sazby nikoliv před krácením, ale po krácení, aby to bylo pro zaměstnance výhodnější.&lt;br /&gt;
&lt;br /&gt;
=== 2. denní cesta a přerušení ===&lt;br /&gt;
Při rozhodování, zda využít ''§163 odst. 4'', se posuzuje, zda SC skončila následující den po zahájení SC, tj. spadá do 2 kalendářních dnů. Přerušení má vliv pouze na počet hodin v jednotlivých dnech, které se případně sečtou dle ''§163 odst. 4'', pokud je to pro zaměstnance výhodnější.&lt;br /&gt;
&lt;br /&gt;
=== Kapesné a krácení za stravu ===&lt;br /&gt;
Kapesné se počítá ze sazby před krácením (ne po krácení).&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Služební cesty]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Hl%C3%A1senie_o_vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD_dane&amp;diff=44536</id>
		<title>Hlásenie o vyúčtování dane</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Hl%C3%A1senie_o_vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD_dane&amp;diff=44536"/>
		<updated>2023-02-23T10:15:45Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;small&amp;gt;Menu: Sestavy &amp;gt; Odvody &amp;gt; Hlásenie &amp;lt;/small&amp;gt; &amp;lt;br&amp;gt;&lt;br /&gt;
[[Image: Hlasenie o vyuctovani dane.png|right|590px]]&lt;br /&gt;
'''Hlásenie o vyúčtování dane''' - slouží k vytvoření podpůrných sestav a výsledného souboru XML pro aplikaci eDane. Pro odeslání hlášení nebo tisk ve vzhledu oficiálních formulářů využijte aplikaci eDane, kam nahrajte vytvořený XML soubor.&lt;br /&gt;
&lt;br /&gt;
=== Část I až III ===&lt;br /&gt;
Část I obsahuje údaje o firmě, část II a III sumární částky za daný rok, které by měli odpovídat sumám za odevzdané měsíční přehledy (z čehož vyplývá, že se tam nemůžou vyskytovat částky z RZ vykonaného po prosincovém přehledu, ty se vyskytují pouze v části V - zaměstnanci s RZ).&lt;br /&gt;
&lt;br /&gt;
=== Část IV - zamestnanci bez RZ ===&lt;br /&gt;
Do této části se načtou zaměstnanci, kterým nebylo provedeno RZ.&lt;br /&gt;
Poznámka: pokud se zaměstnancům, kteří nemají provedeno RZ, nenačítá částka dobrovolného příspěvku na SDS, pravd. není nastaven rozšiřující parametr [[prisp_sds (sk.6) (SK)]]&lt;br /&gt;
&lt;br /&gt;
=== Část V - zamestnanci s RZ ===&lt;br /&gt;
Do této části se načtou zaměstnanci až v okamžiku, kdy je u nich uvedeno datum provedení RZ, tj. v okamžiku, kdy dojde ve zpracování RZ k přepočtu a potvrzení hlášky, zda se mají částky zapsat do mezd.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Historie ==&lt;br /&gt;
=== Za rok 2022 ===&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
- část IV i V: zrušeno datum narození v ř.1 (ale pokud nemá RČ ani daňové TIN, uvede se DN do TIN)  &amp;lt;br&amp;gt;&lt;br /&gt;
- část IV i V: zrušen úhrn příjmů dohody v ř.3   &amp;lt;br&amp;gt;&lt;br /&gt;
- část IV: zrušen v ř.8 počet měsíců NČZD na daňovníka  &amp;lt;br&amp;gt;&lt;br /&gt;
- část V: NČZD DDS přemístěna z ř. 8. na ř.7 vedle NČZD na manželku  &amp;lt;br&amp;gt;&lt;br /&gt;
- část V: zrušena Zam. Prem. z ř. 9 (nyní je na ř. 9 bonus z úroků)  &amp;lt;br&amp;gt;&lt;br /&gt;
- část IV i V: přidán seznam dětí s rozpisem měsíců, za které si zaměstnanec uplatnil nárok na daňový bonus. Tento rozpis dětí je uveden samostatně v sestavě na nové záložce &amp;quot;DETI - Bonusy&amp;quot;, do eDane se ale děti načtou přímo k jednotlivým zaměstnancům, význam sloupců: &amp;lt;br&amp;gt;&lt;br /&gt;
- RZ - pokud se jedná o zaměstnance s RZ, tak je uvedeno písmeno A, &amp;lt;br&amp;gt;&lt;br /&gt;
- O - pokud je u zaměstnance nalezena ruční oprava bonusu v daném roce, tak je uvedeno písmeno A, u takového zaměstnance je třeba případně opravit v eDane měsíce u některého dítěte (systém nemá jak přiřadit opravu ke správnému dítěti a správnému měsíci), &amp;lt;br&amp;gt;&lt;br /&gt;
- Mesice - pokud byl uplatňován bonus celý rok, tak je X u &amp;quot;1-12&amp;quot;, jinak je X u jednotlivých měsíců.  &amp;lt;br&amp;gt;&lt;br /&gt;
 &amp;lt;br&amp;gt;&lt;br /&gt;
Zatržení měsíců u dětí je načítáno dle toho, zda se jedná o zaměstnance s RZ nebo bez: &amp;lt;br&amp;gt;&lt;br /&gt;
Zaměstnanci bez RZ: &amp;lt;br&amp;gt;&lt;br /&gt;
Systém kontroluje nejen, zda je naveden nárok na bonus v evidenci rodinných příslušníků (tabulka rod_prisl_slevy), ale i zda výpočet mzdy bonus vyplatil (tabulka odpocty_rod_prisl), v případě různých dodatečných oprav se tak X u daného měsíce neobjeví, přestože je to dodatečně navedeno v evidenci rodinných příslušníků.  &amp;lt;br&amp;gt;&lt;br /&gt;
Zaměstnanci s RZ: &amp;lt;br&amp;gt;&lt;br /&gt;
Systém kontroluje nejen, zda je naveden nárok na bonus v evidenci rodinných příslušníků (tabulka rod_prisl_slevy), ale i zda roční zúčtování bonus přiznalo (tabulka rzdane_rp - obsahuje i bonusy uplatněné u předchozích zaměstnavatelů byla-li platnost bonusu evidence rodinných příslušníků zadána dle potvrzení).  &amp;lt;br&amp;gt;&lt;br /&gt;
Speciální případ, který nemusí nastat:  &amp;lt;br&amp;gt;&lt;br /&gt;
Pokud pro dítě není nalezen záznam v databázi o přiznaném nebo nepřiznaném bonusu (tabulky odpocty_rod_prisl a rzdane_rp), např. z důvodu nechtěného smazání dítěte a jeho opětovného navedení, tak je u příslušných měsíců písmeno &amp;quot;E&amp;quot; značící, že informace byla načtena čistě jen z evidence rodinných příslušníků a nemuselo dojít k jeho vyplacení (do eDane se ale načte X). &amp;lt;br&amp;gt;&lt;br /&gt;
 &amp;lt;br&amp;gt;&lt;br /&gt;
Z důvodu problémů s otevíráním eDane, po některé z aktualizací windows, se místo IE použije prohlížeč Edge pokud existuje. Hlasenie v22 je zatím dostupné pouze v testovací verzi eDane. &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Za rok 2021 ===&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
1) Datově přibylo pouze &amp;quot;Daňové identifikační číslo&amp;quot; zaměstnance v části IV a V (za zaměstnance) - jen pro cizince s trvalým pobytem v členském státě EU, pokud jej nemá uvedeno v mzdových údajích, tak se uvede jen datum narození (položka pod tím). &amp;lt;br&amp;gt;&lt;br /&gt;
2) V části V došlo ke zrušení řádku 8 - [[Kúpeľná starostlivosť]]. &amp;lt;br&amp;gt;&lt;br /&gt;
3) Hlavní je změna XML pro eDane, kde bezdůvodně došlo ke změně pořadí některých elementů.  &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Slovenská aplikace]]&lt;br /&gt;
* [[prisp_sds (sk.6) (SK)]]&lt;br /&gt;
* Produkční verze eDane: https://edane.financnasprava.sk/win/prod/install/DRSR.Win.DP.DRKlient.application &lt;br /&gt;
* Testovací verze eDane: https://edane.financnasprava.sk/win/test/install/DRSR.Win.DP.DRKlient.application&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Hl%C3%A1senie_o_vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD_dane&amp;diff=44532</id>
		<title>Hlásenie o vyúčtování dane</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Hl%C3%A1senie_o_vy%C3%BA%C4%8Dtov%C3%A1n%C3%AD_dane&amp;diff=44532"/>
		<updated>2023-02-23T10:11:27Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;small&amp;gt;Menu: Sestavy &amp;gt; Odvody &amp;gt; Hlásenie &amp;lt;/small&amp;gt; &amp;lt;br&amp;gt;&lt;br /&gt;
[[Image: Hlasenie o vyuctovani dane.png|right|590px]]&lt;br /&gt;
'''Hlásenie o vyúčtování dane''' - slouží k vytvoření podpůrných sestav a výsledného souboru XML pro aplikaci eDane. Pro odeslání hlášení nebo tisk ve vzhledu oficiálních formulářů využijte aplikaci eDane, kam nahrajte vytvořený XML soubor.&lt;br /&gt;
&lt;br /&gt;
=== Část I až III ===&lt;br /&gt;
Část I obsahuje údaje o firmě, část II a III sumární částky za daný rok, které by měli odpovídat sumám za odevzdané měsíční přehledy (z čehož vyplývá, že se tam nemůžou vyskytovat částky z RZ vykonaného po prosincovém přehledu, ty se vyskytují pouze v části V - zaměstnanci s RZ).&lt;br /&gt;
&lt;br /&gt;
=== Část IV - zamestnanci bez RZ ===&lt;br /&gt;
Do této části se načtou zaměstnanci, kterým nebylo provedeno RZ.&lt;br /&gt;
Poznámka: pokud se zaměstnancům, kteří nemají provedeno RZ, nenačítá částka dobrovolného příspěvku na SDS, pravd. není nastaven rozšiřující parametr [[prisp_sds (sk.6) (SK)]]&lt;br /&gt;
&lt;br /&gt;
=== Část V - zamestnanci s RZ ===&lt;br /&gt;
Do této části se načtou zaměstnanci až v okamžiku, kdy je u nich uvedeno datum provedení RZ, tj. v okamžiku, kdy dojde ve zpracování RZ k přepočtu a potvrzení hlášky, zda se mají částky zapsat do mezd.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Historie ==&lt;br /&gt;
=== Za rok 2022 ===&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
- 3. i 4. strana: zrušeno datum narození v ř.1 (ale pokud nemá RČ ani daňové TIN, uvede se DN do TIN)  &amp;lt;br&amp;gt;&lt;br /&gt;
- 3. i 4. strana: zrušen úhrn příjmů dohody v ř.3   &amp;lt;br&amp;gt;&lt;br /&gt;
- 3. strana: zrušen v ř.8 počet měsíců NČZD na daňovníka  &amp;lt;br&amp;gt;&lt;br /&gt;
- 4. strana: NČZD DDS přemístěna z ř. 8. na ř.7 vedle NČZD na manželku  &amp;lt;br&amp;gt;&lt;br /&gt;
- 4. strana: zrušena Zam. Prem. z ř. 9 (nyní je na ř. 9 bonus z úroků)  &amp;lt;br&amp;gt;&lt;br /&gt;
- 3. i 4. strana: přidán seznam dětí s rozpisem měsíců, za které si zaměstnanec uplatnil nárok na daňový bonus. Tento rozpis dětí je uveden samostatně v sestavě na nové záložce &amp;quot;DETI - Bonusy&amp;quot;, do eDane se ale děti načtou přímo k jednotlivým zaměstnancům, význam sloupců: &amp;lt;br&amp;gt;&lt;br /&gt;
- RZ - pokud se jedná o zaměstnance s RZ, tak je uvedeno písmeno A, &amp;lt;br&amp;gt;&lt;br /&gt;
- O - pokud je u zaměstnance nalezena ruční oprava bonusu v daném roce, tak je uvedeno písmeno A, u takového zaměstnance je třeba případně opravit v eDane měsíce u některého dítěte (systém nemá jak přiřadit opravu ke správnému dítěti a správnému měsíci), &amp;lt;br&amp;gt;&lt;br /&gt;
- Mesice - pokud byl uplatňován bonus celý rok, tak je X u &amp;quot;1-12&amp;quot;, jinak je X u jednotlivých měsíců.  &amp;lt;br&amp;gt;&lt;br /&gt;
 &amp;lt;br&amp;gt;&lt;br /&gt;
Zatržení měsíců u dětí je načítáno dle toho, zda se jedná o zaměstnance s RZ nebo bez: &amp;lt;br&amp;gt;&lt;br /&gt;
Zaměstnanci bez RZ: &amp;lt;br&amp;gt;&lt;br /&gt;
Systém kontroluje nejen, zda je naveden nárok na bonus v evidenci rodinných příslušníků (tabulka rod_prisl_slevy), ale i zda výpočet mzdy bonus vyplatil (tabulka odpocty_rod_prisl), v případě různých dodatečných oprav se tak X u daného měsíce neobjeví, přestože je to dodatečně navedeno v evidenci rodinných příslušníků.  &amp;lt;br&amp;gt;&lt;br /&gt;
Zaměstnanci s RZ: &amp;lt;br&amp;gt;&lt;br /&gt;
Systém kontroluje nejen, zda je naveden nárok na bonus v evidenci rodinných příslušníků (tabulka rod_prisl_slevy), ale i zda roční zúčtování bonus přiznalo (tabulka rzdane_rp - obsahuje i bonusy uplatněné u předchozích zaměstnavatelů byla-li platnost bonusu evidence rodinných příslušníků zadána dle potvrzení).  &amp;lt;br&amp;gt;&lt;br /&gt;
Speciální případ, který nemusí nastat:  &amp;lt;br&amp;gt;&lt;br /&gt;
Pokud pro dítě není nalezen záznam v databázi o přiznaném nebo nepřiznaném bonusu (tabulky odpocty_rod_prisl a rzdane_rp), např. z důvodu nechtěného smazání dítěte a jeho opětovného navedení, tak je u příslušných měsíců písmeno &amp;quot;E&amp;quot; značící, že informace byla načtena čistě jen z evidence rodinných příslušníků a nemuselo dojít k jeho vyplacení (do eDane se ale načte X). &amp;lt;br&amp;gt;&lt;br /&gt;
 &amp;lt;br&amp;gt;&lt;br /&gt;
Z důvodu problémů s otevíráním eDane, po některé z aktualizací windows, se místo IE použije prohlížeč Edge pokud existuje. Hlasenie v22 je zatím dostupné pouze v testovací verzi eDane. &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Za rok 2021 ===&lt;br /&gt;
&amp;lt;small&amp;gt;&lt;br /&gt;
1) Datově přibylo pouze &amp;quot;Daňové identifikační číslo&amp;quot; zaměstnance v části IV a V (za zaměstnance) - jen pro cizince s trvalým pobytem v členském státě EU, pokud jej nemá uvedeno v mzdových údajích, tak se uvede jen datum narození (položka pod tím). &amp;lt;br&amp;gt;&lt;br /&gt;
2) V části V došlo ke zrušení řádku 8 - [[Kúpeľná starostlivosť]]. &amp;lt;br&amp;gt;&lt;br /&gt;
3) Hlavní je změna XML pro eDane, kde bezdůvodně došlo ke změně pořadí některých elementů.  &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Slovenská aplikace]]&lt;br /&gt;
* [[prisp_sds (sk.6) (SK)]]&lt;br /&gt;
* Produkční verze eDane: https://edane.financnasprava.sk/win/prod/install/DRSR.Win.DP.DRKlient.application &lt;br /&gt;
* Testovací verze eDane: https://edane.financnasprava.sk/win/test/install/DRSR.Win.DP.DRKlient.application&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Aktualizace_(Aplika%C4%8Dn%C3%AD_server_KS)&amp;diff=44476</id>
		<title>Aktualizace (Aplikační server KS)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Aktualizace_(Aplika%C4%8Dn%C3%AD_server_KS)&amp;diff=44476"/>
		<updated>2023-02-03T12:28:54Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Aktualizace (Aplikační server KS)'''&lt;br /&gt;
&lt;br /&gt;
[[Aktualizace pomocí utility MaPSetup]]&lt;br /&gt;
&lt;br /&gt;
''Postup aktualizace''&lt;br /&gt;
&lt;br /&gt;
{| border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|&amp;lt;small&amp;gt;&amp;lt;center&amp;gt; Pořadí &amp;lt;/center&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;&amp;lt;center&amp;gt; Bod &amp;lt;/center&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;&amp;lt;center&amp;gt; Obrázek &amp;lt;/center&amp;gt;&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt; Komentář &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;'''1.'''&amp;lt;/center&amp;gt;||&amp;lt;center&amp;gt;'''MaPSetup'''&amp;lt;/center&amp;gt;|| ||Stáhněte si aplikaci ''MaPSetup'' z: https://download.ksprogram.cz/download/MaPSetup.zip.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;'''2.'''&amp;lt;/center&amp;gt;||&amp;lt;center&amp;gt;'''Uložení'''&amp;lt;/center&amp;gt;|| ||Soubor umístěte na server/počítač, kde je nainstalován aplikační server.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;'''3.'''&amp;lt;/center&amp;gt;||&amp;lt;center&amp;gt;'''Spuštění'''&amp;lt;/center&amp;gt;|| ||Rozbalte .zip soubor a spusťte aplikaci ''MaPSetup.exe''.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;'''4.'''&amp;lt;/center&amp;gt;||&amp;lt;center&amp;gt;'''Aplikační server'''&amp;lt;/center&amp;gt;||[[Image: AS-aktualizace-1.png|40px]]||Zvolte ''Aplikační server'' a stiskněte ''Další''.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;'''5.'''&amp;lt;/center&amp;gt;||&amp;lt;center&amp;gt;'''Aktualizace produktu'''&amp;lt;/center&amp;gt;||[[Image: AS-aktualizace-2.png|40px]]||Zvolte ''Aktualizace produktu/produktů'' a stiskněte ''Další''.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;'''6.'''&amp;lt;/center&amp;gt;||&amp;lt;center&amp;gt;'''Aktualizovat'''&amp;lt;/center&amp;gt;|| ||Stiskněte ''Aktualizovat''. Provede se aktualizace na nejnovější verzi aplikačního serveru.&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;center&amp;gt;'''7'''&amp;lt;/center&amp;gt;||&amp;lt;center&amp;gt;'''Aktualizováno'''&amp;lt;/center&amp;gt;||[[Image: AS-aktualizace-3.png|40px]]||Dokončeno. Stiskněte tlačítko ''Konec''.&lt;br /&gt;
|-&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Tímto způsobem se zaktualizuje každá instance aplikačního serveru '''bez změny nastavení'''. To znamená, že umístění a připojovací řetězce do databází zůstanou stejné jako před aktualizací.&lt;br /&gt;
&lt;br /&gt;
V případě, že je potřeba provést '''změnu nastavení''', je v současnosti možná jen varianta: '''odinstalovat a nainstalovat''' znovu s novými parametry.&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Aplikační server KS]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44449</id>
		<title>PodepsaneProhlaseni</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44449"/>
		<updated>2023-01-30T13:59:33Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''PodepsaneProhlaseni''' je [[Parametry (KS portál)|parametr]], který má vliv na to, zda systém při žádosti o RZ kontroluje, zda má zaměstnanec podepsané prohlášení za minulý rok. Pokud je parametr nastaven na hodnotu &amp;quot;a&amp;quot;, tak systém kontroluje, zda měl zaměstnanec ve všech obdobích roku podepsané prohlášení (případně, zda má vyplněno dodatečné prohlášení daně), kromě měsíců, které vyplnil v části předchozí zaměstnavatelé. To, zda bylo zatrženo &amp;quot;podepsáno prohl.&amp;quot; ve mdových údajích při uzávěrkách jednotlivých obdobích si můžete ověřit přes sql dotaz &amp;quot;select os_cislo, datum, dan_sleva from prac_zal order by os_cislo, datum, dan_sleva&amp;quot;. V praxi se objevují situace, kdy zaměstnanec podepíše prohlášení pozdě - až po lednové uzávěrce a pro systém tak nemá zaměstnanec podepsáno prohlášení za leden minulého roku, což se projeví jako blokující validační hlášení při žádosti o RZ: Nemáte podepsáno prohlášení na měsíce: 1! V takovém případě nezbývá než vypnout kontrolu nastavením parametru na hodnotu &amp;quot;n&amp;quot; a podepsané prohlášení kontrolovat ručně.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| PodepsaneProhlaseni&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis &lt;br /&gt;
| Kontrolovat podepsané prohlášení při žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah&lt;br /&gt;
| '''n'''/a&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pozn. Jednotlivé řešení u vybraného zaměstnance je žádost o dodatečné Prohlášení loňského roku a její schválení.&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Parametry (Požadavky)]]&lt;br /&gt;
* [[Parametry (Daňovka)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44251</id>
		<title>PodepsaneProhlaseni</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44251"/>
		<updated>2023-01-17T09:29:34Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''PodepsaneProhlaseni''' je [[Parametry (KS portál)|parametr]], který má vliv na to, zda systém při žádosti o RZ kontroluje, zda má zaměstnanec podepsané prohlášení za minulý rok. Pokud je parametr nastaven na hodnotu &amp;quot;a&amp;quot;, tak systém kontroluje, zda měl zaměstnanec ve všech obdobích roku podepsané prohlášení (případně, zda má vyplněno dodatečné prohlášení daně). To, zda bylo zatrženo &amp;quot;podepsáno prohl.&amp;quot; ve mdových údajích při uzávěrkách jednotlivých obdobích si můžete ověřit přes sql dotaz &amp;quot;select os_cislo, datum, dan_sleva from prac_zal order by os_cislo, datum, dan_sleva&amp;quot;. V praxi se objevují situace, kdy zaměstnanec podepíše prohlášení pozdě - až po lednové uzávěrce a pro systém tak nemá zaměstnanec podepsáno prohlášení za leden minulého roku, což se projeví jako blokující validační hlášení při žádosti o RZ: Nemáte podepsáno prohlášení na měsíce: 1! V takovém případě nezbývá než vypnout kontrolu nastavením parametru na hodnotu &amp;quot;n&amp;quot; a podepsané prohlášení kontrolovat ručně.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| PodepsaneProhlaseni&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis &lt;br /&gt;
| Kontrolovat podepsané prohlášení při žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah&lt;br /&gt;
| '''n'''/a&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Parametry (Požadavky)]]&lt;br /&gt;
* [[Parametry (Daňovka)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44250</id>
		<title>PodepsaneProhlaseni</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44250"/>
		<updated>2023-01-17T09:26:57Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''PodepsaneProhlaseni''' je [[Parametry (KS portál)|parametr]], který má vliv na to, zda systém při žádosti o RZ kontroluje, zda má zaměstnanec podepsané prohlášení za minulý rok. Pokud je parametr nastaven na hodnotu &amp;quot;a&amp;quot;, tak systém kontroluje, zda měl zaměstnanec ve všech obdobích roku podepsané prohlášení (případně, zda má vyplněno dodatečné prohlášení daně). To, zda bylo zatrženo &amp;quot;podepsáno prohl.&amp;quot; ve mdových údajích při uzávěrkách jednotlivých údajích si můžete ověřit přes sql dotaz &amp;quot;select os_cislo, datum, dan_sleva from prac_zal order by os_cislo, datum, dan_sleva&amp;quot;. V praxi se objevují situace, kdy zaměstnanec podepíše prohlášení pozdě - až po lednové uzávěrce a pro systém tak nemá zaměstnanec podepsáno prohlášení za leden minulého roku, což se projeví jako blokující validační hlášení při žádosti o RZ: Nemáte podepsáno prohlášení na měsíce: 1! V takovém případě nezbývá než vypnout kontrolu nastavením parametru na hodnotu &amp;quot;n&amp;quot; a podepsané prohlášení kontrolovat ručně.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| PodepsaneProhlaseni&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis &lt;br /&gt;
| Kontrolovat podepsané prohlášení při žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah&lt;br /&gt;
| '''n'''/a&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Parametry (Požadavky)]]&lt;br /&gt;
* [[Parametry (Daňovka)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44249</id>
		<title>PodepsaneProhlaseni</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=PodepsaneProhlaseni&amp;diff=44249"/>
		<updated>2023-01-17T09:19:03Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''PodepsaneProhlaseni''' je [[Parametry (KS portál)|parametr]], který má vliv na to, zda systém při žádosti o RZ kontroluje, zda má zaměstnanec podepsané prohlášení za minulý rok. Pokud je parametr nastaven na hodnotu a, tak systém kontroluje, zda měl zaměstnanec ve všech obdobích roku podepsané prohlášení (případně, zda má vyplněno dodatečné prohlášení daně). V praxi se objevují situace, kdy zaměstnanec podepíše prohlášení pozdě - až po lednové uzávěrce a pro systém tak nemá zaměstnanec podepsáno prohlášení za leden minulého roku, což se projeví jako blokující validační hlášení při žádosti o RZ: Nemáte podepsáno prohlášení na měsíce: 1! V takovém případě nezbývá než vypnout kontrolu nastavením parametru na hodnotu n a podepsané prohlášení kontrolovat ručně.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název&lt;br /&gt;
| PodepsaneProhlaseni&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Skupina&lt;br /&gt;
| Požadavky&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis &lt;br /&gt;
| Kontrolovat podepsané prohlášení při žádosti o RZ?&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah&lt;br /&gt;
| '''n'''/a&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Parametry (Požadavky)]]&lt;br /&gt;
* [[Parametry (Daňovka)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=44018</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=44018"/>
		<updated>2022-11-28T09:12:11Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Sekce  */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů na přihlašovací stránce získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutím na tlačítko „Odhlásit“. Tento způsob přihlášení, narozdíl od windows SSO, je možno použít i pro uživatele hlásící se zvenku, mimo firemní síť (samozřejmě jen pokud je portál vystaven veřejně).&lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že při AD autentizaci nezáleží na velikosti písmen a umožňuje použít různé formáty loginů a různé tvary domény (a při některých konfiguracích i bez domény) a při definici práv v KS je rovněž možno používat různé formáty loginů, je nutné nastavit parametr SparovaniUziv na CI-BezDomeny, aby systém při načítání práv z KS databáze pro autentizovaného uživatele ignoroval velikost písmen i doménu, jinak se práva nebudou načítat jednotně a budou záviset na tom, v jakém tvaru uživatel zadá svůj login!&lt;br /&gt;
&lt;br /&gt;
Lze se přihlašovat i tvarem loginu bez domény pokud je parametr SparovaniUzivAD (jiný parametr než výše) nastaven na hodnotu true.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel. Od verze 7641A je nutno nastavit i parametr TypOvereni na hodnotu sql.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;sql&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| kspu (případně ks)&lt;br /&gt;
|   osobní číslo se zjistí z agendy Uživatelé KSPortálu.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| ezsap&lt;br /&gt;
|   zákaznická specialita - Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Logine nebo z tabulky sap,&lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 3.&lt;br /&gt;
|-&lt;br /&gt;
| eos4&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 4.&lt;br /&gt;
|-&lt;br /&gt;
| az&lt;br /&gt;
|   Osobní číslo je stejné jako login.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
* EosRoleProvider - zákaznická specialita - načítání rolí ze systému EOS verze 3,&lt;br /&gt;
* Eos4RoleProvider - zákaznická specialita - načítání rolí ze systému EOS verze 4,&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. Pravidlo 3/4. Pokud nastavena hodnota ''true'', pak je vyžadováno následující: Heslo musí obsahovat minimálně 3 typy následujících znaků: číslice, malá písmena, velká písmena, speciální znaky.  || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Typ ověření uživatele pro formulářové přihlášení. || kspu (ks nebo nevyplněno)=ověření účtem z agendy Uživatelé KS portálu, ad=Active Directory, sql=ověření databázovým účtem 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Parametr je povinný pokud je TypOvereni nastaven na jinou hodnotu než kspu. || ks nebo kspu =Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje, az - osobní číslo je stejné jako login	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. || domena\user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| (nepovinné) Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| (nepovinné) AD podkontejnery pro prohledávání , seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| (nepovinné) AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| (povinný při ZdrojOsCisla=ad) AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| (nepovinné) AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| (nepovinné) AD role určené pro KS Portál (oddělené středníkem) - používá se jen v případě že je nastaven RoleProvider na ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43956</id>
		<title>Aktualizace pomocí utility MaPSetup</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43956"/>
		<updated>2022-11-10T13:12:59Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Umístění */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Aktualizace pomocí utility MaPSetup''' je jeden z možných způsobů aktualizací aplikací Ks mzdy, KS portál a Aplikační server KS, ostatní způsoby aktualizace jsou popsány v následujících samostatných stránkách:&lt;br /&gt;
[[Image: Mapsetup 1.png|500px|right]]&lt;br /&gt;
# [[Aktualizace aplikace KS mzdy]].&lt;br /&gt;
# [[Portál-Aktualizace]]&lt;br /&gt;
# [[Aktualizace (Aplikační server KS)]]&lt;br /&gt;
&lt;br /&gt;
== Umístění ==&lt;br /&gt;
Utilita ''MaPSetup'' je součástí aplikace KS mzdy a je tedy ve složce MaP. MaPSetup lze stáhnout i [https://download.ksprogram.cz/download/MaPSetup.zip zde] jako ZIP archív ''MaPSetup.zip'', který rozbalte do libovolné složky.&lt;br /&gt;
&lt;br /&gt;
== Poslední změny ==&lt;br /&gt;
Ve verzi 10.0 byla pro volbu AS zrušena volba &amp;quot;jednoduchý režim&amp;quot; a &amp;quot;expertní režim&amp;quot;, nyní je pouze jeden. V okně s výběrem akce, pro produkt AS, se volba &amp;quot;Instalace&amp;quot; změní na &amp;quot;Změna instalace (přidání/odebrání instance)&amp;quot; pokud je AS nainstalován. Tato volba otevírá okno pro konfiguraci seznamu instancí AS, okno vychází z původního okna &amp;quot;Expertní konfigurátor AS&amp;quot;. Bylo zamezeno volit si u každé instance AS umístění mimo instalační složku, volba názvu podsložky zůstala. Ruční vložení a smazání řádku v seznamu instancí bylo zakázáno a nyní slouží k tomuto účelu tlačítka &amp;quot;Přidat instanci&amp;quot; a &amp;quot;Odebrat instanci&amp;quot;. V prvním sloupci &amp;quot;Akce&amp;quot; je informace, zda bude provedena aktualizace/instalace či odebrání instance. Byl přidán sloupec &amp;quot;TCP Port&amp;quot; pro možnost změnit si předdefinovaný port webových služeb aplikačního serveru. Opraveno přehození připojovacích řetězců k databázi mezi jednotlivými instancemi po odebrání instance AS (která nebyla poslední instancí). Kompletní seznam změn ve verzi 10.0 je [https://download.ksprogram.cz/download/MapSetupChanges.txt zde].&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
'''1.''' '''Spusťte''' aplikaci '''''MaPSetup.exe'''''. &amp;lt;br&amp;gt;&lt;br /&gt;
Poznámka: Spouštějte aplikaci pod účtem s oprávněním ''Správce počítače'' &amp;lt;small&amp;gt;(Windows: Účty - Správce)&amp;lt;/small&amp;gt;, jinak nemusíte mít oprávnění měnit soubory aplikace. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor].&lt;br /&gt;
&lt;br /&gt;
'''2.''' V prvním okně '''vyberte produkt'''.&lt;br /&gt;
&lt;br /&gt;
'''3.''' Další okna spouští '''samotnou aktualizaci''' (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;MaPSetup&amp;lt;/small&amp;gt;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
|&amp;lt;small&amp;gt;Produkt&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 2&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 3&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|rowspan = &amp;quot;5&amp;quot;|[[Image: Mapsetup 1.png|100px|right]]&lt;br /&gt;
|-&lt;br /&gt;
|[[Image: Mapsetup 1-1.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-2.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-2-2.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-3.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-3-1.png|100px]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: [[Image: Mapsetup mate-nainstalovanu-nejnovejsi-verzi.png|50px]].&lt;br /&gt;
&lt;br /&gt;
== Instrukce a parametry MaPSetup ==&lt;br /&gt;
Pomocí instrukcí a parametrů lze dosáhnout cíleného spouštění, např. aktualizace konkrétního typu, do určitého adresáře, apod. Mohou být založeny například 3 ikony, každá pro aktualizaci samostatného produktu.&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Instrukce MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Instrukce'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /UPDATE'''&lt;br /&gt;
|Provede akci aktualizace. Povinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOCHECK'''&lt;br /&gt;
| Vypne kontrolu, zda-li je už nové sestavení (verze) nainstalováno a zaktualizuje. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /REGISTER'''&lt;br /&gt;
| Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /CLOSE'''&lt;br /&gt;
|Automaticky se zavře poslední okno po provedení aktualizace. Nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /AUTO'''&lt;br /&gt;
|Automaticky se stiskne tlačítko Další nebo Aktualizovat. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SILENT'''&lt;br /&gt;
|Tichý režim bez GUI. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOLOG'''&lt;br /&gt;
|Nebude logovat. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /FORCEVERSION'''&lt;br /&gt;
|Vynutí specifickou verzi.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SETPROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|-&lt;br /&gt;
|''' /PROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Parametry MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Parametr'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /TYPE typ'''&lt;br /&gt;
|Může nabývat jednu z těchto hodnot:&lt;br /&gt;
* TK (KS mzdy PROFi)&lt;br /&gt;
* WK (KS portál)&lt;br /&gt;
* AS (KS aplikační server)&lt;br /&gt;
Povinný parametr.&lt;br /&gt;
|-&lt;br /&gt;
|''' /ICO identifikační číslo'''&lt;br /&gt;
|Identifikační číslo IČ organizace (platné u typů TK, WK), pro níž je sestavení uvolněno. Pokud není uvedeno, zaktualizuje se na poslední standardní sestavení (uvolněné všem uživatelům).&lt;br /&gt;
|-&lt;br /&gt;
|''' /DLL složka'''&lt;br /&gt;
| Zaregistruje DLL knihovny (COM komponenty knihoven KSOleModul.dll a KSNetBridge.dll) do registru s explicitním uvedením cesty (platné u typu TK). (Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak musela být na lokálním počítači uvedená cesta do serverového umístění KS mzdy PROFi. Pokud již DLL knihovny jsou zaregistrované, je opakované použití parametru zbytečné.) Registrace DLL již není nutná (díky main.exe.manifest), pokud však již byla provedena, může být toto potřeba, pokud hodnota v registru odkazuje na již neplatné umístění. Nepovinné. &lt;br /&gt;
|-&lt;br /&gt;
|''' /AKTUALIZOVAT_Z'''&lt;br /&gt;
| Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na vašem aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru [[AKTUALIZOVAT_Z (sk.13)]]; v tom případě je parametr povinný, jinak si lokální stanice opět stáhne starou verzi z vašeho aktualizačního serveru.&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE1 složka''' &lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE2 složka'''&lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem - pokud existuje i vedlejší instance (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
* Na '''pořadí a velikosti písmen''' v instrukcích a parametrech '''nezáleží'''.&lt;br /&gt;
* Stejně tak '''nezáleží na sklonu lomítka'''.&lt;br /&gt;
* Pokud se povinné parametry či instrukce pro daný typ neuvedou, spustí se grafické rozhraní MaPSetup.&lt;br /&gt;
* V případě, že se v cestě u některého z parametrů (DLL, AKTUALIZOVAT_Z, INSTANCE1, INSTANCE2) vyskytuje '''mezera, uvozte tuto cestu uvozovkami &amp;quot; &amp;quot;'''.&lt;br /&gt;
&lt;br /&gt;
=== Příklady ===&lt;br /&gt;
Aktualizace KS mzdy PROFi&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678  /TYPE TK /AKTUALIZOVAT_Z &amp;quot;X:\KS Program\AktualizaceAplikace&amp;quot;&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /NOCHECK&lt;br /&gt;
&lt;br /&gt;
Aktualizace aplikace KS portál&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal\Hlavni /INSTANCE2 D:\KSPortal\Test&lt;br /&gt;
&lt;br /&gt;
Uvedené IČ je pouze ilustrativní.&lt;br /&gt;
&lt;br /&gt;
== Poznámky ==&lt;br /&gt;
Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [https://download.ksprogram.cz/download]. Počítač toho, kdo provádí aktualizaci, tedy nesmí mít blokován přístup k této adrese antivirem či podnikovým firewalem.&lt;br /&gt;
&lt;br /&gt;
Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. &amp;lt;small&amp;gt;HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí. &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Aktualizace aplikace KS mzdy]]&lt;br /&gt;
* &amp;lt;small&amp;gt;[[Aktualizace aplikace]] &amp;lt;/small&amp;gt;&lt;br /&gt;
* &amp;lt;small&amp;gt;&amp;lt;s&amp;gt;[[Aktualizace pomocí utility MaPSetup - starší verze 1]]&amp;lt;/s&amp;gt;&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43944</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43944"/>
		<updated>2022-10-31T14:41:11Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přístupová práva uživatelů */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů na přihlašovací stránce získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutím na tlačítko „Odhlásit“. Tento způsob přihlášení, narozdíl od windows SSO, je možno použít i pro uživatele hlásící se zvenku, mimo firemní síť (samozřejmě jen pokud je portál vystaven veřejně).&lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že při AD autentizaci nezáleží na velikosti písmen a umožňuje použít různé formáty loginů a různé tvary domény (a při některých konfiguracích i bez domény) a při definici práv v KS je rovněž možno používat různé formáty loginů, je nutné nastavit parametr SparovaniUziv na CI-BezDomeny, aby systém při načítání práv z KS databáze pro autentizovaného uživatele ignoroval velikost písmen i doménu, jinak se práva nebudou načítat jednotně a budou záviset na tom, v jakém tvaru uživatel zadá svůj login!&lt;br /&gt;
&lt;br /&gt;
Lze se přihlašovat i tvarem loginu bez domény pokud je parametr SparovaniUzivAD (jiný parametr než výše) nastaven na hodnotu true.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel. Od verze 7641A je nutno nastavit i parametr TypOvereni na hodnotu sql.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;sql&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| kspu (případně ks)&lt;br /&gt;
|   osobní číslo se zjistí z agendy Uživatelé KSPortálu.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| ezsap&lt;br /&gt;
|   zákaznická specialita - Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Logine nebo z tabulky sap,&lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 3.&lt;br /&gt;
|-&lt;br /&gt;
| eos4&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 4.&lt;br /&gt;
|-&lt;br /&gt;
| az&lt;br /&gt;
|   Osobní číslo je stejné jako login.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
* EosRoleProvider - zákaznická specialita - načítání rolí ze systému EOS verze 3,&lt;br /&gt;
* Eos4RoleProvider - zákaznická specialita - načítání rolí ze systému EOS verze 4,&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. Pravidlo 3/4. Pokud nastavena hodnota ''true'', pak je vyžadováno následující: Heslo musí obsahovat minimálně 3 typy následujících znaků: číslice, malá písmena, velká písmena, speciální znaky.  || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43943</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43943"/>
		<updated>2022-10-31T14:39:19Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přístupová práva uživatelů */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů na přihlašovací stránce získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutím na tlačítko „Odhlásit“. Tento způsob přihlášení, narozdíl od windows SSO, je možno použít i pro uživatele hlásící se zvenku, mimo firemní síť (samozřejmě jen pokud je portál vystaven veřejně).&lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že při AD autentizaci nezáleží na velikosti písmen a umožňuje použít různé formáty loginů a různé tvary domény (a při některých konfiguracích i bez domény) a při definici práv v KS je rovněž možno používat různé formáty loginů, je nutné nastavit parametr SparovaniUziv na CI-BezDomeny, aby systém při načítání práv z KS databáze pro autentizovaného uživatele ignoroval velikost písmen i doménu, jinak se práva nebudou načítat jednotně a budou záviset na tom, v jakém tvaru uživatel zadá svůj login!&lt;br /&gt;
&lt;br /&gt;
Lze se přihlašovat i tvarem loginu bez domény pokud je parametr SparovaniUzivAD (jiný parametr než výše) nastaven na hodnotu true.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel. Od verze 7641A je nutno nastavit i parametr TypOvereni na hodnotu sql.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;sql&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| kspu (případně ks)&lt;br /&gt;
|   osobní číslo se zjistí z agendy Uživatelé KSPortálu.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| ezsap&lt;br /&gt;
|   zákaznická specialita - Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Logine nebo z tabulky sap,&lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 3.&lt;br /&gt;
|-&lt;br /&gt;
| eos4&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 4.&lt;br /&gt;
|-&lt;br /&gt;
| az&lt;br /&gt;
|   Osobní číslo je stejné jako login.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
* EosRoleProvider - zákaznická specialita - načítání rolí ze systému EOS&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. Pravidlo 3/4. Pokud nastavena hodnota ''true'', pak je vyžadováno následující: Heslo musí obsahovat minimálně 3 typy následujících znaků: číslice, malá písmena, velká písmena, speciální znaky.  || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43942</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43942"/>
		<updated>2022-10-31T14:37:17Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Zdroj informace pro vazbu login - osobní číslo */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů na přihlašovací stránce získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutím na tlačítko „Odhlásit“. Tento způsob přihlášení, narozdíl od windows SSO, je možno použít i pro uživatele hlásící se zvenku, mimo firemní síť (samozřejmě jen pokud je portál vystaven veřejně).&lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že při AD autentizaci nezáleží na velikosti písmen a umožňuje použít různé formáty loginů a různé tvary domény (a při některých konfiguracích i bez domény) a při definici práv v KS je rovněž možno používat různé formáty loginů, je nutné nastavit parametr SparovaniUziv na CI-BezDomeny, aby systém při načítání práv z KS databáze pro autentizovaného uživatele ignoroval velikost písmen i doménu, jinak se práva nebudou načítat jednotně a budou záviset na tom, v jakém tvaru uživatel zadá svůj login!&lt;br /&gt;
&lt;br /&gt;
Lze se přihlašovat i tvarem loginu bez domény pokud je parametr SparovaniUzivAD (jiný parametr než výše) nastaven na hodnotu true.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel. Od verze 7641A je nutno nastavit i parametr TypOvereni na hodnotu sql.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;sql&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| kspu (případně ks)&lt;br /&gt;
|   osobní číslo se zjistí z agendy Uživatelé KSPortálu.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| ezsap&lt;br /&gt;
|   zákaznická specialita - Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Logine nebo z tabulky sap,&lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 3.&lt;br /&gt;
|-&lt;br /&gt;
| eos4&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 4.&lt;br /&gt;
|-&lt;br /&gt;
| az&lt;br /&gt;
|   Osobní číslo je stejné jako login.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. Pravidlo 3/4. Pokud nastavena hodnota ''true'', pak je vyžadováno následující: Heslo musí obsahovat minimálně 3 typy následujících znaků: číslice, malá písmena, velká písmena, speciální znaky.  || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43941</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43941"/>
		<updated>2022-10-31T14:32:34Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přihlášení databázovým účtem */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů na přihlašovací stránce získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutím na tlačítko „Odhlásit“. Tento způsob přihlášení, narozdíl od windows SSO, je možno použít i pro uživatele hlásící se zvenku, mimo firemní síť (samozřejmě jen pokud je portál vystaven veřejně).&lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že při AD autentizaci nezáleží na velikosti písmen a umožňuje použít různé formáty loginů a různé tvary domény (a při některých konfiguracích i bez domény) a při definici práv v KS je rovněž možno používat různé formáty loginů, je nutné nastavit parametr SparovaniUziv na CI-BezDomeny, aby systém při načítání práv z KS databáze pro autentizovaného uživatele ignoroval velikost písmen i doménu, jinak se práva nebudou načítat jednotně a budou záviset na tom, v jakém tvaru uživatel zadá svůj login!&lt;br /&gt;
&lt;br /&gt;
Lze se přihlašovat i tvarem loginu bez domény pokud je parametr SparovaniUzivAD (jiný parametr než výše) nastaven na hodnotu true.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel. Od verze 7641A je nutno nastavit i parametr TypOvereni na hodnotu sql.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;sql&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|-&lt;br /&gt;
| eos4&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 4.&lt;br /&gt;
|-&lt;br /&gt;
| az&lt;br /&gt;
|   Osobní číslo je stejné jako login.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. Pravidlo 3/4. Pokud nastavena hodnota ''true'', pak je vyžadováno následující: Heslo musí obsahovat minimálně 3 typy následujících znaků: číslice, malá písmena, velká písmena, speciální znaky.  || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43913</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43913"/>
		<updated>2022-10-21T13:39:43Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Zdroj informace pro vazbu login - osobní číslo */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů na přihlašovací stránce získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutím na tlačítko „Odhlásit“. Tento způsob přihlášení, narozdíl od windows SSO, je možno použít i pro uživatele hlásící se zvenku, mimo firemní síť (samozřejmě jen pokud je portál vystaven veřejně).&lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že při AD autentizaci nezáleží na velikosti písmen a umožňuje použít různé formáty loginů a různé tvary domény (a při některých konfiguracích i bez domény) a při definici práv v KS je rovněž možno používat různé formáty loginů, je nutné nastavit parametr SparovaniUziv na CI-BezDomeny, aby systém při načítání práv z KS databáze pro autentizovaného uživatele ignoroval velikost písmen i doménu, jinak se práva nebudou načítat jednotně a budou záviset na tom, v jakém tvaru uživatel zadá svůj login!&lt;br /&gt;
&lt;br /&gt;
Lze se přihlašovat i tvarem loginu bez domény pokud je parametr SparovaniUzivAD (jiný parametr než výše) nastaven na hodnotu true.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|-&lt;br /&gt;
| eos4&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu verze 4.&lt;br /&gt;
|-&lt;br /&gt;
| az&lt;br /&gt;
|   Osobní číslo je stejné jako login.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-&lt;br /&gt;
| ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. Pravidlo 3/4. Pokud nastavena hodnota ''true'', pak je vyžadováno následující: Heslo musí obsahovat minimálně 3 typy následujících znaků: číslice, malá písmena, velká písmena, speciální znaky.  || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43864</id>
		<title>Aktualizace pomocí utility MaPSetup</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43864"/>
		<updated>2022-09-23T11:29:23Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Aktualizace pomocí utility MaPSetup''' je jeden z možných způsobů aktualizací aplikací Ks mzdy, KS portál a Aplikační server KS, ostatní způsoby aktualizace jsou popsány v následujících samostatných stránkách:&lt;br /&gt;
[[Image: Mapsetup 1.png|500px|right]]&lt;br /&gt;
# [[Aktualizace aplikace KS mzdy]].&lt;br /&gt;
# [[Portál-Aktualizace]]&lt;br /&gt;
# [[Aktualizace (Aplikační server KS)]]&lt;br /&gt;
&lt;br /&gt;
== Umístění ==&lt;br /&gt;
Utilita ''MaPSetup'' je součástí aplikace KS mzdy a je tedy ve složce MaP. MaPSetup lze stáhnout i [https://download.ksprogram.cz/download/MapSetup.zip zde] jako ZIP archív ''MapSetup.zip'', který rozbalte do libovolné složky.&lt;br /&gt;
&lt;br /&gt;
== Poslední změny ==&lt;br /&gt;
Ve verzi 10.0 byla pro volbu AS zrušena volba &amp;quot;jednoduchý režim&amp;quot; a &amp;quot;expertní režim&amp;quot;, nyní je pouze jeden. V okně s výběrem akce, pro produkt AS, se volba &amp;quot;Instalace&amp;quot; změní na &amp;quot;Změna instalace (přidání/odebrání instance)&amp;quot; pokud je AS nainstalován. Tato volba otevírá okno pro konfiguraci seznamu instancí AS, okno vychází z původního okna &amp;quot;Expertní konfigurátor AS&amp;quot;. Bylo zamezeno volit si u každé instance AS umístění mimo instalační složku, volba názvu podsložky zůstala. Ruční vložení a smazání řádku v seznamu instancí bylo zakázáno a nyní slouží k tomuto účelu tlačítka &amp;quot;Přidat instanci&amp;quot; a &amp;quot;Odebrat instanci&amp;quot;. V prvním sloupci &amp;quot;Akce&amp;quot; je informace, zda bude provedena aktualizace/instalace či odebrání instance. Byl přidán sloupec &amp;quot;TCP Port&amp;quot; pro možnost změnit si předdefinovaný port webových služeb aplikačního serveru. Opraveno přehození připojovacích řetězců k databázi mezi jednotlivými instancemi po odebrání instance AS (která nebyla poslední instancí). Kompletní seznam změn ve verzi 10.0 je [https://download.ksprogram.cz/download/MapSetupChanges.txt zde].&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
'''1.''' '''Spusťte''' aplikaci '''''MaPSetup.exe'''''. &amp;lt;br&amp;gt;&lt;br /&gt;
Poznámka: Spouštějte aplikaci pod účtem s oprávněním ''Správce počítače'' &amp;lt;small&amp;gt;(Windows: Účty - Správce)&amp;lt;/small&amp;gt;, jinak nemusíte mít oprávnění měnit soubory aplikace. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor].&lt;br /&gt;
&lt;br /&gt;
'''2.''' V prvním okně '''vyberte produkt'''.&lt;br /&gt;
&lt;br /&gt;
'''3.''' Další okna spouští '''samotnou aktualizaci''' (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;MaPSetup&amp;lt;/small&amp;gt;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
|&amp;lt;small&amp;gt;Produkt&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 2&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 3&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|rowspan = &amp;quot;5&amp;quot;|[[Image: Mapsetup 1.png|100px|right]]&lt;br /&gt;
|-&lt;br /&gt;
|[[Image: Mapsetup 1-1.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-2.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-2-2.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-3.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-3-1.png|100px]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: [[Image: Mapsetup mate-nainstalovanu-nejnovejsi-verzi.png|50px]].&lt;br /&gt;
&lt;br /&gt;
== Instrukce a parametry MaPSetup ==&lt;br /&gt;
Pomocí instrukcí a parametrů lze dosáhnout cíleného spouštění, např. aktualizace konkrétního typu, do určitého adresáře, apod. Mohou být založeny například 3 ikony, každá pro aktualizaci samostatného produktu.&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Instrukce MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Instrukce'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /UPDATE'''&lt;br /&gt;
|Provede akci aktualizace. Povinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOCHECK'''&lt;br /&gt;
| Vypne kontrolu, zda-li je už nové sestavení (verze) nainstalováno a zaktualizuje. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /REGISTER'''&lt;br /&gt;
| Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /CLOSE'''&lt;br /&gt;
|Automaticky se zavře poslední okno po provedení aktualizace. Nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /AUTO'''&lt;br /&gt;
|Automaticky se stiskne tlačítko Další nebo Aktualizovat. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SILENT'''&lt;br /&gt;
|Tichý režim bez GUI. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOLOG'''&lt;br /&gt;
|Nebude logovat. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /FORCEVERSION'''&lt;br /&gt;
|Vynutí specifickou verzi.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SETPROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|-&lt;br /&gt;
|''' /PROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Parametry MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Parametr'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /TYPE typ'''&lt;br /&gt;
|Může nabývat jednu z těchto hodnot:&lt;br /&gt;
* TK (KS mzdy PROFi)&lt;br /&gt;
* WK (KS portál)&lt;br /&gt;
* AS (KS aplikační server)&lt;br /&gt;
Povinný parametr.&lt;br /&gt;
|-&lt;br /&gt;
|''' /ICO identifikační číslo'''&lt;br /&gt;
|Identifikační číslo IČ organizace (platné u typů TK, WK), pro níž je sestavení uvolněno. Pokud není uvedeno, zaktualizuje se na poslední standardní sestavení (uvolněné všem uživatelům).&lt;br /&gt;
|-&lt;br /&gt;
|''' /DLL složka'''&lt;br /&gt;
| Zaregistruje DLL knihovny (COM komponenty knihoven KSOleModul.dll a KSNetBridge.dll) do registru s explicitním uvedením cesty (platné u typu TK). (Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak musela být na lokálním počítači uvedená cesta do serverového umístění KS mzdy PROFi. Pokud již DLL knihovny jsou zaregistrované, je opakované použití parametru zbytečné.) Registrace DLL již není nutná (díky main.exe.manifest), pokud však již byla provedena, může být toto potřeba, pokud hodnota v registru odkazuje na již neplatné umístění. Nepovinné. &lt;br /&gt;
|-&lt;br /&gt;
|''' /AKTUALIZOVAT_Z'''&lt;br /&gt;
| Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na vašem aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru [[AKTUALIZOVAT_Z (sk.13)]]; v tom případě je parametr povinný, jinak si lokální stanice opět stáhne starou verzi z vašeho aktualizačního serveru.&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE1 složka''' &lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE2 složka'''&lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem - pokud existuje i vedlejší instance (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
* Na '''pořadí a velikosti písmen''' v instrukcích a parametrech '''nezáleží'''.&lt;br /&gt;
* Stejně tak '''nezáleží na sklonu lomítka'''.&lt;br /&gt;
* Pokud se povinné parametry či instrukce pro daný typ neuvedou, spustí se grafické rozhraní MaPSetup.&lt;br /&gt;
* V případě, že se v cestě u některého z parametrů (DLL, AKTUALIZOVAT_Z, INSTANCE1, INSTANCE2) vyskytuje '''mezera, uvozte tuto cestu uvozovkami &amp;quot; &amp;quot;'''.&lt;br /&gt;
&lt;br /&gt;
=== Příklady ===&lt;br /&gt;
Aktualizace KS mzdy PROFi&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678  /TYPE TK /AKTUALIZOVAT_Z &amp;quot;X:\KS Program\AktualizaceAplikace&amp;quot;&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /NOCHECK&lt;br /&gt;
&lt;br /&gt;
Aktualizace aplikace KS portál&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal\Hlavni /INSTANCE2 D:\KSPortal\Test&lt;br /&gt;
&lt;br /&gt;
Uvedené IČ je pouze ilustrativní.&lt;br /&gt;
&lt;br /&gt;
== Poznámky ==&lt;br /&gt;
Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [https://download.ksprogram.cz/download]. Počítač toho, kdo provádí aktualizaci, tedy nesmí mít blokován přístup k této adrese antivirem či podnikovým firewalem.&lt;br /&gt;
&lt;br /&gt;
Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. &amp;lt;small&amp;gt;HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí. &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Aktualizace aplikace KS mzdy]]&lt;br /&gt;
* &amp;lt;small&amp;gt;[[Aktualizace aplikace]] &amp;lt;/small&amp;gt;&lt;br /&gt;
* &amp;lt;small&amp;gt;&amp;lt;s&amp;gt;[[Aktualizace pomocí utility MaPSetup - starší verze 1]]&amp;lt;/s&amp;gt;&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43863</id>
		<title>Aktualizace pomocí utility MaPSetup</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43863"/>
		<updated>2022-09-23T11:26:36Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Aktualizace pomocí utility MaPSetup''' je jeden z možných způsobů aktualizací aplikací Ks mzdy, KS portál a Aplikační server KS, ostatní způsoby aktualizace jsou popsány v následujících samostatných stránkách:&lt;br /&gt;
[[Image: Mapsetup 1.png|500px|right]]&lt;br /&gt;
# [[Aktualizace aplikace KS mzdy]].&lt;br /&gt;
# [[Portál-Aktualizace]]&lt;br /&gt;
# [[Aktualizace (Aplikační server KS)]]&lt;br /&gt;
&lt;br /&gt;
== Umístění ==&lt;br /&gt;
Utilita ''MaPSetup'' je součástí aplikace KS mzdy a je tedy ve složce MaP. MaPSetup lze stáhnout i [https://download.ksprogram.cz/download/MapSetup.zip zde] jako ZIP archív ''MapSetup.zip'', který rozbalte do libovolné složky.&lt;br /&gt;
&lt;br /&gt;
== Poslední změny ==&lt;br /&gt;
Ve verzi 10.0 byla pro volbu AS zrušena volba &amp;quot;jednoduchý režim&amp;quot; a &amp;quot;expertní režim&amp;quot;, nyní je pouze jeden. V okně s výběrem akce, pro produkt AS, se volba &amp;quot;Instalace&amp;quot; změní na &amp;quot;Změna instalace (přidání/odebrání instance)&amp;quot; pokud je AS nainstalován. Tato volba otevírá okno pro konfiguraci seznamu instancí AS, okno vychází z původního okna &amp;quot;Expertní konfigurátor AS&amp;quot;. Bylo zamezeno volit si u každé instance AS umístění mimo instalační složku, volba názvu podsložky zůstala. Ruční vložení a smazání řádku v seznamu instancí bylo zakázáno a nyní slouží k tomuto účelu tlačítka &amp;quot;Přidat instanci&amp;quot; a &amp;quot;Odebrat instanci&amp;quot;. V prvním sloupci &amp;quot;Akce&amp;quot; je informace, zda bude provedena aktualizace/instalace či odebrání instance. Byl přidán sloupec &amp;quot;TCP Port&amp;quot; pro možnost změnit si předdefinovaný port webových služeb aplikačního serveru. Opraveno přehození připojovacích řetězců k databázi mezi jednotlivými instancemi po odebrání instance AS (která nebyla poslední instancí). Kompletní seznam změn [https://download.ksprogram.cz/download/MapSetupChanges.txt zde].&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
'''1.''' '''Spusťte''' aplikaci '''''MaPSetup.exe'''''. &amp;lt;br&amp;gt;&lt;br /&gt;
Poznámka: Spouštějte aplikaci pod účtem s oprávněním ''Správce počítače'' &amp;lt;small&amp;gt;(Windows: Účty - Správce)&amp;lt;/small&amp;gt;, jinak nemusíte mít oprávnění měnit soubory aplikace. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor].&lt;br /&gt;
&lt;br /&gt;
'''2.''' V prvním okně '''vyberte produkt'''.&lt;br /&gt;
&lt;br /&gt;
'''3.''' Další okna spouští '''samotnou aktualizaci''' (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;MaPSetup&amp;lt;/small&amp;gt;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
|&amp;lt;small&amp;gt;Produkt&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 2&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 3&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|rowspan = &amp;quot;5&amp;quot;|[[Image: Mapsetup 1.png|100px|right]]&lt;br /&gt;
|-&lt;br /&gt;
|[[Image: Mapsetup 1-1.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-2.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-2-2.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-3.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-3-1.png|100px]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: [[Image: Mapsetup mate-nainstalovanu-nejnovejsi-verzi.png|50px]].&lt;br /&gt;
&lt;br /&gt;
== Instrukce a parametry MaPSetup ==&lt;br /&gt;
Pomocí instrukcí a parametrů lze dosáhnout cíleného spouštění, např. aktualizace konkrétního typu, do určitého adresáře, apod. Mohou být založeny například 3 ikony, každá pro aktualizaci samostatného produktu.&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Instrukce MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Instrukce'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /UPDATE'''&lt;br /&gt;
|Provede akci aktualizace. Povinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOCHECK'''&lt;br /&gt;
| Vypne kontrolu, zda-li je už nové sestavení (verze) nainstalováno a zaktualizuje. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /REGISTER'''&lt;br /&gt;
| Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /CLOSE'''&lt;br /&gt;
|Automaticky se zavře poslední okno po provedení aktualizace. Nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /AUTO'''&lt;br /&gt;
|Automaticky se stiskne tlačítko Další nebo Aktualizovat. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SILENT'''&lt;br /&gt;
|Tichý režim bez GUI. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOLOG'''&lt;br /&gt;
|Nebude logovat. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /FORCEVERSION'''&lt;br /&gt;
|Vynutí specifickou verzi.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SETPROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|-&lt;br /&gt;
|''' /PROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Parametry MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Parametr'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /TYPE typ'''&lt;br /&gt;
|Může nabývat jednu z těchto hodnot:&lt;br /&gt;
* TK (KS mzdy PROFi)&lt;br /&gt;
* WK (KS portál)&lt;br /&gt;
* AS (KS aplikační server)&lt;br /&gt;
Povinný parametr.&lt;br /&gt;
|-&lt;br /&gt;
|''' /ICO identifikační číslo'''&lt;br /&gt;
|Identifikační číslo IČ organizace (platné u typů TK, WK), pro níž je sestavení uvolněno. Pokud není uvedeno, zaktualizuje se na poslední standardní sestavení (uvolněné všem uživatelům).&lt;br /&gt;
|-&lt;br /&gt;
|''' /DLL složka'''&lt;br /&gt;
| Zaregistruje DLL knihovny (COM komponenty knihoven KSOleModul.dll a KSNetBridge.dll) do registru s explicitním uvedením cesty (platné u typu TK). (Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak musela být na lokálním počítači uvedená cesta do serverového umístění KS mzdy PROFi. Pokud již DLL knihovny jsou zaregistrované, je opakované použití parametru zbytečné.) Registrace DLL již není nutná (díky main.exe.manifest), pokud však již byla provedena, může být toto potřeba, pokud hodnota v registru odkazuje na již neplatné umístění. Nepovinné. &lt;br /&gt;
|-&lt;br /&gt;
|''' /AKTUALIZOVAT_Z'''&lt;br /&gt;
| Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na vašem aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru [[AKTUALIZOVAT_Z (sk.13)]]; v tom případě je parametr povinný, jinak si lokální stanice opět stáhne starou verzi z vašeho aktualizačního serveru.&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE1 složka''' &lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE2 složka'''&lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem - pokud existuje i vedlejší instance (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
* Na '''pořadí a velikosti písmen''' v instrukcích a parametrech '''nezáleží'''.&lt;br /&gt;
* Stejně tak '''nezáleží na sklonu lomítka'''.&lt;br /&gt;
* Pokud se povinné parametry či instrukce pro daný typ neuvedou, spustí se grafické rozhraní MaPSetup.&lt;br /&gt;
* V případě, že se v cestě u některého z parametrů (DLL, AKTUALIZOVAT_Z, INSTANCE1, INSTANCE2) vyskytuje '''mezera, uvozte tuto cestu uvozovkami &amp;quot; &amp;quot;'''.&lt;br /&gt;
&lt;br /&gt;
=== Příklady ===&lt;br /&gt;
Aktualizace KS mzdy PROFi&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678  /TYPE TK /AKTUALIZOVAT_Z &amp;quot;X:\KS Program\AktualizaceAplikace&amp;quot;&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /NOCHECK&lt;br /&gt;
&lt;br /&gt;
Aktualizace aplikace KS portál&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal\Hlavni /INSTANCE2 D:\KSPortal\Test&lt;br /&gt;
&lt;br /&gt;
Uvedené IČ je pouze ilustrativní.&lt;br /&gt;
&lt;br /&gt;
== Poznámky ==&lt;br /&gt;
Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [https://download.ksprogram.cz/download]. Počítač toho, kdo provádí aktualizaci, tedy nesmí mít blokován přístup k této adrese antivirem či podnikovým firewalem.&lt;br /&gt;
&lt;br /&gt;
Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. &amp;lt;small&amp;gt;HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí. &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Aktualizace aplikace KS mzdy]]&lt;br /&gt;
* &amp;lt;small&amp;gt;[[Aktualizace aplikace]] &amp;lt;/small&amp;gt;&lt;br /&gt;
* &amp;lt;small&amp;gt;&amp;lt;s&amp;gt;[[Aktualizace pomocí utility MaPSetup - starší verze 1]]&amp;lt;/s&amp;gt;&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43862</id>
		<title>Aktualizace pomocí utility MaPSetup</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Aktualizace_pomoc%C3%AD_utility_MaPSetup&amp;diff=43862"/>
		<updated>2022-09-23T11:25:12Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Aktualizace pomocí utility MaPSetup''' je jeden z možných způsobů aktualizací aplikací Ks mzdy, KS portál a Aplikační server KS, ostatní způsoby aktualizace jsou popsány v následujících samostatných stránkách:&lt;br /&gt;
[[Image: Mapsetup 1.png|500px|right]]&lt;br /&gt;
# [[Aktualizace aplikace KS mzdy]].&lt;br /&gt;
# [[Portál-Aktualizace]]&lt;br /&gt;
# [[Aktualizace (Aplikační server KS)]]&lt;br /&gt;
&lt;br /&gt;
== Umístění ==&lt;br /&gt;
Utilita ''MaPSetup'' je součástí aplikace KS mzdy a je tedy ve složce MaP. MaPSetup lze stáhnout i [https://download.ksprogram.cz/download/MapSetup.zip zde] jako ZIP archív ''MapSetup.zip'', který rozbalte do libovolné složky.&lt;br /&gt;
&lt;br /&gt;
== Poslední změny ==&lt;br /&gt;
Ve verzi 10.0 bylo pro volbu AS zrušena volba &amp;quot;jednoduchý režim&amp;quot; a &amp;quot;expertní režim&amp;quot;, nyní je pouze jeden. V okně s výběrem akce, pro produkt AS, se volba &amp;quot;Instalace&amp;quot; změní na &amp;quot;Změna instalace (přidání/odebrání instance)&amp;quot; pokud je AS nainstalován. Tato volba otevírá okno pro konfiguraci seznamu instancí AS, okno vychází z původního okna &amp;quot;Expertní konfigurátor AS&amp;quot;. Bylo zamezeno volit si u každé instance AS umístění mimo instalační složku, volba názvu podsložky zůstala. Ruční vložení a smazání řádku v seznamu instancí bylo zakázáno a nyní slouží k tomuto účelu tlačítka &amp;quot;Přidat instanci&amp;quot; a &amp;quot;Odebrat instanci&amp;quot;. V prvním sloupci &amp;quot;Akce&amp;quot; je informace, zda bude provedena aktualizace/instalace či odebrání instance. Byl přidán sloupec &amp;quot;TCP Port&amp;quot; pro možnost změnit si předdefinovaný port webových služeb aplikačního serveru. Opraveno přehození připojovacích řetězců k databázi mezi jednotlivými instancemi po odebrání instance AS (která nebyla poslední instancí). Kompletní seznam změn [https://download.ksprogram.cz/download/MapSetupChanges.txt zde].&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
'''1.''' '''Spusťte''' aplikaci '''''MaPSetup.exe'''''. &amp;lt;br&amp;gt;&lt;br /&gt;
Poznámka: Spouštějte aplikaci pod účtem s oprávněním ''Správce počítače'' &amp;lt;small&amp;gt;(Windows: Účty - Správce)&amp;lt;/small&amp;gt;, jinak nemusíte mít oprávnění měnit soubory aplikace. Pokud je toto splněno, objeví se po spuštění v titulku okna nápis [Administrátor].&lt;br /&gt;
&lt;br /&gt;
'''2.''' V prvním okně '''vyberte produkt'''.&lt;br /&gt;
&lt;br /&gt;
'''3.''' Další okna spouští '''samotnou aktualizaci''' (příp. slouží k nastavení konfigurace před aktualizací či provedení jiných akcí).&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;MaPSetup&amp;lt;/small&amp;gt;&lt;br /&gt;
|- style=&amp;quot;background-color: #eeeeee&amp;quot;&lt;br /&gt;
|&amp;lt;small&amp;gt;Produkt&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 2&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;Okno č. 3&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|rowspan = &amp;quot;5&amp;quot;|[[Image: Mapsetup 1.png|100px|right]]&lt;br /&gt;
|-&lt;br /&gt;
|[[Image: Mapsetup 1-1.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-2.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-2-2.png|100px]]&lt;br /&gt;
|-&lt;br /&gt;
| [[Image: Mapsetup 1-3.png|100px]]&lt;br /&gt;
| [[Image: Mapsetup 1-3-1.png|100px]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pokud je již nainstalováno nejnovější sestavení aplikace, zobrazí se hláška: [[Image: Mapsetup mate-nainstalovanu-nejnovejsi-verzi.png|50px]].&lt;br /&gt;
&lt;br /&gt;
== Instrukce a parametry MaPSetup ==&lt;br /&gt;
Pomocí instrukcí a parametrů lze dosáhnout cíleného spouštění, např. aktualizace konkrétního typu, do určitého adresáře, apod. Mohou být založeny například 3 ikony, každá pro aktualizaci samostatného produktu.&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Instrukce MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Instrukce'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /UPDATE'''&lt;br /&gt;
|Provede akci aktualizace. Povinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOCHECK'''&lt;br /&gt;
| Vypne kontrolu, zda-li je už nové sestavení (verze) nainstalováno a zaktualizuje. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /REGISTER'''&lt;br /&gt;
| Zaregistruje DLL knihovny do registru. Povinné, pokud nejsou registrované knihovny. Jinak nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /CLOSE'''&lt;br /&gt;
|Automaticky se zavře poslední okno po provedení aktualizace. Nepovinné.&lt;br /&gt;
|- &lt;br /&gt;
|''' /AUTO'''&lt;br /&gt;
|Automaticky se stiskne tlačítko Další nebo Aktualizovat. Nepovinné.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SILENT'''&lt;br /&gt;
|Tichý režim bez GUI. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /NOLOG'''&lt;br /&gt;
|Nebude logovat. Nepovinné&lt;br /&gt;
|-&lt;br /&gt;
|''' /FORCEVERSION'''&lt;br /&gt;
|Vynutí specifickou verzi.&lt;br /&gt;
|-&lt;br /&gt;
|''' /SETPROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|-&lt;br /&gt;
|''' /PROXY'''&lt;br /&gt;
| [[MaPSetup (Proxy)]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable sortable&amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Parametry MaPSetup.exe&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Parametr'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|&amp;lt;small&amp;gt;'''Popis'''&amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|''' /TYPE typ'''&lt;br /&gt;
|Může nabývat jednu z těchto hodnot:&lt;br /&gt;
* TK (KS mzdy PROFi)&lt;br /&gt;
* WK (KS portál)&lt;br /&gt;
* AS (KS aplikační server)&lt;br /&gt;
Povinný parametr.&lt;br /&gt;
|-&lt;br /&gt;
|''' /ICO identifikační číslo'''&lt;br /&gt;
|Identifikační číslo IČ organizace (platné u typů TK, WK), pro níž je sestavení uvolněno. Pokud není uvedeno, zaktualizuje se na poslední standardní sestavení (uvolněné všem uživatelům).&lt;br /&gt;
|-&lt;br /&gt;
|''' /DLL složka'''&lt;br /&gt;
| Zaregistruje DLL knihovny (COM komponenty knihoven KSOleModul.dll a KSNetBridge.dll) do registru s explicitním uvedením cesty (platné u typu TK). (Pokud je KS mzdy PROFi nainstalován na serveru a uživatelé jej spouštění vzdáleně, pak musela být na lokálním počítači uvedená cesta do serverového umístění KS mzdy PROFi. Pokud již DLL knihovny jsou zaregistrované, je opakované použití parametru zbytečné.) Registrace DLL již není nutná (díky main.exe.manifest), pokud však již byla provedena, může být toto potřeba, pokud hodnota v registru odkazuje na již neplatné umístění. Nepovinné. &lt;br /&gt;
|-&lt;br /&gt;
|''' /AKTUALIZOVAT_Z'''&lt;br /&gt;
| Pro typ TK. Nepovinné. Aktualizuje soubory jak na lokálním počítači tak na vašem aktualizačním serveru. Platí pro případ, kdy se aplikace KS mzdy PROFi na lokálních stanicích aktualizují z umístění uvedeného v parametru [[AKTUALIZOVAT_Z (sk.13)]]; v tom případě je parametr povinný, jinak si lokální stanice opět stáhne starou verzi z vašeho aktualizačního serveru.&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE1 složka''' &lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|-&lt;br /&gt;
|''' /INSTANCE2 složka'''&lt;br /&gt;
| Aktualizuje portál v umístění uvedeném za tímto parametrem - pokud existuje i vedlejší instance (platné jen pro typ WK - pro něj povinné).&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
* Na '''pořadí a velikosti písmen''' v instrukcích a parametrech '''nezáleží'''.&lt;br /&gt;
* Stejně tak '''nezáleží na sklonu lomítka'''.&lt;br /&gt;
* Pokud se povinné parametry či instrukce pro daný typ neuvedou, spustí se grafické rozhraní MaPSetup.&lt;br /&gt;
* V případě, že se v cestě u některého z parametrů (DLL, AKTUALIZOVAT_Z, INSTANCE1, INSTANCE2) vyskytuje '''mezera, uvozte tuto cestu uvozovkami &amp;quot; &amp;quot;'''.&lt;br /&gt;
&lt;br /&gt;
=== Příklady ===&lt;br /&gt;
Aktualizace KS mzdy PROFi&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678  /TYPE TK /AKTUALIZOVAT_Z &amp;quot;X:\KS Program\AktualizaceAplikace&amp;quot;&lt;br /&gt;
 MaPSetup.exe /UPDATE /ICO 12345678 /TYPE TK /NOCHECK&lt;br /&gt;
&lt;br /&gt;
Aktualizace aplikace KS portál&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal&lt;br /&gt;
 MaPSetup.exe /UPDATE /TYPE WK /ICO 12345678 /INSTANCE1 D:\KSPortal\Hlavni /INSTANCE2 D:\KSPortal\Test&lt;br /&gt;
&lt;br /&gt;
Uvedené IČ je pouze ilustrativní.&lt;br /&gt;
&lt;br /&gt;
== Poznámky ==&lt;br /&gt;
Soubory pro aktualizaci (sbalené ve formě .ZIP) jsou získávány z webu [https://download.ksprogram.cz/download]. Počítač toho, kdo provádí aktualizaci, tedy nesmí mít blokován přístup k této adrese antivirem či podnikovým firewalem.&lt;br /&gt;
&lt;br /&gt;
Cesta pro aktualizaci aplikace KS mzdy PROFi je vyhledána automaticky z registrů Windows. &amp;lt;small&amp;gt;HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft Windows/Current Version/APPPath/main.exe. Pokud je zde více klíčů, bere se v úvahu první, výchozí. &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Aktualizace aplikace KS mzdy]]&lt;br /&gt;
* &amp;lt;small&amp;gt;[[Aktualizace aplikace]] &amp;lt;/small&amp;gt;&lt;br /&gt;
* &amp;lt;small&amp;gt;&amp;lt;s&amp;gt;[[Aktualizace pomocí utility MaPSetup - starší verze 1]]&amp;lt;/s&amp;gt;&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43256</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43256"/>
		<updated>2022-04-26T13:15:15Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přihlášení active directory účtem */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů na přihlašovací stránce získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutím na tlačítko „Odhlásit“. Tento způsob přihlášení, narozdíl od windows SSO, je možno použít i pro uživatele hlásící se zvenku, mimo firemní síť (samozřejmě jen pokud je portál vystaven veřejně).&lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že při AD autentizaci nezáleží na velikosti písmen a umožňuje použít různé formáty loginů a různé tvary domény (a při některých konfiguracích i bez domény) a při definici práv v KS je rovněž možno používat různé formáty loginů, je nutné nastavit parametr SparovaniUziv na CI-BezDomeny, aby systém při načítání práv z KS databáze pro autentizovaného uživatele ignoroval velikost písmen i doménu, jinak se práva nebudou načítat jednotně a budou záviset na tom, v jakém tvaru uživatel zadá svůj login!&lt;br /&gt;
&lt;br /&gt;
Lze se přihlašovat i tvarem loginu bez domény pokud je parametr SparovaniUzivAD (jiný parametr než výše) nastaven na hodnotu true.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43253</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43253"/>
		<updated>2022-04-26T09:01:54Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přihlášení active directory účtem */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit na přihlašovací stránce přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. &lt;br /&gt;
&lt;br /&gt;
Vzhledem k tomu, že AD není case sensitivní a umožňuje při autentizaci použít různé tvary loginů, je nutné nastavit parametr SparovaniUziv, aby byl systém schopen nalézt uživatele v KS databázi pot tvarem loginu, jakým byl do KS naveden.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43252</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43252"/>
		<updated>2022-04-26T08:29:04Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Windows - Systém jednotného přihlášení (SSO) */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo), do portálu se přihlašují automaticky loginem, pod kterým se přihlásili k doménovému serveru prostřednictvím přihlášení do Windows, z čehož vyplývá, že je tento způsob použitelný jen uvnitř firemní sítě (případně za použití VPN).&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit na přihlašovací stránce přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. &lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=43247</id>
		<title>Služební cesty - Slovenská aplikace</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=43247"/>
		<updated>2022-04-22T08:22:59Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Kurzy při vyúčtování */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=== Kurzy při vyúčtování ===&lt;br /&gt;
Při vyúčtování SC používá slovenská verze tyto kurzy, dle platné legislativy:&lt;br /&gt;
&lt;br /&gt;
a) kurz ECB k 1. dni v měsíci (ve kterém SC začíná) a to pouze pro případ uvedený v §36 odst. 6 zákona č. 283/2002, tj. kdy se zaměstnanec se zaměstnavatelem dohodli, že záloha na stravné bude poskytnuta v jiné měně než stanovuje vyhláška pro danou krajinu. Tuto dohodu aplikace neeviduje, ale je možné aktivovat parametr '''slc_strVmenZal''', což způsobí, že aplikace v případě zálohy '''s účelem stravné''' vyplacené v jiné měně než je uvedena v číselníku zahraniční stravné, považuje za stav, že tato dohoda byla učiněna a stravné vygeneruje v měně zálohy. Tj. již nárok na stravné stanoví v dohodnuté měně a stravné v dohodnuté měně vstupuje do vyúčtování, kurz k 1. dni tedy již nevstupuje do vyúčtování ani zaúčtování (závazek z nároku na stravné vzniká v dohodné měně a v dohodnuté měně se o něm i účtuje). Pokud není aktivován parametr slc_strVmenZal, nebo záloha nemá vyplněn účel, může účetní přepnout měnu stravného na záložce stravné a částka se automaticky přepočte kurzem k 1.dni měsíce. &lt;br /&gt;
&lt;br /&gt;
b) kurz doložený zaměstnancem pro směnu zálohy na jinou měnu &lt;br /&gt;
&lt;br /&gt;
c) kurz ECB k předcházejícímu dni poskytnutí zálohy na SC&lt;br /&gt;
&lt;br /&gt;
d) kurz ECB k předcházejícímu dni vyúčtování SC (tj. aplikace bere pro SC jako den uskutečnění účetního případu datum vyúčtování (v praxi se používá i datum předložení dokladů zaměstnancem))&lt;br /&gt;
&lt;br /&gt;
[https://podpora.financnasprava.sk/337635-%C3%9A%C4%8Dtovanie-cestovn%C3%BDch-n%C3%A1hrad---pou%C5%BEitie-kurzu Finančná správa SR/Účtovanie cestovných náhrad - použitie kurzu]&lt;br /&gt;
&lt;br /&gt;
=== Parametry ===&lt;br /&gt;
slc_strVmenZal - Pokud zaměstnanec dostane zálohu na stravné v jiné měně než je ve vyhlášce pro danou cizí zemi, vypočítá se nárok na stravné v měně zálohy, přičemž se použije kurz k 1.dni měsíce kdy cesta začala dle §36(6) 283/2002.&lt;br /&gt;
&lt;br /&gt;
== Číselník tuzemské stravné ==&lt;br /&gt;
&lt;br /&gt;
[[Image: E-sc-cis-tuzemske-stravne-SK.png|700px]]&lt;br /&gt;
&lt;br /&gt;
=== Stravné ===&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Stravné (SK legislativa) v EUR &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|od 1.11.2014&lt;br /&gt;
|od 1.12.2016&lt;br /&gt;
|od 1.6.2018&lt;br /&gt;
|od 1.7.2019 &lt;br /&gt;
|-&lt;br /&gt;
|5 - 12 hod ||4 || 4,20||4,50 || 4,80 || '''5,10'''&lt;br /&gt;
|-&lt;br /&gt;
|12 - 18 hod ||6 ||6,30|| 6,70 || 7,10 || '''7,60'''&lt;br /&gt;
|-&lt;br /&gt;
|více než 18 hod ||9,50 ||9,80 || 10,30 || 10,90 || '''11,60'''&lt;br /&gt;
|}&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
=== Krácení ===&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Krácení (SK legislativa) &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|S = '''25%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|O = '''40%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|V = '''35%'''&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pozor: pro SK legislativu (narozdíl od CZ legislativy) se procenta krácení vztahují vždy k plné sazbě, tj. sazbě pro pásmo &amp;gt; 18h a ne k sazbě pro konkrétní pásmo. Výňatek ze zákona o cestovných náhradách §5 odst.6: &amp;quot;Ak má zamestnanec na pracovnej ceste preukázane zabezpečené bezplatné stravovanie čiastočne, zamestnávateľ stravné určené podľa odsekov 1, 2 alebo 5 kráti o 25 % za bezplatne poskytnuté raňajky, o 40 % za bezplatne poskytnutý obed a o 35 % za bezplatne poskytnutú večeru z ustanovenej sumy stravného pre časové pásmo nad 18 hodín alebo z najvyššej dohodnutej sumy stravného podľa odseku 5.&amp;quot;. Tj. dle zákona se krátí o pevnou částku dle charakteru jídla, bez ohledu na pásmo. Pokud tedy budete mít nastavení dle zákona, např. 25% pro snídani u 1., 2. i 3. pásma, tak je to vždy 25% z plné sazby (ze sazby pro 3. pásmo). Pokud si nastavíte nižší krácení, než stanovuje zákon, např. 10 % pro snídani pro 1. pásmo, částka o kterou krátíte méně než stanovuje zákon se projeví ve sloupci nadlimit stravného).&lt;br /&gt;
&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
=== Spotřeba vozidla a výpočet náhrady za PHM ===&lt;br /&gt;
SK verze vyžaduje zadání všech 3 spotřeb vlastního automobilu, neboť zákon o cestovných náhradách č. 283/2002 vyžaduje při výpočtu náhrad za PHM rozlišovat ujeté kilometry dle cyklů. KS neeviduje, podle jaké normy je zadaná spotřeba, nemá si tedy dle čeho určit, zda pro jízdu po městě zvýšit spotřebu o 40% dle písmene a) či o 20% dle písmene d). Z toho vyplývá, že pokud v TP není spotřeba pro cykly město/mimo město/komb, musíte jednotlivé spotřeby odvodit(dopočítat) dle §7 odstavce 6 a zadat je do evidence vozidel:&lt;br /&gt;
&lt;br /&gt;
'''(6) Spotreba podľa technického preukazu sa použije takto:'''&lt;br /&gt;
&lt;br /&gt;
'''a)''' ak je v technickom preukaze uvedená spotreba len podľa príslušnej slovenskej technickej normy, na výpočet sa použije spotreba podľa tejto normy; pri jazde cestného motorového vozidla v meste sa spotreba určená podľa slovenskej technickej normy zvýši o 40 %,&lt;br /&gt;
&lt;br /&gt;
'''Tzn. kombinovaná = X, město = 1.4*X, mimo = X'''&lt;br /&gt;
&lt;br /&gt;
'''b)''' ak je v technickom preukaze uvedená spotreba podľa slovenskej technickej normy aj predpisu Európskej hospodárskej komisie alebo len podľa predpisu Európskej hospodárskej komisie, na výpočet sa použije spotreba podľa predpisu Európskej hospodárskej komisie vypočítaná aritmetickým priemerom; pri jazde cestného motorového vozidla v meste sa použije spotreba určená na jazdu v meste,&lt;br /&gt;
&lt;br /&gt;
'''Tzn. kombinovaná = průměr, město = město, mimo = průměr'''&lt;br /&gt;
&lt;br /&gt;
'''c)''' ak je v technickom preukaze uvedená spotreba podľa osobitného predpisu8a) v členení na mestský cyklus, mimomestský cyklus a kombinovaný cyklus, na výpočet sa použije spotreba zodpovedajúca príslušnému cyklu premávky alebo kombinácii jednotlivých cyklov premávky, odvodených od konkrétneho režimu jazdy cestného motorového vozidla,&lt;br /&gt;
&lt;br /&gt;
'''(V TP jsou přímo položky město, mimo město, kombinovaná)'''&lt;br /&gt;
&lt;br /&gt;
'''d)''' ak je v technickom preukaze cestného motorového vozidla uvedená spotreba podľa osobitného predpisu8a) bez členenia na cykly, na výpočet sa použije spotreba podľa tohto osobitného predpisu; pri jazde cestného motorového vozidla v meste sa spotreba zvýši o 20 %.&lt;br /&gt;
&lt;br /&gt;
'''Tzn. kombinovaná = X, město = 1.2*X, mimo = X'''&lt;br /&gt;
&lt;br /&gt;
Pokud upravujete spotřebu vozidla v evidenci vozidel, které již máte v rozpracovaném cestovním příkaze, musíte jednotlivé spotřeby upravit i v &amp;quot;hlavičce&amp;quot; cestovního příkazu a následně přepočítat náhrady. (aplikace nepočítá s tím, že by se spotřeba vozidla během pár dnů mohla změnit, zároveň ty hodnoty tam slouží pro vozidlo nenavedené do evidence vozidel).&lt;br /&gt;
&lt;br /&gt;
[[Služební cesty|zpět]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43214</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43214"/>
		<updated>2022-04-12T14:39:54Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přístupová práva uživatelů */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo). Do portálu se přihlašují automaticky loginem, pod kterým se přihlásili do Windows.&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit na přihlašovací stránce přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. &lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvider – načítá aplikační role z Active Directory (AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí)&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43213</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43213"/>
		<updated>2022-04-12T14:38:19Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Další možnosti nastavení */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo). Do portálu se přihlašují automaticky loginem, pod kterým se přihlásili do Windows.&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit na přihlašovací stránce přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. &lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvide – načítá aplikační role z Active Directory&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43212</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43212"/>
		<updated>2022-04-12T14:33:31Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Způsob ověření uživatelů */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo). Do portálu se přihlašují automaticky loginem, pod kterým se přihlásili do Windows.&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit na přihlašovací stránce přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. &lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Zdroj informace pro vazbu login - osobní číslo = &lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se většinou získává ze stejného místa, proti kterému se uživatel ověřuje. Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
'''ZdrojOsCisla'''&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   v případě, že typ_overeni je také nevyplněn, osobní číslo se zjistí z agendy Uživatelé KSPortálu v desktopové aplikaci (aplikaci KS&amp;amp;nbsp;Mzdy). Pokud je typ_overeni=ad, bere se jakoby byl ZdrojOsCisla nastaveno rovněž na hodnotu ad.&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Osobní číslo se zjistí z Active Directory (musí být nastaveny ad_* parametry).&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Osobní číslo se zjistí v Evidenci zaměstnanců na záložce Osobní údaje dle pole Login  &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Osobní číslo se zjistí ze systému EOSu.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Zdroj informace pro vazbu login-OČ''&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvide – načítá aplikační role z Active Directory&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Active directory ==&lt;br /&gt;
=== Typ ověřování ===&lt;br /&gt;
V souboru web.config je možno nově nastavit typ ověřování pro Active Directory přes parametr ad_auth_type.&lt;br /&gt;
Možné hodnoty jsou basic a secure, výchozí hodnota je secure, tj. způsob, který se používal i před úpravou.&lt;br /&gt;
(Tj. pokud je AD a portál na stejném serveru nebo typ secure způsobuje 20s zpoždění, lze typ nastavit na basic)&lt;br /&gt;
&lt;br /&gt;
=== Načítání rolí vzhledem ke skupinám ===&lt;br /&gt;
Změna v načítání rolí z AD (tj. v případě, že je ve web.config defaultProvider nastaven ADRoleProvider): Při načítání rolí (skupin) uživatele z AD se načítaly pouze ty role, ve kterých byl uživatel zařazen přímo. Nově se načtou i role, pod kterými jsou role uživatele zařazeny. Příklad: Novák je členem ve skupině &amp;quot;Vedoucí&amp;quot; a skupina &amp;quot;Vedoucí&amp;quot; je členem ve skupině &amp;quot;Zaměstnanci&amp;quot;, pro Nováka se nově načtou role &amp;quot;Vedoucí&amp;quot; i &amp;quot;Zaměstnanci&amp;quot; (před úpravou jen Vedoucí). Ale zůstává zároveň platit to, že AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí (zde je změna, před úpravou musela začínat &amp;quot;KS_&amp;quot;).&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43211</id>
		<title>Instalační příručka</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Instala%C4%8Dn%C3%AD_p%C5%99%C3%ADru%C4%8Dka&amp;diff=43211"/>
		<updated>2022-04-12T14:07:42Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přihlašování uživatelů KS Portálu */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;{{KS portál}}&lt;br /&gt;
Tento dokument je vlastnictvím společnosti KS-program, spol. s r.o., Vsetín. Slouží pro potřeby školení a studia uživatelů systému Mzdy a personalistika. Žádná část dokumentu nesmí být nijak kopírována, zveřejňována nebo jinak poskytnuta třetím osobám bez předchozího písemného souhlasu odpovědných zástupců KS-program, spol. s r.o. &lt;br /&gt;
&lt;br /&gt;
= Podporované prohlížeče =&lt;br /&gt;
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:&lt;br /&gt;
* '''''Mozilla Firefox'''''&lt;br /&gt;
* '''''Google Chrome'''''&lt;br /&gt;
* '''''Microsoft Edge'''''&lt;br /&gt;
&lt;br /&gt;
Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení). &lt;br /&gt;
=== Historie ===&lt;br /&gt;
: &amp;lt;small&amp;gt;[[Podporované prohlížeče (KS portál) (historie)]] &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
= Co je potřeba ke zprovoznění KS Portálu =&lt;br /&gt;
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS&amp;amp;nbsp;Portál potřebuje cca 100 MB místa na webovém serveru.&lt;br /&gt;
&lt;br /&gt;
* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení). &lt;br /&gt;
&amp;lt;!-- &lt;br /&gt;
Do 1.9.2017 postačilo &lt;br /&gt;
Běhové prostředí .Net Framework 4.0 a vyšší (volně a zdarma ke stažení). &lt;br /&gt;
&lt;br /&gt;
XIV. Změna běhového prostředí Microsoft .Net Framework (Všechny produkty)&lt;br /&gt;
Od 1.9.2017 bude změněno běhové prostředí .Net Framework našich aplikací (KS mzdy PROFI, KS Portál a KS Aplikační Server) na verzi 4.6.1&lt;br /&gt;
Z důvodu přechodu na novější verzi nebudou naše aplikace dále funkční na operačních systémech starších než:&lt;br /&gt;
- Windows Server 2008 R2 ( KS portál a KS Aplikační Server)&lt;br /&gt;
- Windows 7 SP1 (KS mzdy PROFI)&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Vhodné je mít nejprve nainstalovaný webový server IIS a potom teprve nainstalovat .NET Framewok. V tomto pořadí se Framewok sám zaregistruje do IIS. Pokud toto pořadí nemůžete dodržet nebo nevíte v jakém pořadí byly tyto dvě aplikace naistalovány, spusťte registraci Frameworku do IIS ručně  pomocí příkazu (jako správce z příkazové řádky)&amp;lt;br/&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* V IIS musí být povolen ASP modul. Je to ISAPI rozšíření webového serveru, které zpracovává požadavky na stránky s příponou ASPX.&lt;br /&gt;
&lt;br /&gt;
= Jak postupovat při instalaci =&lt;br /&gt;
&lt;br /&gt;
===Aplikace nesmí být instalována jako Web Site===&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
===Pro Windows Server 2008 R2, 2012  (IIS 7) a vyšší===&lt;br /&gt;
&lt;br /&gt;
# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\). &lt;br /&gt;
# Do adresáře ksprtl rozbalte obsah souboru PRTXXXXY.zip (XXXXY - odpovídající verze aplikace). Instalační sadu si stáhněte ' z: http://download.ksprogram.cz/download/&lt;br /&gt;
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu&amp;lt;br/&amp;gt; zápisu do podadresářů Logs a Temp&lt;br /&gt;
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).&lt;br /&gt;
# V základním nastavení vytvořené webové aplikace se ujistěte, že aplikace běží ve fondu aplikací(aplikačním poolu), který využívá .NET Framework v4.&lt;br /&gt;
# V souboru web.config (nebo ve vlastnostech webové aplikace) upravte ConnectionString, tak aby odpovídal vašemu DB připojení. (viz. Nastavení DB připojení).&lt;br /&gt;
&lt;br /&gt;
= Nastavení DB připojení =&lt;br /&gt;
Připojení na databáze MSSQL a Oracle je již implementován přímo v Net Frameworku, takže se pro tyto databázové platformy nemusí nic instalovat. K ostatním databázovým platformám je možné přistupovat prostřednictvím ODBC. Použité ODBC musí podporovat DotNet. Zákazník by měl získat ODBC od svého dodavatele databáze (my jej nedodáváme).&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Databázové připojení v KS&amp;amp;nbsp;Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci &amp;lt;connectionStrings&amp;gt; v souboru web.config v hlavním adresáři aplikace.&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Příklady ConnectionStringu ==&lt;br /&gt;
&lt;br /&gt;
=== Pro MSSQL ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=web_pc;database=mzdy;uid=test;pwd=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro Oracle ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;Data Source=KSPROGRA;User Id=test;Password=test&amp;quot;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
providerName=&amp;quot;System.Data.OracleClient&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pro ODBC ===&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;DSN=i_mzdy&amp;quot; providerName=&amp;quot;System.Data.Odbc&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Položky DB připojení ===&lt;br /&gt;
&lt;br /&gt;
{|&lt;br /&gt;
|name&lt;br /&gt;
| - jméno DB připojení&lt;br /&gt;
|-&lt;br /&gt;
|server&lt;br /&gt;
| - název nebo IP adresa počítače, na kterém běží DB server&lt;br /&gt;
|-&lt;br /&gt;
|database&lt;br /&gt;
| - název databáze, ke které bude chtít být připojeni&lt;br /&gt;
|-&lt;br /&gt;
|uid&lt;br /&gt;
| - login pro přístup do databáze&lt;br /&gt;
|-&lt;br /&gt;
|pwd&lt;br /&gt;
| - heslo pro přístup do databáze&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Doplňující informace ==&lt;br /&gt;
=== Oracle ===&lt;br /&gt;
Na serveru s IIS je potřeba mít stejnou verzi klienta pro Oracle jako je Oracle databáze. Je vyžadován 32 bit oracle client. Na adresář Oracle_home (adresář oracle clienta), nadřízené a podřízené složky musí mít přístup skupina uživatelů Authenticated Users a to právo Read&amp;amp;Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''&lt;br /&gt;
&lt;br /&gt;
Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.&lt;br /&gt;
&lt;br /&gt;
=== PostgreSQL ===&lt;br /&gt;
* [[PostgreSQL]]&lt;br /&gt;
&lt;br /&gt;
== Ze zkušeností ==&lt;br /&gt;
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):&lt;br /&gt;
&lt;br /&gt;
''In fact this kind of error (ORA-12638) has many causes. I had it in 10.2.0.3 due to a bug. And also I had it in 9.2.0.8 because we had some troubles with our Active Directory. When the parameter SQLNET_AUTHENTIFICATION_SERVICES is set to NTS then before the connexion the Oracle server ask for a &amp;quot;ticket&amp;quot; to the Active Directory. And, if it cannot retrieve a valid &amp;quot;ticket&amp;quot; then we have the error ORA-12638.''&lt;br /&gt;
&lt;br /&gt;
''So finally, I set SQLNET_AUTHENTIFICATION_SERVICES = (NTS,NONE) so the OS authentification is not compulsory ant we didn't have the error ORA-12638 anymore.''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Jak je uvedeno výše v anglickém textu, tato chyba může mít více příčin. Problém vzniká tím, že se Oracle snaží uživatele, který přistupuje do DB ověřit proti Active Directory. Do DB přistupujete pod uživatelem, který není naveden v Active Directory. Řešením je vypnout ověření DB uživatele proti Active Directory. Obecně se doporučuje v konfiguračním souboru sqlnet.ora (buď na serveru nebo na klientovi) zaměnit řádek: &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NTS)&amp;lt;/font&amp;gt; za &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;SQLNET.AUTHENTICATION_SERVICES= (NONE)&amp;lt;/font&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS&amp;amp;nbsp;Portál).&lt;br /&gt;
&lt;br /&gt;
= Přihlašování uživatelů KS Portálu =&lt;br /&gt;
KS portál nabízí tyto způsoby přihlašování uživatelů:&lt;br /&gt;
&lt;br /&gt;
- Přihlášení portálovým účtem&lt;br /&gt;
&lt;br /&gt;
- Windows - Systém jednotného přihlášení (SSO)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení active directory účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení databázovým účtem&lt;br /&gt;
&lt;br /&gt;
- Přihlášení přes externí autentizační službu (OAUTH2, SAML2)&lt;br /&gt;
&lt;br /&gt;
- Přihlášení externího uživatele - nezaměstnance&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Při volbě způsobu přihlašování je třeba také pamatovat na to, že po ověření uživatele je potřeba nějak svázat přihlášeného uživatele s konkrétním zaměstnancem v databázi, tedy vazba login-osobní číslo, viz ZdrojOsCisla níže.&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení portálovým účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit přihlašovací údaje (login a heslo) na přihlašovací stránce. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. Přihlašovací údaje spravuje pověřená osoba buď na staránce Nastavení/Uživatelé nebo v agendě Uživatelé KS portálu v desktopové aplikaci. Nový zaměstnanci se také mohou registrovat sami, pokud je to povoleno.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Windows - Systém jednotného přihlášení (SSO) ===&lt;br /&gt;
Uživatelé nemusí vyplňovat přihlašovací údaje (login a heslo). Do portálu se přihlašují automaticky loginem, pod kterým se přihlásili do Windows.&lt;br /&gt;
&lt;br /&gt;
V souboru web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Windows&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  Po přidání parametru &amp;lt;add key=&amp;quot;SkipLoginPage&amp;quot; value=&amp;quot;true&amp;quot;/&amp;gt; se přeskočí přihlašovací stránka.&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
V IIS je třeba povolit metodu autentizace windows.&lt;br /&gt;
&lt;br /&gt;
Do databáze přistupuje portál buď pod DB účtem zadaným v connectionstringu, nebo pod windows účtem uživatele pokud je v connectstringu nastaveno Integrated Security=true a identita fondu aplikace je ponechána na hodnotě ApplicationPoolIdentity (tj. není nastaven specifický účet zosobnění).&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení active directory účtem ===&lt;br /&gt;
Uživatelé musí při přístupu na portál vyplnit na přihlašovací stránce přihlašovací údaje (login a heslo) k active directory účtu. Teprve po vyplnění platných údajů a jejich ověření získají uživatelé přístup do portálu. Na konci relace se uživatele odhlásí kliknutí na „odhlašovací“ tlačítko. &lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;ad&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;SparovaniUziv&amp;quot; value=&amp;quot;CI-BezDomeny&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  a dále nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, viz Sekce &amp;lt;appSettings&amp;gt; - skupina Active Directory (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení databázovým účtem ===&lt;br /&gt;
&lt;br /&gt;
Uživatel zadává databázový login a heslo, ověření probíhá prostřednictvím připojení k databázi se zadanými přihlašovacími údaji. Portál přístupuje do databáze pod jménem uživatele, v connectionstringu musí být zadány místo jména uživatele a hesla masky %user% a %password%, které jsou při vytváření připojení nahrazeny přihlašovacími údaji, které zadal uživatel.&lt;br /&gt;
&lt;br /&gt;
V souboru Web.config je potřeba nastavit:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;authentication mode=&amp;quot;Forms&amp;quot;&amp;gt; &lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&lt;br /&gt;
  &amp;lt;add name=&amp;quot;web_mzdy&amp;quot; connectionString=&amp;quot;server=absint_pc;database=web_mzdy;uid=%user%;pwd=%password%&amp;quot; providerName=&amp;quot;System.Data.SqlClient&amp;quot;/&amp;gt;&lt;br /&gt;
&amp;lt;/nowiki&amp;gt;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení přes externí autentizační službu (OAUTH2, SAML2) ===&lt;br /&gt;
&lt;br /&gt;
Je možno využít přihlašování přes externí autentizační službu podporující protokol OAuth 2.0, případně SAML 2.0. Více informací je k dispozici na stránce rozšíření aplikace '''[[Externí přihlašování | Externí přihlašování]]'''&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=== Přihlášení externího uživatele - nezaměstnance ===&lt;br /&gt;
&lt;br /&gt;
Tento způsob přihlášení je určen pro externí uživatele (nezaměstnance), např. správce. Bez ohledu na nastavený způsob přihlašování nakonfigurovaný pro zaměstnance, se externí uživatel může přihlásit přes stránku &amp;quot;/Public/ExternalUserLogin.aspx&amp;quot;, na kterou se dostane např. odkazem „Externí uživatel“ ze standardní přihlašovací stránky. Pokud je nastaven 1. způsob přihlašování, může se přihlásit i přes standardní stránku určenou pro zaměstnance. Externího zaměstnance musí pověřená osoba navést v agendě Uživatelé KS portálu/Externí uživatelé.&lt;br /&gt;
&lt;br /&gt;
= Způsob ověření uživatelů = &lt;br /&gt;
Způsob ověření uživatelů určuje hodnota parametru&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;TypOvereni&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; &lt;br /&gt;
v souboru web.config v sekci &amp;lt;appSettings&amp;gt; (viz. následující tabulka).&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 &amp;lt;center&amp;gt;'''Způsob ověření uživatelů'''&amp;lt;/center&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|&amp;lt;table align=&amp;quot;center&amp;quot; border=&amp;quot;2&amp;quot; width=&amp;quot;100%&amp;quot; cellspacing=&amp;quot;4&amp;quot; cellpadding=&amp;quot;3&amp;quot; rules=&amp;quot;all&amp;quot; style=&amp;quot;margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Hodnota'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;td bgcolor=&amp;quot;#A7C1F2&amp;quot;&amp;gt;&amp;lt;b&amp;gt;'''Význam'''&amp;lt;/b&amp;gt;&amp;lt;/td&amp;gt;&lt;br /&gt;
&amp;lt;tr&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Nevyplněno (výchozí)&lt;br /&gt;
|   Přihlašovací údaje uživatele se ověřují proti agendě Uživatelé KSPortálu v těžkém klientovi(aplikaci KS&amp;amp;nbsp;Mzdy).&lt;br /&gt;
|-&lt;br /&gt;
| ad&lt;br /&gt;
|   Přihlašovací údaje se ověřují v Active Directory.&lt;br /&gt;
|-&lt;br /&gt;
| ez&lt;br /&gt;
|   Login uživatel se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje &lt;br /&gt;
|-&lt;br /&gt;
| eos&lt;br /&gt;
|   Přihlašovací údaje uživatele se ověřují v EOSu.&lt;br /&gt;
|}&lt;br /&gt;
''Tabulka 1: Způsob ověření uživatelů''&lt;br /&gt;
&lt;br /&gt;
Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance. &lt;br /&gt;
Osobní číslo se získává se stejného místa, proti kterému se uživatel ověřuje.&lt;br /&gt;
Pokud vyvstane potřeba získat osobní číslo z jiného zdroje, je to možné nastavit parametrem&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;ZdrojOsCisla&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt; .  Parametr může nabývat stejných hodnot jako parametr TypOvereni (viz. Tabulka 1).&lt;br /&gt;
&lt;br /&gt;
= Přístupová práva uživatelů =&lt;br /&gt;
&lt;br /&gt;
Řízení přístupu k údajům a operacím&lt;br /&gt;
&lt;br /&gt;
Přístup uživatelů je definován prostřednictvím uživatelských rolí. Odkud se mají načítat role uživatelů určuje RoleProvider:&lt;br /&gt;
* KSRoleProvider – načítá aplikační role z databáze aplikace&lt;br /&gt;
* ADRoleProvide – načítá aplikační role z Active Directory&lt;br /&gt;
&lt;br /&gt;
Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.&lt;br /&gt;
&lt;br /&gt;
Nastavení přístupových práv uživatelským rolím může provádět pouze administrátor KS Portálu. A to přímo v KS Portálu v menu Nastavení / Práva.&lt;br /&gt;
&lt;br /&gt;
Login každého uživatele musí být přiřazen k nějaké roli, jinak nebude mít uživatel přístup k žádné části portálu. Login lze ke konkrétní roli přiřadit v agendě přístupových práv v naší aplikaci KS Mzdy (se kterou je KS Portál svázán). V agendě přístupových práv v aplikaci KS Mzdy lze přiřazovat k rolím loginy, které jsou buď v databázi (jako uživatalé DB) nebo v agendě Uživatelé KS Portálu.&amp;lt;br&amp;gt;&lt;br /&gt;
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem&amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/font&amp;gt;, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.&lt;br /&gt;
&lt;br /&gt;
= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =&lt;br /&gt;
&lt;br /&gt;
Nastavení provádí pouze administrátor KS Portálu. Typ řádkových práv může správce nastavit v parametrech KS Portálu (Nastavení / Parametry).&lt;br /&gt;
# Standardní (výchozí nastavení) – přihlášený uživatel má povolen přístup jen na pevně daný výčet osobních čísel a středisek Výčet povolených osobních čísel a středisek se nastavuje v aplikaci KS Mzdy a KS Portál toto nastavení přebírá.&lt;br /&gt;
# Dle systemizace – přihlášený uživatel má povolen přístup na sebe a své podřízené dle systemizace pracovních míst z aplikace KS Mzdy. V popisech pracovních míst u každého pracovního místa musí být vyplněno příslušné pracovní středisko.&lt;br /&gt;
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.&lt;br /&gt;
&lt;br /&gt;
= Registrace nových uživatelů v KS Portálu =&lt;br /&gt;
&amp;lt;font color=&amp;quot;red&amp;quot;&amp;gt;Tato kapitola platí jen v případě ověřování uživatelů v agendě [[Uživatelé KS portálu]] v těžkém klientovi (výchozí nastavení).&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Aby uživatel získal přístup do KS&amp;amp;nbsp;Portálu, musí mít vytvořen účet v agendě Uživatelé KS Portálu. Účet mu může ručně vytvořit (nebo upravit) správce aplikace KS Mzdy.&lt;br /&gt;
&lt;br /&gt;
=== Uživatelé se mohou registrovat sami ===&lt;br /&gt;
&amp;lt;nowiki&amp;gt;Je také možné povolit neregistrovaným uživatelům KS&amp;amp;nbsp;Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci &amp;lt;appSettings&amp;gt; následující řádky:&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;Registrace&amp;quot; value=&amp;quot;user&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;VychoziRole&amp;quot; value=&amp;quot;&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
První řádek povoluje uživatelům KS&amp;amp;nbsp;Portálu registraci. Druhý musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí.&lt;br /&gt;
&lt;br /&gt;
* [[Registrace nového uživatele]]&lt;br /&gt;
&lt;br /&gt;
= Další možnosti nastavení =&lt;br /&gt;
Základní nastavení aplikace KS&amp;amp;nbsp;Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).&lt;br /&gt;
&lt;br /&gt;
== Sekce &amp;lt;appSettings&amp;gt; ==&lt;br /&gt;
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;&amp;lt;nowiki&amp;gt;&amp;lt;add key=&amp;quot;název&amp;quot; value=&amp;quot;hodnota&amp;quot;/&amp;gt;&amp;lt;/nowiki&amp;gt;.&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{|class=&amp;quot;wikitable &amp;quot; border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;	&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Seznam parametrů sekce &amp;lt;appSettings&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|- style=&amp;quot;background-color: #A7C1F2&amp;quot;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Skupina'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Název'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Popis'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
| &amp;lt;small&amp;gt; &amp;lt;center&amp;gt;'''Možné hodnoty (nebo příklad hodnoty)'''&amp;lt;/center&amp;gt; &amp;lt;/small&amp;gt;	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 24|Přihlášení || ''' LastPasswordsCheck  '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LockAfterWrongPasswords  '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' MinPasswordLength  '''|| Minimální požadovaná délka hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' CheckPasswordComplexity  '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordExpiration  '''|| Počet dnů do expirace hesla uživatele. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' WarningBeforePasswordExpiration  '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PasswordReset  '''|| Obnova zapomenutého hesla. Bez odblokování účtu, s odblokováním účtu. [[Zapomenuté heslo (správa)]] || 0 - obnova hesla je zakázána (výchozí hodnota)&lt;br /&gt;
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty &amp;lt;br&amp;gt;&lt;br /&gt;
2 - obnova hesla je povolena, zamknuté účty budou odemknuty&lt;br /&gt;
|-&lt;br /&gt;
| '''PasswordResetAuth''' || Způsob obnovy zapomenutého hesla &amp;lt;small&amp;gt;(hd 53919)&amp;lt;/small&amp;gt; || 1 - pomocí zadání pracovního e-mailu namísto loginu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' TypOvereni  '''|| Jiný typ ověření uživatele pro formulářové přihlášení. || nevyplněno=uživatelé KS portálu nastavení v těžkém klientovi, ad=Active Directory, ez=Login uživatele se hledá v poli Login v Evidenci zaměstnanců na záložce Osobní údaje, eos=přihlašovací údaje uživatele se ověřují v EOSu 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' ZdrojOsCisla  '''|| Udává odkud se zjišťuje osobní číslo pro login. Pokud není vyplněn, použije se hodnota z TypOvereni. || ks=Uživatelé KS portálu, ad=Active Directory, ez=evidence zaměstnanců/osobní údaje 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SkipLoginPage  '''|| Pokud se využívá SSO (Systém jednotného přihlášení) a má se přeskočit LoginPage, provede se automaticky přihlášení. || hodnota true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' NabizeniHeslaZakazat  '''|| Vypnout nabízení dříve použitého hesla na přihlašovací stránce pro uživatele a na přihlašovací stránce pro externí uživatele (hd 44956). || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUziv  '''|| Povolí volnější kontrolu loginu, bez kontroly domény a velikosti písmen. Při formulářovém přihlášení a TypOvereni=ad by mělo být CI nebo CI-BezDomeny, neboť AD je case insenstive, tj. Domena\jiRI.novAK by se následně nespároval s loginem DOMENA\jiri.novak v DB. || BezDomeny, CI, CI-BezDomeny 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' SparovaniUzivAD  '''|| Hodnota true umožní přihlášení loginem bez domény i pro ad_auth_type=basic. Uplatňuje se jen u formulářového přihlášení a TypOvereni=ad. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Admins  '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ExterniUziv  '''|| Zda se do aplikace mohou přihlašovat externí uživatelé (tací, kteří nejsou v cílové databázi mezi zaměstnanci). || nevyplněno – přihlásit se mohou jen zaměstnanci&lt;br /&gt;
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' VychoziRole  '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal 	&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||&lt;br /&gt;
|-&lt;br /&gt;
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||&lt;br /&gt;
|-	&lt;br /&gt;
| ''' Registrace  '''|| Způsob registrace nových uživatelů. Pokud není vyplněn ''user'', musí mít ve své hodnotě zadán název výchozí uživatelské role, do které se takto registrovaní uživatelé přiřadí. || user 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RegistraceRodneCislo  '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PocetMesicuRolePoVystupu  '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' RolePoVystupu  '''|| Role po ukončení pracovního poměru. || poVystupu 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' PristupNaVsechnyPodniky  '''|| Zda má mít přihlášený uživatel přístup i na data zaměstnanců z jiných podniků v databázi (více IČ). || true - uživatel má přístup na zaměstnance ze všech podniků&lt;br /&gt;
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 2|Prostředí  || ''' OptimalizaceMenu  '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu&lt;br /&gt;
True / ano – zobrazí se jen přístupné položky menu&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ShowEmployeePhoto  '''|| Zobrazování fotek zaměstnanců. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Logování || ''' ShowExceptionDetail  '''|| Zda se má zobrazit detailní výpis chyb. || true / false 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' EmailChybyZobrazovat  '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' AppAudit  '''|| Zapnutí logování činností uživatelů na KS portále. || true 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' LogType  '''|| Způsob logování výjimek (chyb). Určuje, zda se mají zaznamenávat chyby vzniklé při běhu aplikace. Při hodnotě &amp;quot;&amp;quot;xml&amp;quot;&amp;quot; se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí &amp;lt;br&amp;gt;&lt;br /&gt;
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml&lt;br /&gt;
|-&lt;br /&gt;
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu.  || '''a''' / n&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 5|Různé || ''' CachedTables  '''|| Použito při optimalizacích načítání (hd 47235). [[Řešení některých problémů (KS portál)]] || názvy db tabulek 	&lt;br /&gt;
|-	&lt;br /&gt;
|  ''' Cache  '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage 	&lt;br /&gt;
|-&lt;br /&gt;
|  ''' FormatDatumu  '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd&lt;br /&gt;
datetime – datum je typu DateTime&lt;br /&gt;
|-	&lt;br /&gt;
| ''' DbCmdTimeout  '''|| Maximální povolená doba pro vykonání jednoho Db příkazu, pokud překročena, objeví se hláška || Číslo znamenající délku timeoutu v sekundách 	&lt;br /&gt;
|-	&lt;br /&gt;
| '''NotSupBrowser'''|| Blokování nepodporovaného prohlížeče || 1 - výchozí hodnota (blokace), 2 - pouze upozornění&lt;br /&gt;
|-	&lt;br /&gt;
| rowspan = 10|[[Active Directory]] || ''' ad_connect_string  '''|| AD LDAP cesta ke kontejneru, ve kterém jsou hledány uživatelské účty. || LDAP://server/OU=Lokality,DC=ksprogram,DC=cz 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user  '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_password  '''|| Heslo uživatelského účtu zadaného v ad_user. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_auth_type  '''|| Možnost nastavení typu ověřování pro Active Directory , hodnoty=basic nebo secure (pokud secure nefunguje, může zpomalit přihlášení o 20 sekund). || basic / secure 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_search_in  '''|| AD podkontejnery pro prohledávání (nepovinné), seznam cest oddělených středníkem (relativně k ad_connect_string). Použít v případě, kdy je zapotřebí prohledávání omezit na 2 a více kontejnerů. V opačném případě, kdy se má omezit vyhledávání na jeden kontejner, lze použít přímo parametr ad_connect_string. || OU=Aktivní,OU=CZ Pobocka;OU=Aktivní,OU=SK Pobocka 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_user_filter  '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_login  '''|| AD název atributu, ve kterém jsou uloženy přihlašovací jména uživatelů pro Microsoft AD vždy &amp;quot;samAccountName&amp;quot;. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_user  '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_atr_os_cislo_zastupce  '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' ad_groups  '''|| AD role určené pro KS Portál (oddělené středníkem) v případě ze je nastaven ADRoleProvider. Pokud není vyplněno vezmou se všechny role, které existuji v KS. ||  	&lt;br /&gt;
|-&lt;br /&gt;
| rowspan = 5|Web proxy ||''' proxyUrl  '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPort  '''|| Port proxy serveru. || 8888 	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyUsername  '''|| Login pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' proxyPassword  '''|| Heslo pro přístup k proxy. ||  	&lt;br /&gt;
|-	&lt;br /&gt;
| ''' portal_url  '''|| Řeší případy kdy např. kvůli přesměrovávání adresy KS portálu se ztratí skutečné jméno hosta, na kterého má být požadavek přesměrován a z toho důvodu se v odkazech generovaných v notifikačních emailech zobrazuje chybná adresa url. &amp;lt;small&amp;gt;též hd 51506&amp;lt;/small&amp;gt;|| Do hodnoty se zadává celá adresa url KS portálu. 	&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Zašifrování vybraných sekcí web.config ==&lt;br /&gt;
Zašifrování sekce appSettings pro virtuální adresář ksprtl. Provádí se přes příkazovou řádku pod účtem administrátora následujícím příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Dešifrování stejné sekce se pak provede příkazem &amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd &amp;quot;appSettings&amp;quot; -app &amp;quot;/ksprtl&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Následující příkaz přidělí účtu pod kterým běží asp.net právo dešifrovat zašifrované sekce web.config. V defaultním nastavením je tímto účtem &amp;quot;NETWORKSERVICE&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;font color=&amp;quot;blue&amp;quot;&amp;gt;C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa &amp;quot;NetFrameworkConfigurationKey&amp;quot; &amp;quot;NETWORKSERVICE&amp;quot;&amp;lt;/font&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Active directory ==&lt;br /&gt;
=== Typ ověřování ===&lt;br /&gt;
V souboru web.config je možno nově nastavit typ ověřování pro Active Directory přes parametr ad_auth_type.&lt;br /&gt;
Možné hodnoty jsou basic a secure, výchozí hodnota je secure, tj. způsob, který se používal i před úpravou.&lt;br /&gt;
(Tj. pokud je AD a portál na stejném serveru nebo typ secure způsobuje 20s zpoždění, lze typ nastavit na basic)&lt;br /&gt;
&lt;br /&gt;
=== Načítání rolí vzhledem ke skupinám ===&lt;br /&gt;
Změna v načítání rolí z AD (tj. v případě, že je ve web.config defaultProvider nastaven ADRoleProvider): Při načítání rolí (skupin) uživatele z AD se načítaly pouze ty role, ve kterých byl uživatel zařazen přímo. Nově se načtou i role, pod kterými jsou role uživatele zařazeny. Příklad: Novák je členem ve skupině &amp;quot;Vedoucí&amp;quot; a skupina &amp;quot;Vedoucí&amp;quot; je členem ve skupině &amp;quot;Zaměstnanci&amp;quot;, pro Nováka se nově načtou role &amp;quot;Vedoucí&amp;quot; i &amp;quot;Zaměstnanci&amp;quot; (před úpravou jen Vedoucí). Ale zůstává zároveň platit to, že AD skupina je považována za KS roli pouze pokud je uvedena v parametru ad_groups, pokud ad_groups není vyplněn, tak skupina musí být v číselníku rolí (zde je změna, před úpravou musela začínat &amp;quot;KS_&amp;quot;).&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Příručka KS Portál]]&lt;br /&gt;
* [[Přístup i po ukončení pracovního poměru (KS portál)]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Plugin&amp;diff=43190</id>
		<title>Plugin</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Plugin&amp;diff=43190"/>
		<updated>2022-04-04T13:45:48Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Desktop aplikace umožňuje použití '''dočasných plugin modulů''', vyrobených za účelem operativní změny v chování aplikace.&lt;br /&gt;
&lt;br /&gt;
Použít lze pouze pluginy '''vyrobené společností KS-Program''', s.r.o. Aplikace je zabezpečena proti možnosti aktivace pluginů jiných dodavatelů. Aktivace a použití pluginu je archivaváno pro možnost zpětného dohledání jejich použití. Každý plugin před spuštěním informuje uživatele o jeho obsahu.&lt;br /&gt;
&lt;br /&gt;
'''Aktivace pluginu''' - plugin se aktivuje přes menu Evidence/Zákaznické speciality - tlačítko &amp;quot;Načíst dočasný plugin&amp;quot;. Vyberete příslušný *.PBD soubor pluginu, který jste obdrželi emailem od pracovníka společnosti KS-Program. Plugin je aktivní pouze po dobu běhu aplikace, při dalším spuštění aplikace je potřeba plugin znovu načíst!&lt;br /&gt;
&lt;br /&gt;
&amp;lt;small&amp;gt;(20.5.2021)&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Systémová příručka]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Active_Directory&amp;diff=42393</id>
		<title>Active Directory</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Active_Directory&amp;diff=42393"/>
		<updated>2021-11-09T14:09:25Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Active Directory (AD)'''&lt;br /&gt;
&lt;br /&gt;
== Vazba na AD - Desktopová aplikace ==&lt;br /&gt;
&lt;br /&gt;
Desktopová aplikace využívá Active Directory pro následující účely: &lt;br /&gt;
&lt;br /&gt;
* '''ověření uživatele při přihlášení do aplikace''' (při spuštění aplikace s parametrem /T nebo /TD, ověření nepřímo - tzv. trusted connection, ověření ve skutečnosti provádí SQL server) &lt;br /&gt;
&lt;br /&gt;
* '''načítání uživatelských účtů z AD''' pro účely přiřazení aplikační role (pokud je zapnut rozšiřující parametr AD_READ_USERS) &lt;br /&gt;
&lt;br /&gt;
* '''synchronizace základních údajů zaměstnanců''' povětšinou směrem KS-&amp;gt;AD. Tato funkcionalita vyžaduje programové úpravy, neboť každý zákazník má jiné požadavky na přenos údajů.&lt;br /&gt;
: [[Synchronizace údajů KS-AD]]&lt;br /&gt;
: [[Synchronizace údajů KS-AD (příklad)]]&lt;br /&gt;
&lt;br /&gt;
* '''přiřazování práv'''&lt;br /&gt;
: [[Přiřazování práv uživatelům z Active Directory]]&lt;br /&gt;
&lt;br /&gt;
== Parametry ==&lt;br /&gt;
* [[Rozšiřující parametry (skupina 13)]] - parametry začínající &amp;quot;AD_...&amp;quot;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
== Vazba na AD - Portál ==&lt;br /&gt;
1) '''Autentizace''': Pokud chcete jen ověřovat uživatele AD účtem, tak stačí mít ve web.config nastaveno buď&lt;br /&gt;
&lt;br /&gt;
a) windows SSO přihlašování: authentication mode=&amp;quot;Windows&amp;quot; (přebírá se přihlášení uživatele do windows, použitelné pouze uvnitř firmy nebo přes VPN),&lt;br /&gt;
&lt;br /&gt;
b) nebo formulářové přihlašování s ověřováním v AD: authentication mode=&amp;quot;Forms&amp;quot;, parametr TypOvereni=ad a nastavit parametry s prefixem &amp;quot;ad_&amp;quot; (příklady vyplnění naleznete v souboru web.config.default)&lt;br /&gt;
&lt;br /&gt;
2) '''Vazba Osobní číslo - Login''': Pokud má být z AD zjišťováno i osobní číslo přihlášeného uživatele, pomocí kterého se účet sváže s konkrétním zaměstnancem, je třeba ve web.configu nastavit parametr ZdrojOsCisla na hodnotu &amp;quot;ad&amp;quot; a nastavit parametry s prefixem &amp;quot;ad_&amp;quot;, především ad_atr_os_cislo_user, ve kterém je uveden název atributu, ve kterém se nachází osobní číslo (employeeNumber nebo employeeId)&lt;br /&gt;
&lt;br /&gt;
3) '''Role''': Pokud se mají z AD přebírat i role uživatele (group) je třeba ve web.config změnit defaultProvider z KSRoleProvider na ADRoleProvider. Role s odpovídajícím názvem musí existovat i v KS. Role přebírané z AD lze omezit pomocí parametru ad_groups.&lt;br /&gt;
&lt;br /&gt;
Více viz [[Instalační příručka]].&lt;br /&gt;
&lt;br /&gt;
'''Dotaz: Může se správce, který není zaměstnancem, přihlásit do portálu AD účtem? '''&lt;br /&gt;
&lt;br /&gt;
Ano, a to přes standardní přihlašovací stránku, ale pouze za předpokladu, že AD login je naveden v agendě &amp;quot;Uživatelé KS portálu&amp;quot; na záložce &amp;quot;Externí uživatelé&amp;quot;. Pokud externí uživatel nemá AD účet, může se přihlásit přes stránku &amp;quot;Externí přihlášení&amp;quot; a to KS loginem a heslem navedeným v agendě &amp;quot;Uživatelé KS portálu&amp;quot; na záložce &amp;quot;Externí uživatelé&amp;quot; (na této stránce se ignoruje nastavení parametru TypOvereni a používá se KS ověření).&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Přenosy dat]]&lt;br /&gt;
* [[Systémová příručka]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_DB_tabulky&amp;diff=42337</id>
		<title>Služební cesty - DB tabulky</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_DB_tabulky&amp;diff=42337"/>
		<updated>2021-10-19T12:27:07Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: /* Přenos nastavení workflow do druhé databáze */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Číselníky ==&lt;br /&gt;
&lt;br /&gt;
select * from slc_cis_strav_t; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_cis_strav_z;&lt;br /&gt;
&lt;br /&gt;
select * from slc_druh_dopr; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_vozidla; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_cis_phm; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_ceny_phm; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_cis_zakl_nahr;&lt;br /&gt;
&lt;br /&gt;
select * from slc_cis_cn; &amp;lt;br&amp;gt;&lt;br /&gt;
&lt;br /&gt;
select * from slc_cis_kody_uc; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_cis_zpus_plat;&lt;br /&gt;
&lt;br /&gt;
== Cestovní příkazy ==&lt;br /&gt;
&lt;br /&gt;
select * from slc_zalohy; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_prubeh; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_stravne; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_nahrady; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_nahrady_rozp; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from sluz_cesty; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from sluz_cesty_vyuct; &amp;lt;br&amp;gt;&lt;br /&gt;
select * from slc_zauct;&lt;br /&gt;
&lt;br /&gt;
== Číslo služební cesty ==&lt;br /&gt;
* '''ev_cislo''' (long) - původní číslo služební cesty, později interní identifikátor&lt;br /&gt;
* '''cislo''' (char (25)) - číslo služební cesty. Aktuálně platí, že ''cislo'' = ''ev_cislo'' a uživatelsky je možno jej měnit jen v &amp;quot;těžké&amp;quot; aplikaci, nikoliv na portále. Do budoucna se počítá s generováním čísla služební cesty dle masky (např rok/číslo). Toto číslo je zobrazováno v sestavách služebních cest.&lt;br /&gt;
&lt;br /&gt;
== Přenos nastavení workflow do druhé databáze ==&lt;br /&gt;
Použijte export/import nastavení do XML na stránce Nastavení/Nastavení workflow.&lt;br /&gt;
&amp;lt;!--&lt;br /&gt;
Postup pro přenos nastavení workflow pro služební cesty. Nastavení workflow je ve dvou tabulkách workfl_faze a workfl_stavy,&lt;br /&gt;
záznamy ke služebním cestám mají id_master=5:&lt;br /&gt;
&lt;br /&gt;
A) export seznamu kroků a nastavení uživatelských prvků:&lt;br /&gt;
1. v SQL promptu provést:&lt;br /&gt;
select * from workfl_faze where id_master=5;&lt;br /&gt;
2 uložit jako workfl_faze.SQL&lt;br /&gt;
3. v poznámkovém bloku odstranit create table, protože tabulka už&lt;br /&gt;
existuje, místo nich tam dát příkaz pro promazání existujícího nastavení:&lt;br /&gt;
delete from workfl_faze where id_master=5;&lt;br /&gt;
4. uložit změny&lt;br /&gt;
&lt;br /&gt;
B) export seznamu stavů a jejich nastavení:&lt;br /&gt;
select * from workfl_stavy where id_master=5;&lt;br /&gt;
2 uložit jako workfl_stavy.SQL&lt;br /&gt;
3. v poznámkovém bloku odstranit create table, protože tabulka už&lt;br /&gt;
existuje, místo nich tam dát příkaz pro promazání existujícího nastavení:&lt;br /&gt;
delete from workfl_stavy where id_master=5;&lt;br /&gt;
4. uložit změny&lt;br /&gt;
&lt;br /&gt;
C) import nastavení&lt;br /&gt;
Oba soubory nalít přes SQL prompt (Otevřít, Provést)&lt;br /&gt;
&lt;br /&gt;
D) případně upravit id PM/os. čísla adresátů či doplnit vlastnosti do&lt;br /&gt;
popisu PM, na které se odkazujete pomocí vd_atr&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Požadavky (DB tabulky)]]&lt;br /&gt;
&lt;br /&gt;
[[Služební cesty|zpět]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Ujet%C3%A9_km&amp;diff=42333</id>
		<title>Ujeté km</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Ujet%C3%A9_km&amp;diff=42333"/>
		<updated>2021-10-19T12:00:31Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;&amp;lt;small&amp;gt;Menu: Zaměstnanec &amp;gt; Ujeté km&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Stránka Ujeté km v KS portále je určena pro účely evidence soukromě ujetých kilometrů za daný měsíc firemním vozem přiděleným manažerům a jiným osobám pro služební i soukromé účely. Zaměstnanec může vidět a editovat údaje '''pouze za jemu přidělená vozidla''' z agendy [[Evidence vozidel (Přidělení zaměstnanci)]]. Stránka je součástí placeného rozšíření aplikace, standardně tedy není přístupná. Zadané kilometry může účetní prohlížet/editovat v desktopové aplikaci v [[Evidence vozidel (Ujeté km)]].&lt;br /&gt;
&lt;br /&gt;
Popis polí:&lt;br /&gt;
&lt;br /&gt;
* Počáteční stav tachometru - needitovatelné pole, hodnota za daný měsíc je dopočítávána z počátečního stavu tachometru při přidělení (v agendě přídělení) a ujetých kilometrů za předchozí měsíce.&lt;br /&gt;
* Kilometry soukromě - editovatelné pole, ujeté kilometry za soukromé jízdy za daný měsíc.&lt;br /&gt;
* Kilometry služebně/nevyúčtované ve SC - editovatelné pole, ujeté kilometry pro služební účely, které nejsou služebními cestami nebo nebyly (a nebudou) do služebních cest zadány.&lt;br /&gt;
* Kilometry služebně/vyúčtované ve SC - needitovatelné pole, hodnota je zjištěna ze zadaných služebních cest.&lt;br /&gt;
* Konečný stav tachometru - pole je sice editační, ale jeho hodnota se nikam neukládá, pokud uživatel hodnotu změní automaticky se dle něj dopočte pole &amp;quot;Kilometry sokromě&amp;quot; jako &amp;quot;Konečný stav&amp;quot; - &amp;quot;Počáteční stav&amp;quot; - &amp;quot;Kilometry služebně&amp;quot;.&lt;br /&gt;
&lt;br /&gt;
[[Image: Ujete_km-Editace.png|thumb|590px|Editace (za období 04/2019)]]&lt;br /&gt;
&lt;br /&gt;
[[Image: Ujete_km.png|880px]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[KS portál]]&lt;br /&gt;
* Desktopová aplikace: [[Evidence vozidel (Ujeté km)]]&lt;br /&gt;
* Desktopová aplikace: [[Evidence vozidel (Přidělení zaměstnanci)]]&lt;br /&gt;
* [[sc_aus_phm (sk.15)]] - výpočet částky za spotřebovanou PHM&lt;br /&gt;
&amp;lt;!-- hd 39420 --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;text-align:center&amp;quot;&amp;gt;[[Příručka KS Portál|Zpět]] | [[Zapnutí zástupu (KS portál)|Zapnutí zástupu]]&amp;lt;/div&amp;gt;&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=42332</id>
		<title>Služební cesty - Slovenská aplikace</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=42332"/>
		<updated>2021-10-19T11:43:25Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=== Kurzy při vyúčtování ===&lt;br /&gt;
Při vyúčtování SC používá slovenská verze tyto kurzy, dle platné legislativy:&lt;br /&gt;
&lt;br /&gt;
a) kurz ECB k 1. dni v měsíci (ve kterém SC začíná) a to pouze pro případ uvedený v §36 odst. 6 zákona č. 283/2002, tj. kdy se zaměstnanec se zaměstnavatelem dohodli, že záloha na stravné bude poskytnuta v jiné měně než stanovuje vyhláška pro danou krajinu. Tuto dohodu aplikace neeviduje, ale je možné aktivovat parametr slc_strVmenZal, což způsobí, že aplikace v případě zálohy s účelem stravné v jiné měně než má být stravné považuje za to, že tato dohoda byla učiněna a stravné vygeneruje v měně zálohy. Tj. již nárok na stravné stanoví v dohodnuté měně a stravné v dohodnuté měně vstupuje do vyúčtování, kurz k 1. dni tedy již nevstupuje do vyúčtování ani zaúčtování (závazek z nároku na stravné vzniká v dohodné měně a v dohodnuté měně se o něm i účtuje). Pokud není aktivován parametr slc_strVmenZal, může účetní přepnout měnu stravného na záložce stravné a částka se automaticky přepočte kurzem k 1.dni. &lt;br /&gt;
&lt;br /&gt;
b) kurz doložený zaměstnancem pro směnu zálohy na jinou měnu &lt;br /&gt;
&lt;br /&gt;
c) kurz ECB k předcházejícímu dni poskytnutí zálohy na SC&lt;br /&gt;
&lt;br /&gt;
d) kurz ECB k předcházejícímu dni vyúčtování SC (tj. aplikace bere pro SC jako den uskutečnění účetního případu datum vyúčtování (v praxi se používá i datum předložení dokladů zaměstnancem))&lt;br /&gt;
&lt;br /&gt;
[https://podpora.financnasprava.sk/337635-%C3%9A%C4%8Dtovanie-cestovn%C3%BDch-n%C3%A1hrad---pou%C5%BEitie-kurzu Finančná správa SR/Účtovanie cestovných náhrad - použitie kurzu]&lt;br /&gt;
&lt;br /&gt;
=== Parametry ===&lt;br /&gt;
slc_strVmenZal - Pokud zaměstnanec dostane zálohu na stravné v jiné měně než je ve vyhlášce pro danou cizí zemi, vypočítá se nárok na stravné v měně zálohy, přičemž se použije kurz k 1.dni měsíce kdy cesta začala dle §36(6) 283/2002.&lt;br /&gt;
&lt;br /&gt;
== Číselník tuzemské stravné ==&lt;br /&gt;
&lt;br /&gt;
[[Image: E-sc-cis-tuzemske-stravne-SK.png|700px]]&lt;br /&gt;
&lt;br /&gt;
=== Stravné ===&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Stravné (SK legislativa) v EUR &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|od 1.11.2014&lt;br /&gt;
|od 1.12.2016&lt;br /&gt;
|od 1.6.2018&lt;br /&gt;
|od 1.7.2019 &lt;br /&gt;
|-&lt;br /&gt;
|5 - 12 hod ||4 || 4,20||4,50 || 4,80 || '''5,10'''&lt;br /&gt;
|-&lt;br /&gt;
|12 - 18 hod ||6 ||6,30|| 6,70 || 7,10 || '''7,60'''&lt;br /&gt;
|-&lt;br /&gt;
|více než 18 hod ||9,50 ||9,80 || 10,30 || 10,90 || '''11,60'''&lt;br /&gt;
|}&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
=== Krácení ===&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Krácení (SK legislativa) &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|S = '''25%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|O = '''40%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|V = '''35%'''&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pozor: pro SK legislativu (narozdíl od CZ legislativy) se procenta krácení vztahují vždy k plné sazbě, tj. sazbě pro pásmo &amp;gt; 18h a ne k sazbě pro konkrétní pásmo. Výňatek ze zákona o cestovných náhradách §5 odst.6: &amp;quot;Ak má zamestnanec na pracovnej ceste preukázane zabezpečené bezplatné stravovanie čiastočne, zamestnávateľ stravné určené podľa odsekov 1, 2 alebo 5 kráti o 25 % za bezplatne poskytnuté raňajky, o 40 % za bezplatne poskytnutý obed a o 35 % za bezplatne poskytnutú večeru z ustanovenej sumy stravného pre časové pásmo nad 18 hodín alebo z najvyššej dohodnutej sumy stravného podľa odseku 5.&amp;quot;. Tj. dle zákona se krátí o pevnou částku dle charakteru jídla, bez ohledu na pásmo. Pokud tedy budete mít nastavení dle zákona, např. 25% pro snídani u 1., 2. i 3. pásma, tak je to vždy 25% z plné sazby (ze sazby pro 3. pásmo). Pokud si nastavíte nižší krácení, než stanovuje zákon, např. 10 % pro snídani pro 1. pásmo, částka o kterou krátíte méně než stanovuje zákon se projeví ve sloupci nadlimit stravného).&lt;br /&gt;
&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
=== Spotřeba vozidla a výpočet náhrady za PHM ===&lt;br /&gt;
SK verze vyžaduje zadání všech 3 spotřeb vlastního automobilu, neboť zákon o cestovných náhradách č. 283/2002 vyžaduje při výpočtu náhrad za PHM rozlišovat ujeté kilometry dle cyklů. KS neeviduje, podle jaké normy je zadaná spotřeba, nemá si tedy dle čeho určit, zda pro jízdu po městě zvýšit spotřebu o 40% dle písmene a) či o 20% dle písmene d). Z toho vyplývá, že pokud v TP není spotřeba pro cykly město/mimo město/komb, musíte jednotlivé spotřeby odvodit(dopočítat) dle §7 odstavce 6 a zadat je do evidence vozidel:&lt;br /&gt;
&lt;br /&gt;
'''(6) Spotreba podľa technického preukazu sa použije takto:'''&lt;br /&gt;
&lt;br /&gt;
'''a)''' ak je v technickom preukaze uvedená spotreba len podľa príslušnej slovenskej technickej normy, na výpočet sa použije spotreba podľa tejto normy; pri jazde cestného motorového vozidla v meste sa spotreba určená podľa slovenskej technickej normy zvýši o 40 %,&lt;br /&gt;
&lt;br /&gt;
'''Tzn. kombinovaná = X, město = 1.4*X, mimo = X'''&lt;br /&gt;
&lt;br /&gt;
'''b)''' ak je v technickom preukaze uvedená spotreba podľa slovenskej technickej normy aj predpisu Európskej hospodárskej komisie alebo len podľa predpisu Európskej hospodárskej komisie, na výpočet sa použije spotreba podľa predpisu Európskej hospodárskej komisie vypočítaná aritmetickým priemerom; pri jazde cestného motorového vozidla v meste sa použije spotreba určená na jazdu v meste,&lt;br /&gt;
&lt;br /&gt;
'''Tzn. kombinovaná = průměr, město = město, mimo = průměr'''&lt;br /&gt;
&lt;br /&gt;
'''c)''' ak je v technickom preukaze uvedená spotreba podľa osobitného predpisu8a) v členení na mestský cyklus, mimomestský cyklus a kombinovaný cyklus, na výpočet sa použije spotreba zodpovedajúca príslušnému cyklu premávky alebo kombinácii jednotlivých cyklov premávky, odvodených od konkrétneho režimu jazdy cestného motorového vozidla,&lt;br /&gt;
&lt;br /&gt;
'''(V TP jsou přímo položky město, mimo město, kombinovaná)'''&lt;br /&gt;
&lt;br /&gt;
'''d)''' ak je v technickom preukaze cestného motorového vozidla uvedená spotreba podľa osobitného predpisu8a) bez členenia na cykly, na výpočet sa použije spotreba podľa tohto osobitného predpisu; pri jazde cestného motorového vozidla v meste sa spotreba zvýši o 20 %.&lt;br /&gt;
&lt;br /&gt;
'''Tzn. kombinovaná = X, město = 1.2*X, mimo = X'''&lt;br /&gt;
&lt;br /&gt;
Pokud upravujete spotřebu vozidla v evidenci vozidel, které již máte v rozpracovaném cestovním příkaze, musíte jednotlivé spotřeby upravit i v &amp;quot;hlavičce&amp;quot; cestovního příkazu a následně přepočítat náhrady. (aplikace nepočítá s tím, že by se spotřeba vozidla během pár dnů mohla změnit, zároveň ty hodnoty tam slouží pro vozidlo nenavedené do evidence vozidel).&lt;br /&gt;
&lt;br /&gt;
[[Služební cesty|zpět]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=42331</id>
		<title>Služební cesty - Slovenská aplikace</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=42331"/>
		<updated>2021-10-19T11:18:45Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=== Kurzy při vyúčtování ===&lt;br /&gt;
Při vyúčtování SC používá slovenská verze tyto kurzy, dle platné legislativy:&lt;br /&gt;
&lt;br /&gt;
a) kurz ECB k 1. dni v měsíci (ve kterém SC začíná) a to pouze pro případ uvedený v §36 odst. 6 zákona č. 283/2002, tj. kdy se zaměstnanec se zaměstnavatelem dohodli, že záloha na stravné bude poskytnuta v jiné měně než stanovuje vyhláška pro danou krajinu. Tuto dohodu aplikace neeviduje, ale je možné aktivovat parametr slc_strVmenZal, což způsobí, že aplikace v případě zálohy s účelem stravné v jiné měně než má být stravné považuje za to, že tato dohoda byla učiněna a stravné vygeneruje v měně zálohy. Tj. již nárok na stravné stanoví v dohodnuté měně a stravné v dohodnuté měně vstupuje do vyúčtování, kurz k 1. dni tedy již nevstupuje do vyúčtování ani zaúčtování (závazek z nároku na stravné vzniká v dohodné měně a v dohodnuté měně se o něm i účtuje). Pokud není aktivován parametr slc_strVmenZal, může účetní přepnout měnu stravného na záložce stravné a částka se automaticky přepočte kurzem k 1.dni. &lt;br /&gt;
&lt;br /&gt;
b) kurz doložený zaměstnancem pro směnu zálohy na jinou měnu &lt;br /&gt;
&lt;br /&gt;
c) kurz ECB k předcházejícímu dni poskytnutí zálohy na SC&lt;br /&gt;
&lt;br /&gt;
d) kurz ECB k předcházejícímu dni vyúčtování SC (tj. aplikace bere pro SC jako den uskutečnění účetního případu datum vyúčtování (v praxi se používá i datum předložení dokladů zaměstnancem))&lt;br /&gt;
&lt;br /&gt;
[https://podpora.financnasprava.sk/337635-%C3%9A%C4%8Dtovanie-cestovn%C3%BDch-n%C3%A1hrad---pou%C5%BEitie-kurzu Finančná správa SR/Účtovanie cestovných náhrad - použitie kurzu]&lt;br /&gt;
&lt;br /&gt;
=== Parametry ===&lt;br /&gt;
slc_strVmenZal - Pokud zaměstnanec dostane zálohu na stravné v jiné měně než je ve vyhlášce pro danou cizí zemi, vypočítá se nárok na stravné v měně zálohy, přičemž se použije kurz k 1.dni měsíce kdy cesta začala dle §36(6) 283/2002.&lt;br /&gt;
&lt;br /&gt;
== Číselník tuzemské stravné ==&lt;br /&gt;
&lt;br /&gt;
[[Image: E-sc-cis-tuzemske-stravne-SK.png|700px]]&lt;br /&gt;
&lt;br /&gt;
=== Stravné ===&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Stravné (SK legislativa) v EUR &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|od 1.11.2014&lt;br /&gt;
|od 1.12.2016&lt;br /&gt;
|od 1.6.2018&lt;br /&gt;
|od 1.7.2019 &lt;br /&gt;
|-&lt;br /&gt;
|5 - 12 hod ||4 || 4,20||4,50 || 4,80 || '''5,10'''&lt;br /&gt;
|-&lt;br /&gt;
|12 - 18 hod ||6 ||6,30|| 6,70 || 7,10 || '''7,60'''&lt;br /&gt;
|-&lt;br /&gt;
|více než 18 hod ||9,50 ||9,80 || 10,30 || 10,90 || '''11,60'''&lt;br /&gt;
|}&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
=== Krácení ===&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Krácení (SK legislativa) &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|S = '''25%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|O = '''40%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|V = '''35%'''&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pozor: pro SK legislativu (narozdíl od CZ legislativy) se procenta krácení vztahují vždy k plné sazbě, tj. sazbě pro pásmo &amp;gt; 18h a ne k sazbě pro konkrétní pásmo. Výňatek ze zákona o cestovných náhradách §5 odst.6: &amp;quot;Ak má zamestnanec na pracovnej ceste preukázane zabezpečené bezplatné stravovanie čiastočne, zamestnávateľ stravné určené podľa odsekov 1, 2 alebo 5 kráti o 25 % za bezplatne poskytnuté raňajky, o 40 % za bezplatne poskytnutý obed a o 35 % za bezplatne poskytnutú večeru z ustanovenej sumy stravného pre časové pásmo nad 18 hodín alebo z najvyššej dohodnutej sumy stravného podľa odseku 5.&amp;quot;. Tj. dle zákona se krátí o pevnou částku dle charakteru jídla, bez ohledu na pásmo. Pokud tedy budete mít nastavení dle zákona, např. 25% pro snídani u 1., 2. i 3. pásma, tak je to vždy 25% z plné sazby (ze sazby pro 3. pásmo). Pokud si nastavíte nižší krácení, než stanovuje zákon, např. 10 % pro snídani pro 1. pásmo, částka o kterou krátíte méně než stanovuje zákon se projeví ve sloupci nadlimit stravného).&lt;br /&gt;
&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Služební cesty|zpět]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=42328</id>
		<title>Služební cesty - Slovenská aplikace</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Slu%C5%BEebn%C3%AD_cesty_-_Slovensk%C3%A1_aplikace&amp;diff=42328"/>
		<updated>2021-10-18T14:00:55Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=== Kurzy při vyúčtování ===&lt;br /&gt;
Při vyúčtování SC používá slovenská verze tyto kurzy, dle platné legislativy:&lt;br /&gt;
&lt;br /&gt;
a) kurz ECB k 1. dni v měsíci, ve kterém SC začíná a to při zjišťování výše nároku na stravné a pouze v případě aktivovaného parametru slc_strVmenZal a poskytnutí zálohy na stravné v jiné měně než stanovuje vyhláška dle §36 odst. 6 zákona č. 283/2002 (V opačném případě musí účetní měnu na záložce stravné přepnout sama). &lt;br /&gt;
&lt;br /&gt;
b) kurz doložený zaměstnancem pro směnu zálohy na jinou měnu &lt;br /&gt;
&lt;br /&gt;
c) kurz ECB k předcházejícímu dni poskytnutí zálohy na SC&lt;br /&gt;
&lt;br /&gt;
d) kurz ECB k předcházejícímu dni vyúčtování SC&lt;br /&gt;
&lt;br /&gt;
=== Parametry ===&lt;br /&gt;
slc_strVmenZal - Pokud zaměstnanec dostane zálohu na stravné v jiné měně než je ve vyhlášce pro danou cizí zemi, vypočítá se nárok na stravné v měně zálohy, přičemž se použije kurz k 1.dni měsíce kdy cesta začala dle §36(6) 283/2002.&lt;br /&gt;
&lt;br /&gt;
== Číselník tuzemské stravné ==&lt;br /&gt;
&lt;br /&gt;
[[Image: E-sc-cis-tuzemske-stravne-SK.png|700px]]&lt;br /&gt;
&lt;br /&gt;
=== Stravné ===&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Stravné (SK legislativa) v EUR &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|od 1.11.2014&lt;br /&gt;
|od 1.12.2016&lt;br /&gt;
|od 1.6.2018&lt;br /&gt;
|od 1.7.2019 &lt;br /&gt;
|-&lt;br /&gt;
|5 - 12 hod ||4 || 4,20||4,50 || 4,80 || '''5,10'''&lt;br /&gt;
|-&lt;br /&gt;
|12 - 18 hod ||6 ||6,30|| 6,70 || 7,10 || '''7,60'''&lt;br /&gt;
|-&lt;br /&gt;
|více než 18 hod ||9,50 ||9,80 || 10,30 || 10,90 || '''11,60'''&lt;br /&gt;
|}&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
=== Krácení ===&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|+ &amp;lt;small&amp;gt;Krácení (SK legislativa) &amp;lt;/small&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
|Délka pracovní cesty&lt;br /&gt;
|rok 2013&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|S = '''25%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|O = '''40%'''&lt;br /&gt;
|-&lt;br /&gt;
|všechna pásma&lt;br /&gt;
|V = '''35%'''&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Pozor: pro SK legislativu (narozdíl od CZ legislativy) se procenta krácení vztahují vždy k plné sazbě, tj. sazbě pro pásmo &amp;gt; 18h a ne k sazbě pro konkrétní pásmo. Výňatek ze zákona o cestovných náhradách §5 odst.6: &amp;quot;Ak má zamestnanec na pracovnej ceste preukázane zabezpečené bezplatné stravovanie čiastočne, zamestnávateľ stravné určené podľa odsekov 1, 2 alebo 5 kráti o 25 % za bezplatne poskytnuté raňajky, o 40 % za bezplatne poskytnutý obed a o 35 % za bezplatne poskytnutú večeru z ustanovenej sumy stravného pre časové pásmo nad 18 hodín alebo z najvyššej dohodnutej sumy stravného podľa odseku 5.&amp;quot;. Tj. dle zákona se krátí o pevnou částku dle charakteru jídla, bez ohledu na pásmo. Pokud tedy budete mít nastavení dle zákona, např. 25% pro snídani u 1., 2. i 3. pásma, tak je to vždy 25% z plné sazby (ze sazby pro 3. pásmo). Pokud si nastavíte nižší krácení, než stanovuje zákon, např. 10 % pro snídani pro 1. pásmo, částka o kterou krátíte méně než stanovuje zákon se projeví ve sloupci nadlimit stravného).&lt;br /&gt;
&lt;br /&gt;
[[Tuzemské stravné|Více informací zde.]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
[[Služební cesty|zpět]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(P%C5%99id%C4%9Blen%C3%AD_zam%C4%9Bstnanci)&amp;diff=42326</id>
		<title>Evidence vozidel (Přidělení zaměstnanci)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(P%C5%99id%C4%9Blen%C3%AD_zam%C4%9Bstnanci)&amp;diff=42326"/>
		<updated>2021-10-18T11:39:45Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Evidence vozidel (Přidělení zaměstnanci)''&lt;br /&gt;
&lt;br /&gt;
Přidělení vozu pracovníkovi/pracovníkům má za následek to, že se služební '''vozidlo''' již nebude '''v cestovním příkaze nabízet''' všem zaměstnancům, ale '''pouze zaměstnancům''', '''kterým bylo''' vozidlo '''přiděleno''' &amp;lt;small&amp;gt;(jedno vozidlo lze přidělit i více zaměstnancům)&amp;lt;/small&amp;gt;. Přidělení lze časově vymezit (a mít tedy i historii). &lt;br /&gt;
&lt;br /&gt;
[[Image: Evidence vozidel-Prideleni zamestnanci.png]]&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;span style=&amp;quot;background:#FFFF00&amp;quot;&amp;gt;'''Přiděleno zaměstnanci'''&amp;lt;/span&amp;gt; - &amp;lt;small&amp;gt;povinný údaj&amp;lt;/small&amp;gt;&lt;br /&gt;
* &amp;lt;span style=&amp;quot;background:#FFFF00&amp;quot;&amp;gt;'''Přiděleno od'''&amp;lt;/span&amp;gt; - &amp;lt;small&amp;gt;povinný údaj&amp;lt;/small&amp;gt;&lt;br /&gt;
* '''Přiděleno do'''&lt;br /&gt;
* '''I pro soukromé užití''' - pokud byl vůz přidělen zaměstnanci i pro soukromé užívání, zatrhněte příslušnou volbu. Následně může být automaticky generována do mezd příslušná částka: [[MOT.VOZIDLA 1% (výpočet z Evidence vozidel)]]&lt;br /&gt;
* '''Číslo smlouvy'''&lt;br /&gt;
* '''Stav tachometru při přidělení''' - položka je důležitá v případě sledování soukromě ujetých kilometrů, které lze zadávat za jednotlivé měsíce na stránce portálu: [[Ujeté km]].&lt;br /&gt;
&lt;br /&gt;
==Sestava - Varianta A==&lt;br /&gt;
Sestava obsahuje údaje z evidence za všechny přidělené vozy (přidělené ve zvolém období od-do). Varianta A se zobrazuje pokud není aktivováno rozšíření aplikace Ujeté km.&lt;br /&gt;
&lt;br /&gt;
[[Soubor:SY018A.png]]&lt;br /&gt;
&lt;br /&gt;
==Sestava - Varianta B==&lt;br /&gt;
&lt;br /&gt;
Varianta B se zobrazuje pokud je aktivováno rozšíření aplikace Ujeté km, oproti variantě A obsahuje navíc sloupce se soukromými kilometry ze zmíněného rozšíření. Tj. sestavu lze využít jako podklad pro určení poměru ujetých kilometrů soukromě versus služebně (pro odpočet DPH za PHM)&lt;br /&gt;
[[Soubor:SY018B.png]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Evidence vozidel]]&lt;br /&gt;
* [[Závazky]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(Ujet%C3%A9_km)&amp;diff=42325</id>
		<title>Evidence vozidel (Ujeté km)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(Ujet%C3%A9_km)&amp;diff=42325"/>
		<updated>2021-10-18T11:38:53Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Evidence vozidel (Ujeté km)'' &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Evidence &amp;gt; Služební cesty &amp;gt; Evidence vozidel / Ujeté km &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Popis ==&lt;br /&gt;
Agenda &amp;quot;Ujeté km&amp;quot; je placené rozšíření modulu služební cesty a je určena pro účely evidence soukromě ujetých kilometrů za daný měsíc firemním vozem přiděleným manažerům a jiným osobám pro služební i soukromé účely. Níže je obrázek z desktopové aplikace, kde lze ujeté kilometry sice také plnit, ale k zadávání ujetých kilometrů přiděleným zaměstnanem slouží stránka v portále: '''[[Ujeté km]]''', kde naleznete informace pro zaměstnance.&lt;br /&gt;
&lt;br /&gt;
[[Image: Evidence vozidel-Ujete km.png|900px]]&lt;br /&gt;
&lt;br /&gt;
== Import CSV ==&lt;br /&gt;
Prostřednictvím tlačítka ''Import CSV'' (zákaznická specialita) lze v editaci hromadně naimportovat hodnoty ujetých kilometrů.&lt;br /&gt;
Importní soubor musí mít v 1. řádku identifikaci sloupců: spz, souk_km, sluz_km, může a nemusí mít sloupec os_cislo (systém zjistí řidiče dle záložky Přidělení zaměstnanci). Na pořadí sloupců nezáleží. Za každé auto 1 řádek za měsíc. Po výběru období a souboru se data načtou do okna, kde lze následně data upravit nebo některé řádky smazat a následně po kontrole uložit. &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;small&amp;gt;hd 44669&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Sestava ==&lt;br /&gt;
Sestava obsahuje údaje za všechny přidělené vozy, soukromé km jsou uvedeny po jednotlivých měsících, proto pokud chcete kumulaci km za rok, použijte sestavu v předchozí záložce, tj. přidělení zaměstnanci.&lt;br /&gt;
[[Soubor:SY019.png]]&lt;br /&gt;
&lt;br /&gt;
== Návaznosti ==&lt;br /&gt;
* Sestavu SY018/B ze záložky [[Evidence vozidel (Přidělení zaměstnanci)]] lze využít jako podklad pro určení poměru ujetých kilometrů soukromě versus služebně (pro odpočet DPH za PHM)&lt;br /&gt;
* Pokud pohonné hmoty hradí zaměstnanvatel, Lze měsíčně generovat srážku nebo přidanění za pohonné hmoty ujeté soukromě viz [[sc_aus_phm (sk.15)]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Evidence vozidel]]&lt;br /&gt;
* [[Ujeté km]] - Portál&lt;br /&gt;
* [[Evidence vozidel (Přidělení zaměstnanci)]]&lt;br /&gt;
* [[sc_aus_phm (sk.15)]] - výpočet částky za spotřebovanou PHM&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Soubor:SY019.png&amp;diff=42324</id>
		<title>Soubor:SY019.png</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Soubor:SY019.png&amp;diff=42324"/>
		<updated>2021-10-18T11:36:52Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: Ujeté km - sestava ujetých km po měsících&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Ujeté km - sestava ujetých km po měsících&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(P%C5%99id%C4%9Blen%C3%AD_zam%C4%9Bstnanci)&amp;diff=42323</id>
		<title>Evidence vozidel (Přidělení zaměstnanci)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(P%C5%99id%C4%9Blen%C3%AD_zam%C4%9Bstnanci)&amp;diff=42323"/>
		<updated>2021-10-18T11:11:43Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Evidence vozidel (Přidělení zaměstnanci)''&lt;br /&gt;
&lt;br /&gt;
Přidělení vozu pracovníkovi/pracovníkům má za následek to, že se služební '''vozidlo''' již nebude '''v cestovním příkaze nabízet''' všem zaměstnancům, ale '''pouze zaměstnancům''', '''kterým bylo''' vozidlo '''přiděleno''' &amp;lt;small&amp;gt;(jedno vozidlo lze přidělit i více zaměstnancům)&amp;lt;/small&amp;gt;. Přidělení lze časově vymezit (a mít tedy i historii). &lt;br /&gt;
&lt;br /&gt;
[[Image: Evidence vozidel-Prideleni zamestnanci.png]]&lt;br /&gt;
&lt;br /&gt;
* &amp;lt;span style=&amp;quot;background:#FFFF00&amp;quot;&amp;gt;'''Přiděleno zaměstnanci'''&amp;lt;/span&amp;gt; - &amp;lt;small&amp;gt;povinný údaj&amp;lt;/small&amp;gt;&lt;br /&gt;
* &amp;lt;span style=&amp;quot;background:#FFFF00&amp;quot;&amp;gt;'''Přiděleno od'''&amp;lt;/span&amp;gt; - &amp;lt;small&amp;gt;povinný údaj&amp;lt;/small&amp;gt;&lt;br /&gt;
* '''Přiděleno do'''&lt;br /&gt;
* '''I pro soukromé užití''' - pokud byl vůz přidělen zaměstnanci i pro soukromé užívání, zatrhněte příslušnou volbu. Následně může být automaticky generována do mezd příslušná částka: [[MOT.VOZIDLA 1% (výpočet z Evidence vozidel)]]&lt;br /&gt;
* '''Číslo smlouvy'''&lt;br /&gt;
* '''Stav tachometru při přidělení''' - položka je důležitá v případě sledování soukromě ujetých kilometrů, které lze zadávat za jednotlivé měsíce na stránce portálu: [[Ujeté km]].&lt;br /&gt;
&lt;br /&gt;
==Sestava - Varianta A==&lt;br /&gt;
Sestava obsahuje údaje z evidence za všechny přidělené vozy (přidělené ve zvolém období od-do). Varianta A se zobrazuje pokud není aktivováno rozšíření aplikace Ujeté km.&lt;br /&gt;
&lt;br /&gt;
[[Soubor:SY018A.png]]&lt;br /&gt;
&lt;br /&gt;
==Sestava - Varianta B==&lt;br /&gt;
&lt;br /&gt;
Varianta B se zobrazuje pokud je aktivováno rozšíření aplikace Ujeté km, oproti variantě A obsahuje navíc sloupce se soukromými kilometry ze zmíněného rozšíření.&lt;br /&gt;
[[Soubor:SY018B.png]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Evidence vozidel]]&lt;br /&gt;
* [[Závazky]]&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Soubor:SY018A.png&amp;diff=42322</id>
		<title>Soubor:SY018A.png</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Soubor:SY018A.png&amp;diff=42322"/>
		<updated>2021-10-18T11:07:33Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: načtena nová verze &amp;quot;Soubor:SY018A.png&amp;quot;&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Vozidla přidělená zaměstnancům, varianta A (bez aktivního rozšíření Ujeté km)&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Soubor:SY018A.png&amp;diff=42321</id>
		<title>Soubor:SY018A.png</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Soubor:SY018A.png&amp;diff=42321"/>
		<updated>2021-10-18T11:04:59Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: Vozidla přidělená zaměstnancům, varianta A (bez aktivního rozšíření Ujeté km)&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Vozidla přidělená zaměstnancům, varianta A (bez aktivního rozšíření Ujeté km)&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Soubor:SY018B.png&amp;diff=42320</id>
		<title>Soubor:SY018B.png</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Soubor:SY018B.png&amp;diff=42320"/>
		<updated>2021-10-18T10:28:03Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: Vozidla přidělená zaměstnancům, varianta B (aktivované rozšíření Ujeté km)&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;Vozidla přidělená zaměstnancům, varianta B (aktivované rozšíření Ujeté km)&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Ujet%C3%A9_km&amp;diff=42319</id>
		<title>Ujeté km</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Ujet%C3%A9_km&amp;diff=42319"/>
		<updated>2021-10-18T08:20:17Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Ujeté km'' &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Zaměstnanec &amp;gt; Ujeté km&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Stránka je určena pro účely evidence soukromě ujetých kilometrů za daný měsíc firemním vozem přiděleným manažerům a jiným osobám pro služební i soukromé účely. Zaměstnanec může vidět a editovat údaje '''pouze za jemu přidělená vozidla''' z agendy [[Evidence vozidel (Přidělení zaměstnanci)]]. Stránka je součástí placeného rozšíření aplikace, standardně tedy není přístupná. &lt;br /&gt;
&lt;br /&gt;
* Počáteční stav tachometru - needitovatelné pole, hodnota za daný měsíc je dopočítávána z počátečního stavu tachometru při přidělení (v agendě přídělení) a ujetých kilometrů za předchozí měsíce.&lt;br /&gt;
* Kilometry soukromě - editovatelné pole, ujeté kilometry za soukromé jízdy za daný měsíc.&lt;br /&gt;
* Kilometry služebně/nevyúčtované ve SC - editovatelné pole, ujeté kilometry pro služební účely, které nejsou služebními cestami nebo nebyly (a nebudou) do služebních cest zadány.&lt;br /&gt;
* Kilometry služebně/vyúčtované ve SC - needitovatelné pole, hodnota je zjištěna ze zadaných služebních cest.&lt;br /&gt;
* Konečný stav tachometru - pole je sice editační, ale jeho hodnota se nikam neukládá, pokud uživatel hodnotu změní automaticky se dle něj dopočte pole &amp;quot;Kilometry sokromě&amp;quot; jako &amp;quot;Konečný stav&amp;quot; - &amp;quot;Počáteční stav&amp;quot; - &amp;quot;Kilometry služebně&amp;quot;.&lt;br /&gt;
&lt;br /&gt;
[[Image: Ujete_km-Editace.png|thumb|590px|Editace (za období 04/2019)]]&lt;br /&gt;
&lt;br /&gt;
[[Image: Ujete_km.png|880px]]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[KS portál]]&lt;br /&gt;
* [[Evidence vozidel (Přidělení zaměstnanci)]]&lt;br /&gt;
* [[sc_aus_phm (sk.15)]] - výpočet částky za spotřebovanou PHM&lt;br /&gt;
&amp;lt;!-- hd 39420 --&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div style=&amp;quot;text-align:center&amp;quot;&amp;gt;[[Příručka KS Portál|Zpět]] | [[Zapnutí zástupu (KS portál)|Zapnutí zástupu]]&amp;lt;/div&amp;gt;&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(Ujet%C3%A9_km)&amp;diff=42318</id>
		<title>Evidence vozidel (Ujeté km)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Evidence_vozidel_(Ujet%C3%A9_km)&amp;diff=42318"/>
		<updated>2021-10-18T07:55:15Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;''Evidence vozidel (Ujeté km)'' &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Evidence &amp;gt; Služební cesty &amp;gt; Evidence vozidel / Ujeté km &amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Agenda &amp;quot;Ujeté km&amp;quot; je placené rozšíření aplikace. Níže je obrázek z desktopové aplikace, kde lze ujeté kilometry také plnit, ale k zadávání ujetých kilometrů zaměstnanci slouží&lt;br /&gt;
&lt;br /&gt;
stránka v portále: '''[[Ujeté km]]''', kde naleznete více informací.&lt;br /&gt;
&lt;br /&gt;
[[Image: Evidence vozidel-Ujete km.png|900px]]&lt;br /&gt;
&lt;br /&gt;
== Import CSV ==&lt;br /&gt;
Prostřednictvím tlačítka ''Import CSV'' (zákaznická specialita) lze v editaci hromadně naimportovat hodnoty ujetých kilometrů.&lt;br /&gt;
Importní soubor musí mít v 1. řádku identifikaci sloupců: spz, souk_km, sluz_km, může a nemusí mít sloupec os_cislo (systém zjistí řidiče dle záložky Přidělení zaměstnanci). Na pořadí sloupců nezáleží. Za každé auto 1 řádek za měsíc. Po výběru období a souboru se data načtou do okna, kde lze následně data upravit nebo některé řádky smazat a následně po kontrole uložit. &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;small&amp;gt;hd 44669&amp;lt;/small&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Evidence vozidel]]&lt;br /&gt;
* [[sc_aus_phm (sk.15)]] - výpočet částky za spotřebovanou PHM&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Silni%C4%8Dn%C3%AD_da%C5%88&amp;diff=42317</id>
		<title>Silniční daň</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Silni%C4%8Dn%C3%AD_da%C5%88&amp;diff=42317"/>
		<updated>2021-10-18T07:39:03Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''Silniční daň''' &amp;lt;br&amp;gt;&lt;br /&gt;
&amp;lt;small&amp;gt;Menu: Evidence &amp;gt; Služební cesty &amp;gt; Sestavy / Silniční daň &amp;lt;/small&amp;gt; &amp;lt;br&amp;gt;&lt;br /&gt;
Sestava čerpá data z '''[[Evidence vozidel]]''' a zadaných služebních cest a umožňuje&lt;br /&gt;
* '''načíst údaje''' potřebné pro výpočet silniční daně/dane z motorových vozidiel a &lt;br /&gt;
* '''vytvořit XML soubor''' pro elektronické podání &lt;br /&gt;
:: Česko: [https://adisepo.mfcr.cz/adistc/adis/idpr_epo/epo2/uvod/vstup.faces adisepo.mfcr.cz]&lt;br /&gt;
:: Slovensko: [http://www.edane.sk/ edane.sk]&lt;br /&gt;
&lt;br /&gt;
Do sestavy vstupují pouze ty firemní vozy, kde je provozovatelem vlastní firma.&lt;br /&gt;
&lt;br /&gt;
== Česko ==&lt;br /&gt;
&amp;lt;!-- '''Aktuálně je zpracován výpočet pro roky 2009 - 2015.''' &amp;lt;small&amp;gt;Sazby daně zůstávaly stejné.&amp;lt;/small&amp;gt; --&amp;gt;&lt;br /&gt;
[[Image: S-SY012.png|right|750px]]&lt;br /&gt;
&lt;br /&gt;
Příklad výpočtu pro r. 2015:&lt;br /&gt;
* ''Počet měsíců = 12.''&lt;br /&gt;
* ''Objem 1390 ccm --&amp;gt; sazba = 2400 Kč.''&lt;br /&gt;
* ''Datum 1. registrace 1.12.2014 --&amp;gt; sleva 48% po dobu 36 kal.měsíců od data první registrace.''&lt;br /&gt;
* ''Výsledná částka 2400 * 0,52 = 1248 Kč.''&lt;br /&gt;
&lt;br /&gt;
==== Silniční daň ====&lt;br /&gt;
'''Silniční daň''' platí pro české legislativní prostředí.&lt;br /&gt;
&lt;br /&gt;
Silniční daň musí platit každý, kdo využívá vozidlo k podnikání nebo jiné samostatné výdělečné činnosti. Předmětem daně jsou silniční vozidla a jejich přípojná vozidla&lt;br /&gt;
* '''registrovaná''' a&lt;br /&gt;
* '''provozovaná v Česku'''.&lt;br /&gt;
&lt;br /&gt;
==== Principy výpočtu ====&lt;br /&gt;
* Platí se '''za měsíce''', ve kterých se auto používalo k podnikání (nad určitou hmotnost bez ohledu na účel).&lt;br /&gt;
* Od daně jsou '''osvobozena''' některá auta ke '''specializovaným účelům'''.&lt;br /&gt;
* Slevu nebo osvobození mohou mít automobily s '''alternativním pohonem''' (''elektřina, LPG, CNG, hybridní'', apod.).&lt;br /&gt;
* Platí se i za '''vlastní automobil zaměstnance''', který byl využíván k pracovním cestám - buď podle počtu měsíců nebo denní sazbou daně za každý služební den.&lt;br /&gt;
* Jsou rozdílné '''sazby dle objemu motoru'''.&lt;br /&gt;
* Částku ovlivňuje také '''datum první registrace''' (slevy).&lt;br /&gt;
* Pro '''nákladní''' auta je rozhodující také hmotnost a počet náprav.&lt;br /&gt;
&lt;br /&gt;
==== Odkazy ====&lt;br /&gt;
* [http://www.penize.cz/silnicni-dan/294261-silnicni-dan-priznejte-do-konce-ledna-formulare-a-kalkulacka#silnicnidan penize.cz - kalkulačka]&lt;br /&gt;
* [http://www.finance.cz/dane-a-mzda/majetkove-dane/silnicni-dan/sazby-dane/ finance.cz - sazby silniční daně]&lt;br /&gt;
&lt;br /&gt;
== Slovensko ==&lt;br /&gt;
&amp;lt;!-- '''Aktuálně je zpracován výpočet pro rok 2015.''' &amp;lt;small&amp;gt;Od r. 2015 došlo ke změně zákona a sjednocení sazeb pro všechny kraje. &amp;lt;/small&amp;gt; --&amp;gt;&lt;br /&gt;
==== Daň z motorových vozidiel==== &lt;br /&gt;
Daň z motorových vozidiel platí pro slovenské legislativní prostředí.&lt;br /&gt;
=== Principy výpočtu ===&lt;br /&gt;
Principy výpočtu jsou obdobné jako pro české legislativní prostředí.&lt;br /&gt;
&lt;br /&gt;
==== Odkazy ====&lt;br /&gt;
* [http://ekonomika.sme.sk/kalkulacky/dan-z-motorovych-vozidiel-cestna-dan-2015.php ekonomika.sme.sk - sadzby 2015]&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Služební cesty]]&lt;br /&gt;
__NOTOC__&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
	<entry>
		<id>https://prirucky.ksprogram.cz/index.php?title=Sc_aus_phm_(sk.15)&amp;diff=42316</id>
		<title>Sc aus phm (sk.15)</title>
		<link rel="alternate" type="text/html" href="https://prirucky.ksprogram.cz/index.php?title=Sc_aus_phm_(sk.15)&amp;diff=42316"/>
		<updated>2021-10-15T12:47:12Z</updated>

		<summary type="html">&lt;p&gt;Wikisysop: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;'''sc_aus_phm (sk.15)''' je [[Rozšiřující parametry|parametr]] pro automatické generování částky (srážky nebo přidanění) za pohonné hmoty za soukromé km.&lt;br /&gt;
&lt;br /&gt;
== Funkcionalita ==&lt;br /&gt;
&lt;br /&gt;
{|border=&amp;quot;1&amp;quot; cellpadding=&amp;quot;3&amp;quot; cellspacing=&amp;quot;0&amp;quot;&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Kód&lt;br /&gt;
| sc_aus_phm&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Název &lt;br /&gt;
| Kód mzd.pol. pro cenu PHM za soukromé km ujeté firemním vozem&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Rozsah &lt;br /&gt;
| číslo&lt;br /&gt;
|-&lt;br /&gt;
! scope=&amp;quot;row&amp;quot;| Popis&lt;br /&gt;
|  &lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
U firemních vozidel '''přidělených i pro soukromé užití''', u kterých hradí cenu pohonných hmot firma, se prostřednictvím tohoto parametru provádí '''výpočet částky za spotřebovanou pohonnou hmotu za soukromé jízdy''' dle &lt;br /&gt;
* soukromých kilometrů vykázaných v rozšíření [[Ujeté km]]&lt;br /&gt;
* průměrné spotřeby vozu z evidence vozidel a &lt;br /&gt;
* ceny PHM v číselníku [[Ceny PHM]].&lt;br /&gt;
&lt;br /&gt;
Do hodnoty parametru se zadává číslo mzdové položky, na kterou má být částka generována. &lt;br /&gt;
&lt;br /&gt;
'''Přidanění:'''&lt;br /&gt;
Mzdovou položku je třeba patřičně nastavit v číselníku mzdových položek, aby nedošlo k vyplacení částky, ale jen k přidanění (způsob danění -1), plus nastavit SP a ZP. &lt;br /&gt;
&lt;br /&gt;
'''Srážka:'''&lt;br /&gt;
Požijte kód z rozsahu pro srážky (pokud nepoužijete kód z rozsahu pro srážky, dejte před kód mzdové položky znak mínus, aby se generovala záporná částka).&lt;br /&gt;
&lt;br /&gt;
== Odkazy ==&lt;br /&gt;
* [[Služební cesty - nastavení]]&lt;br /&gt;
* &amp;lt;small&amp;gt;hd 57248&amp;lt;/small&amp;gt;&lt;/div&gt;</summary>
		<author><name>Wikisysop</name></author>
	</entry>
</feed>