Prirucky - Příspěvky [cs]

KS WebAPI

2021-10-12T08:50:55Z

Jakub: /* Operace dostupné pomocí KS WebAPI */

''KS WebAPI'' je webová služba postavená na technologii '''Windows Communication Foundation'''. Umožňuje předávat údaje z databáze KS mzdy klientské aplikaci nebo ukládat údaje do databáze KS mzdy zaslané klientskou aplikací.

==Komunikační protokol==
Pro hostování webové služby se využívá KS aplikační server. Komunikačním protokolem je http, případně ve spojení se SSL (HTTPS). Pro výměnu zpráv se používá protokol SOAP. Ve výchozím nastavení je připraven typ endpointu wsHttpBinding.

=Zpřístupnění KS WebAPI=

KS WebAPI je potřeba '''aktivovat''' prostřednictvím '''[[Rozšíření aplikace]]''' v desktop aplikaci.
Jsou dostupné 3 varianty, které se liší množinou zpracovávaných dat a povolením pro čtení a zápis údajů:

* '''KS WebAPI Free'''
:Bezplatná verze obecného rozhraní pro čtení dat zaměstnanců ze systému KS mzdy. Umožňuje čtení omezené množiny položek ze skupiny údajů 'KmenoveUdaje'.

* '''KS WebAPI Reader'''
:Obecné rozhraní pro čtení dat zaměstnanců ze systému KS mzdy.

* '''KS WebAPI Writer'''
:Obecné rozhraní pro čtení a zápis dat zaměstnanců do/ze systému KS mzdy.

'''Pro zpřístupnění je potřeba provést tyto kroky:'''

# V aplikaci KS mzdy, v okně 'Rozšíření aplikace' (menu: Nápověda > Rozšíření aplikace), aktivovat požadované rozšíření.
#Provést úpravu databáze.
#V aplikaci KS mzdy spustit úlohu WebAPI (menu: Systém > Web API). Potvrzením volby 'Ano' dojde k vygenerování dokumentace k přenášeným údajům (ve formě HTML). Generování dokumentace je potom potřeba provádět vždy, pokud bude vydaná nová verze KS WebAPI.

=Operace dostupné pomocí KS WebAPI=

V tabulce jsou uvedeny pouze hlavní operace dostupné všem zákazníkům. Někteří zákazníci mohou mít zpřístupněny další specifické operace. Dále se seznam liší dle varianty (Free, Reader, Writer).

'''Vždy je nutné vygenerovat si dokumentaci k WebAPI pomocí desktop aplikace.'''

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Souhrn údajů'''
|'''Čtení'''
|'''Zápis'''
|'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || || || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || || || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || || || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || || ||
|-
| [[WebAPI Plánované směny|Plánované směny]] || || ||
|-
| [[WebAPI Požadavky|Požadavky]] || || || [[Požadavky]]
|}

=Metody webové služby=

KS WebAPI nabízí metody: '''GetData''', '''InsertData''', '''UpdateData'''.

Všechny metody přebírají v parametru strukturu ''KSWebAPI_Parameters'' a vrací návratovou strukturu ''KSWebAPI_Response''.

==GetData==

Metoda '''GetData''' vrací data z databáze KS mzdy dle zadaných kritérií.

Nastavení parametrů struktury KSWebAPI_Parameters

* '''ItemGroup'''
:Povinný údaj. Předá se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''Items'''
:Předá se seznam položek, které budou v návratové datové struktuře. Jednotlivé položky se oddělí čárkou (Příklad: OsCislo, Jmeno, Prijmeni).

* '''[[JsonSearchCriteria]]''' - předá se vyhledávací podmínka v JSON formátu.

* '''[[JsonOptions]]''' - nepovinný údaj, slouží pro doplnění speciálních parametrů, které ovlivní zpracovávanou skupinu údajů.

Popis údajů v návratové struktuře '''KSWebAPI_Response'''

* '''Data'''
:Očekávané data vyhovující podmínce v JsonSearchCriteria ve formátu JSON.

==InsertData==

Metoda '''InsertData''' zapisuje data do databáze KS mzdy.

Nastavení parametrů struktury '''KSWebAPI_Parameters'''

* '''ItemGroup'''
:Povinný údaj. Předá se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''JsonChangeData'''
:Povinný údaj. V JSON struktuře se předají data, která mají být zapsána do databáze KS mzdy. Vždy se jedná o pole, kde v jednotlivých objektech pole jsou data pro insert.

'''Příklad dat pro vložení jednoho záznamu'''
<pre>
[
[{ "IdPodniku": "1", "Jmeno": "Karel", "Prijmeni": "Nový", "RodneCislo": "800101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "100", "PscTrv": "75501", "MistoTrv": "Vsetín", "KmenStr": "1", "DatumNastupu": "2019-01-01"}]
]
</pre>

'''Příklad dat pro vložení více záznamů'''
<pre>
[
[ { "IdPodniku": "1", "Jmeno": "Karel", "Prijmeni": "Nový", "RodneCislo": "800101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "100", "PscTrv": "75501", "MistoTrv": "Vsetín",
"KmenStr": "1", "DatumNastupu": "2019-01-01"},
{ "IdPodniku": "1", "Jmeno": "Petr", "Prijmeni": "Test", "RodneCislo": "81101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "101", "PscTrv": "75501", "MistoTrv": "Vsetín",
"KmenStr": "1", "DatumNastupu": "2019-02-01"},
{ "IdPodniku": "1", "Jmeno": "Marie", "Prijmeni": "Nová", "RodneCislo": "820101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "102", "PscTrv": "75501", "MistoTrv": "Vsetín",
"KmenStr": "1", "DatumNastupu": "2019-03-01"}
]
]
</pre>

Popis údajů v návratové struktuře '''KSWebAPI_Response'''

*'''Data'''
:V JSON formátu jsou předána data, která byla vložena do databáze.

==UpdateData==
Metoda '''UpdateData''' provádí změnu dat v databázi KS mzdy.

Nastavení parametrů struktury '''KSWebAPI_Parameters'''

* '''ItemGroup'''
:Povinný údaj. Předá se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''JsonChangeData'''
:Povinný údaj. V JSON struktuře se předají data, která mají být změněna v databázi KS mzdy. Vždy se jedná o pole. V poli by měl být pouze jeden objekt s měněnými položkami.

'''Příklad dat pro změnu údajů'''
<pre>
[{ "KmenStr": "100", "DatumVystupu": "2019-12-31" }]
</pre>

* '''[[JsonSearchCriteria]]''' - předá se vyhledávací podmínka v JSON formátu, pro omezení množiny dat, které mají být změněny.

* '''[[JsonOptions]]''' - nepovinný údaj, slouží pro doplnění speciálních parametrů, které ovlivní zpracovávanou skupinu údajů.

=KSWebAPI_Parameters=

Struktura obsahuje parametry:

* '''ItemGroup'''
:Povinný údaj. Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''Items'''
:Vyplňuje se v případe volání metody '''GetData'''. Předává se seznam položek, které budou v návratové datové struktuře, na které má uživatel oprávnění. Jednotlivé položky se oddělují čárkou (Příklad: OsCislo, Jmeno, Prijmeni).

* '''JsonChangeData'''
:Vyplňuje se v případe volání metody '''InsertData''' nebo '''UpdateData'''. V JSON struktuře se předávají data, která mají být zapsána do databáze KS mzdy. Vždy se jedná o JSON pole.
* '''[[JsonSearchCriteria]]''' - slouží k předání vyhledávacích kritérií pro omezení množiny zpracovávaných údajů.

* '''[[JsonOptions]]''' - vlastnost slouží pro doplnění speciálních parametrů, které ovlivní zpracovávanou skupinu údajů.

=KSWebAPI_Response=

Struktura obsahuje parametry:

* '''ResponseDatetime'''
:Datum a čas odpovědi.

* '''StatusCode'''
:Stav odpovědi. 200 – OK, 500 – chyba.

* '''Message'''
:Zpráva odpovědi.

* '''IsError'''
:Indikace zda nastala chyba.

* '''ErrorMessage'''
:Chybová zpráva o chybovém stavu při zpracování metody.

* '''Data'''
:Data ve formátu JSON.

=Autentizace=
Pro ověření uživatele se používá UserName autentizace, kdy se předává jméno a heslo uživatele při volání metody webové služby v části ClientCredentials.
Tato metoda musí být nastavena v konfiguračním souboru klienta.

==Příklady==

<pre>
<security>
<message clientCredentialType="UserName" />
</security>
</pre>

Uživatelé se evidují v okně ''''Správa uživatelů''''

[[Soubor:Sprava-uzivatelu-KS-WEBAPI.jpg|350px]]

=Aplikační server=

Aplikační server (dále AS) je samostatný program, který běží jako '''Windows služba''' a mimo jiné zajišťuje hostování webové služby '''KS WebAPI'''.

==Instalace==

Z uložiště KS - program je potřeba stáhnout poslední verzi aplikace MaPSetup, která slouží k instalaci AS: http://download.ksprogram.cz/download/MaPSetup.zip.

V instalaci pokračujte podle příručky: [[Aplikační_server_KS|Aplikační_server_KS]]

==Konfigurace KS WebAPI==

Konfigurace KS WebAPI se provádí převážně v konfiguračním souboru AS. Některá nastavení (např. Správa uživatelů KS WebAPI) se provádí v aplikaci AS SeanceMAnager.

===Konfigurační soubor===

Konfigurace KS WebAPI se provádí v konfiguračním souboru AS 'ASServer.exe.config'. Soubor je uložen v adresáři 'ASServer', v umístění instance AS, které bylo vybráno pro instalaci AS.

V konfiguračním souboru se nastaví Endpoint, Binding, Behavior, případně jiná nastavení.

Níže je uvedena vzorová konfigurace, která využívá zabezpečení s ověřením uživatelského jména na straně klienta a proto je potřeba nastavit certifikát v části '''''<serviceCertificate>'''''

'''Vzorová konfigurace'''
<pre>
<system.serviceModel>
<services>
<service name="KSProgram.AS.WCF.KSWebAPI" behaviorConfiguration="KSWebAPIBehavior">
<host>
<baseAddresses>
<add baseAddress="http://localhost:9001/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>

<endpoint address=""
binding="wsHttpBinding"
bindingConfiguration="KSWebAPIBinding"
contract="KSProgram.AS.WCF.IKSWebAPI" />
</service>
</services>
<bindings>
<wsHttpBinding>
<binding name="KSWebAPIBinding">
<security mode="Message">
<message clientCredentialType="UserName" />
</security>
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"
maxArrayLength="2147483647"
maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />
</binding>
</wsHttpBinding>
</bindings>

<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<userNameAuthentication userNamePasswordValidationMode="Custom"
customUserNamePasswordValidatorType="KSProgram.AS.WCF.PasswordValidator, WCFLib"/>
<serviceCertificate findValue="WebAPI_cert" storeLocation="LocalMachine"
storeName="My" x509FindType="FindBySubjectName"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</pre>

===AS SeanceManager===

AS SeanceManager (dále ASSM) je aplikace, která byla nainstalována společně s AS a slouží ke správě AS (spouštění instancí AS, konfigurace úloh, kontrola stavu úloh, atd.), viz obr. 1. ASSM je umístěn v adresáři, který byl vybrán pro instalaci AS (''…\KS-AS\ASSeanceManager\ASSeanceManager.exe'').

V případě KS WebAPI je zde typ úlohy ''''Webová služba KSWebAPI'''' (Kód = 73) v seznamu '''Typy úlohy'''. V části 'Nastavení webové služby' se provádí nastavení uživatelských účtů pro autentizaci.

ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.

[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]

===Správa uživatelů===

V AS SeanceManageru se provádí nastavení uživatelských účtů pro autentizaci. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka 'Správa uživatelů' otevře příslušné okno .

[[Soubor:Sprava-uzivatelu-KS-WEBAPI.jpg|350px]]

===Oprávnění na položky===

V AS SeanceManageru se provádí nastavení oprávnění ''''Čtení'''' a ''''Zápis'''' na položky pro jednotlivé skupiny položek. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''''Přístupová práva'''' otevře příslušné okno

[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]

==Spuštění KS WebAPI==

Pro spuštění KS WebAPI je potřeba mít aktivní úlohu ''''Webová služba KSWebAPI'''' (Kód = 73). Aktivace / Deaktivace se provádí tlačítkem '''Aktivovat vybranou úlohu / Deaktivovat vybranou úlohu'''. Dále je potřeba mít spuštěnou instanci AS. Spuštění / Zastavení instance AS se provádí tlačítkem '''Spustit instanci KS-AS / Zastavit instanci KS-AS'''.

=Chybové stavy=

Při požadavku zaslaném klientem na KS WebAPI jsou případné chybové stavy odesílány zpět klientovi v návratovém typu '''KSWebAPI_Response''', atributu '''ErrorMessage'''. Některé typy výjimek (např. databázové chyby) jsou navíc logovány v event logu systému windows.

=Klientská aplikace=

Klientská aplikace se vytvoří na základě znalosti popisu webové služby KS WebAPI (WSDL). WSDL je dostupné v umístění webové služby. Dle zde uvedeného vzorového konfiguračního souboru tomu odpovídá:
<nowiki>http://localhost:9001/KSAsServer/WebService/WebAPI?wsdl</nowiki>

Níže je uveden příklad zdrojového kódu v C#, který provádí volání '''GetData''' z KS WebAPI.

'''Vzorová konfigurace'''
<pre>
ServiceReference_KSWS.KSWebAPI_Parameters par = new ServiceReference_KSWS.KSWebAPI_Parameters();

// Požadované údaje.
par.Items = "OsCislo, Jmeno, Prijmeni, KmenStr, DatumNastupu, DatumVystupu";

// Skupina údajů.
par.ItemGroup = "KmenoveUdaje";

// Nastavení vyhedávacího kritéria.
par.JsonSearchCriteria = @"[
{ 'Item': 'OsCislo', 'Operator': '<=', 'Value': 100 },
'AND',
{ 'Item': 'DatumNastupu', 'Operator': '>=', 'Value': '2000-01-01' }
]".Replace("'", "\"");

ServiceReference_KSWS.KSWebAPIClient client = new ServiceReference_KSWS.KSWebAPIClient("WSHttpBinding_IKSWebAPI");
try
{
// Zadání uživatelského jména a hesla pro autentizaci.
client.ClientCredentials.UserName.UserName = "uzivatel";
client.ClientCredentials.UserName.Password = "test";

// Zavolání metody webové služby.
resp = client.GetData(par); // Získání dat.

// Zpracování výsledku.
string code = resp.StatusCode; // Stavový kód. (200 - OK, 500 - chyba)
string data = resp.Data; // Data.
string errorMessage = resp.ErrorMessage; // Chybová správa.

client.Close(); // Uzavření klienta.
}
catch (Exception ex)
{
client.Abort();
}

</pre>

== Odkazy ==
* [[Systémová příručka]]
* [[Přenosy dat]]

KS WebAPI

2021-10-12T08:50:15Z

Jakub: /* Operace dostupné pomocí KS WebAPI */

''KS WebAPI'' je webová služba postavená na technologii '''Windows Communication Foundation'''. Umožňuje předávat údaje z databáze KS mzdy klientské aplikaci nebo ukládat údaje do databáze KS mzdy zaslané klientskou aplikací.

==Komunikační protokol==
Pro hostování webové služby se využívá KS aplikační server. Komunikačním protokolem je http, případně ve spojení se SSL (HTTPS). Pro výměnu zpráv se používá protokol SOAP. Ve výchozím nastavení je připraven typ endpointu wsHttpBinding.

=Zpřístupnění KS WebAPI=

KS WebAPI je potřeba '''aktivovat''' prostřednictvím '''[[Rozšíření aplikace]]''' v desktop aplikaci.
Jsou dostupné 3 varianty, které se liší množinou zpracovávaných dat a povolením pro čtení a zápis údajů:

* '''KS WebAPI Free'''
:Bezplatná verze obecného rozhraní pro čtení dat zaměstnanců ze systému KS mzdy. Umožňuje čtení omezené množiny položek ze skupiny údajů 'KmenoveUdaje'.

* '''KS WebAPI Reader'''
:Obecné rozhraní pro čtení dat zaměstnanců ze systému KS mzdy.

* '''KS WebAPI Writer'''
:Obecné rozhraní pro čtení a zápis dat zaměstnanců do/ze systému KS mzdy.

'''Pro zpřístupnění je potřeba provést tyto kroky:'''

# V aplikaci KS mzdy, v okně 'Rozšíření aplikace' (menu: Nápověda > Rozšíření aplikace), aktivovat požadované rozšíření.
#Provést úpravu databáze.
#V aplikaci KS mzdy spustit úlohu WebAPI (menu: Systém > Web API). Potvrzením volby 'Ano' dojde k vygenerování dokumentace k přenášeným údajům (ve formě HTML). Generování dokumentace je potom potřeba provádět vždy, pokud bude vydaná nová verze KS WebAPI.

=Operace dostupné pomocí KS WebAPI=

V tabulce jsou uvedeny pouze hlavní operace dostupné všem zákazníkům. Někteří zákazníci mohou mít zpřístupněny další specifické operace. Dále se seznam liší dle varianty (Free, Reader, Writer). '''Vždy je nutné vygenerovat si dokumentaci k WebAPI pomocí desktop aplikace.'''

{|class="wikitable sortable" border="1" cellpadding="3" cellspacing="0"
|- style="background-color: #eeeeee"
|'''Souhrn údajů'''
|'''Čtení'''
|'''Zápis'''
|'''Význam'''
|-
| [[WebAPI Pracovní pomůcky|PracovniPomucky]]
| Ano
| Ano
| Přiřazení prac. pomůcek zaměstnancům
|-
| [[WebAPI Zpracované mzdy |ZpracovaneMzdy ]]
| Ano
| Ne
| Mzdy zaměstnanců a odvody podniku.
|-
| [[WebAPI Jazykové znalosti |JazykoveZnalosti ]]
| Ano
| Ano
| Jazykové znalosti zaměstnanců
|-
| [[WebAPI Dovolená|Dovolena ]]
| Ano
| Ne
| Dovolená v hodinách (legislativa 2021)
|-
| [[WebAPI Divize|Divize ]]
| Ano
| Ano
| Číselník divizí
|-
| [[WebAPI Benefitní volno|BenefitniVolno ]]
| Ano
| Ne
| Benefitní volna zaměstnanců
|-
| [[WebAPI Zpracovaná docházka|ZpracovanaDochazka ]]
| Ano
| Ano
| Sesumovaná docházková data pro mzdy
|-
| [[WebAPI Platby |Platby ]]
| Ano
| Ano
| Platby zaměstanců
|-
| [[WebAPI Pracovní místa|PracovniMista ]]
| Ano
| Ano
| Číselník pracovních míst
|-
| [[WebAPI Pracovní poměry |PracovniPomery ]]
| Ano
| Ano
| Pracovněprávní poměry zaměstnanců
|-
| [[WebAPI Pracovní postup|PracovniPostup ]]
| Ano
| Ne
| Pracovní postup zaměstnanců
|-
| [[WebAPI Pracovní povolení|PracovniPovoleni ]]
| Ano
| Ano
| Pracovní povolení cizinců
|-
| [[WebAPI Kmenové údaje|KmenoveUdaje ]]
| Ano
| Ano
| Evidence zaměstnanců
|-
| [[WebAPI Rodinní příslušníci|RodinniPrislusnici ]]
| Ano
| Ano
| Rodinní příslušníci
|-
| [[WebAPI Rodinní příslušníci slevy|RodinniPrislusniciSlevy ]]
| Ano
| Ano
| Daňové zvýhodnění rodinných příslušníků
|-
| [[WebAPI Skupiny středisek |SkupinyStredisek ]]
| Ano
| Ano
| Číselník skupiny středisek
|-
| [[WebAPI Služební cesty výdaje |SluzebniCestyVydaje ]]
| Ano
| Ne
| Cestovní výdaje/náhrady
|-
| [[WebAPI Služební cesty|SluzebniCesty ]]
| Ano
| Ne
| Služební cesty
|-
| [[WebAPI Služební cesty vyučtování|SluzebniCestyVyuctovani ]]
| Ano
| Ne
| Vyúčtování služebních cest
|-
| [[WebAPI Služební cesty zálohy|SluzebniCestyZalohy ]]
| Ano
| Ne
| Zálohy na služební cesty
|-
| [[WebAPI Střediska|Strediska ]]
| Ano
| Ano
| Číselník středisek
|-
| [[WebAPI Kontakty|Kontakty]]
| Ano
| Ano
| Kontakty (telefonní čísla, emaily)
|-
| [[WebAPI Vzdělání|Vzdelani ]]
| Ano
| Ano
| Dosažené vzdělání zaměstnanců
|-
| [[WebAPI KumulacePoVyuctovani|KumulacePoVyuctovani]] || Ano || Ne || Měsíční kumulace a další údaje po vyúčtování za os.číslo.
|-
| [[WebAPI MimoevidencniStavy|MimoevidencniStavy]] || Ano || Ne || [[Mimoevidenční stav]]
|-
| [[WebAPI Poznamky|Poznamky]] || || || Poznámky
|-
| [[WebAPI CiselnikJazyku|CiselnikJazyku]] || || || Číselník jazyků
|-
| [[WebAPI CiselnikStupnuVzdelani|CiselnikStupnuVzdelani]] || || || Číselník stupňů vzdělání
|-
| [[WebAPI iTutor_Courses|iTutor_Courses]] || || ||
|-
| [[WebAPI Plánované směny|Plánované směny]] || || ||
|-
| [[WebAPI Požadavky|Požadavky]] || || || [[Požadavky]]
|}

=Metody webové služby=

KS WebAPI nabízí metody: '''GetData''', '''InsertData''', '''UpdateData'''.

Všechny metody přebírají v parametru strukturu ''KSWebAPI_Parameters'' a vrací návratovou strukturu ''KSWebAPI_Response''.

==GetData==

Metoda '''GetData''' vrací data z databáze KS mzdy dle zadaných kritérií.

Nastavení parametrů struktury KSWebAPI_Parameters

* '''ItemGroup'''
:Povinný údaj. Předá se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''Items'''
:Předá se seznam položek, které budou v návratové datové struktuře. Jednotlivé položky se oddělí čárkou (Příklad: OsCislo, Jmeno, Prijmeni).

* '''[[JsonSearchCriteria]]''' - předá se vyhledávací podmínka v JSON formátu.

* '''[[JsonOptions]]''' - nepovinný údaj, slouží pro doplnění speciálních parametrů, které ovlivní zpracovávanou skupinu údajů.

Popis údajů v návratové struktuře '''KSWebAPI_Response'''

* '''Data'''
:Očekávané data vyhovující podmínce v JsonSearchCriteria ve formátu JSON.

==InsertData==

Metoda '''InsertData''' zapisuje data do databáze KS mzdy.

Nastavení parametrů struktury '''KSWebAPI_Parameters'''

* '''ItemGroup'''
:Povinný údaj. Předá se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''JsonChangeData'''
:Povinný údaj. V JSON struktuře se předají data, která mají být zapsána do databáze KS mzdy. Vždy se jedná o pole, kde v jednotlivých objektech pole jsou data pro insert.

'''Příklad dat pro vložení jednoho záznamu'''
<pre>
[
[{ "IdPodniku": "1", "Jmeno": "Karel", "Prijmeni": "Nový", "RodneCislo": "800101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "100", "PscTrv": "75501", "MistoTrv": "Vsetín", "KmenStr": "1", "DatumNastupu": "2019-01-01"}]
]
</pre>

'''Příklad dat pro vložení více záznamů'''
<pre>
[
[ { "IdPodniku": "1", "Jmeno": "Karel", "Prijmeni": "Nový", "RodneCislo": "800101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "100", "PscTrv": "75501", "MistoTrv": "Vsetín",
"KmenStr": "1", "DatumNastupu": "2019-01-01"},
{ "IdPodniku": "1", "Jmeno": "Petr", "Prijmeni": "Test", "RodneCislo": "81101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "101", "PscTrv": "75501", "MistoTrv": "Vsetín",
"KmenStr": "1", "DatumNastupu": "2019-02-01"},
{ "IdPodniku": "1", "Jmeno": "Marie", "Prijmeni": "Nová", "RodneCislo": "820101111", "MistoNarozeni": "Vsetín", "StatNar": "CZ", "StPrisl": "203", "RodinStav": "2", "TrCislo": "102", "PscTrv": "75501", "MistoTrv": "Vsetín",
"KmenStr": "1", "DatumNastupu": "2019-03-01"}
]
]
</pre>

Popis údajů v návratové struktuře '''KSWebAPI_Response'''

*'''Data'''
:V JSON formátu jsou předána data, která byla vložena do databáze.

==UpdateData==
Metoda '''UpdateData''' provádí změnu dat v databázi KS mzdy.

Nastavení parametrů struktury '''KSWebAPI_Parameters'''

* '''ItemGroup'''
:Povinný údaj. Předá se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''JsonChangeData'''
:Povinný údaj. V JSON struktuře se předají data, která mají být změněna v databázi KS mzdy. Vždy se jedná o pole. V poli by měl být pouze jeden objekt s měněnými položkami.

'''Příklad dat pro změnu údajů'''
<pre>
[{ "KmenStr": "100", "DatumVystupu": "2019-12-31" }]
</pre>

* '''[[JsonSearchCriteria]]''' - předá se vyhledávací podmínka v JSON formátu, pro omezení množiny dat, které mají být změněny.

* '''[[JsonOptions]]''' - nepovinný údaj, slouží pro doplnění speciálních parametrů, které ovlivní zpracovávanou skupinu údajů.

=KSWebAPI_Parameters=

Struktura obsahuje parametry:

* '''ItemGroup'''
:Povinný údaj. Předává se název skupiny údajů (entity) v KS mzdy (např. 'KmenoveUdaje').

* '''Items'''
:Vyplňuje se v případe volání metody '''GetData'''. Předává se seznam položek, které budou v návratové datové struktuře, na které má uživatel oprávnění. Jednotlivé položky se oddělují čárkou (Příklad: OsCislo, Jmeno, Prijmeni).

* '''JsonChangeData'''
:Vyplňuje se v případe volání metody '''InsertData''' nebo '''UpdateData'''. V JSON struktuře se předávají data, která mají být zapsána do databáze KS mzdy. Vždy se jedná o JSON pole.
* '''[[JsonSearchCriteria]]''' - slouží k předání vyhledávacích kritérií pro omezení množiny zpracovávaných údajů.

* '''[[JsonOptions]]''' - vlastnost slouží pro doplnění speciálních parametrů, které ovlivní zpracovávanou skupinu údajů.

=KSWebAPI_Response=

Struktura obsahuje parametry:

* '''ResponseDatetime'''
:Datum a čas odpovědi.

* '''StatusCode'''
:Stav odpovědi. 200 – OK, 500 – chyba.

* '''Message'''
:Zpráva odpovědi.

* '''IsError'''
:Indikace zda nastala chyba.

* '''ErrorMessage'''
:Chybová zpráva o chybovém stavu při zpracování metody.

* '''Data'''
:Data ve formátu JSON.

=Autentizace=
Pro ověření uživatele se používá UserName autentizace, kdy se předává jméno a heslo uživatele při volání metody webové služby v části ClientCredentials.
Tato metoda musí být nastavena v konfiguračním souboru klienta.

==Příklady==

<pre>
<security>
<message clientCredentialType="UserName" />
</security>
</pre>

Uživatelé se evidují v okně ''''Správa uživatelů''''

[[Soubor:Sprava-uzivatelu-KS-WEBAPI.jpg|350px]]

=Aplikační server=

Aplikační server (dále AS) je samostatný program, který běží jako '''Windows služba''' a mimo jiné zajišťuje hostování webové služby '''KS WebAPI'''.

==Instalace==

Z uložiště KS - program je potřeba stáhnout poslední verzi aplikace MaPSetup, která slouží k instalaci AS: http://download.ksprogram.cz/download/MaPSetup.zip.

V instalaci pokračujte podle příručky: [[Aplikační_server_KS|Aplikační_server_KS]]

==Konfigurace KS WebAPI==

Konfigurace KS WebAPI se provádí převážně v konfiguračním souboru AS. Některá nastavení (např. Správa uživatelů KS WebAPI) se provádí v aplikaci AS SeanceMAnager.

===Konfigurační soubor===

Konfigurace KS WebAPI se provádí v konfiguračním souboru AS 'ASServer.exe.config'. Soubor je uložen v adresáři 'ASServer', v umístění instance AS, které bylo vybráno pro instalaci AS.

V konfiguračním souboru se nastaví Endpoint, Binding, Behavior, případně jiná nastavení.

Níže je uvedena vzorová konfigurace, která využívá zabezpečení s ověřením uživatelského jména na straně klienta a proto je potřeba nastavit certifikát v části '''''<serviceCertificate>'''''

'''Vzorová konfigurace'''
<pre>
<system.serviceModel>
<services>
<service name="KSProgram.AS.WCF.KSWebAPI" behaviorConfiguration="KSWebAPIBehavior">
<host>
<baseAddresses>
<add baseAddress="http://localhost:9001/KSAsServer/WebService/WebAPI"/>
</baseAddresses>
</host>

<endpoint address=""
binding="wsHttpBinding"
bindingConfiguration="KSWebAPIBinding"
contract="KSProgram.AS.WCF.IKSWebAPI" />
</service>
</services>
<bindings>
<wsHttpBinding>
<binding name="KSWebAPIBinding">
<security mode="Message">
<message clientCredentialType="UserName" />
</security>
<readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"
maxArrayLength="2147483647"
maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />
</binding>
</wsHttpBinding>
</bindings>

<behaviors>
<serviceBehaviors>
<behavior name="KSWebAPIBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
<serviceCredentials>
<userNameAuthentication userNamePasswordValidationMode="Custom"
customUserNamePasswordValidatorType="KSProgram.AS.WCF.PasswordValidator, WCFLib"/>
<serviceCertificate findValue="WebAPI_cert" storeLocation="LocalMachine"
storeName="My" x509FindType="FindBySubjectName"/>
</serviceCredentials>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</pre>

===AS SeanceManager===

AS SeanceManager (dále ASSM) je aplikace, která byla nainstalována společně s AS a slouží ke správě AS (spouštění instancí AS, konfigurace úloh, kontrola stavu úloh, atd.), viz obr. 1. ASSM je umístěn v adresáři, který byl vybrán pro instalaci AS (''…\KS-AS\ASSeanceManager\ASSeanceManager.exe'').

V případě KS WebAPI je zde typ úlohy ''''Webová služba KSWebAPI'''' (Kód = 73) v seznamu '''Typy úlohy'''. V části 'Nastavení webové služby' se provádí nastavení uživatelských účtů pro autentizaci.

ASSM (soubor '''ASSeanceManager.exe''') je nutné spouštět jako '''správce'''.

[[Soubor:Nastaveni-as-seancemanager-webapi.jpg|450px]]

===Správa uživatelů===

V AS SeanceManageru se provádí nastavení uživatelských účtů pro autentizaci. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka 'Správa uživatelů' otevře příslušné okno .

[[Soubor:Sprava-uzivatelu-KS-WEBAPI.jpg|350px]]

===Oprávnění na položky===

V AS SeanceManageru se provádí nastavení oprávnění ''''Čtení'''' a ''''Zápis'''' na položky pro jednotlivé skupiny položek. V sekci ''''Nastavení webové služby'''' se po stisku tlačítka ''''Přístupová práva'''' otevře příslušné okno

[[Soubor:Pristupova-prava-polozky-ks-webapi.jpg|350px]]

==Spuštění KS WebAPI==

Pro spuštění KS WebAPI je potřeba mít aktivní úlohu ''''Webová služba KSWebAPI'''' (Kód = 73). Aktivace / Deaktivace se provádí tlačítkem '''Aktivovat vybranou úlohu / Deaktivovat vybranou úlohu'''. Dále je potřeba mít spuštěnou instanci AS. Spuštění / Zastavení instance AS se provádí tlačítkem '''Spustit instanci KS-AS / Zastavit instanci KS-AS'''.

=Chybové stavy=

Při požadavku zaslaném klientem na KS WebAPI jsou případné chybové stavy odesílány zpět klientovi v návratovém typu '''KSWebAPI_Response''', atributu '''ErrorMessage'''. Některé typy výjimek (např. databázové chyby) jsou navíc logovány v event logu systému windows.

=Klientská aplikace=

Klientská aplikace se vytvoří na základě znalosti popisu webové služby KS WebAPI (WSDL). WSDL je dostupné v umístění webové služby. Dle zde uvedeného vzorového konfiguračního souboru tomu odpovídá:
<nowiki>http://localhost:9001/KSAsServer/WebService/WebAPI?wsdl</nowiki>

Níže je uveden příklad zdrojového kódu v C#, který provádí volání '''GetData''' z KS WebAPI.

'''Vzorová konfigurace'''
<pre>
ServiceReference_KSWS.KSWebAPI_Parameters par = new ServiceReference_KSWS.KSWebAPI_Parameters();

// Požadované údaje.
par.Items = "OsCislo, Jmeno, Prijmeni, KmenStr, DatumNastupu, DatumVystupu";

// Skupina údajů.
par.ItemGroup = "KmenoveUdaje";

// Nastavení vyhedávacího kritéria.
par.JsonSearchCriteria = @"[
{ 'Item': 'OsCislo', 'Operator': '<=', 'Value': 100 },
'AND',
{ 'Item': 'DatumNastupu', 'Operator': '>=', 'Value': '2000-01-01' }
]".Replace("'", "\"");

ServiceReference_KSWS.KSWebAPIClient client = new ServiceReference_KSWS.KSWebAPIClient("WSHttpBinding_IKSWebAPI");
try
{
// Zadání uživatelského jména a hesla pro autentizaci.
client.ClientCredentials.UserName.UserName = "uzivatel";
client.ClientCredentials.UserName.Password = "test";

// Zavolání metody webové služby.
resp = client.GetData(par); // Získání dat.

// Zpracování výsledku.
string code = resp.StatusCode; // Stavový kód. (200 - OK, 500 - chyba)
string data = resp.Data; // Data.
string errorMessage = resp.ErrorMessage; // Chybová správa.

client.Close(); // Uzavření klienta.
}
catch (Exception ex)
{
client.Abort();
}

</pre>

== Odkazy ==
* [[Systémová příručka]]
* [[Přenosy dat]]

Dokumenty vystavené (KS portál)

2021-09-20T07:23:52Z

Jakub:

__NOTOC__
V záložce Dokumenty vystavené je k dispozici přehled vystavených a archivovaných dokumentů (ve formátu '''.pdf'''), které jsou uloženy v C/S aplikaci v příslušné agendě.
[[Image:dok_vystavene.png|right|990px]]
[[Image:Dok vystavene-docx-portal.png|right|850px]]

Aktuálně se zobrazují tyto typy dokumentů:

{|border="1" cellpadding="3" cellspacing="0"
|+ Dokumenty vystavené (KS portál)
|- style="background-color: #eeeeee"
|Typ dokumentu || Komentář
|-
|[[ELDP]] ||
|-
| [[Potvrzení zdanitelných příjmů]] ||
|-
| [[Výpočet daně a daňového zvýhodnění]] ||
|-
| [[Šablona dokumentu DOCX]] || [[Bezpapírové HR]]
|}

== Razítko ==
* [[Firemní razítko]] - dokument je možno opatřit razítkem.

== Zobrazení ==
'''Menu:''' Zaměstnanec > Zaměstnanec > Dokumenty vystavené

== Přístupová práva ==
'''Menu:''' Nastavení > [[Portál-Práva|Práva]] > Role-Akce

* Zaměstnanec;Dokumenty vystavené:prohlížení

==Rozšíření aplikace - Dokumenty vystavené heslo==

Rozšíření aplikace umožňuje zobrazit dokument v náhledu přímo na stránce v portále, po zapnutí tohoto rozšíření dojde k zobrazení nového sloupce s ikonkou lupy v seznamu "dokumentů vystavených" v portálové agendě Zaměstnanec-Zaměstnanec-Dokumenty Vystavené.

Dále se zobrazí nový parametr s názvem ''SifrovaneDokumenty'' ve skupině obecných.Po zapnutí tohoto parametru dojde k tomu, že se využije heslo pro výplatní lístek při stažení jakéhokoliv PDF dokumentu z agendy "Dokumenty vystavené". Takovýto dokument se následně stáhne do stanice, na které je portál spuštěn a při jeho otevření je vyžadováno zadání hesla. Zabrání se tak tedy zneužití dokumentu, případně jeho čtení prostým otevřením v prohlížeči PDF dokumentů.

== Odkazy na zdrojová data v aplikaci KS mzdy PROFi ==
* [[Dokumenty vystavené|Dokumenty vystavené]]

== Odkazy ==
* [[Sdílené úložiště]]

<div style="text-align:center">[[Příručka KS Portál|Zpět]] | [[Závazky (KS portál)|Závazky]]</div>

Podpis dokumentu (Nastavení)

2021-09-13T05:55:35Z

Jakub: /* Certifikáty */

''Podpis dokumentu (Nastavení)''

== Šablona dokumentu ==
* [[Šablona dokumentu DOCX]] - je nutné použít tento typ šablony.

* '''{sign1} ... {sign10}''' - do šablony se vkládá jedno nebo více polí, které představují "podpis".

== Nastavení workflow ==
* [[Inicializace workflow (Jednorázová funkce 133)]]
* [[Nastavení workflow]] - v kterém kroku a komu je nabízeno pole "podpis".
[[Image: Podpis dokumentu-Nastaveni workflor-Priklad.png|250px]]

== Certifikáty ==
Dále je potřeba systémově nastavit podpisový certifikát. Nastavení certifikátu je vlastně přidání uživatele IIS Serveru pro přístup k tomuto certifikátu.
* [[CertOtiskHR]]

''Postup'':
# Nainstalovat certifikát na server, kde běží IIS AppPool. Nainstalovat pro uživatele - místní počítač.
# Nastavit přístup na privátní klíč.
## Otevřít Správa certifikátů počítačů jít do podsložky Osobní -> Certifikáty.
## Pravým tlačítkem myši vybrat certifikát a zvolit Všechny úkoly -> Spravovat privátní klíče.
## Přidat uživatele IIS AppPool\KSAppPool případně jiný pool, pod kterým běží aplikace KS Portál. Název poolu je možno zjistit v IIS.

[[Image: Spravce internetove informacni sluzby.png|250px]]
[[Image: Kryptograficky otisk.png|250px]]

== Parametry ==
* [[Parametry (Bezpapírové HR)]]

== Odkazy ==
* [[Podpis dokumentu]]

DvoufaktoroveHR

2021-09-07T07:30:56Z

Jakub:

'''DvoufaktoroveHR''' je [[Parametry (KS portál)|parametr]].

Je možné nastavit dobu po které expiruje kód pomocí parametru ve ''web.config''. Název parametru je '''DvoufaktorTimeout''' a nastavuje se zde čas v celých minutách.

== Funkcionalita ==

{|border="1" cellpadding="3" cellspacing="0"
|-
! scope="row"| Název
| DvoufaktoroveHR
|-
! scope="row"| Skupina
| Bezpapírové HR
|-
! scope="row"| Popis
| Využití dvoufaktorového ověření při ručním podpisu
|-
! scope="row"| Rozsah
| '''0''' / 1 / 2
|}

=== 0 ===
Hodnota ''0'' znamená, že dvoufaktorové ověřování se nevyužívá.

=== 1 - email ===

=== 2 - SMS ===
* [[SMS Notifikace]]

== Odkazy ==
* [[Parametry (Bezpapírové HR)]]
*

SMS Notifikace

2021-09-02T06:10:59Z

Jakub: /* Konfigurace T-Mobile */

[[Soubor:TelefonSMS.png|right|200px]]
Prostřednictvím rozšíření aplikace SMS Notifikace je možné nechat si zasílat notifikace z aplikace KS Portál. Tato funkcionalita bude dále rozvíjena a implementována na více místech, kde by se dalo využít zasílání SMS notifikací. Aktuálně je možné využít zasílání bezpečnostního 6-místného kódu při přihlašování do KS Portálu. Díky tomu je možné využít dvou-faktorové ověřování při přihlášení. Zapnutí tohoto přihlašování se provádí pomocí parametru '''''DvoufaktorovyLogin''''', který má možnost nastavení na 3 různé hodnoty a to:
*0 - Vypnuto
*1 - Emailová zpráva
*2 - SMS Zpráva

SMS zpráva je zasílána na kontakt '''Mobilní telefon''' a pokud je to nutné, např. zaměstnanec má číslo z jiné země, je potřeba uvést v předvolbu ve tvaru (+420xxxxxxxxx, případně jinou, ale vždy s plus).

==Konfigurace O2==

V případě, že se rozhodnete využít služby SMS Connector od operátora O2, je nutné provést následující kroky, pro zprovoznění této služby.

# Vyplnit parametr '''''ApplicationIDSMS''''' , který obsahuje ID účtu SMS Connectoru
# Vyplnit parametr '''''CertOtiskSMS''''' , který obsahuje hash otisk certifikátu pro odesílání SMS.
# Nainstalovat certifikát na server, kde běží IIS AppPool. Nainstalovat pro uživatele - místní počítač.
# Nastavit přístup na privátní klíč.
## Otevřít ''Správa certifikátů počítačů'' jít do podsložky ''Osobní -> Certifikáty''
## Pravým tlačítkem myši vybrat certifikát O2 SMS Connectoru a zvolit ''Všechny úkoly -> Spravovat privátní klíče''
## Přidat uživatele '''''IIS AppPool\KSAppPool''''' případně jiný pool, pod kterým běží aplikace KS Portál. Název poolu je možno zjistit v IIS.

==Konfigurace T-Mobile==

V případě, že se rozhodnete využít služby SMS Connector od operátora T-Mobile, je nutné provést následující kroky, pro zprovoznění této služby.

# Vyplnit parametr '''''ApplicationIDSMS''''' , který obsahuje uživatelské jméno účtu SMS Connectoru.
# Vyplnit parametr '''''AppPasswordSMS''''' , který obsahuje heslo k účtu SMS Connectoru pro odesílání SMS.

SMS Notifikace

2021-09-02T06:04:52Z

Jakub: /* Konfigurace O2 */

SMS Notifikace

2021-09-02T06:04:04Z

Jakub: /* Konfigurace O2 */

[[Soubor:TelefonSMS.png|right|200px]]
Prostřednictvím rozšíření aplikace SMS Notifikace je možné nechat si zasílat notifikace z aplikace KS Portál. Tato funkcionalita bude dále rozvíjena a implementována na více místech, kde by se dalo využít zasílání SMS notifikací. Aktuálně je možné využít zasílání bezpečnostního 6-místného kódu při přihlašování do KS Portálu. Díky tomu je možné využít dvou-faktorové ověřování při přihlášení. Zapnutí tohoto přihlašování se provádí pomocí parametru '''''DvoufaktorovyLogin''''', který má možnost nastavení na 3 různé hodnoty a to:
*0 - Vypnuto
*1 - Emailová zpráva
*2 - SMS Zpráva

SMS zpráva je zasílána na kontakt '''Mobilní telefon''' a pokud je to nutné, např. zaměstnanec má číslo z jiné země, je potřeba uvést v předvolbu ve tvaru (+420xxxxxxxxx, případně jinou, ale vždy s plus).

==Konfigurace O2==

V případě, že se rozhodnete využít služby SMS Connector od operátora O2, je nutné provést následující kroky, pro zprovoznění této služby.

# Vyplnit parametr '''''ApplicationIDSMS''''' , který obsahuje ID účtu SMS Connectoru
# Vyplnit parametr '''''CertOtiskSMS''''' , který obsahuje hash otisk certifikátu pro odesílání SMS.
# Nainstalovat certifikát na server, kde běží IIS AppPool. Nainstalovat pro uživatele - místní počítač.
# Nastavit přístup na privátní klíč.
## Otevřít ''Správa certifikátů počítačů'' jít do podsložky ''Osobní -> Certifikáty''
## Pravým tlačítkem myši vybrat certifikát O2 SMS Connectoru a zvolit ''Všechny úkoly -> Spravovat privátní klíče''
## Přidat uživatele '''''IIS AppPool\KSAppPool''''' případně jiný pool pod kterým běží aplikace KS Portál. Název poolu je možno zjistit v IIS.

==Konfigurace T-Mobile==

SMS Notifikace

2021-09-01T12:30:37Z

Jakub:

SMS Notifikace

2021-09-01T12:27:43Z

Jakub: /* Konfigurace O2 */

SMS Notifikace

2021-09-01T12:26:47Z

Jakub:

SMS Notifikace

2021-09-01T12:26:15Z

Jakub:

SMS Notifikace

2021-09-01T12:25:19Z

Jakub:

Prostřednictvím rozšíření aplikace SMS Notifikace je možné nechat si zasílat notifikace z aplikace KS Portál. Tato funkcionalita bude dále rozvíjena a implementována na více místech, kde by se dalo využít zasílání SMS notifikací. Aktuálně je možné využít zasílání bezpečnostního 6-místného kódu při přihlašování do KS Portálu. Díky tomu je možné využít dvoufaktorové ověřování při přihlášení. SMS zpráva je zasílána na kontakt '''Mobilní telefon''' a pokud je to nutné, např. zaměstnanec má číslo z jiné země, je potřeba uvést v předvolbu ve tvaru (+420xxxxxxxxx, případně jinou, ale vždy s plus).

[[Soubor:TelefonSMS.png|thumb|right|200px]]]

SMS Notifikace

2021-09-01T12:24:17Z

Jakub: Založena nová stránka: Prostřednictvím rozšíření aplikace SMS Notifikace je možné nechat si zasílat notifikace z aplikace KS Portál. Tato funkcionalita bude dále rozvíjena a implement…

Soubor:TelefonSMS.png

2021-09-01T12:23:52Z

Jakub:

Dočasné heslo

2021-08-03T07:58:52Z

Jakub:

V případě prvního přihlášení do aplikace KS Portál pomocí formulářového přihlašování a nastaveném parametru '''TypOvereni''' na hodnotu "ks" nebo nevyplněném, je vyžadována změna dočasného hesla ze strany uživatele.

Pro tento případ je nutné mít vytvořenu roli s názvem '''PortalDocasneHeslo''', která má přístup do záložky '''Nastavení - Změna hesla'''.

Tato role se aplikuje automaticky všem uživatelům z dočasným heslem a umožňuje pouze nastavení hesla.

Dočasné heslo

2021-08-03T07:58:38Z

Jakub: Založena nová stránka: V případě prvního přihlášení do aplikace KS Portál pomocí formulářového přihlašování a nastaveném parametru '''TypOvereni''' na hodnotu "ks" nebo nevypln…

V případě prvního přihlášení do aplikace KS Portál pomocí formulářového přihlašování a nastaveném parametru '''TypOvereni''' na hodnotu "ks" nebo nevyplněném, je vyžadována změna dočasného hesla ze strany uživatele.

Pro tento případ je nutné mít vytvořenu roli s názvem '''PortalDocasneHeslo''', která má přístup do záložky Nastavení - Změna hesla.

Tato role se aplikuje automaticky všem uživatelům z dočasným heslem a umožňuje pouze nastavení hesla.

Portál-ObecnéInformace

2021-08-03T07:52:58Z

Jakub:

{| id="mp-upper" style="width: 30%; margin:4px 0 0 0; background:none; border-spacing: 0;"
| class="MainPageBG" style="width:40%; border:1px solid #cedff2; background:#f5faff; vertical-align:top; color:#000;" |
{| id="mp-left" style="width:100%; vertical-align:top; background:#f5faff;"
! style="padding:2px;" | Obecné informace
|-
| style="color:#000;" | <div id="mp-tfa" style="padding:2px 15px">

[[Uživatelé (KS portál)]] 
[[Login do KSPortálu]] 
[[Ovládání aplikace]] 
[[O uživateli]] 
[[Změna hesla]] 
[[Zapomenuté heslo]] 
[[Dočasné heslo]] 
[[Přístup i po ukončení pracovního poměru (KS portál)]] 
[[Video na přihlašovací stránce]] 
[[Výchozí stránka (KS portál)|Výchozí stránka]] 
[[Obrázky v aplikaci]] 
[[Firemní logo]] 
[[Uživatelské rozhraní v cizím jazyce (portál)]] 
[[Portál-Nastavení maxima využité paměti|Nastavení maxima využité paměti]] 
[[Výstupy emailem versus v aplikaci]] 
[[Browser info]] 
[[Řešení některých problémů (KS portál)]] 
[[Rozšíření a úpravy web.config]] 
[[Chybové hlášení (portál)|Chybové hlášení]]
-----------
[[Zákaznické speciality (KS portál)|Zákaznické speciality]]

<div style="text-align:center">[[Příručka KS Portál|Zpět]]</div>
</div>
|}
|}

Externí přihlašování

2021-07-28T06:03:33Z

Jakub: /* Princip činnosti */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. V případě, že je k dispozici více databází, je zobrazena stránka s možností výběru databáze, následným stiskem tlačítka Zvolit, dojde k přihlášení uživatele. Předaný údaj z autentizační služby je následně spárován s uživatelským jménem přiřazeným danému uživateli KS Portálu nebo osobní číslem, dle nastavení. Uživatel se následně ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

Je také možno použít certifikát pro ověřování a nevyužívat tak ClientSecret. Úpravy, které se odlišují jsou označeny stejným číslem, ale s hvězdičkou.

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''2*.) Upravení web.config s certifikátem'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="TenantId" value=""/>

<add key="OauthCertThumbprint" value=""/>

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''4.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''5.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

'''6*.) Instalace certifikátu na stanici'''

Je nutné nainstalovat certifikát na stanici, kde běží IIS server, dále pak je nutné ve správci certifikátů počítačů, nastavit pro tento certifikát práva pro čtení na privátní klíč pro uživatele "IIS AppPool\{název_poolu_KSPortálu}", např. "IIS AppPool\KsAppPool"

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Externí přihlašování

2021-07-28T06:00:11Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. Toto jméno je následně spárováno s uživatelským jménem přiřazeným danému uživateli KS Portálu. Uživatel se tedy ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

Je také možno použít certifikát pro ověřování a nevyužívat tak ClientSecret. Úpravy, které se odlišují jsou označeny stejným číslem, ale s hvězdičkou.

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''2*.) Upravení web.config s certifikátem'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="TenantId" value=""/>

<add key="OauthCertThumbprint" value=""/>

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''4.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''5.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

'''6*.) Instalace certifikátu na stanici'''

Je nutné nainstalovat certifikát na stanici, kde běží IIS server, dále pak je nutné ve správci certifikátů počítačů, nastavit pro tento certifikát práva pro čtení na privátní klíč pro uživatele "IIS AppPool\{název_poolu_KSPortálu}", např. "IIS AppPool\KsAppPool"

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Externí přihlašování

2021-07-28T05:59:37Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. Toto jméno je následně spárováno s uživatelským jménem přiřazeným danému uživateli KS Portálu. Uživatel se tedy ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

Je také možno použít certifikát pro ověřování a nevyužívat tak ClientSecret. Úpravy, které se odlišují jsou označeny stejným číslem, ale s hvězdičkou.

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''2*.) Upravení web.config s certifikátem'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="TenantId" value=""/>

<add key="OauthCertThumbprint" value=""/>

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''4.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''5.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

'''6*.) Instalace certifikátu na pc'''

Je nutné nainstalovat certifikát na stanici, kde běží IIS server, dále pak je nutné ve správci certifikátů počítačů, nastavit pro tento certifikát práva pro čtení na privátní klíč pro uživatele "IIS AppPool\{název_poolu_KSPortálu}", např. "IIS AppPool\KsAppPool"

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Externí přihlašování

2021-07-27T08:40:08Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. Toto jméno je následně spárováno s uživatelským jménem přiřazeným danému uživateli KS Portálu. Uživatel se tedy ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

Je také možno použít certifikát pro ověřování a nevyužívat tak ClientSecret. Úpravy, které se odlišují jsou označeny stejným číslem, ale s hvězdičkou.

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''2*.) Upravení web.config s certifikátem'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="TenantId" value=""/>

<add key="OauthCertThumbprint" value=""/>

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

'''7*.) Instalace certifikátu na pc'''

Je nutné nainstalovat certifikát na stanici, kde běží IIS server, dále pak je nutné ve správci certifikátů počítačů, nastavit pro tento certifikát práva pro čtení na privátní klíč pro uživatele "IIS AppPool\{název_poolu_KSPortálu}", např. "IIS AppPool\KsAppPool"

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Externí přihlašování

2021-07-27T08:39:35Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. Toto jméno je následně spárováno s uživatelským jménem přiřazeným danému uživateli KS Portálu. Uživatel se tedy ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

Je také možno použít certifikát pro ověřování a nevyužívat tak ClientSecret. Úpravy, které se odlišují jsou označeny stejným číslem, ale s hvězdičkou.

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''2*.) Upravení web.config s certifikátem'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="TenantId" value=""/>

<add key="OauthCertThumbprint" value=""/>

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

'''7*.) Instalace certifikátu na pc'''
Je nutné nainstalovat certifikát na stanici, kde běží IIS server, dále pak je nutné ve správci certifikátů počítačů, nastavit pro tento certifikát práva pro čtení na privátní klíč pro uživatele "IIS AppPool\{název_poolu_KSPortálu}", např. "IIS AppPool\KsAppPool"

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Externí přihlašování

2021-07-27T08:39:17Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. Toto jméno je následně spárováno s uživatelským jménem přiřazeným danému uživateli KS Portálu. Uživatel se tedy ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

Je také možno použít certifikát pro ověřování a nevyužívat tak ClientSecret. Úpravy, které se odlišují jsou označeny stejným číslem, ale s hvězdičkou.

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''2*.) Upravení web.config s certifikátem'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="TenantId" value=""/>

<add key="OauthCertThumbprint" value=""/>

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

'''7.) Instalace certifikátu na pc'''
Je nutné nainstalovat certifikát na stanici, kde běží IIS server, dále pak je nutné ve správci certifikátů počítačů, nastavit pro tento certifikát práva pro čtení na privátní klíč pro uživatele "IIS AppPool\{název_poolu_KSPortálu}", např. "IIS AppPool\KsAppPool"

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Externí přihlašování

2021-07-27T08:35:34Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. Toto jméno je následně spárováno s uživatelským jménem přiřazeným danému uživateli KS Portálu. Uživatel se tedy ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

Je také možno použít certifikát pro ověřování a nevyužívat tak ClientSecret. Úpravy, které se odlišují jsou označeny stejným číslem, ale s hvězdičkou.

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''2*.) Upravení web.config s certifikátem'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="TenantId" value=""/>

<add key="OauthCertThumbprint" value=""/>

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Instalační příručka

2021-06-16T06:43:23Z

Jakub: /* Systém jednotného přihlášení (SSO) */

{{KS portál}}
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.

= Podporované prohlížeče =
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:
* '''''Mozilla Firefox'''''
* '''''Google Chrome'''''
* '''''Microsoft Edge'''''

Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení).
=== Historie ===
: [[Podporované prohlížeče (KS portál) (historie)]] 

= Co je potřeba ke zprovoznění KS Portálu =
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS Portál potřebuje cca 100 MB místa na webovém serveru.

* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení).


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) 
%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i

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

= Jak postupovat při instalaci =

===Aplikace nesmí být instalována jako Web Site===

===Pro Windows Server 2008 R2, 2012 (IIS 7) a vyšší===

# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\).
# 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/
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu zápisu do podadresářů Logs a Temp
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).
# 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.
# 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í).

= Nastavení DB připojení =
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).

<nowiki>Databázové připojení v KS Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci <connectionStrings> v souboru web.config v hlavním adresáři aplikace.</nowiki>

== Příklady ConnectionStringu ==

=== Pro MSSQL ===
<nowiki><add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test"</nowiki>

providerName="System.Data.SqlClient"/>

=== Pro Oracle ===
<nowiki><add name="web_mzdy" connectionString="Data Source=KSPROGRA;User Id=test;Password=test"</nowiki>

providerName="System.Data.OracleClient"/>

=== Pro ODBC ===
<nowiki><add name="web_mzdy" connectionString="DSN=i_mzdy" providerName="System.Data.Odbc"/></nowiki>

=== Položky DB připojení ===

{|
|name
| - jméno DB připojení
|-
|server
| - název nebo IP adresa počítače, na kterém běží DB server
|-
|database
| - název databáze, ke které bude chtít být připojeni
|-
|uid
| - login pro přístup do databáze
|-
|pwd
| - heslo pro přístup do databáze
|}

== Doplňující informace ==
=== Oracle ===
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&Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''

Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.

=== PostgreSQL ===
* [[PostgreSQL]]

== Ze zkušeností ==
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):

''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 "ticket" to the Active Directory. And, if it cannot retrieve a valid "ticket" then we have the error ORA-12638.''

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

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: SQLNET.AUTHENTICATION_SERVICES= (NTS) za SQLNET.AUTHENTICATION_SERVICES= (NONE).

Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS Portál).

= Přihlašování uživatelů KS Portálu =
KS portál nabízí dva typy přihlašování uživatelů: webový formulář a systém jednotného přihlášení.

== Webový formulář ==
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.

V souboru Web.config je potřeba nastavit:

<nowiki><authentication mode="Forms"></nowiki>

=== Způsob přístupu uživatelů do databáze ===
# Přístup do databáze pro všechny uživatele pod jedním DB účtem (výchozí). Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.
# Přístup do databáze pod vlastním jménem uživatele, v connectionstringu jsou zadány místo jména uživatele a hesla masky, které jsou při vytváření připojení vyměněny za skutečné přihlašovací údaje. Příklad:<nowiki><add name="web_mzdy" connectionString="server=absint_pc;database=web_mzdy;uid=%user %;pwd=%password%" providerName="System.Data.SqlClient"/></nowiki>

== Systém jednotného přihlášení (SSO) ==
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.

V souboru web.config je potřeba nastavit:

<nowiki><authentication mode="Windows"></nowiki>

Do databáze přistupují všichni uživatelé pod jedním DB účtem. Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.

Po přidání parametru <add key="SkipLoginPage" value="true"/> se přeskočí přihlašovací stránka.


===Externí přihlašování===

Je možno využít přihlašování pomocí protokolu 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í]]'''

= Způsob ověření uživatelů =
Způsob ověření uživatelů určuje hodnota parametru
<add key="TypOvereni" value=""/>
v souboru web.config v sekci <appSettings> (viz. následující tabulka).

<center>'''Způsob ověření uživatelů'''</center>

{|<table align="center" border="2" width="100%" cellspacing="4" cellpadding="3" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;">
<tr>
<td bgcolor="#A7C1F2">'''Hodnota'''</td>
<td bgcolor="#A7C1F2">'''Význam'''</td>
<tr>
|-
| Nevyplněno (výchozí)
| Přihlašovací údaje uživatele se ověřují proti agendě Uživatelé KSPortálu v těžkém klientovi(aplikaci KS Mzdy).
|-
| ad
| Přihlašovací údaje se ověřují v Active Directory.
|-
| ez
| Login uživatel 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.
|}
''Tabulka 1: Způsob ověření uživatelů''

Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance.
Osobní číslo se získává se 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
<add key="ZdrojOsCisla" value=""/> . Parametr může nabývat stejných hodnot jako parametr TypOvereni (viz. Tabulka 1).

= Přístupová práva uživatelů =

Řízení přístupu k údajům a operacím

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:
* KSRoleProvider – načítá aplikační role z databáze aplikace
* ADRoleProvide – načítá aplikační role z Active Directory

Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.

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.

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. 
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem 
<add key="VychoziRole" value=""/>, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.

= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =

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).
# 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á.
# 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.
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.

= Registrace nových uživatelů v KS Portálu =
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í).

Aby uživatel získal přístup do KS 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.

=== Uživatelé se mohou registrovat sami ===
<nowiki>Je také možné povolit neregistrovaným uživatelům KS Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci <appSettings> následující řádky:</nowiki>

<nowiki><add key="Registrace" value="user"/></nowiki>

<nowiki><add key="VychoziRole" value=""/></nowiki>

První řádek povoluje uživatelům KS 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í.

* [[Registrace nového uživatele]]

= Další možnosti nastavení =
Základní nastavení aplikace KS Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).

== Sekce <appSettings> ==
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru <nowiki><add key="název" value="hodnota"/></nowiki>.

{|class="wikitable " border="1" cellpadding="3" cellspacing="0"
|+ Seznam parametrů sekce <appSettings> 
|- style="background-color: #A7C1F2"
| <center>'''Skupina'''</center> 
| <center>'''Název'''</center> 
| <center>'''Popis'''</center> 
| <center>'''Možné hodnoty (nebo příklad hodnoty)'''</center> 
|-
| rowspan = 21|Přihlášení || ''' LastPasswordsCheck '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo
|-
| ''' LockAfterWrongPasswords '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo
|-
| ''' MinPasswordLength '''|| Minimální požadovaná délka hesla uživatele. || číslo
|-
| ''' CheckPasswordComplexity '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false
|-
| ''' PasswordExpiration '''|| Počet dnů do expirace hesla uživatele. || číslo
|-
| ''' WarningBeforePasswordExpiration '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo
|-
| ''' 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)
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty 
2 - obnova hesla je povolena, zamknuté účty budou odemknuty
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' Admins '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin
|-
| ''' 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
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu
|-
| ''' VychoziRole '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal
|-
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||
|-
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||
|-
| ''' 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
|-
| ''' RegistraceRodneCislo '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true
|-
| ''' PocetMesicuRolePoVystupu '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo
|-
| ''' RolePoVystupu '''|| Role po ukončení pracovního poměru. || poVystupu
|-
| ''' 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ů
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku
|-
| rowspan = 2|Prostředí || ''' OptimalizaceMenu '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu
True / ano – zobrazí se jen přístupné položky menu
|-
| ''' ShowEmployeePhoto '''|| Zobrazování fotek zaměstnanců. || true / false
|-
| rowspan = 5|Logování || ''' ShowExceptionDetail '''|| Zda se má zobrazit detailní výpis chyb. || true / false
|-
| ''' EmailChybyZobrazovat '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true
|-
| ''' AppAudit '''|| Zapnutí logování činností uživatelů na KS portále. || true
|-
| ''' 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ě ""xml"" se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí 
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml
|-
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu. || '''a''' / n
|-
| rowspan = 4|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
|-
| ''' Cache '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage
|-
| ''' FormatDatumu '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd
datetime – datum je typu DateTime
|-
| ''' 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
|-
| 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
|-
| ''' ad_user '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||
|-
| ''' ad_password '''|| Heslo uživatelského účtu zadaného v ad_user. ||
|-
| ''' 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
|-
| ''' 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
|-
| ''' ad_user_filter '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203
|-
| ''' 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 "samAccountName". ||
|-
| ''' ad_atr_os_cislo_user '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId
|-
| ''' ad_atr_os_cislo_zastupce '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||
|-
| ''' 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. ||
|-
| rowspan = 5|Web proxy ||''' proxyUrl '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1
|-
| ''' proxyPort '''|| Port proxy serveru. || 8888
|-
| ''' proxyUsername '''|| Login pro přístup k proxy. ||
|-
| ''' proxyPassword '''|| Heslo pro přístup k proxy. ||
|-
| ''' 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. též hd 51506|| Do hodnoty se zadává celá adresa url KS portálu.
|}

== Zašifrování vybraných sekcí web.config ==
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 C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe "appSettings" -app "/ksprtl"

Dešifrování stejné sekce se pak provede příkazem C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd "appSettings" -app "/ksprtl"

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 "NETWORKSERVICE"

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa "NetFrameworkConfigurationKey" "NETWORKSERVICE"

== Active directory ==
=== Typ ověřování ===
V souboru web.config je možno nově nastavit typ ověřování pro Active Directory přes parametr ad_auth_type.
Možné hodnoty jsou basic a secure, výchozí hodnota je secure, tj. způsob, který se používal i před úpravou.
(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)

=== Načítání rolí vzhledem ke skupinám ===
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ě "Vedoucí" a skupina "Vedoucí" je členem ve skupině "Zaměstnanci", pro Nováka se nově načtou role "Vedoucí" i "Zaměstnanci" (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 "KS_").

== Odkazy ==
* [[Příručka KS Portál]]
* [[Přístup i po ukončení pracovního poměru (KS portál)]]

Instalační příručka

2021-06-16T06:43:09Z

Jakub: /* Systém jednotného přihlášení (SSO) */

{{KS portál}}
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.

= Podporované prohlížeče =
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:
* '''''Mozilla Firefox'''''
* '''''Google Chrome'''''
* '''''Microsoft Edge'''''

Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení).
=== Historie ===
: [[Podporované prohlížeče (KS portál) (historie)]] 

= Co je potřeba ke zprovoznění KS Portálu =
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS Portál potřebuje cca 100 MB místa na webovém serveru.

* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení).


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) 
%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i

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

= Jak postupovat při instalaci =

===Aplikace nesmí být instalována jako Web Site===

===Pro Windows Server 2008 R2, 2012 (IIS 7) a vyšší===

# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\).
# 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/
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu zápisu do podadresářů Logs a Temp
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).
# 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.
# 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í).

= Nastavení DB připojení =
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).

<nowiki>Databázové připojení v KS Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci <connectionStrings> v souboru web.config v hlavním adresáři aplikace.</nowiki>

== Příklady ConnectionStringu ==

=== Pro MSSQL ===
<nowiki><add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test"</nowiki>

providerName="System.Data.SqlClient"/>

=== Pro Oracle ===
<nowiki><add name="web_mzdy" connectionString="Data Source=KSPROGRA;User Id=test;Password=test"</nowiki>

providerName="System.Data.OracleClient"/>

=== Pro ODBC ===
<nowiki><add name="web_mzdy" connectionString="DSN=i_mzdy" providerName="System.Data.Odbc"/></nowiki>

=== Položky DB připojení ===

{|
|name
| - jméno DB připojení
|-
|server
| - název nebo IP adresa počítače, na kterém běží DB server
|-
|database
| - název databáze, ke které bude chtít být připojeni
|-
|uid
| - login pro přístup do databáze
|-
|pwd
| - heslo pro přístup do databáze
|}

== Doplňující informace ==
=== Oracle ===
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&Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''

Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.

=== PostgreSQL ===
* [[PostgreSQL]]

== Ze zkušeností ==
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):

''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 "ticket" to the Active Directory. And, if it cannot retrieve a valid "ticket" then we have the error ORA-12638.''

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

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: SQLNET.AUTHENTICATION_SERVICES= (NTS) za SQLNET.AUTHENTICATION_SERVICES= (NONE).

Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS Portál).

= Přihlašování uživatelů KS Portálu =
KS portál nabízí dva typy přihlašování uživatelů: webový formulář a systém jednotného přihlášení.

== Webový formulář ==
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.

V souboru Web.config je potřeba nastavit:

<nowiki><authentication mode="Forms"></nowiki>

=== Způsob přístupu uživatelů do databáze ===
# Přístup do databáze pro všechny uživatele pod jedním DB účtem (výchozí). Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.
# Přístup do databáze pod vlastním jménem uživatele, v connectionstringu jsou zadány místo jména uživatele a hesla masky, které jsou při vytváření připojení vyměněny za skutečné přihlašovací údaje. Příklad:<nowiki><add name="web_mzdy" connectionString="server=absint_pc;database=web_mzdy;uid=%user %;pwd=%password%" providerName="System.Data.SqlClient"/></nowiki>

== Systém jednotného přihlášení (SSO) ==
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.

V souboru web.config je potřeba nastavit:

<nowiki><authentication mode="Windows"></nowiki>

Do databáze přistupují všichni uživatelé pod jedním DB účtem. Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.

Po přidání parametru <add key="SkipLoginPage" value="true"/> se přeskočí přihlašovací stránka.



===Externí přihlašování===

Je možno využít přihlašování pomocí protokolu 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í]]'''

= Způsob ověření uživatelů =
Způsob ověření uživatelů určuje hodnota parametru
<add key="TypOvereni" value=""/>
v souboru web.config v sekci <appSettings> (viz. následující tabulka).

<center>'''Způsob ověření uživatelů'''</center>

{|<table align="center" border="2" width="100%" cellspacing="4" cellpadding="3" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;">
<tr>
<td bgcolor="#A7C1F2">'''Hodnota'''</td>
<td bgcolor="#A7C1F2">'''Význam'''</td>
<tr>
|-
| Nevyplněno (výchozí)
| Přihlašovací údaje uživatele se ověřují proti agendě Uživatelé KSPortálu v těžkém klientovi(aplikaci KS Mzdy).
|-
| ad
| Přihlašovací údaje se ověřují v Active Directory.
|-
| ez
| Login uživatel 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.
|}
''Tabulka 1: Způsob ověření uživatelů''

Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance.
Osobní číslo se získává se 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
<add key="ZdrojOsCisla" value=""/> . Parametr může nabývat stejných hodnot jako parametr TypOvereni (viz. Tabulka 1).

= Přístupová práva uživatelů =

Řízení přístupu k údajům a operacím

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:
* KSRoleProvider – načítá aplikační role z databáze aplikace
* ADRoleProvide – načítá aplikační role z Active Directory

Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.

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.

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. 
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem 
<add key="VychoziRole" value=""/>, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.

= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =

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).
# 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á.
# 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.
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.

= Registrace nových uživatelů v KS Portálu =
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í).

Aby uživatel získal přístup do KS 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.

=== Uživatelé se mohou registrovat sami ===
<nowiki>Je také možné povolit neregistrovaným uživatelům KS Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci <appSettings> následující řádky:</nowiki>

<nowiki><add key="Registrace" value="user"/></nowiki>

<nowiki><add key="VychoziRole" value=""/></nowiki>

První řádek povoluje uživatelům KS 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í.

* [[Registrace nového uživatele]]

= Další možnosti nastavení =
Základní nastavení aplikace KS Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).

== Sekce <appSettings> ==
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru <nowiki><add key="název" value="hodnota"/></nowiki>.

{|class="wikitable " border="1" cellpadding="3" cellspacing="0"
|+ Seznam parametrů sekce <appSettings> 
|- style="background-color: #A7C1F2"
| <center>'''Skupina'''</center> 
| <center>'''Název'''</center> 
| <center>'''Popis'''</center> 
| <center>'''Možné hodnoty (nebo příklad hodnoty)'''</center> 
|-
| rowspan = 21|Přihlášení || ''' LastPasswordsCheck '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo
|-
| ''' LockAfterWrongPasswords '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo
|-
| ''' MinPasswordLength '''|| Minimální požadovaná délka hesla uživatele. || číslo
|-
| ''' CheckPasswordComplexity '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false
|-
| ''' PasswordExpiration '''|| Počet dnů do expirace hesla uživatele. || číslo
|-
| ''' WarningBeforePasswordExpiration '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo
|-
| ''' 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)
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty 
2 - obnova hesla je povolena, zamknuté účty budou odemknuty
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' Admins '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin
|-
| ''' 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
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu
|-
| ''' VychoziRole '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal
|-
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||
|-
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||
|-
| ''' 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
|-
| ''' RegistraceRodneCislo '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true
|-
| ''' PocetMesicuRolePoVystupu '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo
|-
| ''' RolePoVystupu '''|| Role po ukončení pracovního poměru. || poVystupu
|-
| ''' 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ů
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku
|-
| rowspan = 2|Prostředí || ''' OptimalizaceMenu '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu
True / ano – zobrazí se jen přístupné položky menu
|-
| ''' ShowEmployeePhoto '''|| Zobrazování fotek zaměstnanců. || true / false
|-
| rowspan = 5|Logování || ''' ShowExceptionDetail '''|| Zda se má zobrazit detailní výpis chyb. || true / false
|-
| ''' EmailChybyZobrazovat '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true
|-
| ''' AppAudit '''|| Zapnutí logování činností uživatelů na KS portále. || true
|-
| ''' 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ě ""xml"" se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí 
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml
|-
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu. || '''a''' / n
|-
| rowspan = 4|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
|-
| ''' Cache '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage
|-
| ''' FormatDatumu '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd
datetime – datum je typu DateTime
|-
| ''' 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
|-
| 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
|-
| ''' ad_user '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||
|-
| ''' ad_password '''|| Heslo uživatelského účtu zadaného v ad_user. ||
|-
| ''' 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
|-
| ''' 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
|-
| ''' ad_user_filter '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203
|-
| ''' 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 "samAccountName". ||
|-
| ''' ad_atr_os_cislo_user '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId
|-
| ''' ad_atr_os_cislo_zastupce '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||
|-
| ''' 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. ||
|-
| rowspan = 5|Web proxy ||''' proxyUrl '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1
|-
| ''' proxyPort '''|| Port proxy serveru. || 8888
|-
| ''' proxyUsername '''|| Login pro přístup k proxy. ||
|-
| ''' proxyPassword '''|| Heslo pro přístup k proxy. ||
|-
| ''' 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. též hd 51506|| Do hodnoty se zadává celá adresa url KS portálu.
|}

== Zašifrování vybraných sekcí web.config ==
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 C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe "appSettings" -app "/ksprtl"

Dešifrování stejné sekce se pak provede příkazem C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd "appSettings" -app "/ksprtl"

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 "NETWORKSERVICE"

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa "NetFrameworkConfigurationKey" "NETWORKSERVICE"

== Active directory ==
=== Typ ověřování ===
V souboru web.config je možno nově nastavit typ ověřování pro Active Directory přes parametr ad_auth_type.
Možné hodnoty jsou basic a secure, výchozí hodnota je secure, tj. způsob, který se používal i před úpravou.
(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)

=== Načítání rolí vzhledem ke skupinám ===
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ě "Vedoucí" a skupina "Vedoucí" je členem ve skupině "Zaměstnanci", pro Nováka se nově načtou role "Vedoucí" i "Zaměstnanci" (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 "KS_").

== Odkazy ==
* [[Příručka KS Portál]]
* [[Přístup i po ukončení pracovního poměru (KS portál)]]

Externí přihlašování

2021-06-15T12:23:10Z

Jakub: /* Konfigurace SAML 2.0 přihlašování */

Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založeno na standartu OAuth 2.0 nebo SAML 2.0. Díky využití přihlašování prostřednictvím OAuth 2.0 nebo SAML 2.0 není nutné mít zřízeno heslo pro přístup do portálu. Je možno se přihlásit prostřednictvím účtu Google, Microsoft, případně vlastního přihlašování, které dokáže komunikovat s aplikací KS Portál prostřednictvím tohoto standartu. Případně za využití OpenID protokolu. V těchto službách tak může být nastaveno více-faktorové ověření na základě něhož dojde k předání příslušného uživatelského jména, které je následně spárováno na základě parametru ''ZdrojOsCisla''.

Pro využití je nutno zaregistrovat si aplikaci KS-Portál jako důvěryhodnou a využít tak principů tohoto standardu. Je tak možno dosáhnout vyšší bezpečnosti při autentizaci a autorizaci uživatelů při přihlašování do portálu. Na straně portálu je pak vyžadováno nastavení konektivity s autentizační službou a nastavení uživatelských jmen uživatelům KS Portálu, které budou následně korektně asociována s údaji, které vrátí autentizační služba. Díky využití tohoto rozšíření, nejsou uživatele nuceni zadávat své přihlašovací údaje do portálu a bezpečnostní politika hesel tak zůstává svěřena třetí straně. Komunikace mezi KS Portálem a autentizační službou musí probíhat prostřednictvím zabezpečeného přenosu s využitím šifrování pomocí TLS za využití protokolu HTTPS.

==Princip činnosti==

Uživatel přistoupí na stránku určenou pro přihlašování do portálu, například : „https://ksprogram.cz/demo/ksportal/Public/ExternalLogin.aspx“ . Uživatel je poté přesměrován na stránku autentizační služby například stránka Googlu, Microsoft, apod. Při tomto přesměrování dojde k odeslání informací, potřebných pro žádost autentizačního serveru. Uživatel následně zadá své přihlašovací údaje do tohoto účtu. Provede veškeré úkony spojené s přihlašováním a je přesměrován zpět na portál. Tato odpověď již obsahuje informace, které slouží KS Portálu pro vytvoření dohody s autentizačním severem, který následně portálu předá přihlašovací jméno. Toto jméno je následně spárováno s uživatelským jménem přiřazeným danému uživateli KS Portálu. Uživatel se tedy ocitne na stránce po přihlášení, například „https://ksprogram.cz/demo/ksportal/Default.aspx“.

=Konfigurace OAuth 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>


<add key="ExternalLogin" value="OAUTH2"/>

<add key="ClientId" value="" />

<add key="ClientSecret" value="" />

<add key="scope" value="https://graph.microsoft.com/.default" />

<add key="State" value="1"/>

<add key="AuthenticationEndpoint" value="" />

<add key="RedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="TokenEndpoint" value="" />

<add key="UserinfoEndpoint" value="https://graph.microsoft.com/v1.0/me" />

<add key="OauthUsername" value="userPrincipalName" />

<add key="LogoutEndpoint" value="" />

<add key="LogoutRedirectUri" value="https://localhost:44301/ksportal/Public/ExternalLogin.aspx" />

<add key="Nonce" value="1"/>

<add key="ResponseType" value="code"/>

<add key="ResponseMode" value="form_post"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

=Konfigurace SAML 2.0 přihlašování =

'''1.) Zapnutí rozšíření''' '''Externí přihlašování''' prostřednictvím C/S aplikace KS Mzdy PROFi v agendě ''Nápověda - Rozšíření aplikace''

'''2.) Upravení web.config'''

<pre>

<add key="ExternalLogin" value="SAML2"/>

<add key="SAML2LoginUrl" value=""/>

<add key="SAML2RedirectURI" value=""/>

<add key="SAML2EntityID" value=""/>

<add key="SAML2Cert" value=" -----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
"/>
</pre>

'''3.) Nastavit výchozí databázi''', ke které se portál připojí, na první místo + parametr umístěný pod connection stringem, parametr je nyní zakomentován

<pre>
<dataConfiguration defaultDatabase="{nazev_db}"/>
</pre>

'''4.) Kontrola nastavení párování loginů'''
<pre>

<add key="SparovaniUziv" value="CI-BezDomeny"/>
</pre>

'''5.) Nastavení výchozí stránky pro přihlášení'''

<pre>
<forms name="Ksprtl" loginUrl="~/Public/ExternalLogin.aspx" defaultUrl="~/Default2.aspx" />
</pre>

'''6.) Důležitý je parametr ZdrojOsCisla'''

pokud není vyplněn, berou se osobní čísla z aplikace a tedy je nutné mít naplněnu agendu Uživatelé KS Portálu, kde musí být navedeny Loginy k daným osobním číslům, lze použít například i AD

Externí přihlašování

2021-06-15T12:19:43Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Externí přihlašování

2021-06-15T12:19:17Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Externí přihlašování

2021-06-15T12:18:26Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Externí přihlašování

2021-06-15T12:17:44Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Externí přihlašování

2021-06-15T12:14:53Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Externí přihlašování

2021-06-15T12:13:34Z

Jakub: /* Konfigurace OAuth 2.0 přihlašování */

Externí přihlašování

2021-06-15T11:58:46Z

Jakub:

Externí přihlašování

2021-06-15T11:58:26Z

Jakub: Založena nová stránka: Rozšíření aplikace '''Externí přihlašování''' umožňuje využít přihlašování do aplikace prostřednictvím služby třetí strany. Přihlašování je založ…

Instalační příručka

2021-06-15T11:51:51Z

Jakub: /* Systém jednotného přihlášení (SSO) */

{{KS portál}}
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.

= Podporované prohlížeče =
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:
* '''''Mozilla Firefox'''''
* '''''Google Chrome'''''
* '''''Microsoft Edge'''''

Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení).
=== Historie ===
: [[Podporované prohlížeče (KS portál) (historie)]] 

= Co je potřeba ke zprovoznění KS Portálu =
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS Portál potřebuje cca 100 MB místa na webovém serveru.

* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení).


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) 
%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i

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

= Jak postupovat při instalaci =

===Aplikace nesmí být instalována jako Web Site===

===Pro Windows Server 2008 R2, 2012 (IIS 7) a vyšší===

# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\).
# 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/
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu zápisu do podadresářů Logs a Temp
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).
# 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.
# 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í).

= Nastavení DB připojení =
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).

<nowiki>Databázové připojení v KS Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci <connectionStrings> v souboru web.config v hlavním adresáři aplikace.</nowiki>

== Příklady ConnectionStringu ==

=== Pro MSSQL ===
<nowiki><add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test"</nowiki>

providerName="System.Data.SqlClient"/>

=== Pro Oracle ===
<nowiki><add name="web_mzdy" connectionString="Data Source=KSPROGRA;User Id=test;Password=test"</nowiki>

providerName="System.Data.OracleClient"/>

=== Pro ODBC ===
<nowiki><add name="web_mzdy" connectionString="DSN=i_mzdy" providerName="System.Data.Odbc"/></nowiki>

=== Položky DB připojení ===

{|
|name
| - jméno DB připojení
|-
|server
| - název nebo IP adresa počítače, na kterém běží DB server
|-
|database
| - název databáze, ke které bude chtít být připojeni
|-
|uid
| - login pro přístup do databáze
|-
|pwd
| - heslo pro přístup do databáze
|}

== Doplňující informace ==
=== Oracle ===
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&Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''

Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.

=== PostgreSQL ===
* [[PostgreSQL]]

== Ze zkušeností ==
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):

''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 "ticket" to the Active Directory. And, if it cannot retrieve a valid "ticket" then we have the error ORA-12638.''

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

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: SQLNET.AUTHENTICATION_SERVICES= (NTS) za SQLNET.AUTHENTICATION_SERVICES= (NONE).

Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS Portál).

= Přihlašování uživatelů KS Portálu =
KS portál nabízí dva typy přihlašování uživatelů: webový formulář a systém jednotného přihlášení.

== Webový formulář ==
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.

V souboru Web.config je potřeba nastavit:

<nowiki><authentication mode="Forms"></nowiki>

=== Způsob přístupu uživatelů do databáze ===
# Přístup do databáze pro všechny uživatele pod jedním DB účtem (výchozí). Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.
# Přístup do databáze pod vlastním jménem uživatele, v connectionstringu jsou zadány místo jména uživatele a hesla masky, které jsou při vytváření připojení vyměněny za skutečné přihlašovací údaje. Příklad:<nowiki><add name="web_mzdy" connectionString="server=absint_pc;database=web_mzdy;uid=%user %;pwd=%password%" providerName="System.Data.SqlClient"/></nowiki>

== Systém jednotného přihlášení (SSO) ==
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.

V souboru web.config je potřeba nastavit:

<nowiki><authentication mode="Windows"></nowiki>

Do databáze přistupují všichni uživatelé pod jedním DB účtem. Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.

Po přidání parametru <add key="SkipLoginPage" value="true"/> se přeskočí přihlašovací stránka.



Je možno využít přihlašování pomocí protokolu 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í]]'''

= Způsob ověření uživatelů =
Způsob ověření uživatelů určuje hodnota parametru
<add key="TypOvereni" value=""/>
v souboru web.config v sekci <appSettings> (viz. následující tabulka).

<center>'''Způsob ověření uživatelů'''</center>

{|<table align="center" border="2" width="100%" cellspacing="4" cellpadding="3" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;">
<tr>
<td bgcolor="#A7C1F2">'''Hodnota'''</td>
<td bgcolor="#A7C1F2">'''Význam'''</td>
<tr>
|-
| Nevyplněno (výchozí)
| Přihlašovací údaje uživatele se ověřují proti agendě Uživatelé KSPortálu v těžkém klientovi(aplikaci KS Mzdy).
|-
| ad
| Přihlašovací údaje se ověřují v Active Directory.
|-
| ez
| Login uživatel 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.
|}
''Tabulka 1: Způsob ověření uživatelů''

Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance.
Osobní číslo se získává se 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
<add key="ZdrojOsCisla" value=""/> . Parametr může nabývat stejných hodnot jako parametr TypOvereni (viz. Tabulka 1).

= Přístupová práva uživatelů =

Řízení přístupu k údajům a operacím

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:
* KSRoleProvider – načítá aplikační role z databáze aplikace
* ADRoleProvide – načítá aplikační role z Active Directory

Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.

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.

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. 
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem 
<add key="VychoziRole" value=""/>, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.

= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =

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).
# 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á.
# 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.
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.

= Registrace nových uživatelů v KS Portálu =
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í).

Aby uživatel získal přístup do KS 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.

=== Uživatelé se mohou registrovat sami ===
<nowiki>Je také možné povolit neregistrovaným uživatelům KS Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci <appSettings> následující řádky:</nowiki>

<nowiki><add key="Registrace" value="user"/></nowiki>

<nowiki><add key="VychoziRole" value=""/></nowiki>

První řádek povoluje uživatelům KS 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í.

* [[Registrace nového uživatele]]

= Další možnosti nastavení =
Základní nastavení aplikace KS Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).

== Sekce <appSettings> ==
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru <nowiki><add key="název" value="hodnota"/></nowiki>.

{|class="wikitable " border="1" cellpadding="3" cellspacing="0"
|+ Seznam parametrů sekce <appSettings> 
|- style="background-color: #A7C1F2"
| <center>'''Skupina'''</center> 
| <center>'''Název'''</center> 
| <center>'''Popis'''</center> 
| <center>'''Možné hodnoty (nebo příklad hodnoty)'''</center> 
|-
| rowspan = 21|Přihlášení || ''' LastPasswordsCheck '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo
|-
| ''' LockAfterWrongPasswords '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo
|-
| ''' MinPasswordLength '''|| Minimální požadovaná délka hesla uživatele. || číslo
|-
| ''' CheckPasswordComplexity '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false
|-
| ''' PasswordExpiration '''|| Počet dnů do expirace hesla uživatele. || číslo
|-
| ''' WarningBeforePasswordExpiration '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo
|-
| ''' 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)
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty 
2 - obnova hesla je povolena, zamknuté účty budou odemknuty
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' Admins '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin
|-
| ''' 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
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu
|-
| ''' VychoziRole '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal
|-
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||
|-
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||
|-
| ''' 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
|-
| ''' RegistraceRodneCislo '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true
|-
| ''' PocetMesicuRolePoVystupu '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo
|-
| ''' RolePoVystupu '''|| Role po ukončení pracovního poměru. || poVystupu
|-
| ''' 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ů
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku
|-
| rowspan = 2|Prostředí || ''' OptimalizaceMenu '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu
True / ano – zobrazí se jen přístupné položky menu
|-
| ''' ShowEmployeePhoto '''|| Zobrazování fotek zaměstnanců. || true / false
|-
| rowspan = 5|Logování || ''' ShowExceptionDetail '''|| Zda se má zobrazit detailní výpis chyb. || true / false
|-
| ''' EmailChybyZobrazovat '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true
|-
| ''' AppAudit '''|| Zapnutí logování činností uživatelů na KS portále. || true
|-
| ''' 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ě ""xml"" se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí 
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml
|-
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu. || '''a''' / n
|-
| rowspan = 4|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
|-
| ''' Cache '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage
|-
| ''' FormatDatumu '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd
datetime – datum je typu DateTime
|-
| ''' 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
|-
| 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
|-
| ''' ad_user '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||
|-
| ''' ad_password '''|| Heslo uživatelského účtu zadaného v ad_user. ||
|-
| ''' 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
|-
| ''' 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
|-
| ''' ad_user_filter '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203
|-
| ''' 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 "samAccountName". ||
|-
| ''' ad_atr_os_cislo_user '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId
|-
| ''' ad_atr_os_cislo_zastupce '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||
|-
| ''' 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. ||
|-
| rowspan = 5|Web proxy ||''' proxyUrl '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1
|-
| ''' proxyPort '''|| Port proxy serveru. || 8888
|-
| ''' proxyUsername '''|| Login pro přístup k proxy. ||
|-
| ''' proxyPassword '''|| Heslo pro přístup k proxy. ||
|-
| ''' 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. též hd 51506|| Do hodnoty se zadává celá adresa url KS portálu.
|}

== Zašifrování vybraných sekcí web.config ==
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 C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe "appSettings" -app "/ksprtl"

Dešifrování stejné sekce se pak provede příkazem C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd "appSettings" -app "/ksprtl"

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 "NETWORKSERVICE"

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa "NetFrameworkConfigurationKey" "NETWORKSERVICE"

== Active directory ==
=== Typ ověřování ===
V souboru web.config je možno nově nastavit typ ověřování pro Active Directory přes parametr ad_auth_type.
Možné hodnoty jsou basic a secure, výchozí hodnota je secure, tj. způsob, který se používal i před úpravou.
(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)

=== Načítání rolí vzhledem ke skupinám ===
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ě "Vedoucí" a skupina "Vedoucí" je členem ve skupině "Zaměstnanci", pro Nováka se nově načtou role "Vedoucí" i "Zaměstnanci" (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 "KS_").

== Odkazy ==
* [[Příručka KS Portál]]
* [[Přístup i po ukončení pracovního poměru (KS portál)]]

Instalační příručka

2021-06-15T11:51:00Z

Jakub: /* Systém jednotného přihlášení (SSO) */

{{KS portál}}
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.

= Podporované prohlížeče =
Podporovanými prohlížeči jsou '''aktuální verze''' následujících produktů:
* '''''Mozilla Firefox'''''
* '''''Google Chrome'''''
* '''''Microsoft Edge'''''

Prohlížeč musí mít '''povolen ''JavaScript'' a ''Cookies''''' (výchozí nastavení).
=== Historie ===
: [[Podporované prohlížeče (KS portál) (historie)]] 

= Co je potřeba ke zprovoznění KS Portálu =
* '''Windows Server 2008 R2, 2012 a vyšší'''. KS Portál potřebuje cca 100 MB místa na webovém serveru.

* '''Běhové prostředí .Net Framework 4.6.1 a vyšší''' (volně a zdarma ke stažení).


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) 
%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i

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

= Jak postupovat při instalaci =

===Aplikace nesmí být instalována jako Web Site===

===Pro Windows Server 2008 R2, 2012 (IIS 7) a vyšší===

# Kdekoliv na disku vytvořte adresář ksprtl (Doporučujeme do adresáře c:\Inetpub\wwwroot\).
# 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/
# Skupině uživatelů Authenticated Users nastavte práva:čtení na adresáři ksprtl včetně jeho obsahu zápisu do podadresářů Logs a Temp
# V IIS vytvořte novou webovou aplikaci s odkazem na fyzický adresář ksprtl (vytvořený v bodu 1).
# 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.
# 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í).

= Nastavení DB připojení =
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).

<nowiki>Databázové připojení v KS Portálu (ASP.NET aplikaci) definuje ConnectionString, který se nachází v sekci <connectionStrings> v souboru web.config v hlavním adresáři aplikace.</nowiki>

== Příklady ConnectionStringu ==

=== Pro MSSQL ===
<nowiki><add name="web_mzdy" connectionString="server=web_pc;database=mzdy;uid=test;pwd=test"</nowiki>

providerName="System.Data.SqlClient"/>

=== Pro Oracle ===
<nowiki><add name="web_mzdy" connectionString="Data Source=KSPROGRA;User Id=test;Password=test"</nowiki>

providerName="System.Data.OracleClient"/>

=== Pro ODBC ===
<nowiki><add name="web_mzdy" connectionString="DSN=i_mzdy" providerName="System.Data.Odbc"/></nowiki>

=== Položky DB připojení ===

{|
|name
| - jméno DB připojení
|-
|server
| - název nebo IP adresa počítače, na kterém běží DB server
|-
|database
| - název databáze, ke které bude chtít být připojeni
|-
|uid
| - login pro přístup do databáze
|-
|pwd
| - heslo pro přístup do databáze
|}

== Doplňující informace ==
=== Oracle ===
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&Execute. Pokud nejsou práva nastavena správně objeví se chyba: ''System.Data.OracleClient requires Oracle client software version 8.1.7 or greater.''

Pokud to nepomůže nastavte stejná práva uživateli ASPNET, pod kterým běží proces ASP.NET.

=== PostgreSQL ===
* [[PostgreSQL]]

== Ze zkušeností ==
Pokud KS Portál zahlásí databázovou chybu ORA-12638 (jedná se o zdokumentovanou chybu Oracle):

''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 "ticket" to the Active Directory. And, if it cannot retrieve a valid "ticket" then we have the error ORA-12638.''

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

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: SQLNET.AUTHENTICATION_SERVICES= (NTS) za SQLNET.AUTHENTICATION_SERVICES= (NONE).

Lepším řešením je upravit soubor sqlnet.ora na straně Oracle klienta (na počítači, kde běží KS Portál).

= Přihlašování uživatelů KS Portálu =
KS portál nabízí dva typy přihlašování uživatelů: webový formulář a systém jednotného přihlášení.

== Webový formulář ==
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.

V souboru Web.config je potřeba nastavit:

<nowiki><authentication mode="Forms"></nowiki>

=== Způsob přístupu uživatelů do databáze ===
# Přístup do databáze pro všechny uživatele pod jedním DB účtem (výchozí). Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.
# Přístup do databáze pod vlastním jménem uživatele, v connectionstringu jsou zadány místo jména uživatele a hesla masky, které jsou při vytváření připojení vyměněny za skutečné přihlašovací údaje. Příklad:<nowiki><add name="web_mzdy" connectionString="server=absint_pc;database=web_mzdy;uid=%user %;pwd=%password%" providerName="System.Data.SqlClient"/></nowiki>

== Systém jednotného přihlášení (SSO) ==
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.

V souboru web.config je potřeba nastavit:

<nowiki><authentication mode="Windows"></nowiki>

Do databáze přistupují všichni uživatelé pod jedním DB účtem. Přihlašovací údaje k tomuto účtu jsou zadány v connectionstringu.

Po přidání parametru <add key="SkipLoginPage" value="true"/> se přeskočí přihlašovací stránka.

Je možno využít přihlašování pomocí protokolu 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í]]'''

= Způsob ověření uživatelů =
Způsob ověření uživatelů určuje hodnota parametru
<add key="TypOvereni" value=""/>
v souboru web.config v sekci <appSettings> (viz. následující tabulka).

<center>'''Způsob ověření uživatelů'''</center>

{|<table align="center" border="2" width="100%" cellspacing="4" cellpadding="3" rules="all" style="margin:1em 1em 1em 0; border:solid 1px #AAAAAA; border-collapse:collapse;empty-cells:show;">
<tr>
<td bgcolor="#A7C1F2">'''Hodnota'''</td>
<td bgcolor="#A7C1F2">'''Význam'''</td>
<tr>
|-
| Nevyplněno (výchozí)
| Přihlašovací údaje uživatele se ověřují proti agendě Uživatelé KSPortálu v těžkém klientovi(aplikaci KS Mzdy).
|-
| ad
| Přihlašovací údaje se ověřují v Active Directory.
|-
| ez
| Login uživatel 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.
|}
''Tabulka 1: Způsob ověření uživatelů''

Při přihlášení uživatele je potřeba získat i jeho osobní číslo, které jej identifikuje jako konkretního zaměstnance.
Osobní číslo se získává se 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
<add key="ZdrojOsCisla" value=""/> . Parametr může nabývat stejných hodnot jako parametr TypOvereni (viz. Tabulka 1).

= Přístupová práva uživatelů =

Řízení přístupu k údajům a operacím

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:
* KSRoleProvider – načítá aplikační role z databáze aplikace
* ADRoleProvide – načítá aplikační role z Active Directory

Nastavení, který provider se má použít, se provádí v konfiguračním souboru aplikace.

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.

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. 
V konfiguračním souboru web.config je možno definovat výchozí roli parametrem 
<add key="VychoziRole" value=""/>, která se přiřadí všem uživatelům, kteří nebudou mít explicitně přiřazenou žádnou roli.

= Řízení přístupu na data jiných uživatelů (tzv. řádková práva) =

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).
# 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á.
# 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.
# Dle AD – přihlášený uživatel má povolen přístup na sebe a své podřízené dle hierarchie v Active Directory.

= Registrace nových uživatelů v KS Portálu =
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í).

Aby uživatel získal přístup do KS 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.

=== Uživatelé se mohou registrovat sami ===
<nowiki>Je také možné povolit neregistrovaným uživatelům KS Portálu, aby se mohli sami zaregistrovat. V souboru web.config musí být v sekci <appSettings> následující řádky:</nowiki>

<nowiki><add key="Registrace" value="user"/></nowiki>

<nowiki><add key="VychoziRole" value=""/></nowiki>

První řádek povoluje uživatelům KS 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í.

* [[Registrace nového uživatele]]

= Další možnosti nastavení =
Základní nastavení aplikace KS Portál se provádí v souboru web.config, který se nachází v adresáři ksprtl (kořenovém adresáři aplikace).

== Sekce <appSettings> ==
V této sekci se nacházejí parametry aplikace. Jejich pořadí není důležité. Zapisují se ve tvaru <nowiki><add key="název" value="hodnota"/></nowiki>.

{|class="wikitable " border="1" cellpadding="3" cellspacing="0"
|+ Seznam parametrů sekce <appSettings> 
|- style="background-color: #A7C1F2"
| <center>'''Skupina'''</center> 
| <center>'''Název'''</center> 
| <center>'''Popis'''</center> 
| <center>'''Možné hodnoty (nebo příklad hodnoty)'''</center> 
|-
| rowspan = 21|Přihlášení || ''' LastPasswordsCheck '''|| Počet minulých hesel kontrolovaných na odlišnost. || číslo
|-
| ''' LockAfterWrongPasswords '''|| Počet neplatných pokusů o zadání hesla, po kterém se uzamkne účet uživatele. || číslo
|-
| ''' MinPasswordLength '''|| Minimální požadovaná délka hesla uživatele. || číslo
|-
| ''' CheckPasswordComplexity '''|| Kontrolovat složitost hesla. || Pravidlo 3/4, hodnoty true / false
|-
| ''' PasswordExpiration '''|| Počet dnů do expirace hesla uživatele. || číslo
|-
| ''' WarningBeforePasswordExpiration '''|| Kolik dnů před expirací hesla zobrazit upozornění. || číslo
|-
| ''' 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)
1 - obnova hesla je povolena, zamknuté účty zůstanou zamknuty 
2 - obnova hesla je povolena, zamknuté účty budou odemknuty
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' 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
|-
| ''' Admins '''|| Výčet loginů, které patří administrátorům aplikace. Jeden nebo více loginů oddělených středníkem. || admin;admin2;ksadmin
|-
| ''' 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
True – přihlásit se mohou i externí uživatelé z agendy Uživatelé KS Portálu
|-
| ''' VychoziRole '''|| Výchozí uživatelská role, pokud nemá uživatel explicitně definovanou žádnou roli. || portal
|-
| '''VychoziProfil''' || Výchozí [[Přístupové profily (portál)|profil]] ||
|-
| '''VychoziProfilVedouci''' || Výchozí [[Přístupové profily (portál)|profil]] pro vedoucího ||
|-
| ''' 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
|-
| ''' RegistraceRodneCislo '''|| Hodnota true při registraci zapne kontrolu shody rodného čísla v evidenci zaměstnanců pro zadané osobní číslo. || true
|-
| ''' PocetMesicuRolePoVystupu '''|| Počet měsíců platnosti role po ukončení pracovního poměru. || číslo
|-
| ''' RolePoVystupu '''|| Role po ukončení pracovního poměru. || poVystupu
|-
| ''' 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ů
nevyplněno/false – uživatel má přístup pouze na zaměstnance ze stejného podniku
|-
| rowspan = 2|Prostředí || ''' OptimalizaceMenu '''|| Zda zobrazovat celé menu aplikace nebo jen přístupné položky. || nevyplněno – zobrazí se celé menu
True / ano – zobrazí se jen přístupné položky menu
|-
| ''' ShowEmployeePhoto '''|| Zobrazování fotek zaměstnanců. || true / false
|-
| rowspan = 5|Logování || ''' ShowExceptionDetail '''|| Zda se má zobrazit detailní výpis chyb. || true / false
|-
| ''' EmailChybyZobrazovat '''|| Zda zobrazovat chyby vzniklé při pokusu odeslat email. || true
|-
| ''' AppAudit '''|| Zapnutí logování činností uživatelů na KS portále. || true
|-
| ''' 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ě ""xml"" se chyby logují do Logs/Exceptions.xml, jinak do EventLogu. || nevyplněno – záznam se neprovádí 
Xml – provádí se záznam do souboru ksprtl/Logs/exceptions.xml
|-
| '''SecurityQRKod''' || [[Chybové hlášení (portál)|Chybové hlášení]] zobrazováno formou QR kódu. || '''a''' / n
|-
| rowspan = 4|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
|-
| ''' Cache '''|| Způsobí potlačení ukládání stránek („kešování“) na straně prohlížeče do temporary internet files. || nopage
|-
| ''' FormatDatumu '''|| Datový typ pro datum v MSSQL DB. || nevyplněno – datum je char(10) yyyy-mm-dd
datetime – datum je typu DateTime
|-
| ''' 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
|-
| 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
|-
| ''' ad_user '''|| AD přihlašovací jméno uživatele (včetně domény) mající právo číst informace z AD. ||
|-
| ''' ad_password '''|| Heslo uživatelského účtu zadaného v ad_user. ||
|-
| ''' 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
|-
| ''' 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
|-
| ''' ad_user_filter '''|| AD Filtrovací výraz, omezující vyhledávání uživatelů v AD. || countryCode=203
|-
| ''' 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 "samAccountName". ||
|-
| ''' ad_atr_os_cislo_user '''|| AD název atributu, ve kterém jsou uloženy osobní čísla uživatelů. || employeeNumber, employeeId
|-
| ''' ad_atr_os_cislo_zastupce '''|| AD název atributu, ve kterém je uloženo DN zástupce. ||
|-
| ''' 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. ||
|-
| rowspan = 5|Web proxy ||''' proxyUrl '''|| Název nebo IP adresa proxy serveru. || 127.0.0.1
|-
| ''' proxyPort '''|| Port proxy serveru. || 8888
|-
| ''' proxyUsername '''|| Login pro přístup k proxy. ||
|-
| ''' proxyPassword '''|| Heslo pro přístup k proxy. ||
|-
| ''' 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. též hd 51506|| Do hodnoty se zadává celá adresa url KS portálu.
|}

== Zašifrování vybraných sekcí web.config ==
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 C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pe "appSettings" -app "/ksprtl"

Dešifrování stejné sekce se pak provede příkazem C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pd "appSettings" -app "/ksprtl"

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 "NETWORKSERVICE"

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -pa "NetFrameworkConfigurationKey" "NETWORKSERVICE"

== Active directory ==
=== Typ ověřování ===
V souboru web.config je možno nově nastavit typ ověřování pro Active Directory přes parametr ad_auth_type.
Možné hodnoty jsou basic a secure, výchozí hodnota je secure, tj. způsob, který se používal i před úpravou.
(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)

=== Načítání rolí vzhledem ke skupinám ===
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ě "Vedoucí" a skupina "Vedoucí" je členem ve skupině "Zaměstnanci", pro Nováka se nově načtou role "Vedoucí" i "Zaměstnanci" (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 "KS_").

== Odkazy ==
* [[Příručka KS Portál]]
* [[Přístup i po ukončení pracovního poměru (KS portál)]]

Vývěska

2021-06-15T11:36:41Z

Jakub:

''Vývěska'' je rozšíření umožňující zobrazovat zprávy a odkazy v aplikaci KS portál. Tvoří ji dvě části:
* '''''[[Redakční systém (Vývěska)|Redakční systém]]''''' - pro tvorbu zpráv
* '''''[[Vývěska (Vývěska)|Vývěska]]''''' - samotná vývěska
* '''''[[Ankety|Ankety]]''''' - ankety a dotazníky

== Odkazy ==
* [[KS portál]]

Ankety

2021-06-15T11:35:35Z

Jakub: /* Správa anket */

Ankety jsou rozšíření aplikace díky němuž je možno vytvářet jednoduché dotazníky a ankety pro zaměstnance v rámci KS Portálu.

Na titulní stránce se podobně jako v případě ''Vývěsky'' zobrazují jednotlivé ankety a to v bloku Oznámení.

*''Výchozí stránka Default2.aspx''

Agenda ''Zaměstnanec - Vývěska - Ankety'' slouží pouze pro správce. Je zde dostupný seznam všech anket a je zde také možno ankety vytvářet.

Do budoucna bude také možno na ankety odpovídat v rámci agendy ''Zaměstnanec - Vývěska - Ankety'', doposud je tak možno učinit pouze na titulní stránce portálu.

[[Soubor:Ankety_(1).png|350px]]

==Správa anket==

Při vytváření ankety je nutné vyplnit její název a množinu (podniků,středisek,osob,...) kterým se má anketa zobrazovat. Ve výchozím stavu je dále zvoleno, že anketa je anonymní, ve vyhodnocení, jsou pak odpovědi anonymizovány. Dále je pak možno přidat krátký popis ankety, zvolit datum publikování, datum ukončení zobrazování ankety a obrázek (ikonu) ankety.

Důležitou informací je, že pokud je nastaveno datum publikování ankety do budoucna, je možné anketu do datumu zahájení vyplňování libovolně editovat. Tzn. je možno přidávat otázky, odebírat je, případně přidávat a odebírat odpovědi.

[[Soubor:Ankety_(2).png|350px]]

Následně se zobrazí okno, ve kterém se tvoří samotná anketa. Zde je na výběr typ odpovědi

*Checkbox - umožňuje vybrat více odpovědí
*RadioButton - umožňuje vybrat pouze jednu z nabízených možností
*Text - umožňuje zadat libovolnou odpověď

[[Soubor:Ankety_(3).png|350px]]

==Vyplnění ankety==
Na úvodní stránce je možno následně v sekci ''Oznámení'' odpovědět na jednotlivé otázky. Otázky, které jsou povinné, jsou podbarveny žlutou barvou.

[[Soubor:Ankety_(4).png|350px]]

==Vyhodnocení ankety==
V agendě '''Ankety''' je po započetí sběru odpovědí možno provést vizualizaci výsledků a to buď prostřednictvím grafu nebo tabulky. Grafy jednotlivých odpovědí jsou zobrazeny pod záložkou '''Vyhodnocení ankety''' a tabulkový přehled je uveden pod záložkou '''Odpovědi'''

[[Soubor:Ankety_(5).png|350px]]

Ankety

2021-06-15T11:28:14Z

Jakub: /* Vyhodnocení ankety */

Ankety jsou rozšíření aplikace díky němuž je možno vytvářet jednoduché dotazníky a ankety pro zaměstnance v rámci KS Portálu.

Na titulní stránce se podobně jako v případě ''Vývěsky'' zobrazují jednotlivé ankety a to v bloku Oznámení.

*''Výchozí stránka Default2.aspx''

Agenda ''Zaměstnanec - Vývěska - Ankety'' slouží pouze pro správce. Je zde dostupný seznam všech anket a je zde také možno ankety vytvářet.

Do budoucna bude také možno na ankety odpovídat v rámci agendy ''Zaměstnanec - Vývěska - Ankety'', doposud je tak možno učinit pouze na titulní stránce portálu.

[[Soubor:Ankety_(1).png|350px]]

==Správa anket==

Při vytváření ankety je nutné vyplnit její název a množinu (podniků,středisek,osob,...) kterým se má anketa zobrazovat. Ve výchozím stavu je dále zvoleno, že anketa je anonymní, ve vyhodnocení, jsou pak odpovědi anonymizovány. Dále je pak možno přidat krátký popis ankety, zvolit datum publikování, datum ukončení zobrazování ankety a obrázek (ikonu) ankety.

[[Soubor:Ankety_(2).png|350px]]

Následně se zobrazí okno, ve kterém se tvoří samotná anketa. Zde je na výběr typ odpovědi

*Checkbox - umožňuje vybrat více odpovědí
*RadioButton - umožňuje vybrat pouze jednu z nabízených možností
*Text - umožňuje zadat libovolnou odpověď

[[Soubor:Ankety_(3).png|350px]]

==Vyplnění ankety==
Na úvodní stránce je možno následně v sekci ''Oznámení'' odpovědět na jednotlivé otázky. Otázky, které jsou povinné, jsou podbarveny žlutou barvou.

[[Soubor:Ankety_(4).png|350px]]

==Vyhodnocení ankety==
V agendě '''Ankety''' je po započetí sběru odpovědí možno provést vizualizaci výsledků a to buď prostřednictvím grafu nebo tabulky. Grafy jednotlivých odpovědí jsou zobrazeny pod záložkou '''Vyhodnocení ankety''' a tabulkový přehled je uveden pod záložkou '''Odpovědi'''

[[Soubor:Ankety_(5).png|350px]]

Ankety

2021-06-15T11:26:26Z

Jakub:

Ankety jsou rozšíření aplikace díky němuž je možno vytvářet jednoduché dotazníky a ankety pro zaměstnance v rámci KS Portálu.

Na titulní stránce se podobně jako v případě ''Vývěsky'' zobrazují jednotlivé ankety a to v bloku Oznámení.

*''Výchozí stránka Default2.aspx''

Agenda ''Zaměstnanec - Vývěska - Ankety'' slouží pouze pro správce. Je zde dostupný seznam všech anket a je zde také možno ankety vytvářet.

Do budoucna bude také možno na ankety odpovídat v rámci agendy ''Zaměstnanec - Vývěska - Ankety'', doposud je tak možno učinit pouze na titulní stránce portálu.

[[Soubor:Ankety_(1).png|350px]]

==Správa anket==

Při vytváření ankety je nutné vyplnit její název a množinu (podniků,středisek,osob,...) kterým se má anketa zobrazovat. Ve výchozím stavu je dále zvoleno, že anketa je anonymní, ve vyhodnocení, jsou pak odpovědi anonymizovány. Dále je pak možno přidat krátký popis ankety, zvolit datum publikování, datum ukončení zobrazování ankety a obrázek (ikonu) ankety.

[[Soubor:Ankety_(2).png|350px]]

Následně se zobrazí okno, ve kterém se tvoří samotná anketa. Zde je na výběr typ odpovědi

*Checkbox - umožňuje vybrat více odpovědí
*RadioButton - umožňuje vybrat pouze jednu z nabízených možností
*Text - umožňuje zadat libovolnou odpověď

[[Soubor:Ankety_(3).png|350px]]

==Vyplnění ankety==
Na úvodní stránce je možno následně v sekci ''Oznámení'' odpovědět na jednotlivé otázky. Otázky, které jsou povinné, jsou podbarveny žlutou barvou.

[[Soubor:Ankety_(4).png|350px]]

==Vyhodnocení ankety==
V agendě '''Ankety''' je po započetí sběru odpovědí možno provést vizualizaci výsledků a to buď prostřednictvím grafu nebo tabulky.

[[Soubor:Ankety_(5).png|350px]]

Ankety

2021-06-15T11:22:45Z

Jakub:

Ankety

2021-06-15T11:22:19Z

Jakub:

Ankety

2021-06-15T11:22:02Z

Jakub:

Ankety

2021-06-15T11:08:22Z

Jakub:

Ankety

2021-06-15T11:07:53Z

Jakub:

Soubor:Ankety (5).png

2021-06-15T10:57:21Z

Jakub:

Soubor:Ankety (4).png

2021-06-15T10:57:12Z

Jakub:

Soubor:Ankety (3).png

2021-06-15T10:56:57Z

Jakub: