# Single Sign On (SSO)

## Funktionsprinzip

Die **einmalige Anmeldung**, oft mit dem englischen Kürzel **SSO** (Single Sign-On) bezeichnet, ist eine Methode, die es einem Nutzer ermöglicht, auf mehrere Computeranwendungen (oder gesicherte Websites) zuzugreifen, indem er sich nur einmal authentifiziert.

Das Unternehmen kann **sein eigenes Authentifizierungssystem** anstelle der von Dastra standardmäßig angebotenen lokalen Anmeldung verwenden. Zu den am häufigsten verwendeten SSO-Systemen gehören Microsoft Active Directory, Google Workspace (ehemals GSuite), Auth0 usw.

**Die Funktionsweise ist wie folgt:**

Ein Nutzer (**User Agent**) fordert eine Verbindung beim Dienstanbieter (**Service Provider**) an, der sich an einen Identitätsanbieter (**Identity Provider**) wendet, der den Nutzer authentifiziert. Diese Authentifizierung wird dann an den Dienstanbieter zurückgesendet, der die Verbindungsanfrage des Nutzers akzeptiert.

In unserem Fall ist der User Agent der **Browser eines Dastra-Nutzers**. Der Service Provider ist **Dastra** und der Identity Provider ist Ihr **bevorzugter Authentifizierungsanbieter** (zum Beispiel: Active Directory).

![Funktionsprinzip des SSO unter Verwendung des SAML-2-Protokolls](/files/SVK38jfUqbk7lORdG8Md)

## Einrichtung

Innerhalb eines Dastra-Abonnements haben Sie die Möglichkeit, wenn Sie die Funktionalität abonniert haben, ein oder mehrere SSO-Logins zu verwalten. Um auf die SSO-Konfiguration zuzugreifen, gehen Sie auf [die Konfigurationsseite für SSO-Logins](https://app.dastra.eu/general-settings/sso) im Sicherheits-Tab des Konfigurationspanels des Abonnementkontos.

{% hint style="info" %}
**Achtung**: Sie müssen Inhaber der Organisation sein, um auf diese Seite zugreifen zu können.
{% endhint %}

Dastra bietet zwei Protokolle für die einmalige Anmeldung an: [**SAML 2**](/de/features/settings/single-sign-on-sso/saml-2.md) und [**Open ID**](/de/features/settings/single-sign-on-sso/openid.md). Um auf die Konfigurationshilfe zuzugreifen, klicken Sie auf die folgenden Links.

{% content-ref url="/pages/FzTuK7VNYBVP7iZGTqHy" %}
[SAML 2](/de/features/settings/single-sign-on-sso/saml-2.md)
{% endcontent-ref %}

{% content-ref url="/pages/CmDe8LDToLHPwNe7hrrU" %}
[OpenId](/de/features/settings/single-sign-on-sso/openid.md)
{% endcontent-ref %}

{% content-ref url="/pages/qktRgQq3McV7W87s1uI7" %}
[ADFS](/de/features/settings/single-sign-on-sso/adfs.md)
{% endcontent-ref %}

## Wie aktiviere ich das SSO für alle Nutzer Ihrer Organisation?

### Einrichtung:

* Klicken Sie auf Ihre SSO-Konfiguration
* Aktivieren Sie das Kontrollkästchen „Für alle Nutzer erzwingen"

<figure><img src="/files/q2WmeJWlUBHgyyajWIi6" alt=""><figcaption></figcaption></figure>

### Verwaltung von vom SSO-Login befreiten Nutzern

In bestimmten Fällen möchten Sie **das SSO für bestimmte Nutzer deaktivieren** (zum Beispiel ein Sicherheitsadministrator, ein Dienstkonto, ein Nutzer, der sich nicht in Ihrem Active Directory befindet...). In diesem Fall ist es möglich, spezifische Nutzer anzugeben, die nicht zum SSO-Login Ihrer Organisation weitergeleitet werden. Es wird empfohlen, einen Nutzer mit einem lokalen Dienstkonto zu benennen, um Fehlfunktionen des SSO zu handhaben, beispielsweise bei einem Ausfall des Identitätsanbieters oder einem Konfigurationsproblem.

Diese Nutzer können sich mit **ihrem Passwort** bei der Anwendung anmelden.

Sie können vom SSO befreite Nutzer benennen, indem Sie die Nutzer Ihrer Organisation im folgenden Feld auswählen:

<figure><img src="/files/rLgpoUVbWtvzB2dl78Af" alt=""><figcaption></figcaption></figure>

## Wie aktiviere ich die automatische Nutzerbereitstellung?

Wenn Sie möchten, dass die Nutzer Ihres Identitätsanbieters keine Konten erstellen müssen, um auf die Einheit zuzugreifen, können Sie das Kontrollkästchen „Automatische Nutzerbereitstellung" aktivieren. Wenn Sie Ihren Nutzern eine SSO-Anbieter-URL wie diese bereitstellen:

```
https://account.dastra.eu/account/loginexternal?
provider={id de votre provider}&
returnUrl=https://www.dastra.eu 
```

Sie können diesen Link abrufen, indem Sie auf diese Schaltfläche klicken:<br>

<figure><img src="/files/7HQLlA7KWVnAFw8jroHe" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/jISggxwFJ282Ph1aXw3s" alt=""><figcaption></figcaption></figure>

Im Fall einer validierten Authentifizierung wird automatisch ein Konto in Dastra erstellt und eine Benachrichtigungs-E-Mail wird Ihnen einige Stunden später zugesendet.

Die automatische Bereitstellung funktioniert nur, wenn dieser Link an die Nutzer weitergegeben wird; sie können dies nicht über die klassische Anmeldeseite tun.

{% hint style="warning" %}
Wenn das Konto des Nutzers im Authentifizierungsanbieter gelöscht oder ungültig gemacht wird, wird sein Konto in Dastra nicht gelöscht, er kann sich jedoch nicht mehr anmelden. Sie haben die Möglichkeit, diese Konten [über den Nutzermanager des Abonnements](https://app.dastra.eu/general-settings/users) zu bereinigen.
{% endhint %}

Sie können **die standardmäßig zugewiesene Rolle** für alle mit Ihrem Abonnement verknüpften Organisationen wählen.

![](/files/3hRqtCVCmJoEoJVvMduf)

{% hint style="info" %}
Derzeit unterstützt Dastra nicht das Binding von Rollen über die Eigenschaften des Authentifizierungsservers. Wenn diese Funktionalität wichtig ist, können Sie uns dies über die [Support-Seite](https://app.dastra.eu/general-settings/support) mitteilen.
{% endhint %}

### Team-Binding

Es ist möglich, die Teams eines Mandanten an eine Eigenschaft (Claim) zu binden, die von Ihrem Authentifizierungsserver zurückgegeben wird.

<figure><img src="/files/ozAmJ0TOUek1mrifyFo9" alt=""><figcaption></figcaption></figure>

## Wie verwalte ich die Logins der Nutzer?

Sie können den Login-Typ der Nutzer konfigurieren, indem Sie die [Nutzerverwaltungsseite des Abonnements](https://app.dastra.eu/general-settings/users) aufrufen. Wenn Sie ein Nutzerprofil aufrufen, können Sie den bevorzugten SSO-Login auswählen. Sobald der Nutzer sich mit seiner E-Mail-Adresse bei Dastra anmeldet, wird er automatisch zur Login-Seite des von Ihnen eingerichteten Authentifizierungsanbieters weitergeleitet.

![](/files/lqYu3v8z6wEZZW4I3lLG)

Sie können den Login-Typ auch bei der Einladung neuer Nutzer festlegen.

### Was tun, wenn ich mich nicht per SSO anmelden kann?

Kontaktieren Sie sofort [den Support](/de/getting-started/le-support/faire-une-demande-de-support.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.dastra.eu/de/features/settings/single-sign-on-sso.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
