> ## Documentation Index > Fetch the complete documentation index at: https://docs.cocoondata.com/llms.txt > Use this file to discover all available pages before exploring further. # Konfiguration der Einzelanmeldung über einen IdP Ein Covata-Plattform-Administrator kann einen externen IdP-Service (Identitätsanbieter) konfigurieren, der über die SAML (Security Assertion Markup Language) 2.0 mit der betreffenden Covata-Plattform-Instanz interagiert. (Beachten Sie, dass die Covata-Plattform SAML Version 1.0 nicht unterstützt.) Sobald diese Konfiguration erfolgreich aufgebaut wurde, kann die Covata-Plattform die Authentifizierung der [Covata-Benutzer](/2.16/de/admin/administering-users.md) über eine separate URL an diesen IdP-Service delegieren und so über die Covata-Plattform Unterstützung für Einzelanmeldung (single sign-on) bieten. Wenn sich ein Benutzer gegenüber dem IdP-Service der Covata-Plattform erfolgreich authentifiziert hat, gibt der IdP der Covata-Plattform automatisch einen SAML-Token zurück (der den betreffenden Benutzer repräsentiert), und diese tauscht den SAML-Token gegen einen Zugriffs-/Aktualisierungs-Token. Für die Konfiguration eines IdP-Service auf der Covata-Plattform wird Folgendes *benötigt*: * eine **IdP-Metadaten-Datei** - dies ist eine XML-Datei gemäß dem [SAML-Standard](http://saml.xml.org/saml-specifications), die Sie von Ihrem IdP-Service erhalten; sie enthält Konfigurationsdaten, die Drittanbieterdiensten (wie der Covata-Plattform) die Interaktion mit dem IdP-Service selbst ermöglichen. * das **E-Mail-Feld des IdP** - Covata-Benutzer-Accounts (auf der Covata-Plattform) werden mit diesem Benutzerfeld des IdP-Service abgeglichen. Beachten Sie bitte, dass die Konfigurationsinformationen für dieses Feld eventuell nicht Bestandteil der IdP-Metadaten-Datei bilden. * ein **privater Schlüssel** und ein **öffentliches X.509-Zertifikat** (für die **Covata-Plattform**) - dieses X.509-Zertifikat wird (manuell oder automatisch) an den IdP-Service hochgeladen, der es dann für die sichere Kommunikation mit der Covata-Plattform nutzt. \ **Hinweis:** Die IdP-Metadaten-Datei enthält auch ein öffentliches X.509-Zertifikat für den IdP-Service, das die Covata-Plattform für die sichere Kommunikation mit dem IdP-Service nutzt. > [!WARNING] > > Der Zugriffsdienst der Covata-Plattform unterstützt *keine* Erstellung von Benutzern auf einem IdP-Service. Benutzer auf einem IdP-Service müssen derzeit direkt über den IdP selbst hinzugefügt oder aktualisiert werden (z. B. über einen LDAP-Server). Für auf der Covata-Plattform direkt hinzugefügte Covata-Benutzer-Accounts, ob: > > * [manuell](/2.16/de/admin/administering-users.md#adding-a-new-user) als [lokaler](/2.16/de/admin/administering-users.md#account-type) Benutzer-Account oder > * automatisch von der Covata-Plattform als Benutzer mit [Ad-hoc-Rolle](/2.16/de/admin/administering-users.md#adhoc-role) (und dem Account-Typ [Extern](/2.16/de/admin/administering-users.md#account-type)), > > gilt jedoch, dass sie dem IdP-Service *nicht automatisch hinzugefügt werden*. > > Ist daher ein konfigurierter IdP-Service auf der Covata-Plattform aktiviert, können sich die betreffenden Benutzer nur über die eigene Anmelde-URL der Covata-Plattform authentifizieren (und nicht über die URL der Covata-Plattform für die Einzelanmeldung, die die Authentifizierung an den IdP-Service delegiert). > > Haben jedoch die betreffenden Covata-Benutzer anschließend einen äquivalenten, direkt beim IdP-Service angelegten Account (d. h. mit derselben E-Mail-Adresse), können sie die URL der Covata-Plattform für die Einzelanmeldung nutzen. ![IdP/SAML-Seite](https://mintcdn.com/cocoondata/_MzKWwAlmVvZNHNz/images/d4844b0f3d18-saml-page.png?fit=max\&auto=format\&n=_MzKWwAlmVvZNHNz\&q=85\&s=db3533ac0c4dd0acb60bf829a17facc5) ## Konfiguration eines IdP-Service Die Seite **SAML** der Covata-Verwaltung (oben) ermöglicht Folgendes: * [Hinzufügen einer IdP-Service-Konfiguration](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md#adding-an-idp-service-configuration) zur Covata-Plattform-Instanz * [Bearbeitung](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md#editing-the-idp-service-configuration) einer bestehenden IdP-Service-Konfiguration * [Deaktivierung oder Reaktivierung](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md#disabling-or-re-enabling-the-idp-service-configuration) einer bestehenden IdP-Service-Konfiguration ### Hinzufügen einer IdP-Service-Konfiguration **Hinzufügen einer IdP-Servicekonfiguration zur Covata-Plattform:** 1. [Melden Sie sich](/2.16/de/admin/accessing-administration.md#signing-in) bei der Covata-Verwaltung an. 2. Klicken Sie auf die Option **SAML** links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface), um die Seite **SAML** aufzurufen. 3. Klicken Sie auf die Schaltfläche **IdP-Konfiguration hinzufügen**. 4. Füllen Sie im Dialogfeld **IdP-Konfiguration hinzufügen** die in der [Tabelle](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md#idp-service-configuration-fields) (unten) beschriebenen Felder für die Konfiguration des IdP-Service aus. 5. Klicken Sie auf **Speichern**, und die IdP-Service-Konfiguration erscheint auf der Seite **SAML**. \ **Hinweise:** * Sobald der IdP-Service erfolgreich konfiguriert wurde, können sich Benutzer dem IdP-Service gegenüber authentifizieren, indem sie im URL-Feld ihres Browsers die Basis-URL Ihrer Instanz der Safe Share-Webanwendung angeben (die auch die URL der Covata-Plattform ist), gefolgt von `/sso` (für Einzelanmeldung), also z. B.: \ `https://safe-share.xy-firma.de/sso` * Wenn Covata-Benutzer in der Lage sein sollen, sich vom IdP-Service abzumelden, vergewissern Sie sich, dass der Service entsprechend konfiguriert ist und dass den betreffenden Benutzern gegebenenfalls ausreichende Informationen zur Verfügung gestellt werden, wie sie sich vom IdP abmelden. Andernfalls bleiben die Benutzer bei der Safe Share-Webanwendung angemeldet, wenn sie die URL für die Einzelanmeldung (oben) erneut besuchen und dann auf die Schaltfläche **Einzelanmeldung** klicken. * Es kann nur eine IdP-Service-Konfiguration hinzugefügt werden, die dann wie im Folgenden beschrieben bearbeitet werden kann. ### Bearbeitung der IdP-Service-Konfiguration 1. [Melden Sie sich](/2.16/de/admin/accessing-administration.md#signing-in) bei der Covata-Verwaltung an. 2. Klicken Sie auf die Option **SAML** links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface), um die Seite **SAML** aufzurufen. 3. Klicken Sie auf den Link **IdP-Konfiguration bearbeiten**. 4. Ändern Sie im Dialogfeld **IdP-Konfiguration bearbeiten** die in der [Tabelle](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md#idp-service-configuration-fields) (unten) beschriebenen Felder für die Konfiguration des IdP-Service. 5. Klicken Sie auf **Speichern**, und die IdP-Service-Konfiguration wird aktualisiert. Die folgende Tabelle beschreibt alle für IdP relevanten Felder, die die Covata-Plattform benötigt, um eine erfolgreiche Verbindung zu einem LDAP-Server/-Benutzerverzeichnis herzustellen. | Feld | Beschreibung | | - | - | | Zeitunterschiedspuffer | Der maximal zulässige Zeitunterschied (in Sekunden) zwischen den Uhren des IdP-Service (Identitätsanbieter) und dem Zugriffsdienst der Covata-Plattform. Es wird davon ausgegangen, dass zwischen den Server-Uhren des IdP-Service und des Zugriffsdienstes ein inhärenter Zeitunterschied besteht. Für die Definition der **Gültigkeit der SAML-Sitzung** unten (zu der der Wert dieses **Zeitunterschiedspuffers** addiert wird) muss daher der zwischen dem IdP-Service und dem Zugriffsdienst maximal zulässige Zeitunterschied festgelegt werden. | | Gültigkeit der SAML-Sitzung | Die SAML-Sitzung (d. h. vom IdP-Service ausgegebene Asssertions) bleibt diese Anzahl Sekunden lang gültig. Nach der erfolgreichen Authentifizierung eines Benutzers beim IdP-Service erstellt der IdP-Service eine *Assertion*, die im Allgemeinen im Zwischenspeicher abgelegt und anschließend allen entsprechenden, mit Einzelanmeldung arbeitenden Serviceanbietern (zu denen auch der Zugriffsdienst der Covata-Plattform zählt) zur Verfügung gestellt wird. Diese Assertion enthält im Allgemeinen Folgendes: • den ([oben](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md) beschriebenen) SAML-Token selbst, der für den authentifizierten Benutzer steht • eine *Erstellungszeit*, die angibt, wann der IdP-Service die Assertion erstellt hat. Auf Anforderung des Zugriffsdienstes sendet der IdP-Service seine (im Zwischenspeicher abgelegte) Assertion (mit dem SAML-Token) dem Zugriffsdienst, wenn der Zugriffs-Token (und Aktualisierungs-Token) des Covata-Benutzers abläuft - für weitere Informationen über die Gültigkeitsdauer von Zugriffs-/Aktualisierungs-Token siehe die [Tabelle](/2.16/de/admin/configuring-client-applications.md#client-application-fields) zur [Konfiguration von Client-Anwendungen](/2.16/de/admin/configuring-client-applications.md). Dieser SAML-Token überschreibt daher effektiv die Gültigkeitsdauer von Zugriffs-/Aktualisierungs-Token (da ein gültiger SAML-Token vom Zugriffsdienst gegen einen neuen Zugriffs-/Aktualisierungs-Token ausgetauscht wird). Die *gesamte Gültigkeit der SAML-Sitzung* wird als die Summe aus dem Wert für die **Gültigkeit der SAML-Sitzung** und dem Wert für den **Zeitunterschiedspuffer** oben berechnet. Ist der Zeitunterschied zwischen der aktuellen Zeit des Zugriffsdienstes und der *Erstellungszeit* der Assertion im Zwischenspeicher größer als diese *gesamte Gültigkeit der SAML-Sitzung*, lehnt die Covata-Plattform die betreffende Assertion des IdP-Service (und ihren SAML-Token) ab. Der Benutzer muss sich in diesem Fall gegenüber dem IdP-Service erneut authentifizieren (und der Service muss eine neue Assertion mit einer neuen Erstellungszeit anlegen). **Hinweise:** • Definieren Sie eine optimale **Gültigkeit der SAML-Sitzung**, die für die anderen Serviceanbieter, die den konfigurierten IdP-Service nutzen, geeignet ist: • Wird dieser Wert zu hoch angesetzt, kann dies das Risiko erhöhen, dass die Sitzung eines Benutzers auf der Covata-Plattform kompromittiert wird. • Wird dieser Wert zu gering angesetzt, können Benutzer zu häufig gezwungen werden, sich beim IdP-Service erneut zu authentifizieren, was die Nutzung dieses IdP-Service durch andere Serviceanbieter beeinträchtigen kann. • Beachten Sie, dass alle Benutzer-Sitzungen mit gültigen Zugriffs-/Aktualisierungs-Token offen bleiben, wenn die Covata-Plattform eine Assertion eines IdP-Service (aufgrund einer Überschreitung der *gesamten Gültigkeit der SAML-Sitzung*) abgelehnt hat, sofern sich Benutzer nicht abmelden oder ihre [Token/Sitzungen ablaufen gelassen werden](/2.16/de/admin/administering-users.md#expiring-users-tokens-sessions). | | Feld IdP-E-Mail | Der Name des IdP-Metadatenfelds, das den E-Mail-Adressen der Benutzer entspricht **Hinweis:** Definiert eine IdP-Metadaten-Datei ihr E-Mail-Feld in dieser Datei, überschreibt der in diesem **Feld IdP-E-Mail** angegebene Wert den Wert in der IdP-Metadaten-Datei. | | IdP-Metadaten-Datei | Gibt an, ob die IdP-Metadaten-Datei auf die Covata-Plattform hochgeladen und dort konfiguriert wurde. Diese Datei bildet eine der ([oben](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md) beschriebenen) Anforderungen für die Konfiguration eines IdP-Service auf der Covata-Plattform. **Hochladen the IdP-Metadaten-Datei:** • [Melden Sie sich](/2.16/de/admin/accessing-administration.md#signing-in) bei der Covata-Verwaltung an. • Klicken Sie auf die Option **SAML** links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface), um die Seite **SAML** aufzurufen. • Klicken Sie auf die Schaltfläche **IdP-Metadaten hochladen**. • Klicken Sie im Dialogfeld **IdP-Metadaten** auf **IdP-Metadaten-XML-Datei hochladen**. • Navigieren Sie zu Ihrer IdP-Metadaten-Datei (XML-Datei gemäß dem SAML-Standard) mit den Konfigurationsinformationen, anhand deren die Covata-Plattform mit dem IdP-Service interagieren kann, und wählen Sie diese Datei aus. • Klicken Sie auf **Schließen**, um das Dialogfeld **IdP-Metadaten** zu schließen. **Hinweis:** Sie können eine hochgeladene IdP-Metadaten-Datei jederzeit entfernen, indem Sie dieses Dialogfeld **IdP-Metadaten** öffnen, die Schaltfläche **IdP-Konfiguration entfernen** anklicken (die die Schaltfläche **IdP-Metadaten-XML-Datei hochladen** ersetzt, sobald eine IdP-Metadaten-Datei erfolgreich auf die Covata-Plattform hochgeladen wurde) und anschließend **Speichern** anklicken, um die Entfernung zu übernehmen. Sobald eine IdP-Metadaten-Datei auf die Covata-Plattform hochgeladen wurde, müssen auch ein privater Schlüssel und ein Zertifikat des Dienstanbieters (SP) auf die Covata-Plattform hochgeladen werden - dies ist eine weitere der ([oben](/2.16/de/admin/configuring-single-sign-on-using-an-idp.md) beschriebenen) Anforderungen für die Konfiguration eines IdP-Service auf der Covata-Plattform. **Hochladen des privaten Schlüssels und Zertifikats des Dienstanbieters:** • Vergewissern Sie sich, dass Sie bei der Covata-Verwaltung [angemeldet sind](/2.16/de/admin/accessing-administration.md#signing-in) und die Option **SAML** links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface) angeklickt haben, um die Seite **SAML** aufzurufen. • Klicken Sie auf die Schaltfläche **SP-Zertifikat hochladen**. • Befolgen Sie im Dialogfeld **Privater Schlüssel und Zertifikat des Dienstanbieters** die Anweisungen oben, um einen privaten Schlüssel und ein Zertifikat zu erstellen, anhand deren die Covata-Plattform dem IdP-Service die sichere Kommunikation mit der Covata-Plattform gestattet. • Klicken Sie auf **Speichern**, um den privaten Schlüssel und das Zertifikat zu speichern. • Klicken Sie auf **Schließen**, um das Dialogfeld **Privater Schlüssel und Zertifikat des Dienstanbieters** zu schließen. **Hinweise:** • Sie können einen konfigurierten privaten Schlüssel und ein Zertifikat eines Dienstanbieters jederzeit entfernen. Öffnen Sie hierzu das Dialogfeld **Privater Schlüssel und Zertifikat des Dienstanbieters** und klicken Sie auf die Schaltfläche **Entfernen** (die die Schaltfläche **Speichern** ersetzt, sobald ein privater Schlüssel und ein Zertifikat eines Dienstanbieters auf der Covata-Plattform konfiguriert sind). • Sobald ein privater Schlüssel und ein Zertifikat eines Dienstanbieters konfiguriert sind, können Sie eine XML-Datei des Zertifikats gemäß dem SAML-Standard herunterladen (um sie manuell auf den IdP-Service hochzuladen). Klicken Sie hierzu auf den Link **Metadaten herunterladen** im Dialogfeld **Privater Schlüssel und Zertifikat des Dienstanbieters** oder direkt auf die Seite **SAML** in der Covata-Verwaltung. | | IdP aktiviert? | Gibt an, ob die Covata-Plattform (bei der delegierten Authentifizierung und Einzelanmeldung) mit ihrem konfigurierten IdP-Service arbeiten kann. **Hinweis:** Dieses Feld bleibt leer, bis der Covata-Plattform die IdP-Service-Konfiguration hinzugefügt wurde. | ## Deaktivierung und Reaktivierung der IdP-Service-Konfiguration Die Deaktivierung der IdP-Service-Konfiguration deaktiviert die Möglichkeit zur Einzelanmeldung bei der Covata-Plattform (über diesen konfigurierten IdP-Service). Ist die IdP-Service-Konfiguration deaktiviert, können Benutzer daher die Basis-URL Ihrer Instanz der Safe Share-Webanwendung, gefolgt von `/sso` zur Anmeldung bei Covata nicht mehr verwenden, z. B.: `https://safe-share.xy-firma.de/sso` **Deaktivierung, Aktivierung und Reaktivierung der IdP-Service-Konfiguration:** 1. [Melden Sie sich](/2.16/de/admin/accessing-administration.md#signing-in) bei der Covata-Verwaltung an. 2. Klicken Sie auf die Option **SAML** links auf der [Covata-Verwaltung-Oberfläche](/2.16/de/admin/accessing-administration.md#the-administration-interface), um die Seite **SAML** aufzurufen. 3. Gehen Sie anschließend wie folgt vor: * *Deaktivierung der IdP-Service-Konfiguration* - klicken Sie auf die (grüne) Schaltfläche **Aktiviert**, um sie auf **Deaktiviert** umzuschalten. * *Aktivierung oder Reaktivierung der IdP-Service-Konfiguration* - klicken Sie auf die (rote) Schaltfläche **Deaktiviert**, um sie auf **Aktiviert** umzuschalten. *** #### Bitte hinterlassen Sie uns hier Ihr Feedback. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.