Diese Anleitung ist an IT-Fachpersonal gerichtet. Sie unterstützt die selbstständige Anbindung von Q.wiki an Google Workspace.

Wir empfehlen ausdrücklich die Nutzung von SCIM und OIDC für die Nutzerprovisionierung und Single Sign-On. SCIM provisioniert alle gewählten User "just in case" und ermöglicht so, Nutzern in Q.wiki Inhalte und Berechtigungen zuzuweisen, bevor die Nutzer sich das erste Mal an Q.wiki angemeldet haben. Das ist mit SAML und der "just in time" Provisionierung nicht möglich.

Sie benötigen Key User Rechte um die folgenden Schritte durchzuführen.

Empfehlung und allgemeine Informationen

Limitierungen

Migration vorhandener Topic/LDAP Nutzer

Bei Anbindung von Google Workspace werden bestehende Q.wiki Nutzer Nutzer mit einer übereinstimmenden Email-Adresse migriert. Die migrierten Nutzer werden mit den Daten aus Entra ID aktualisiert und von diesem Zeitpunkt an über dieses verwaltet.

Migrierte Nutzer müssen sich über den Button Unternehmenslogin verwenden anmelden. Die Anmeldung mit Nutzernamen und Passwort ist nicht mehr möglich.

Einrichten eines "Notfall-Kontos"

Sollte die Authentifizierung über Google nicht möglich sein, ist eine Anmeldung nur noch über manuell in Q.wiki angelegte Nutzer möglich. Aus diesem Grund empfiehlt es sich, ein manuell verwaltetes Konto der KeyUser Gruppe hinzuzufügen. Dieses Konto muss über eine valide Email-Adresse verfügen und darf nicht über Google provisioniert werden, eine unpersönliche Email-Adresse wie "service@", "it-support@" bietet sich an. 

Anbinden des Benutrzerverzeichnis - Nutzer und Gruppen (SAML Provisionierung und Authentifizierung)

Zur Einrichtung der SAML Provisionierung und Authentifizierung empfehlen wir diese Anleitung von Google:

https://support.google.com/a/answer/6087519?hl=de#zippy=%2Cschritt-benutzerdefinierte-saml-app-hinzuf%C3%BCgen

Mit eingerichteter SAML Authentifizierung ist die sogenannte Just in Time Provisionierung aktiv. Nutzerkonten werden automatisch in Q.wiki angelegt, wenn sie sich das erste Mal anmelden. Die automatische Provisionierung kann in der Nutzerverwaltung, 3-Punkt Menü, Provisionierung konfigurieren deaktiviert werden:

In der Nutzerverwaltung, 3-Punkt Menü, Identity Prover (IdP) anbinden die SAML Konfiguration aufrufen:

die ACS wird in der IdP Konfiguration benötigt, die Entity ID muss mit der IdP Konfiguration übereinstimmen. Ein guter Wert ist der öffentliche Endpunkt für die SAML Metadaten des Systems unter https://IHREURL.qwikinow.de/saml/sp/metadata.