﻿# Hitelesítési lehetőségek

> Az appsettings.json két beállítása határozza meg a bejelentkezést:

Source: https://workwise-solutions.net/hu/docs/installation/authentication/ · Language: hu · English version: https://workwise-solutions.net/docs/installation/authentication/

Az `appsettings.json` két beállítása határozza meg a bejelentkezést:

- `UserSettings.UserStore`: **honnan jönnek a felhasználók és a csoportok**: `Local`, `ActiveDirectory`, `LDAP` vagy `AzureAD` (Microsoft Entra ID).
- `LoginSettings.AuthType`: **hogyan jelentkeznek be**: `Local`, `ActiveDirectory`, `AppleConnect` vagy `OAuth`.

| Felhasználói tár | Lehetséges bejelentkezési módok |
|---|---|
| Local | Local, OAuth |
| ActiveDirectory (csak Windows) | ActiveDirectory |
| LDAP | AppleConnect, OAuth |
| AzureAD (Microsoft Entra ID) | OAuth |

Bármelyik mellett a [külső felhasználók](https://workwise-solutions.net/hu/docs/features/user-management/#külső-felhasználók-és-csoportok) is bejelentkezhetnek a **Bejelentkezés külső felhasználóként** lehetőséggel.

![Bejelentkezési módok és felhasználói tárak](https://workwise-solutions.net/docs/images/diagram-authentication-hu.png)
*A bejelentkezési módok és felhasználói tárak megengedett párosításai, a címtárból érkező és külső felhasználókkal, valamint az API kliensekkel.*

## Helyi (alapértelmezett)

A felhasználók és a csoportok az alkalmazás adatbázisában vannak, a **Felhasználók** és a **Csoportok** oldalon kezelhetők. Új telepítésen a bejelentkezési oldal az első rendszergazda létrehozását kéri ([Első lépések](https://workwise-solutions.net/hu/docs/getting-started/)). A felhasználók e-mailben állíthatják vissza a jelszavukat.

## Active Directory

A `UserStore` és az `AuthType` is `ActiveDirectory`. Csak Windowson működik: más rendszeren az alkalmazás nem indul el vele. A szervernek tartományba léptetettnek kell lennie; IIS alatt kapcsolja be az Anonymous és a Windows Authentication módot ([Windows (IIS)](https://workwise-solutions.net/hu/docs/installation/windows-iis/)).

| Beállítás (`UserSettings.ADSettings`) | Jelentés |
|---|---|
| `RootDomain` | A gyökértároló LDAP útvonala, például `OU=Sales,DC=YourCompany,DC=com`; üresen a szolgáltatásfiók tartománya |
| `SubDomains` | Az erdő altartományai; üresen automatikusan feltérképezi |
| `Username`, `Password`, `AuthenticationType` | Opcionális fiók a lekérdezésekhez |
| `AdminUsers`, `AdminGroups` | A Super Adminok SAM-nevei, más tartományból `DOMAIN\\User` formában |
| `AdQueryTimeout` | Lekérdezési időkorlát másodpercben |
| `DomainNameAliases` | Ha a felhasználók más tartománynévvel jelentkeznek be, mint a tartomány saját neve |

A `LoginSettings.ADSettings.NegotiateLogin` (alapérték `true`) először az integrált Windows-bejelentkezést próbálja; a felhasználók be is írhatják a felhasználónevüket és jelszavukat.

## LDAP

`UserStore: LDAP`. A felhasználókat és a csoportokat egy LDAP-szerverről olvassa (`UserSettings.LdapSettings`): `Host`, `Port` (389), `IsSecure` (LDAPS), `LdapRoot`, opcionális kötési `User` és `Password`, `AdminUsers` és `AdminGroups`, `CacheGroupsOfUserFor`, valamint a **változat** (flavor):

- `ActiveDirectory`: AD attribútumnevek LDAP-on keresztül;
- `Apple`: Apple Open Directory;
- `Custom`: az objektumosztályokat és attribútumneveket a `CustomLdapFlavor` alatt adhatja meg (felhasználóazonosító, felhasználónév, megjelenítési név, csoportazonosító és -név, tagság attribútum, e-mail, a felhasználók és csoportok gyökere, további tulajdonságok).

A csoportokat rekurzívan keresi. Bejelentkezés `AuthType: AppleConnect` móddal (`LoginSettings.AppleConnectSettings`: hitelesítési és ellenőrző URL, alkalmazásazonosító és -kulcs, közös titok, az identitássüti neve; LDAP-űrlapot is felkínál) vagy OAuth-tal.

## Microsoft Entra ID

`UserStore: AzureAD` és `AuthType: OAuth` a Microsoft szolgáltatóval. `UserSettings.AzureADSettings`: egy felhasználók és csoportok olvasására jogosult alkalmazásregisztráció `TenantId`, `ClientId` és `ClientSecret` értéke, `AdminUsers` (e-mail címek), `AdminGroups` (csoportnevek), valamint B2C bérlőkhöz, föderált fiókok esetén az `IssuerEmail`.

## OAuth

`AuthType: OAuth`. A bejelentkezési oldalon egyetlen **Bejelentkezés** gomb jelenik meg, amely átirányít a szolgáltatóhoz. `LoginSettings.OAuthSettings.OAuthType`:

| Szolgáltató | Beállítások |
|---|---|
| `Okta` | `OktaDomain`, `AppId`, `AppSecret`, opcionálisan `IssuerUrl` |
| `Google` | `AppId`, `AppSecret`, `LoginHint` |
| `Microsoft` | `TenantId`, `AppId`, `AppSecret`, opcionálisan egyedi végpontok |
| `Custom` | Bármely Authorization Code folyamatot támogató szolgáltató: `AuthorizationEndpoint`, `TokenEndpoint`, `AppId`, `AppSecret`, valamint hogy honnan jön az e-mail cím és a név (`IdToken` a claim-nevekkel, vagy `OpenId` egy végponttal). Átirányítási cím: `https://<cím>/api/account/oauth/callback/custom` |

Az `OAuthLoginTimeout` korlátozza, meddig tarthat egy bejelentkezés. Az OAuth nem működik `CacheSettings.Type: None` mellett, több szerver esetén pedig közös cache kell hozzá.

## Jogosultságok címtár használatakor

AD, LDAP vagy Entra ID mellett a felhasználó profilja az első bejelentkezéskor jön létre. Az `AdminUsers`/`AdminGroups` listában szereplő felhasználók és csoportok Super Adminok lesznek; a többiek *Public* jogosultsággal indulnak. Az alkalmazásszintű jogosultságokat a Super Adminok a **Profilok** oldalon állítják be, és munkaterületi szerepkör a címtár felhasználóinak és csoportjainak is adható ([Felhasználókezelés](https://workwise-solutions.net/hu/docs/features/user-management/#profilok)).

## Személyes hozzáférési tokenek

A bejelentkezési módtól függetlenül az API-kliensek a `LoginSettings.JwtAuthenticationSettings` kulccsal aláírt személyes hozzáférési tokenekkel hitelesítenek ([Személyes hozzáférési tokenek](https://workwise-solutions.net/hu/docs/features/personal-access-tokens/)).
