# Single Sign-on (SSO) (/docs/verwalten/sso)

> Anmeldung mit dem Firmenkonto: was PeakPrivacy einrichtet, was Ihre IT bereitstellt, was Sie entscheiden und was sich für Mitarbeitende ändert.

Mit Single Sign-on (SSO) melden sich Ihre Mitarbeitenden mit ihrem Firmenkonto an, zum Beispiel bei Microsoft. Passwörter verwaltet dann Ihr Anmeldedienst (Identity Provider), also das System, in dem Ihre Firmenkonten liegen. PeakPrivacy richtet die Anmeldung gemeinsam mit Ihrer IT ein. Im Admin-Bereich gibt es dafür keinen Schalter.

## Was möglich ist
- Microsoft Entra ID, für Organisationen mit Microsoft 365
- Google, für Organisationen mit Google Workspace
- ein anderer Anmeldedienst mit OpenID Connect, einem verbreiteten Anmeldeverfahren
- LDAP, etwa ein Active Directory

Die Anmeldung mit E-Mail und Passwort kann zusätzlich bestehen bleiben, etwa als Notfallzugang.

> **Bekannte Einschränkung:** SAML und die automatische Kontobereitstellung über SCIM sind nicht verfügbar. **Ausweg:** Nutzen Sie OpenID Connect. Konten können dann bei der ersten Anmeldung entstehen.

## Was Ihre IT bereitstellt
- **Anmeldedienst:** welcher es ist und wer ihn bei Ihnen verwaltet.
- **Mandant und Domains:** Ihren Mandanten im Anmeldedienst und die E-Mail-Domains, die sich anmelden dürfen, zum Beispiel `alpenblick.example`. So kann sich niemand mit einem privaten Konto anmelden.
- **Registrierung von PeakPrivacy:** PeakPrivacy nennt Ihrer IT die Weiterleitungsadresse und die nötigen Angaben. Ihre IT registriert PeakPrivacy im Anmeldedienst und übermittelt die Zugangsdaten auf einem vereinbarten, geschützten Weg, nie im Klartext per E-Mail.
- **Gruppen:** falls Rollen oder Gruppen aus dem Anmeldedienst kommen sollen, die Namen dieser Gruppen oder App-Rollen ([Was Sie entscheiden](/docs/verwalten/sso#entscheiden)). Bei Microsoft Entra ID gibt Ihre IT PeakPrivacy zusätzlich das Recht, die Namen der Gruppen zu lesen.
- **Testkonto und Ansprechperson:** ein Konto für den Test und eine Person in Ihrer IT, die Fragen beantwortet.

## Was Sie entscheiden
| Frage | Empfehlung und Folgen |
|---|---|
| Entstehen Konten bei der ersten Anmeldung? | Ja, mit der Rolle **ausstehend**. Dann [schalten Sie neue Konten selbst frei](/docs/verwalten/benutzer#freischalten). Sonst können sich nur Personen anmelden, deren Konto Sie vorher angelegt haben. Diese Konten muss PeakPrivacy über die E-Mail-Adresse mit dem Firmenkonto verknüpfen. |
| Was geschieht mit bestehenden Konten? | PeakPrivacy kann sie über die E-Mail-Adresse mit dem Firmenkonto verknüpfen. Ohne Verknüpfung scheitert die erste Anmeldung mit dem Firmenkonto. |
| Woher kommen die Rollen? | Empfohlen: Sie vergeben die Rollen in PeakPrivacy. Sonst übernimmt PeakPrivacy sie bei jeder Anmeldung aus Ihrem Anmeldedienst. Sie nennen dann, welche Gruppe oder App-Rolle zu **Benutzer** und welche zu **Moderator** wird. Wer zu keiner passt, erhält bei jeder Anmeldung die Rolle für neue Konten, also **ausstehend**. Änderungen im Admin-Bereich, auch eine Freischaltung oder eine Pause, werden dann bei der nächsten Anmeldung überschrieben. |
| Woher kommen die Gruppen? | Entweder pflegen Sie Gruppen in PeakPrivacy, oder PeakPrivacy übernimmt die Mitgliedschaft bei jeder Anmeldung aus Ihrem Verzeichnis. Im zweiten Fall nimmt jede Anmeldung die Person aus allen Gruppen, die es im Verzeichnis nicht mit genau demselben Namen gibt, auch aus einer Pilotgruppe für Peaki. Was Sie im Tab **Benutzer** einer Gruppe anhaken, gilt nur bis zur nächsten Anmeldung. Für Moderatoren gilt die Übernahme nicht. Ihre Gruppen pflegen Sie in PeakPrivacy. Wählen Sie eine Quelle, nicht beide. |

## Was sich für Ihre Mitarbeitenden ändert
- Auf der Anmeldeseite erscheint eine Schaltfläche, etwa **Microsoft** oder **Google**. Ein Passwort für PeakPrivacy übergeben Sie nicht mehr. Die Adresse des Arbeitsbereichs genügt.
- Passwörter setzt Ihre IT im Anmeldedienst zurück, nicht Sie in PeakPrivacy.
- Bei einem Austritt sperrt Ihre IT das Konto zuerst im Anmeldedienst. Danach setzen Sie es in PeakPrivacy auf **ausstehend** ([Konto löschen](/docs/verwalten/benutzer#loeschen)).
- Die Anmeldung mit dem Firmenkonto verbindet keine [Integration](/docs/verwalten/integrationen) wie den Kalender. Jede Person verbindet ihr Konto selbst unter **Einstellungen** › **Integrationen**.

## Ablauf
1. Sie senden PeakPrivacy Ihre Entscheide und die Ansprechperson ([Anfrage stellen](/docs/anwenden/fehlende-funktion#an-peakprivacy)).

2. PeakPrivacy nennt Ihrer IT die Weiterleitungsadresse. Ihre IT registriert PeakPrivacy und übermittelt die Angaben.

3. PeakPrivacy richtet die Anmeldung ein.

4. Sie melden sich mit dem Testkonto in einem privaten Browserfenster an und prüfen Rolle und Gruppen.

5. Sie informieren Ihre Mitarbeitenden.

Spätere Änderungen, etwa an den Domains oder an der Übernahme von Rollen und Gruppen, nimmt PeakPrivacy auf Ihre Anfrage vor. Testen Sie danach wieder mit dem Testkonto.

## Wenn es nicht klappt
- **Die erste Anmeldung mit dem Firmenkonto scheitert.** Für die Adresse besteht schon ein Konto, das nicht mit dem Firmenkonto verknüpft ist, oder ihre Domain ist nicht freigegeben. Senden Sie PeakPrivacy die Adresse und die Meldung auf dem Bildschirm ([Anfrage stellen](/docs/anwenden/fehlende-funktion#an-peakprivacy)).
- **Die Person sieht **Kontoaktivierung ausstehend**.** [Schalten Sie das Konto frei](/docs/verwalten/benutzer#freischalten). Kommen die Rollen aus dem Anmeldedienst, ordnet Ihre IT die Person dort der Gruppe oder App-Rolle für **Benutzer** zu.
- **Eine Rolle oder Gruppe springt nach der Anmeldung zurück.** Sie kommt aus dem Anmeldedienst. Bitten Sie Ihre IT, sie dort zu ändern.
- **Unter **Einstellungen** › **Konto** steht weiterhin **Passwort ändern**.** Für ein Firmenkonto gilt das nicht. Das Passwort ändert die Person im Anmeldedienst.

## Siehe auch
- [Benutzer einladen, freischalten und entfernen](/docs/verwalten/benutzer)
- [Rollen verstehen](/docs/verwalten/rollen)
- [Gruppen und Berechtigungen](/docs/verwalten/gruppen-und-berechtigungen)
