Ga naar inhoud

Authentication domain

Een authenticatiedomein bepaalt waar en hoe de identiteiten van de gebruikers bij het verbinden worden gecontroleerd. Elk account hoort bij een groep en elke groep bij een domein: het domein bepaalt waar de accounts vandaan komen — een bedrijfsdirectory, een interne database of een externe identiteitsprovider.

Deze module somt de gedeclareerde domeinen op. Klik op + om er een toe te voegen, of dubbelklik op een naam om die te configureren. Het type directory wordt bij het aanmaken gekozen en kan daarna niet meer worden gewijzigd.

Er worden vier typen aangeboden:

Type directory Herkomst van de accounts Gebruik
LDAP directory Externe directory (Active Directory, OpenLDAP…) Het gangbare geval: bestaande accounts en groepen worden ongewijzigd hergebruikt, zonder kopie.
Local directory Database binnen het platform Accounts die rechtstreeks vanuit de console worden aangemaakt en beheerd, naast een directory of voor een klein bereik.
SAML domain Externe identiteitsprovider (IdP) De authenticatie wordt gedelegeerd aan de IdP; het platform treedt op als serviceprovider.
Anonymous directory Geen Zeldzame gevallen waarin het bereiken van een applicatie in het geheel geen authenticatie vereist.

Volgorde van het aanmaken

Maak eerst het domein aan, dan de groepen en daarna de gebruikersaccounts: de toegangsrechten op de applicaties worden vervolgens via een toegangscontract aan groepen toegekend.


Gemeenschappelijke configuratie-elementen

Deze instellingen zijn bij elk type domein aanwezig:

Veld Beschrijving
Name Kies een sprekende domeinnaam.
Shortcut URL Wordt alleen in de wijzigingsmodus weergegeven. Directe URL die toegang geeft tot het gebruikersportaal voor dit specifieke domein, zonder de lijst met beschikbare domeinen te doorlopen. Formaat: https://{server}/cloud/?orgname={organisation}&domainid={id}.
Description Optioneel veld dat de inhoud van het domein beschrijft.
Microsoft domain Informatie die de identificatie van de gebruiker begeleidt wanneer single sign-on (SSO) is ingeschakeld.
Expiration Maximale duur van inactiviteit voordat een sessie verloopt. Standaardwaarde: 60 minuten.
Number of attempts before lockout Beperkt het aantal aanmeldpogingen. Aanbevolen waarde: 3 pogingen (bescherming tegen brute-force-aanvallen). Deze grens moet ≤ elke in de LDAP-directory ingestelde grens zijn.
Time before unlock (minutes) Wachttijd voordat vergrendelde sessies worden ontgrendeld. Zet de waarde op 0 om de functie uit te schakelen.
The domain is part of cascading authentication Zie de sectie Authenticatie in cascade.
Delegate authentication to an external server Opties: No, CAS, IdeoSSO.
Alternative username attribute LDAP-attribuut dat als secundaire identificatie dient wanneer de gebruiker met het primaire attribuut niet wordt gevonden (bijvoorbeeld mail, userPrincipalName).
Maximum number of simultaneous sessions per user Aanbevolen waarde: 1 sessie.
Automatic deletion of the oldest session Sluit automatisch een actieve sessie wanneer een nieuwe wordt aangevraagd.
Note displayed in the authentication form Opmerking die uitsluitend bedoeld is voor de gebruikers van het domein.

Authenticatiemethode

Veld Beschrijving
Authentication method Bepaalt hoe de identiteit van de gebruiker bij het aanmelden wordt gecontroleerd: Form (gebruikersnaam en wachtwoord handmatig ingevoerd) / User certificate (de gebruikersnaam wordt uit het veld CN van het certificaat gehaald) / User certificate and form (na de authenticatie met het certificaat wordt bovendien een wachtwoord gevraagd) / Apache authentication (authenticatie gedelegeerd aan de Apache-webserver) / Pro Santé Connect (CIBA) (authenticatie via de Franse nationale identiteitsprovider voor de gezondheidszorg).
Force the use of the virtual keyboard Geeft op de authenticatiepagina een schermtoetsenbord weer om het invoeren van het wachtwoord tegen keyloggers te beschermen.

Pro Santé Connect (CIBA)

Deze velden worden alleen weergegeven wanneer de authenticatiemethode Pro Santé Connect (CIBA) is gekozen. Pro Santé Connect is de Franse nationale identiteitsprovider voor beroepskrachten in de gezondheidszorg.

Veld Beschrijving
Identifier (client id) Clientidentificatie die Pro Santé Connect bij de registratie van de applicatie verstrekt.
Secret (client secret) Bijbehorend clientgeheim, waarmee de OIDC-uitwisselingen met Pro Santé Connect worden gevalideerd.
Sandbox Wanneer dit is aangevinkt, maakt CyberElements verbinding met de testomgeving van PSC in plaats van met de productieomgeving. Alleen voor integratietests gebruiken.
RPPS retrieval Bepaalt waar het RPPS-nummer van de gebruiker vandaan komt (Frans register van beroepskrachten in de gezondheidszorg): Use the authentication attribute (het RPPS wordt uit het primaire authenticatieattribuut gehaald) of Use another user attribute (het RPPS wordt uit een afzonderlijk attribuut gehaald, dat in het volgende veld moet worden opgegeven).
User attribute containing the RPPS Naam van het attribuut dat het RPPS-nummer bevat (bijvoorbeeld rpps, healthcareProfessionalId). Alleen zichtbaar en verplicht als de vorige optie op ”Use another user attribute” staat.

OTP-authenticatietoken

Veld Beschrijving
Authentication token Keuze van de te gebruiken OTP-generator(en) (eerder gedeclareerd via het menu van de OTP-tokengenerators). Meervoudige selectie is mogelijk.
User attribute used to send the OTP Geeft het gebruikersattribuut aan waarmee het OTP voor elk gekozen token wordt bezorgd (bijvoorbeeld mobile voor verzending per sms, mail voor verzending per e-mail). Per gekozen token wordt één veld weergegeven.
Token expiration duration Duur waarna een verzonden OTP niet meer wordt aanvaard. Zet de waarde op 0 om het verlopen uit te schakelen.
Time unit Eenheid van de verloopduur: Hours of Days. De in het vorige veld ingevoerde waarde wordt met deze eenheid vermenigvuldigd (1 voor uren, 24 voor dagen).
Expiration starts Beginpunt van het aftellen tot het verlopen: From the last OTP validation (het OTP verloopt X uur na de validatie ervan) of From the last successful login (het OTP verloopt X uur na het openen van de sessie).
Replace OTP characters with "*" Verbergt de tekens die bij het aanmelden in het veld van het eenmalige wachtwoord worden ingevoerd.

Authenticatie met neomia Pulse

neomia Pulse is een oplossing voor continue authenticatie op basis van gedragsanalyse. Deze velden worden weergegeven wanneer het selectievakje Enable neomia Pulse authentication is aangevinkt.

Veld Beschrijving
Enable neomia Pulse authentication Schakelt de integratie met neomia Pulse in. Er wordt een Pulse-configuratie voor het domein aangemaakt.
API URL Basis-URL van de API van neomia Pulse voor de verificatie van de gebruikers (bijvoorbeeld https://pulse.example.com/api).
Authentication API URL URL van het authenticatie-endpoint van Pulse als dat verschilt van de hoofd-URL.
API key Geheime sleutel waarmee CyberElements zich bij de API van Pulse kan authenticeren.
Number of neomia Pulse attempts Maximaal aantal authenticatiepogingen met Pulse voordat de aanvraag wordt geblokkeerd. Standaardwaarde: 3.
If Pulse authentication succeeds Gedrag wanneer Pulse de gebruiker met succes valideert: Skip the OTP token (alle voor het domein geconfigureerde OTP's worden overgeslagen) of Reinforce authentication (de OTP's blijven verplicht, ook na een geslaagde validatie door Pulse).
If Pulse authentication fails Terugvalgedrag als Pulse mislukt of niet beschikbaar is: Block access (de gebruiker kan zich niet aanmelden, de foutcode PULSE_API_ERROR wordt teruggegeven) of Request an additional authentication factor (automatische terugval op de standaard-OTP-authenticatie).
Display graphical components Geeft op de authenticatiepagina de visuele elementen van het typepatroon van de interface van neomia Pulse weer.
Display authentication factors Toont de gebruiker de lijst met authenticatiefactoren die Pulse heeft gedetecteerd.

Delegatie van de authenticatie aan een externe server

CAS-server

Veld Beschrijving
CAS server URL Volledige URL van de CAS-server waaraan de authenticatie wordt gedelegeerd.

IdeoSSO

Veld Beschrijving
CAS server URL Volledige URL van de IdeoSSO-server.
IdeoSSO, user property matching the identifier Naam van de gebruikerseigenschap van IdeoSSO die in CyberElements als aanmeldidentificatie wordt gebruikt.

Een domein van het type ”Local directory” configureren

Tabblad: General information

Veld Beschrijving
Invisible shortcut Als er meerdere domeinen bestaan, vink dit vakje aan zodat het domein niet in de aan de gebruiker aangeboden lijst verschijnt. Het domein is dan alleen bereikbaar via de volledige shortcut-URL ervan.
Display the access condition if it is invalid Als dit is aangevinkt, wordt de bijbehorende foutmelding aan de gebruiker weergegeven wanneer een ongeldige toegangsvoorwaarde hem verhindert zich aan te melden. Als dit niet is aangevinkt, krijgt de gebruiker geen uitleg. Alleen beschikbaar in de wijzigingsmodus.

Tabblad: Password

Op dit tabblad wordt het beheer van de wachtwoorden van de gebruikers van het lokale domein geconfigureerd.

Veld Beschrijving
Change the user's password at first login Als dit is aangevinkt, wordt de gebruiker bij zijn allereerste aanmelding automatisch omgeleid naar een scherm om het wachtwoord te wijzigen. Hij kan het portaal niet bereiken zolang de wijziging niet is uitgevoerd.
Display the password change form Als dit is aangevinkt, wordt op het aanmeldscherm een koppeling weergegeven waarmee de gebruiker zijn wachtwoord kan wijzigen.
Define a custom password policy Maakt het mogelijk een beleid voor de complexiteit en de levensduur van wachtwoorden te definiëren dat eigen is aan dit domein.

Wanneer Define a custom password policy is aangevinkt, komen de volgende instellingen beschikbaar:

Veld Beschrijving
Display the password policy to the user Als dit is aangevinkt, worden de complexiteitsregels aan de gebruiker weergegeven wanneer hij zijn wachtwoord instelt of wijzigt.
Minimum number of characters Minimaal vereiste lengte van het wachtwoord. Standaardwaarde: 10. Zet de waarde op 0 om de controle uit te schakelen.
Minimum number of lowercase letters Vereist minimumaantal kleine letters. Zet de waarde op 0 om de controle uit te schakelen.
Minimum number of uppercase letters Vereist minimumaantal hoofdletters. Zet de waarde op 0 om de controle uit te schakelen.
Minimum number of digits Vereist minimumaantal cijfers. Zet de waarde op 0 om de controle uit te schakelen.
Minimum number of special characters Vereist minimumaantal speciale tekens. Zet de waarde op 0 om de controle uit te schakelen.
Minimum password lifetime (days) Minimale wachttijd voordat de gebruiker zijn wachtwoord mag wijzigen. Voorkomt te frequente wijzigingen. Zet de waarde op 0 om de controle uit te schakelen.
Maximum password lifetime (days) Termijn waarna het wachtwoord verloopt en moet worden vernieuwd. Standaardwaarde: 60 dagen. Zet de waarde op 0 om de controle uit te schakelen.
Notify the user before expiration (days) Verzendt het opgegeven aantal dagen voordat zijn wachtwoord verloopt een e-mail naar de gebruiker. Vereist een geconfigureerde maximale levensduur, een SMTP-server en een afzenderadres. Zet de waarde op 0 om de functie uit te schakelen.
SMTP server Server waarmee de meldingen over het verlopen worden verzonden (uit de servers die in de SMTP-configuratie zijn gedeclareerd).
Source e-mail E-mailadres dat als afzender van de meldingen wordt weergegeven.
Reject the new password if it contains the login Als dit is aangevinkt, zijn wachtwoorden verboden die de aanmeldidentificatie van de gebruiker bevatten (bescherming tegen voor de hand liggende wachtwoorden).
Reject the new password if it matches one of the last X Houdt een geschiedenis van de wachtwoorden bij en verbiedt het hergebruik van het opgegeven aantal eerdere wachtwoorden. Zet de waarde op 0 om de controle uit te schakelen.

Een domein van het type ”LDAP directory” configureren

Tabblad: General information

Veld Beschrijving
Invisible shortcut Als er meerdere domeinen bestaan, vink dit vakje aan zodat het domein niet in de aan de gebruiker aangeboden lijst verschijnt.

Tabblad: LDAP settings

Verbinding

Veld Beschrijving
Authentication through a site Als dit is aangevinkt, gebruikt CyberElements de Edge Gateway van een site om de directory te bereiken, waardoor er geen inkomende firewallregels vanuit de DMZ hoeven te worden geopend. Met een tweede veld kunt u de site selecteren die moet worden gebruikt.
Authentication type Bindprotocol naar de LDAP-server: SIMPLE (bind met DN + wachtwoord in leesbare tekst via TLS) / NTLM (Windows-authenticatie, vereist het Microsoft-domeinsuffix) / SASL/Digest-MD5 (SASL-authenticatie met MD5-hashing, verzendt het wachtwoord niet in leesbare tekst).
Microsoft domain suffix Suffix van het Windows-domein waarmee de NTLM-identificatie wordt opgebouwd (bijvoorbeeld CONTOSO). Alleen zichtbaar als het authenticatietype NTLM is.

Zoeken naar gebruikers en groepen

Veld Beschrijving
Search mode Bepaalt de strategie waarmee de groepen uit de directory worden opgehaald: Retrieve groups from a group attribute (doorloopt de groepen en leest hun leden — geschikt voor standaarddirectory's) / Retrieve groups from a user attribute (leest het attribuut memberOf van elke gebruiker — sneller bij Active Directory) / Retrieve nested groups through the TokenGroups attribute (gebruikt het speciale AD-attribuut tokenGroups om geneste groepen recursief op te lossen — aanbevolen bij Active Directory).
User attribute containing the groups Naam van het attribuut van het gebruikersobject dat de groepen opsomt waartoe het behoort. Alleen zichtbaar als de modus ”from a user attribute” is gekozen.
Use the user's DN to log in Als dit is aangevinkt, wordt de volledige DN van de gebruiker gebruikt bij de LDAP-bind (authenticatie).
User authentication attribute LDAP-attribuut dat bij het aanmelden als unieke identificatie van de gebruiker dient. Voorgestelde waarden: sAMAccountName (Active Directory), cn, sn, uid, mailNickname, userPrincipalName, employeeID, of aangepast.
User attribute customisation Maakt het mogelijk handmatig een attribuut in te voeren dat niet in de lijst staat. Alleen zichtbaar als ”custom” is gekozen.
Group authentication attribute LDAP-attribuut waarmee de groepen uniek worden geïdentificeerd (bijvoorbeeld cn, sAMAccountName).

Boom

Veld Beschrijving
Users branch Volledige DN van de organisatie-eenheid die de gebruikers bevat (bijvoorbeeld ou=Users,dc=example,dc=com).
Groups branch Volledige DN van de organisatie-eenheid die de groepen bevat (bijvoorbeeld ou=Groups,dc=example,dc=com).
Manual group management Als dit is aangevinkt, worden de groepen niet automatisch gesynchroniseerd vanuit de LDAP-directory. De beheerders moeten de groepen handmatig toevoegen en verwijderen in cyberelements.

Serviceaccount

Veld Beschrijving
Read access account Volledige DN van het serviceaccount waarmee CyberElements de directory bevraagt (bijvoorbeeld cn=service-cye,ou=ServiceAccounts,dc=example,dc=com). Het wordt sterk aangeraden een eigen proxyaccount te definiëren en het anonieme binden met de directory uit te schakelen.
Password Wachtwoord van het serviceaccount.
User class LDAP-objectklasse van de gebruikers die in de directory moeten worden gezocht (bijvoorbeeld person, inetOrgPerson, user bij Active Directory).
Group filter Aanvullend filter op attribuut en waarde om de groepen in de directory te bepalen. Wordt alleen gebruikt met de zoekmodus ”from a group attribute”.

Wachtwoord van de gebruikers

Veld Beschrijving
Display the password change form Als dit is aangevinkt, wordt op het aanmeldscherm een koppeling weergegeven om het wachtwoord te wijzigen. Deze optie is alleen beschikbaar als de verbinding met de directory SSL (LDAPS) gebruikt of via een site loopt.
Check whether the password must be changed Als dit is aangevinkt, bevraagt CyberElements de LDAP-directory om te weten of de gebruiker zijn wachtwoord moet wijzigen (attribuut pwdLastSet bij Active Directory) en verplicht het hem daartoe indien nodig.
Check the password complexity when it is changed Als dit is aangevinkt, controleert CyberElements of het nieuwe wachtwoord voldoet aan het complexiteitsbeleid dat in de directory is gedefinieerd, wanneer de wijziging vanuit het portaal wordt gestart.

Optie Radius

Veld Beschrijving
Enable the Radius option Vink dit vakje alleen aan als de LDAP-directory is gekoppeld aan een Radius-authenticatie (twee factoren). Deze optie kan alleen bij het aanmaken van het domein worden ingeschakeld en kan daarna niet meer worden gewijzigd.

Wanneer de optie Radius is ingeschakeld, verschijnen de volgende instellingen:

Veld Beschrijving
Mode Werkingsmodus van de Radius-server: quicklog (directe authenticatie: het wachtwoord wordt ongewijzigd doorgegeven aan de Radius-server) of challenge/response (de Radius-server verzendt een uitdaging waarop de gebruiker moet antwoorden).
Server IP-adres of DNS-naam van de Radius-server.
Port Poort waarop de Radius-server luistert. Standaardwaarde: 1812.
Secret Geheim dat CyberElements en de Radius-server delen en waarmee de uitwisselingen worden versleuteld.
Number of attempts Maximaal aantal pogingen voordat CyberElements de aanvraag aan de Radius-server opgeeft. Standaardwaarde: 3.
Timeout (seconds) Maximale wachttijd op het antwoord van de Radius-server voordat de termijn verstrijkt. Standaardwaarde: 10 seconden.
Radius NAS IP address Bron-IP-adres dat CyberElements aan de Radius-server opgeeft (attribuut NAS-IP-Address). In te stellen als de Radius-server de aanvragen op bron-IP-adres filtert.

Overige instellingen

Veld Beschrijving
Allow RDS server management Als dit is aangevinkt, kunnen de accounts van dit domein in de module voor het beheer van de RDS-servers aan RDS-servers worden gekoppeld.
Use specific certificate authorities to validate LDAPS certificates Als dit is aangevinkt, gebruikt CyberElements een eigen CA-certificaat om het certificaat te valideren dat de LDAP-server bij SSL-verbindingen voorlegt. Als dit niet is aangevinkt, worden de CA's van het systeem gebruikt (/etc/ssl/certs/ca-certificates.crt).
Certificate authorities (base64 encoding) Bestand met de root-CA('s) in PEM-formaat (tekst die begint met -----BEGIN CERTIFICATE-----). Alleen zichtbaar en verplicht als de vorige optie is ingeschakeld.

LDAP-servers

De servertabel somt de servers op die aan het domein zijn gekoppeld (kolommen: Server, Port, Protocol). Meerdere servers definiëren maakt hoge beschikbaarheid mogelijk: CyberElements schakelt bij een storing automatisch over naar een beschikbare server.

Klik op + om een server toe te voegen. Voer in:

Veld Beschrijving
Server IP-adres of DNS-naam van de LDAP-server.
Port Toegangspoort. Standaardwaarde: 389 (LDAP) of 636 (LDAPS).
Protocol LDAP of LDAP over SSL. Het gebruik van SSL wordt ook op een intern netwerk sterk aangeraden.

Selecteer een bestaande server en klik op het pictogram Properties om die te wijzigen.
Selecteer een server en klik op × om die te verwijderen.


Een domein van het type ”Anonymous directory” configureren

Een anoniem domein kan worden gebruikt in de zeldzame gevallen waarin de toegang tot een applicatie geen authenticatie vereist omdat de gebruiker al op een bijzondere manier is geauthenticeerd.

Veld Beschrijving
Maximum number of connections Beperkt het aantal gelijktijdige verbindingen dat op dit domein is toegestaan.
Use the certificate CN as the user identifier Als dit is aangevinkt, wordt de identificatie van de gebruiker automatisch gehaald uit het veld CN van het clientcertificaat dat bij het verbinden wordt voorgelegd. Die identificatie wordt daarna voor SSO gebruikt.
Identifier format, from the DN Expressie waarmee de identificatie wordt opgebouwd uit de onderdelen van de DN van het certificaat (bijvoorbeeld %CN%@%OU%). Alleen zichtbaar als de vorige optie is ingeschakeld.

Een domein van het type ”SAML” configureren

Wanneer een SAML-domein wordt gebruikt, treedt CyberElements op als serviceprovider (SP) en delegeert het de authenticatie aan een externe identiteitsprovider (IdP).

Tabblad: General information

Veld Beschrijving
Identity provider Type identiteitsprovider: Other (elke standaard SAML-IdP) of Azure (Microsoft Azure AD / Entra ID, waarmee bovendien de asynchrone synchronisatie van de groepen wordt ingeschakeld).
Identity provider EntityId Unieke identificatie van de IdP in de SAML-federatie. De waarde ervan wordt door de IdP verstrekt (bijvoorbeeld https://sts.windows.net/{tenant-id}/ bij Azure, https://[serverName]/idp/shibboleth bij Shibboleth).
Group names variable Naam van het SAML-attribuut dat de groepslidmaatschappen van de gebruiker in de assertion draagt (bijvoorbeeld http://schemas.microsoft.com/ws/2008/06/identity/claims/groups bij Azure).
Email variable Naam van het SAML-attribuut waaruit het platform het e-mailadres leest. Veld alleen-lezen: de waarde staat vast op saml-mail en kan niet worden geconfigureerd.
Login variable Naam van het SAML-attribuut dat in CyberElements als aanmeldidentificatie wordt gebruikt (bijvoorbeeld http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name).
The domain is part of cascading authentication Zie de sectie Authenticatie in cascade.
Manual configuration Als dit is aangevinkt, moeten de parameters van de identiteitsprovider handmatig worden ingevoerd (EntityId van de SAML-eindpunten). Als dit niet is aangevinkt, worden die parameters automatisch uit het metadatabestand gehaald. Alleen beschikbaar in de wijzigingsmodus.

Metadata van de identiteitsprovider

De beheerconsole biedt geen scherm voor de uitwisseling van SAML-metadata: dat tabblad hoort bij het SaaS-aanbod. In client hosted worden de metadata van de IdP en die van de serviceprovider handmatig geconfigureerd, in de Shibboleth-configuratiebestanden van de Mediation Controller.


Authenticatie in cascade

Ga naar de pagina algemene opties om de authenticatie in cascade in te schakelen.

Wanneer een gebruiker het portaal bereikt, zoekt het systeem onder de domeinen in cascade naar de domeinen waarvoor authenticatie zonder login en wachtwoord mogelijk is (SAML, Apache, certificaat). Het eerste domein dat de gebruiker herkent, wordt gebruikt. Als geen enkel domein hem zonder wachtwoord kan authenticeren, worden de velden voor login en wachtwoord weergegeven.

Zodra de functie is ingeschakeld, verschijnen er twee knoppen in de lijst met domeinen:

  • Vink ”The domain is part of cascading authentication” aan voor elk gewenst domein.
  • De volgorde kan met de pijlen omhoog en omlaag worden gewijzigd. Volgorde 0 wordt als eerste verwerkt.

Note

Anonieme domeinen en Radius-domeinen, en domeinen die de authenticatie aan een externe server delegeren (CAS), kunnen niet in de authenticatie in cascade worden gebruikt.