Dokumentation

SSO

Mit SSO melden sich Mitarbeitende über den Identity Provider der Firma an statt mit einem eigenen Gearventory-Passwort. Gearventory spricht dafür OpenID Connect, also praktisch jeden gängigen Anbieter: Microsoft Entra ID, Google Workspace, Keycloak, Auth0 und Vergleichbares.

Was du brauchst

Vom IdP die Issuer-URL (bei Entra ID zum Beispiel https://login.microsoftonline.com/{tenant-id}/v2.0), eine Client-ID und ein Client-Secret.

Beim IdP muss außerdem genau die Redirect-URI hinterlegt sein, die in den SSO-Einstellungen steht:

https://api.gearventory.de/api/auth/sso/callback/tenant-<workspace-id>

Stimmt sie nicht, läuft der Login bis zum IdP durch und scheitert erst auf dem Rückweg. Die Workspace-ID ist fest, ein zweiter Workspace braucht deshalb eine eigene Redirect-URI und je nach IdP einen eigenen Client.

Einrichten

  1. Einstellungen → Erweiterungen → Integrationen → Unternehmens-SSO öffnen.
  2. Issuer-URL, Client-ID und Client-Secret eintragen.
  3. Die E-Mail-Domains ergänzen, für die SSO gelten soll, kommagetrennt: firma.de, firma.com. Nur wer eine Adresse mit einer dieser Domains eingibt, wird zum IdP geschickt.
  4. Speichern, dann den Schalter umlegen. Solange Pflichtangaben fehlen, bleibt er gesperrt.

Häufige Fragen

Was ist mit Leuten außerhalb der Firmen-Domain? Die melden sich weiter ganz normal mit E-Mail und Passwort an, etwa Aushilfen mit privater Adresse.

Muss ich das Secret jedes Mal neu eingeben? Nein. Es bleibt gespeichert. Lässt du das Feld beim nächsten Speichern leer, ändert sich daran nichts.

Was passiert, wenn ich SSO wieder ausschalte? Dann melden sich alle wieder mit Passwort an. Die IdP-Daten bleiben hinterlegt, du musst sie beim nächsten Versuch nicht neu eintippen.