ADFS met SAML SSO

Active Directory Federation Services (ADFS) is Microsofts on-premises identiteitsprovider die gefedereerde identiteit en single sign-on over applicaties heen mogelijk maakt. Met SAML SSO geconfigureerd tussen ADFS en Document360 kunnen je teamleden en lezers inloggen bij Document360 met hun bestaande Active Directory-inloggegevens.

Wat je kunt doen met ADFS als je IdP

Voordat je begint

• Je hebt administratieve toegang tot zowel Document360 als je ADFS-server.
• Je hebt eigenaar - of beheerdersrechten in je Document360-project.
• Open Document360 en ADFS in twee aparte browsertabbladen. Je zult tijdens de installatie meerdere keren tussen deze moeten wisselen.

Stap 1: Creëer een trusttrust voor de afhankelijke partij in ADFS

Voeg de applicatie toe in ADFS

1. Log in op de ADFS Management console op je ADFS-server.
2. Navigeer in de ADFS Managementconsole naar Relying Party Trusts.
3. Klik met de rechtermuisknop op Relying Party Trusts en selecteer Voeg Relying Party Trust toe.
4. In de Wizard Toewijding van Afhankelijke Partij Toevoegen kies je Claims aware en klik je op Start.
5. Selecteer Voer handmatig gegevens in over de betrouwende partij en klik op Volgende.
6. Geef een weergavenaam (bijvoorbeeld "Document360 SAML SSO") en klik op Volgende.
7. Klik in de stap Certificaat Configureren op Volgende (je kunt dit overslaan als je geen certificaat gebruikt).
8. Selecteer onder URL configureren ondersteuning inschakelen voor het SAML 2.0 Web SSO-protocol.

Stap 2: Configureer ADFS met parameters van de Document360 Service Provider

Haal de SP-parameters van Document360

1. Open Document360 in een apart tabblad.
2. Ga naar Instellingen () > Gebruikers & machtigingen > Enterprise SSO.
3. Klik op Create SSO.

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

5. In de stap Configure SP wordt een set parameters weergegeven om de SAML-configuratie in ADFS te voltooien.

Voer de Document360-parameters in ADFS in

Voer de Document360-parameters in in de bijbehorende velden in de stappen 'URL en Identifiers configureren ' in ADFS met behulp van de onderstaande mapping.

8. Klik op Volgend en voltooi de resterende stappen in de wizard, zoals het instellen van multi-factor authenticatie indien nodig, en het toestaan van toegang tot de applicatie voor alle gebruikers.
9. Bekijk je instellingen en klik op Volgend om het vertrouwensvertrouwen van de afhankelijke partij toe te voegen.
10. Vink op het laatste scherm het vakje ' Open' de dialoogkaart 'Claim Bewerken ' aan en klik op Sluiten.

Stap 3: Configureer claimregels in ADFS

Claimregels toevoegen

1. Klik in het dialoog 'Claim Regels bewerken ' op 'Regel toevoegen'.
2. Selecteer 'Send LDAP Attributen as Claims' als regeltemplate en klik op Volgende.
3. Geef een naam aan de claimregel (bijvoorbeeld "Send LDAP Attributes").
4. Configureer het volgende:
   • Attribuutopslag: Selecteer Active Directory.
   • Mapping:
     • LDAP-attribuut: User-Principal-Name | Uitgaande claimtype: Naam-ID
     • LDAP-attribuut: E-mailadressen | Uitgaande claimtype: E-mailadressen
     • LDAP-attribuut: Display-Naam | Uitgaande claimtype: Naam
5. Klik op Afmaken om de regel toe te voegen.
6. Klik op Toepassen om je wijzigingen op te slaan en sluit het dialoogvenster.

Stap 4: Voltooi de SSO-configuratie in Document360

Configureer de identiteitsprovider in Document360

1. Ga terug naar het tabblad Document360 dat de stap 'SP configureren ' toont en klik op Volgende om naar de stap 'IdP configureren ' te navigeren.

2. Het veld 'Configure an existing connection' stelt je in staat een SSO-configuratie te erven die SCIM al heeft ingeschakeld van een hoofdproject. Door deze optie te selecteren, wordt de huidige SSO-configuratie het kind en erft automatisch de SCIM-instellingen van het hoofdproject.
3. Voer de bijbehorende waarden in uit je ADFS-configuratie met behulp van de onderstaande mapping.

4. Download het X.509-certificaat van ADFS en upload het naar het SAML-certificaatveld in Document360.

5. Zet de optie 'Allow IdP' initieerde aanmelding aan of uit op basis van je projectbehoeften.
6. Klik op Volgende om door te gaan naar de SCIM-provisioningstap .

Stap 5: Configureer SCIM-provisioning

SCIM-provisioning stelt je in staat om het beheer van de levenscyclus van gebruikers en lezers tussen ADFS en Document360 te automatiseren. Omdat ADFS SCIM niet native ondersteunt, vereist dit een tool van derden of een op maat gemaakte integratie.

Als je geen SCIM-provisioning nodig hebt, sla dan door naar hieronder de opties SSO naam en inlogopties configureren .

Schakel SCIM in in Document360 in

1. Zet de schakelaar SCIM inschakelen aan .

2. Er verschijnt een bevestigingsdialoog. Bekijk de voorwaarden, vink het vakje aan en klik op Akkoord gaan.
3. De parameters die nodig zijn om de SCIM-configuratie te voltooien, worden vervolgens weergegeven.

4. Voer de benodigde parameters van Document360 in de bijbehorende velden in je aangepaste app.

Wijs standaardrollen en groepen toe in Document360

1. In het veld Standaardrol staat de rol standaard op Bijdrager . Je kunt dit wijzigen in het dropdownmenu indien nodig.
2. 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.
3. 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 groep voor lezer automatisch toewijzen.
4. Schakel de timeout van de idle-sessie SSO in indien nodig en stel de time-outduur in (HH:MM).

5. Klik op Aanmaken om de SAML SSO-configuratie te voltooien.

Gebruikers beheren in ADFS

Om lezers te bekijken die via uw ADFS-integratie zijn toegevoegd:

1. Navigeer in Document360 naar Instellingen () > Gebruikers & rechten > Lezers & groepen.
2. Selecteer de lezer om naar hun lezerprofiel te navigeren.

Lezers die via SCIM zijn ingesteld, tonen een SSO-SCIM-badge naast hun naam.

Beheer de toegang tot content van lezers, gebruikers en groepen

De standaard contentrol die aan een nieuwe gebruiker, lezer of groep wordt toegewezen, is gebaseerd op wat is geconfigureerd tijdens de SCIM-provisioning. Rechten worden standaard op Geen gezet, maar kunnen op elk moment worden bijgewerkt.

1. Selecteer de gewenste lezer en klik op Toegang tot inhoud beheren.
2. Kies het gewenste toegangsniveau uit het dropdown en klik op Updaten.

Best practices

• Exporteer het certificaat in Base-64-gecodeerd (. CER) formaat. Het standaard DER-gecodeerde formaat van ADFS wordt niet ondersteund door Document360. Selecteer altijd Base-64-codering bij het exporteren van het X.509-certificaat.
• Gebruik een tool van derden voor SCIM. ADFS ondersteunt SCIM niet van nature tot SCIM. Plan je gebruikersprovisioning-aanpak voordat je SCIM inschakelt in Document360.
• Configureer claimregels zorgvuldig. Zorg ervoor dat alle drie de LDAP-attributentoewijzingen (Naam-ID, E-mailadressen en Naam) correct zijn geconfigureerd. Ontbrekende of onjuiste claims zullen authenticatiefouten veroorzaken.
• Test eerst met één enkele gebruiker. Voordat je SSO naar alle gebruikers uitrolt, test je de configuratie met één gebruiker om te verifiëren dat claim-regels, certificaten en URL's allemaal correct werken.

FAQ