SAML SSO met Entra

Microsoft Entra ID is Microsofts cloudgebaseerde identiteits- en toegangsbeheerdienst, voorheen bekend als Azure Active Directory. Met SAML SSO geconfigureerd tussen Microsoft Entra en Document360 kunnen je gebruikers en lezers inloggen op Document360 met hun bestaande Microsoft-inloggegevens, zonder dat je een apart wachtwoord nodig hebt.

Wat je kunt doen met Microsoft Entra als je IdP

Voordat je begint

• Je hebt een actief Microsoft Azure-account met beheerdersrecht. Inloggen op entra.microsoft.com.
• Je hebt eigenaar - of beheerdersrechten in je Document360-project.
• Open Document360 en Microsoft Entra in twee aparte browsertabbladen. Je zult tijdens de installatie meerdere keren tussen deze moeten wisselen.

Stap 1: Maak een SAML-applicatie aan in Microsoft Entra

Log in op Microsoft Entra

1. Log in op je Microsoft Azure-account op entra.microsoft.com.
2. Je wordt doorverwezen naar de Microsoft Entra beheercentrumpagina .

Maak de applicatie aan

1. Selecteer in het Microsoft Entra beheercentrum de Entra ID in de linker navigatiebalk en klik op Enterprise-apps.
2. Klik op de pagina Enterprise-applicaties op Nieuwe applicatie > Maak je eigen applicatie.
3. Voer een naam van je applicatie in het veld Invoernaam in en klik op Aanmaken.

Stap 2: Configureer SAML in Entra met behulp van Document360-parameters

Haal de parameters van de Service Provider op van Document360

1. Open Document360 in een apart tabblad.
2. Navigeer naar Instellingen > Gebruikers & Rechten > SSO-configuratie.
3. Klik op Create SSO.

4. Selecteer Entra ID als je Identity Provider (IdP) om automatisch naar de pagina 'Configureer the Service Provider, SP) te navigeren.

5. De pagina Configureer the Service Provider (SP) toont de vereiste parameters om je SAML-integratie in de Identity Provider te configureren.

Configureer SAML in Entra

1. Ga naar Microsoft Entra, en open op de pagina 'aangemaakt applicaties' het tabblad Single sign-on en selecteer de SAML-methode .

2. Klik op Bewerken in de sectie Basis SAML-configuratie en voer de parameters in uit Document360 zoals hieronder weergegeven.

3. Klik op Opslaan.

Stap 3: Voltooi de SSO-configuratie in Document360

Configureer de identiteitsprovider in Document360

1. Ga terug naar Document360 en klik op Volgende om naar de pagina Configureer de Identiteitsprovider (IdP) te gaan.
2. Als je al een bestaande SSO-configuratie hebt, kun je deze selecteren in het dropdown 'Configureer een bestaande verbinding ' om de instellingen te erven. Dit voorkomt redundante opstelling en bespaart tijd.

3. Vul de vereiste velden in met behulp van de parameters die te vinden zijn in het Set up Document360 SCIM SSO gedeelte van de Entra-pagina, zoals hieronder weergegeven.

4. Download het certificaat (Base64) in de sectie SAML-certificaten en voeg het toe aan het SAML-certificaatveld in Document360.

5. Zet de optie 'Allow IdP'-initiatief aanmelden aan of uit afhankelijk van je projecteisen. Lees meer over IdP-geïnitieerde aanmeldingen.
6. Klik op Volgende om door te gaan naar de SCIM-provisioningpagina .

Stap 4: Configureer SCIM-provisioning

SCIM-provisioning automatiseert het beheer van de levenscyclus van gebruikers en lezers tussen Microsoft Entra en Document360. Wanneer ingeschakeld, worden gebruikers die in Entra zijn toegevoegd, bijgewerkt of gedeactiveerd automatisch gesynchroniseerd met Document360.

Als je geen SCIM-provisioning nodig hebt, klik dan op Volgende en volg de stappen uit Stap 5: Meer instellingen.

Schakel SCIM in in Document360 in

1. Zet op de SCIM-provisioningpagina in Document360 de schakelaar SCIM inschakelen .
2. Er verschijnt een bevestigingsdialoog. Lees de voorwaarden en klik op Akkoord. Vervolgens wordt een set parameters weergegeven.

Configureer SCIM-provisioning in Entra

1. Ga naar Entra, selecteer het tabblad Provisioning in het linkermenu en kies vervolgens Nieuwe configuratie in het bovenste menu.

2. De pagina Nieuwe provisioningconfiguratie wordt weergegeven. Vul de velden in het gedeelte Beheerdersreferenties in met de parameters uit Document360 zoals hieronder weergegeven.

Stel standaardrollen en groepen in in Document360

1. Ga terug naar Document360 en zet de schakelaar groepssynchronisatie inschakelen . Wanneer ingeschakeld, worden gebruikers en lezersgroepen automatisch toegewezen op basis van IdP-groepsmapping.
2. In het veld Standaardrol staat de rol standaard op Bijdrager . Je kunt dit wijzigen via het dropdownmenu indien nodig.

3. Selecteer in de velden Gebruikersgroepen en Lezergroepen de groepen die je wilt toevoegen. Meerdere groepen kunnen worden toegevoegd, en ze erven de standaardrol die je eerder hebt gekozen.
4. Klik op Volgende om naar de pagina Meer-instellingen te gaan.

Stap 5: Meer instellingen

Configureer SSO-naam en inlogopties

1. Voer in het veld voor de SSO-naam een naam in voor de SSO-configuratie.
2. Voer in de knop 'Inlogen aanpas' de tekst in voor de inlogknop die aan gebruikers wordt weergegeven.
3. Auto assign reader group - deze optie is alleen beschikbaar voor bestaande SSO-configuraties. Voor nieuw aangemaakte SSO-configuraties wordt deze schakelaar niet weergegeven omdat SCIM automatisch gebruikers en groepen provisioneert. Lees meer over de Auto assign reader-groep.
4. Schakel de uitloggende SSO-gebruiker in indien nodig en stel de duurder inactiviteit in.
5. Kies of je bestaande gebruikers- en lezersaccounts uitnodigt bij SSO.

6. Klik op Aanmaken om de SSO-configuratie te voltooien.

De SSO-configuratie in Document360 wordt succesvol aangemaakt.

Stap 6: Voltooi de SCIM-provisioning in Entra

Test en sla de SCIM-verbinding op

1. Ga terug naar Entra, waar de pagina Nieuwe provisioning configuratie wordt weergegeven.
2. Zodra alle vereiste velden zijn ingevuld, klik je op Testverbinding om de configuratie te verifiëren.

3. Er verschijnt een bevestigingsbericht zodra de SCIM-provisioningverbinding tussen Entra en Document360 succesvol is.
4. Klik op Aanmaken om de configuratie te voltooien.

De SCIM-provisioning tussen Entra en Document360 is met succes gecreëerd.

Best practices

• Maak een niet-galerij applicatie aan. Gebruik altijd de optie 'Integreer elke andere applicatie die je niet vindt in de galerij '-optie bij het maken van je Entra-applicatie. Galerij-apps ondersteunen geen aangepaste SCIM-provisioning.
• Bewaar beide geheime tokens veilig. Behandel de primaire en secundaire SCIM-tokens als wachtwoorden. Sla ze op in een secrets manager of wachtwoordkluis, niet in platte tekstbestanden of coderepositories.
• Test de SCIM-verbinding niet voordat je de Document360-configuratie hebt opgeslagen. De test faalt op dat moment. Voltooi en sla altijd eerst de Document360 SSO-configuratie op, en ga daarna terug naar Entra om te testen.
• Stel attributenmapping in op gebruikersniveau, niet op groepsniveau. Stel bij het configureren van het userType or-attribuut isTeamAccount altijd op gebruikersniveau in om conflicten te voorkomen voor gebruikers die tot meerdere groepen behoren.
• Stem de idle time-out af op je beveiligingsbeleid. Schakel de uitloggende SSO-gebruiker in en stel de duur in die aansluit bij de sessiebeheervereisten van uw organisatie.

FAQ