Google met SAML SSO

Google Workspace is een Identity Provider (IdP) waarmee gebruikers kunnen inloggen bij meerdere applicaties met hun Google-inloggegevens. 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 — u zult ze nodig hebben bij het configureren van de Identiteitsprovider in Document360.
2. Klik in het gedeelte Certificaat op het download-icoon 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 > Enterprise SSO.
2. Klik op Create SSO.

3. Selecteer in de Choose IdP-stap Google als identiteitsprovider.

4. Kopieer vanuit de stap 'SP configureren ' de benodigde 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 via de stap 'SP configureren ' en klik op Volgende om naar de stap 'IdP configureren ' te gaan.
2. Het veld 'Configure an existing connection' stelt je in staat een reeds gemaakte 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. Voor meer informatie over overerving.

3. Voeg in de stap IdP Configureren de informatie toe die je hebt opgemerkt 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-provisioningstap te navigeren.

SCIM-provisioningstap

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 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 inlogknop 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 inricht. Lees meer over de groep voor lezer automatisch toewijzen.
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 kunt u 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 bij de stap IdP configureren het veld 'Een bestaande verbinding configureren ' en selecteer de ouder SSO SCIM-geschikte applicatie waarvan je wilt erven. Door deze optie te selecteren, wijst je het huidige project aan 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 & machtigingen > 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 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

• Schakel de app voor alle gebruikers in voordat je SSO test. De status van de Google SAML-appservice is standaard UIT voor iedereen. Verander deze voor iedereen op AAN voordat je gebruikers uitnodigt om in te loggen met SSO.
• Sla het .pem-certificaat veilig op. Download en sla het Google-certificaat op voordat je de configuratie in Document360 voltooit. Je wordt niet gevraagd het opnieuw te downloaden.
• Gebruik handmatig gebruikersbeheer voor Google IdP. Aangezien SCIM niet wordt ondersteund, plan dan hoe je gebruikers toevoegt, bijwerkt en verwijdert in Document360 wanneer je Google als 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 identiteitsprovider.

FAQ