Hitelesítési lehetőségek
Ezen az oldalon
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,LDAPvagyAzureAD(Microsoft Entra ID).LoginSettings.AuthType: hogyan jelentkeznek be:Local,ActiveDirectory,AppleConnectvagyOAuth.
| 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 is bejelentkezhetnek a Bejelentkezés külső felhasználóként lehetőséggel.
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). 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)).
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 aCustomLdapFlavoralatt 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).
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).