> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SSO und SCIM-Provisionierung einrichten

> Verbinden Sie Ihren Identitätsanbieter mit AhaSlides für Single Sign-On, erzwingen Sie SSO für Ihre E-Mail-Domain und provisionieren Sie Mitglieder per SCIM.

Mit Single Sign-On (SSO) melden sich Ihre Teammitglieder über den Identitätsanbieter Ihrer Organisation bei AhaSlides an, statt ein AhaSlides-Passwort zu nutzen. Die SCIM-Provisionierung erstellt und deaktiviert ihre Konten über denselben Anbieter. Nutzen Sie beides zusammen, wenn Ihre IT-Abteilung an einer Stelle steuern soll, wer auf AhaSlides zugreifen kann.

## Vor dem Start mit SSO und SCIM

SSO und SCIM sind nicht in jedem Plan verfügbar. Um sie für Ihr Team hinzuzufügen, kontaktieren Sie uns über das [Enterprise-Formular](https://ahaslides.com/enterprise/) oder unter [hi@ahaslides.com](mailto:hi@ahaslides.com).

In den Teameinstellungen gibt es keinen SSO- oder SCIM-Bildschirm. Sie richten Ihren Identitätsanbieter ein, und unser Team übernimmt für Sie die Seite von AhaSlides:

| Schritt | Sie | AhaSlides |
| - | - | - |
| Identitätsanbieter verbinden | Erstellen Sie die AhaSlides-App in Ihrem Identitätsanbieter und senden Sie uns deren Details | Sendet Ihren Anbieternamen und schaltet SSO für Ihr Team ein |
| E-Mail-Domains verknüpfen | Teilen Sie uns mit, mit welchen Domains sich Ihr Team anmeldet | Verknüpft sie mit Ihrem Team |
| Nur-SSO-Anmeldung verlangen | Bitten Sie uns, sie einzuschalten | Schaltet sie für Ihre verknüpften Domains ein oder aus |
| SCIM-Provisionierung | Geben Sie die SCIM-URL und das Token in Ihrem Identitätsanbieter ein | Erzeugt Ihr SCIM-Token |

Sie benötigen Administratorzugang zu Ihrem Identitätsanbieter und ein [Team](/de/teams-and-enterprise/managing-your-team-members) bei AhaSlides, dem Ihre Mitglieder beitreten.

## Identitätsanbieter verbinden

AhaSlides funktioniert mit jedem SAML-2.0-Identitätsanbieter, etwa Okta, und mit Microsoft Entra ID.

<Steps>
  <Step title="Uns bitten, SSO einzuschalten">
    Kontaktieren Sie uns mit dem Namen Ihres Teams und den E-Mail-Domains, die Sie nutzen. Wir antworten mit Ihrem **Anbieternamen**, einer kurzen Kennung Ihrer Organisation, die in Ihren SSO-Adressen erscheint.
  </Step>

  <Step title="Die AhaSlides-App in Ihrem Identitätsanbieter erstellen">
    Erstellen Sie für einen SAML-2.0-Anbieter eine SAML-App mit diesen Werten:

    | Feld | Wert |
    | - | - |
    | Single-Sign-On-URL (ACS-URL) | `https://presenter.ahaslides.com/p/saml/your-provider-name/login/callback` |
    | Audience-URI (SP-Entity-ID) | Der Wert, den wir Ihnen mit Ihrem Anbieternamen senden |
    | Name-ID | Die E-Mail-Adresse des Nutzers |

    Sie können unsere Metadaten des Dienstanbieters auch unter `https://presenter.ahaslides.com/p/saml/your-provider-name/metadata` herunterladen.

    Registrieren Sie für Microsoft Entra ID stattdessen eine Anwendung. Wir senden Ihnen die Weiterleitungs-URI, die Sie dort hinzufügen.
  </Step>

  <Step title="Uns die Details Ihres Identitätsanbieters senden">
    Senden Sie für SAML die Anmelde-URL des Identitätsanbieters, den Aussteller und das X.509-Signaturzertifikat oder die Metadatendatei, die sie enthält. Sollen Vor- und Nachname übernommen werden, nennen Sie uns die Attribute, die sie enthalten.

    Senden Sie für Microsoft Entra ID die Mandanten-ID, die Client-ID und ein Client-Geheimnis.
  </Step>

  <Step title="Personen zuweisen und testen">
    Weisen Sie die App den Personen zu, die AhaSlides nutzen sollen. Sobald wir bestätigen, dass die Verbindung aktiv ist, testen Sie sie anhand der Schritte unter „Mit SSO anmelden“.
  </Step>
</Steps>

## E-Mail-Domains mit Ihrem Team verknüpfen

SSO funktioniert nur für E-Mail-Adressen einer Domain, die mit Ihrem Team verknüpft ist, und wir verknüpfen diese Domains für Sie. Senden Sie uns jede Domain, mit der sich Ihre Mitglieder anmelden.

* Eine Domain kann nur mit einem Team verknüpft werden.
* Wer eine E-Mail-Adresse auf einer nicht verknüpften Domain hat, kann sich nicht über Ihr SSO anmelden.

## Mit SSO anmelden

<Steps>
  <Step title="Die SSO-Seite öffnen">
    Klicken Sie auf der [AhaSlides-Anmeldeseite](https://presenter.ahaslides.com/pages/login) auf **Anmelden mit SSO** (Log in with SSO).
  </Step>

  <Step title="Ihre Arbeits-E-Mail-Adresse eingeben">
    Geben Sie Ihre E-Mail-Adresse ein und klicken Sie auf **Einloggen** (Log in). AhaSlides leitet Sie zur Anmeldeseite Ihrer Organisation weiter.
  </Step>

  <Step title="Bei Ihrer Organisation anmelden">
    Nach der Anmeldung dort landen Sie in AhaSlides.
  </Step>
</Steps>

Meldet sich jemand zum ersten Mal mit SSO an, erstellt AhaSlides sein Konto, falls er noch keines hat, und fügt ihn Ihrem Team mit der Rolle **Mitglied** (Member) hinzu. Er legt nie ein AhaSlides-Passwort fest.

## SSO für Ihre Domain verlangen

Standardmäßig fügt die SSO-Einrichtung eine Anmeldemöglichkeit hinzu, entfernt aber keine anderen. Wer bereits ein AhaSlides-Passwort hat, kann es weiter nutzen. Muss SSO in Ihrer Organisation der einzige Zugang sein, bitten Sie uns, die Nur-SSO-Anmeldung für Ihre verknüpften Domains einzuschalten. Dafür ist zuerst eine funktionierende SSO-Verbindung nötig.

Ist sie eingeschaltet, sieht jede Person mit einer E-Mail-Adresse auf einer verknüpften Domain Folgendes:

| Wo | Was sie sehen |
| - | - |
| Seiten für Anmeldung, Registrierung und vergessenes Passwort | Ein Fenster mit dem Titel **Ihre Organisation erfordert Single Sign-On (SSO)** (Your organisation requires single sign-on), nachdem sie ihre E-Mail-Adresse eingegeben haben. **Mit SSO fortfahren** (Continue with SSO) führt zur SSO-Seite; **Andere E-Mail-Adresse verwenden** (Use a different email) leert das Feld. |
| Die SSO-Seite | Die Meldung „Your organisation requires single sign-on. Please continue below to sign in.“ mit ausgefüllter E-Mail-Adresse |
| Kontoeinstellungen | Kein Abschnitt **Passwort** (Password), und die E-Mail-Adresse kann nicht bearbeitet werden |

Das gilt für jede Adresse auf der verknüpften Domain, auch für Personen, die Ihrem Team noch nicht beigetreten sind.

## SCIM-Nutzerprovisionierung einrichten

Mit SCIM kann Ihr Identitätsanbieter AhaSlides-Konten für Sie erstellen, aktualisieren und deaktivieren. AhaSlides unterstützt SCIM 2.0 für Nutzer.

<Steps>
  <Step title="Uns um ein SCIM-Token bitten">
    Wir erzeugen das Token und senden es Ihnen. Bewahren Sie es sicher auf: Wir speichern nur einen Hash davon und können es Ihnen nicht noch einmal anzeigen. Haben Sie es verloren oder wurde es womöglich offengelegt, bitten Sie uns um ein neues.
  </Step>

  <Step title="Die Verbindungsdaten in Ihrem Identitätsanbieter eingeben">
    | Einstellung | Wert |
    | - | - |
    | SCIM-Basis-URL | `https://presenter.ahaslides.com/api/scim/v2` |
    | Authentifizierung | Bearer-Token, gesendet als `Authorization: Bearer your-token` |
    | Eindeutige Kennung | `userName` |
  </Step>

  <Step title="Die Nutzerattribute zuordnen">
    Ordnen Sie die unter „Unterstützte SCIM-Attribute“ aufgeführten Attribute zu und schalten Sie dann das Erstellen, Aktualisieren und Deaktivieren von Nutzern ein. Lassen Sie die Passwortsynchronisierung ausgeschaltet.
  </Step>

  <Step title="Nutzer zuweisen">
    Weisen Sie der AhaSlides-App Personen oder Gruppen zu. Ihr Identitätsanbieter erstellt dann deren Konten.
  </Step>
</Steps>

### Unterstützte SCIM-Attribute

| SCIM-Attribut | Verwendung |
| - | - |
| `userName` | Die E-Mail-Adresse des Mitglieds. Sie identifiziert den Nutzer und wird in Kleinbuchstaben gespeichert. |
| `name.givenName`, `name.familyName` | Vor- und Nachname |
| `displayName` | Wird nur dann für den Namen verwendet, wenn `name` nicht gesendet wird: Das erste Wort wird zum Vornamen, der Rest zum Nachnamen |
| `active` | `true` hält das Konto aktiv; `false` deaktiviert es und meldet das Mitglied ab |
| `externalId` | Wird in der Antwort unverändert zurückgegeben |

### Unterstützte SCIM-Operationen

| Methode | Endpunkt | Funktion |
| - | - | - |
| `GET` | `/Users` | Listet die Nutzer Ihres Teams auf. Akzeptiert `filter=userName eq "name@example.com"`, `startIndex` und `count` (standardmäßig 10). |
| `GET` | `/Users/{id}` | Gibt einen Nutzer zurück |
| `POST` | `/Users` | Erstellt einen Nutzer |
| `PATCH` | `/Users/{id}` | Aktualisiert einzelne Attribute, zum Beispiel `active` |
| `PUT` | `/Users/{id}` | Ersetzt die Attribute eines Nutzers |

Gruppen und `DELETE` werden nicht unterstützt. Um jemandem den Zugang zu entziehen, setzen Sie `active` auf `false`; das senden die meisten Identitätsanbieter, wenn Sie die Zuweisung eines Nutzers aufheben.

Ein per SCIM erstellter Nutzer tritt Ihrem Team mit der Rolle **Mitglied** (Member) bei. Gehört die E-Mail-Adresse bereits zu einem AhaSlides-Konto ohne Team, wird dieses Konto Ihrem Team hinzugefügt, statt ein neues zu erstellen.

### Was sich auf Ihrer Teamseite ändert

Solange SCIM eingeschaltet ist, verwalten Sie die Mitgliedschaft in Ihrem Identitätsanbieter. Auf der Teamseite erscheint die Schaltfläche **Einladen** (Invite) nicht mehr, und Mitglieder können ihre eigene E-Mail-Adresse in den Kontoeinstellungen nicht bearbeiten.

## SSO und SCIM: Fehlerbehebung

### Der SCIM-Verbindungstest liefert 401

Das Token fehlt, ist falsch geschrieben oder nicht mehr aktiv. Prüfen Sie, ob es als Bearer-Token ohne Zusätze drumherum gesendet wird. Schlägt es weiterhin fehl, bitten Sie uns um ein neues Token.

### Der Name eines provisionierten Mitglieds ist falsch oder leer

Senden Sie `name.givenName` und `name.familyName`. Wird nur `displayName` gesendet, teilt AhaSlides ihn am ersten Leerzeichen, wodurch Namen mit mehr als zwei Teilen falsch zugeordnet werden.

### Ein Mitglied kann sich nicht mit SSO anmelden

Prüfen Sie, ob das Mitglied in Ihrem Identitätsanbieter der AhaSlides-App zugewiesen ist und seine E-Mail-Domain eine ist, die wir verknüpfen sollten. Haben Sie eine neue Domain hinzugefügt, teilen Sie sie uns mit, damit wir sie verknüpfen.

## Häufig gestellte Fragen

<AccordionGroup>
  <Accordion title="Kann eine E-Mail-Domain mit zwei Teams verknüpft werden?">
    Nein. Jede Domain gehört zu einem einzigen Team, daher melden sich alle dieser Domain im selben Team an.
  </Accordion>

  <Accordion title="Löscht SCIM AhaSlides-Konten?">
    Nein. SCIM deaktiviert ein Konto und meldet das Mitglied ab. Seine Präsentationen bleiben im Konto erhalten.
  </Accordion>

  <Accordion title="Ich nutze SSO und habe mein Passwort vergessen. Was tun?">
    Sie haben kein AhaSlides-Passwort, das Sie zurücksetzen könnten. Melden Sie sich mit **Anmelden mit SSO** (Log in with SSO) an und lesen Sie [Passwort ändern oder zurücksetzen](/de/account-management/change-or-reset-your-password), wie das Zurücksetzen bei SSO-Konten funktioniert.
  </Accordion>
</AccordionGroup>

**Haben Sie eine Frage?**

Wenden Sie sich an unser Support-Team: Wenn Sie angemeldet sind, nutzen Sie die Chat-Blase unten rechts in Ihrem Dashboard, andernfalls [kontaktieren Sie uns hier](https://ahaslides.com/contact-us/) oder schreiben Sie an [hi@ahaslides.com](mailto:hi@ahaslides.com).

Möchten Sie sich mit anderen Nutzern austauschen? Treten Sie der [AhaSlides-Community](https://community.ahaslides.com/) bei, um Tipps zu teilen, Funktionen vorzuschlagen und zu sehen, wie andere ihr Publikum einbinden.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.