Hoe Microsoft Entra ID (Azure AD) App-rollen & SAML-claims voor EloView SSO te configureren

Doelgroep: Publiek / Elo Klanten, Cloud Identiteit Architecten & IT Beheerders

Artikeltype: Single Sign-On (SSO) & Cloud Identiteit Configuratiehandleiding

Deze uitgebreide handleiding beschrijft hoe u aangepaste App-rollen in Microsoft Entra ID (voorheen Azure Active Directory) kunt maken, ze kunt koppelen aan directory-gebruikers en -groepen, en ze kunt doorgeven als SAML-tokenclaims naar EloView® voor rolgebaseerde toegangscontrole (RBAC).

Architectuur: App-rollen vs. Beveiligingsgroepen

Begrijp hoe Entra ID applicatieniveau rechten beheert in vergelijking met directory-brede beveiligingsgroepen:

Voorbeeld roltoewijzingen voor EloView

Maak aangepaste beveiligingsrollen in EloView die aansluiten bij uw organisatorische teams:

Stap 1: Declareer App-rollen in Azure App-registraties

1. Meld u aan bij het Azure-portaal (of Microsoft Entra-admincentrum).
2. Navigeer naar Azure Active Directory (Microsoft Entra ID) > App-registraties.

3. Selecteer uw geregistreerde EloView-toepassing.

   

4. Klik in het linkermenu onder Beheren op App-rollen, selecteer vervolgens App-rol maken.

   

5. Configureer in het App-rol maken paneel de rolparameters:

   • Weergavenaam: Kan spaties bevatten (bijv. EloView Admins).
   • Toegestane lidtypen: Selecteer Gebruikers/Groepen.
   • Waarde: Exacte rol-token string — mag geen spaties bevatten (bijv. EloView_Admins).
   • Omschrijving: Interne administratieve beschrijving.

   

6. Klik op Toepassen om de rol op te slaan en herhaal dit voor alle vereiste EloView-rollen.

   

Stap 2: Wijs Gebruikers en Groepen toe aan App-rollen

1. Navigeer in het Azure-portaal naar Enterprise-applicaties > Alle applicaties en selecteer uw EloView Enterprise App.

   

2. Onder Beheren, klik op Gebruikers en groepen, selecteer vervolgens Gebruiker/groep toevoegen.

   

3. Selecteer de doel Gebruiker of Groep, klik vervolgens op Selecteer een rol om de bijbehorende App-rol toe te wijzen (bijv. EloView_Admins).

   

4. Klik op Selecteren, klik vervolgens op Toewijzen. Herhaal dit voor alle resterende gebruikers en beveiligingsgroepen.

Stap 3: Koppel de SAML-rolclaim in Single Sign-On

1. Onder uw Enterprise-applicatie, navigeer naar Beheren > Single sign-on (SAML).

2. Klik in de sectie Attributen & Claims op Bewerken.

   

3. Klik op Nieuwe claim toevoegen en configureer de volgende parameters:

   • Naam: roles (Hoofdlettergevoelig: Moet strikt kleine letters zijn zonder namespace)
   • Bron: Attribuut
   • Bronattribuut: user.assignedroles
   
4. Klik op Opslaan.

Stap 4: Test SSO & Verifieer Token-uitgifte

1. Test SAML-token in Azure: Gebruik de Test Single Sign-On tool in Azure om de uitgegeven SAML-assertie te inspecteren. Bevestig dat het attribuut verschijnt met uw geconfigureerde rol:

   roles = EloView_Admins

   

2. Verifieer Roltoewijzing in Portaal: Log in op het EloView-portaal via SSO en verifieer dat de actieve sessie van de gebruiker de toegewezen rol weerspiegelt (bijv. (SAMLUser)EloView_Admins).