SAML SSO met Google

Google Workspace is een identiteitsprovider (IdP) waarmee gebruikers met hun Google-inloggegevens bij meerdere applicaties kunnen inloggen. Met SAML SSO geconfigureerd tussen Google Workspace en Document360, kunnen je teamleden en lezers Document360 openen zonder een apart wachtwoord nodig te hebben.

Wat je kunt doen met Google Workspace als je IdP

Voordat je begint

• Je hebt een actief Google Workspace-account met beheerderstoegang. Als je er een moet aanmaken, meld je dan aan op workspace.google.com.
• Je hebt eigenaar - of beheerdersrechten in je Document360-project.
• Open Document360 en Google Workspace in twee aparte browsertabbladen. Je zult tijdens de installatie meerdere keren tussen deze moeten wisselen.

Stap 1: Maak een aangepaste SAML-app aan in Google Workspace

Voeg een aangepaste SAML-app toe

1. Klik op de startpagina van de Google Workspace beheerdersconsole op Apps en selecteer SAML-apps.
2. Klik op App toevoegen en kies in het dropdown op Aangepaste SAML-app toevoegen.
3. Voer in de app-details een naam in voor je app en klik op Doorgaan.

Noteer de IdP-gegevens en download het certificaat

1. Op de volgende pagina vindt u de SSO-URL, Entiteits-ID en het certificaat. Noteer deze details — je hebt ze nodig bij het configureren van de Identity Provider in Document360.
2. Klik in het gedeelte Certificaat op het downloadicoon om het certificaat in .pem formaat op te slaan in je lokale opslag. Je zult dit certificaat later uploaden in Document360.

Schakel de app in voor gebruikers

1. Bij gebruikerstoegang staat de Servicestatus standaard voor iedereen UIT .
2. Zet het op AAN zodat iedereen gebruikers kan authenticeren via deze app.

Na het voltooien van de Google-zijde configuratie zal je SAML-app er als volgt uitzien.

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

Haal de parameters van de Service Provider op van Document360

1. Navigeer in Document360 naar Instellingen () > Gebruikers & machtigingen > SSO-configuratie.
2. Klik op Create SSO.

3. Selecteer op de pagina Kies je identiteitsprovider (IdP) Google als identiteitsprovider.

4. Vanaf de pagina 'Configureer de Service Provider (SP) kopieert u de volgende parameters.

Voer de Document360-parameters in in Google Workspace

1. Schakel over naar het tabblad Google Workspace en plak de Document360-parameters in de Google aangepaste SAML-app met behulp van de onderstaande mapping.

2. Selecteer in Name ID-formaat EMAIL uit het keuzemenu.
3. Selecteer in Naam-ID Basisinformatie > Primaire e-mail.
4. Klik op Doorgaan.

Voeg attributentoewijzingen toe in Google Workspace

1. Voeg gebruikersvelden toe en selecteer deze in Google Directory, en koppel ze vervolgens aan de attributen van dienstverleners met behulp van de onderstaande tabel.

2. Klik elke keer dat je een attribuut toevoegt op Mapping toevoegen .
3. Als je klaar bent, klik dan op Afronden.

Stap 3: Voltooi de SSO-configuratie in Document360

Configureer de identiteitsprovider in Document360

1. Schakel terug naar Document360 op de pagina Configureer de Service Provider (SP) en klik op Volgende om naar de pagina Configureren de Identity Provider (IdP) te gaan.
2. Het veld 'Configure an existing connection' stelt je in staat een reeds aangemaakt SSO-configuratie te erven. Door deze optie te selecteren, wordt de huidige SSO-configuratie als kind ingesteld en kunnen er geen wijzigingen aan worden gedaan. Om meer te weten te komen over Inheritance.

3. Voeg op de pagina 'Configureer de identiteitsprovider (IdP') de informatie toe die je hebt genoteerd op de Google aangepaste SAML-apppagina met behulp van de onderstaande mapping.

4. Zet de schakelaar 'Allow IdP' die inlogen aan of uit op basis van je projectvereisten.

5. Klik op Volgend om naar de SCIM-provisioningpagina te gaan.

SCIM-provisioningpagina

SCIM-provisioning wordt niet ondersteund wanneer Google is geconfigureerd als jouw Identity Provider (IdP) in Document360.

Deze beperking geldt in twee scenario's:

• Bij het instellen van een nieuwe Google IdP-configuratie.
• Wanneer je een bestaande SSO-configuratie hebt geërfd die Google als IdP gebruikt.

Klik op Volgende om naar Meer instellingen te navigeren.

Stap 4: 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 'Inlog' aanpassen de tekst in die je wilt laten zien op de inlogknop die aan gebruikers wordt getoond.
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 provisioneert. Lees meer over de Auto assign reader-groep.
4. Kies of je alle gebruikers of geselecteerde gebruikers uitnodigt met de knoppen bestaande gebruikers en lezers omzetten naar SSO-radioknoppen .

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

De SSO-configuratie gebaseerd op het SAML-protocol is succesvol geconfigureerd met Google Workspace.

Erven van een andere applicatie

Bij het aanmaken van een nieuwe SSO-configuratie in Document360 kun je instellingen erven van een bestaande SSO-verbinding. Dit vereenvoudigt het installatieproces, voorkomt herhaling van configuratiestappen en helpt beheerders tijd te besparen terwijl consistentie tussen de integraties wordt gewaarborgd.

Selecteer op de pagina Configure Identity Provider (IdP) het veld 'Configure an existing connection' en kies de ouderapplicatie van SSO SCIM waarvan je wilt erven. Door deze optie te selecteren, wordt het huidige project aangewezen als het kindproject, waarbij alle relevante eigenschappen van de ouder worden geërfd.

Omdat SCIM-provisioning Google IdP-configuraties niet ondersteunt, kunnen SCIM-instellingen van het hoofdproject niet worden overgenomen.

Terwijl andere SSO-configuratie-instellingen van het hoofdproject worden geërfd, kunnen SCIM-instellingen alleen niet worden overgenomen.

Gebruikers beheren in Google IdP

Omdat SCIM niet wordt ondersteund voor Google IdP, moeten gebruikers en lezers handmatig worden beheerd in Document360.

Om lezers te bekijken die via je Google SAML-app zijn toegevoegd:

1. Ga in Document360 naar Instellingen > Gebruikers & Rechten > Lezers & Groepen.
2. Selecteer een lezer om naar hun lezersprofiel 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 elke 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

• Schakel de app in voor alle gebruikers voordat je SSO test. De status van de Google SAML-app-service staat standaard voor iedereen uit. Verander het voor iedereen op AAN voordat je gebruikers uitnodigt om in te loggen met SSO.
• Bewaar het .pem-certificaat veilig. Download en sla het Google-certificaat op voordat je de configuratie in Document360 voltooit. Je wordt niet gevraagd om het opnieuw te downloaden.
• Gebruik handmatig gebruikersbeheer voor Google IdP. Omdat SCIM niet wordt ondersteund, plan dan hoe je gebruikers toevoegt, bijwerkt en verwijdert in Document360 wanneer je Google als je IdP gebruikt.
• Overweeg Okta of Entra als je SCIM-provisioning nodig hebt. Als geautomatiseerd gebruikerslevenscyclusbeheer een vereiste is, configureer dan SSO met Okta of Microsoft Entra als je identiteitsprovider.

FAQ