Hoe Single Sign On (SSO) in te stellen met Microsoft Entra

De functie 'Single Sign On' stelt uw bedrijf in staat een veiligere omgeving te hebben door extra beveiliging te bieden met betrekking tot de toegang tot uw Dalux-projecten. Met deze functie kunt u bepalen hoe de gebruikers van uw organisatie toegang krijgen tot projecten: door hen de keuze te geven of te verplichten SSO te gebruiken.

Dit artikel behandelt hoe u SSO instelt voor uw projecten met Microsoft Login (MS Entra, voorheen AzureAD).

Login moet door zowel Dalux als de organisatie van de klant worden goedgekeurd om gebruikers toe te staan in te loggen met hun Microsoft-login.

Configuratie-opties

Bij het instellen van SSO hebt u verschillende opties om te bepalen hoe het inlogproces er voor de gebruikers van uw organisatie uit moet zien. In ieder geval moet Dalux geregistreerd zijn in Microsoft Entra voordat u Dalux de benodigde informatie voor de installatie kunt verstrekken.

Als u Microsoft Entra-groepen wilt gebruiken om Gebruikersrechten te beheren in Dalux HelpDesk, Operations & Maintenance of BIM & Documentation, zorg ervoor dat u Dalux registreert als 'Multitenant'.

Microsoft-beheerder met Dalux-toegang

1. Dalux schakelt Microsoft-login in voor het klantdomein
2. Een beheerder met de juiste toegang in Microsoft Entra logt in op Dalux. Hier wordt hen gevraagd toegang te verlenen aan alle gebruikers van de organisatie.
3. (Optioneel) Als admintoestemming niet is verleend bij de eerste Microsoft-login naar Dalux, is de Dalux-applicatie te vinden in de 'Applications' van Microsoft Entra. De beheerder kan daar vervolgens toestemming verlenen.
4. Definieer in Dalux het loginbeleid van de organisatie.

Microsoft-beheerder zonder Dalux-toegang

1. Dalux schakelt Microsoft-login in voor het klantdomein
2. De Dalux-beheerder van de organisatie definieert het loginbeleid van de organisatie
3. De Microsoft-beheerder verleent toestemming aan de applicatie in Microsoft Entra's 'Applications'.

Goedkeuringsverzoeken activeren

U kunt beslissen of u toestemming wilt verlenen voor de gebruikers van uw organisatie in het algemeen, of dat een beoordelaar toestemming individueel moet verlenen.

Doe dit door toestemmingsverzoeken in Microsoft Entra in te schakelen en ten minste één beoordelaarstype toe te voegen. Op deze manier, wanneer een gebruiker probeert in te loggen met Microsoft-login, krijgt de gebruiker een formulier voor een goedkeuringsverzoek te zien:

De beoordelaar kan het verzoek voor deze gebruiker vervolgens goedkeuren of weigeren in Microsoft Entra.

Informatie om aan Dalux te verstrekken

Dalux ondersteunt Single-Sign-On (SSO) via OAuth2.0 via Microsoft Entra en Microsoft Graph. Vraag de activering aan door contact op te nemen met uw Dalux-consultant en de volgende informatie te verstrekken:

• SSO-activering: laat uw consultant weten dat u SSO voor uw organisatie wilt activeren.
• Domeinen: Geef de domeinen op waarvoor u SSO wilt activeren en verstrek het DNS TXT-record voor Dalux (DALUX=COXXXXXX) om Dalux te laten identificeren als de beheerder van het geregistreerde domein.
• Naam van uw organisatie in Dalux (Bedrijfsprofiel)

Loginbeleid beheren

U kunt specificeren hoe de gebruikers van uw organisatie kunnen inloggen op Dalux. Het is mogelijk een domein te configureren als 'uitsluitend SSO', wat betekent dat gebruikers die geregistreerd zijn met een e-mail van dat domein alleen toegang tot Dalux krijgen na succesvolle authenticatie door AD. Dit voorkomt dat gebruikers aparte wachtwoorden hebben in Dalux.

U regelt deze optie in de volgende instellingen. Voor Field, Box, Tender of Handover, ga naar

Bedrijfsprofielen Selecteer uw bedrijf Instellingen 'Beheerde domeinen'

Selecteer een domein dat is verbonden met uw organisatie en kies het 'Loginbeleid'.

• Require AD: Vereist dat gebruikers inloggen met hun Microsoft-login
• Both AD and DaluxID: Gebruikers kunnen kiezen om in te loggen met Microsoft-login of hun Dalux-account.

Voor HelpDesk, Operations & Onderhoud, of BIM & Documentatie: neem contact op met uw lokale CSM.

Gebruikersbeheer in Dalux FM met Entra

Gebruikersrechten beheren

Dalux FM stelt u in staat uw Dalux-gebruikersgroepen te beheren met groepen vanuit Microsoft Entra. Hiermee kunt u gebruikersrechten in uw AD beheren, die met Dalux worden gesynchroniseerd.

Zorg ervoor dat uw gebruikersgroepen in Dalux FM correct zijn ingesteld en ga naar

InstellingenIntegratiesAzure AD

Kopieer de 'Client Id' en 'Tenant Id' uit Microsoft Entra en voer de 'Client Secret' in het geopende venster in, klik vervolgens op 'Opslaan'. Pas na het opslaan zal de service proberen verbinding te maken. Als de verbinding succesvol is, verschijnen de daadwerkelijke mappingsopties voor Microsoft-groepen, Dalux-groepen en regio's.

Het mappen van uw AD-groepen met gebruikersgroepen en gebruikersregio's maakt het mogelijk dat een AD-groep wordt gekoppeld aan één Dalux-gebruikersgroep en regio. Het staat niet toe om te koppelen aan meerdere combinaties. U kunt meerdere AD-groepen koppelen aan dezelfde Dalux-gebruikersgroep en regio.

Wanneer u de naam van de AD-groep invoert, kunt u op 'Validate' klikken om ervoor te zorgen dat Dalux de groep in uw directory vindt.

Nieuwe Dalux-gebruikersgroepen of AD-groepen worden onmiddellijk weergegeven en kunnen worden gekoppeld; synchronisatie wordt elke nacht uitgevoerd, dus wijzigingen zijn na een dag zichtbaar in Dalux.

Gebruikersinformatie bijwerken

Wanneer een gebruiker zich authenticeert via Microsoft Entra, kan het lokale Dalux-gebruikersprofiel worden bijgewerkt met de volgende waarden uit de Microsoft Graph API (user.read):

• Gebruiker.email -> E-mail
• Gebruiker.givenName -> Naam
• Gebruiker.achternaam -> Naam
• Gebruiker.companyName -> Bedrijf
• Gebruiker.mobilePhone -> Telefoon

Deze gegevens in Dalux worden overschreven door invoer in uw directory. Als de waarde in uw directory leeg is, blijft de data in Dalux behouden.