Entra met SAML SSO

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 uw gebruikers en lezers inloggen bij Document360 met hun bestaande Microsoft-inloggegevens, zonder een apart wachtwoord nodig te hebben.

Wat je kunt doen met Microsoft Entra als je IdP

Voordat je begint

• Je hebt een actief Microsoft Azure-account met beheerdersrecht. Log in 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 & machtigingen > Enterprise SSO.
3. Klik op Create SSO > SAML.

4. Selecteer Entra ID als je Identity Provider (IdP) om automatisch naar de stap 'SP configureren ' te navigeren.

5. De stap 'SP configureert ' toont de benodigde 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 Volgend om naar de stap IdP Configureren te navigeren.
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 'IdP-geïnitieerde aanmelding toestaan' aan of uit afhankelijk van je projectvereisten. Lees meer over aanmelden met IdP-initiatie.
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 ga door naar hieronder de SSO-naam en inlogopties Configureren .

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 gaan. 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 Beheerdersgegevens 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 in 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 verder te gaan.

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 tekst van de Loginknop de tekst in voor de inlogknop die aan gebruikers wordt weergegeven.
3. Automatisch toewijzen van lezergroep - 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 inricht. Lees meer over de Automatisch toewijzende lezergroep.
4. Schakel de timeout van de idle-sessie SSO in indien nodig en stel de time-outduur in (HH:MM).
5. Kies of je bestaande gebruikers- en lezersaccounts uitnodigt bij SSO.

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

De Enterprise SSO-configuratie in Document360 is succesvol aangemaakt.

Stap 5: 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-galerijapplicatie 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.
• Sla beide geheime tokens veilig op. 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 zal op dat moment falen. Voltooi en sla altijd eerst de Document360 SSO-configuratie op, en ga daarna terug naar Entra om te testen.
• Stel attributentoewijzing in op gebruikersniveau, niet op groepsniveau. Bij het configureren van het userType or-attribuut isTeamAccount moet je het altijd op gebruikersniveau instellen om conflicten te voorkomen voor gebruikers die tot meerdere groepen behoren.
• Stem de idle timeout af op je beveiligingsbeleid. Schakel uit idle SSO user in en stel de duur in die aansluit bij de sessiebeheervereisten van je organisatie.

FAQ