---
schema_version: "1"
id: 8a95799429ae6bed127dbb7880850595750b7a0fdc6d47feb87f01f8a10652ad
title: Konfigurieren von verbundenen Apps mit OAuth 2.0-Vertrauensstellung
collection: tableau
version: current
locale: de-de
portal_url: https://docs.salesforce.com/tableau/current/de-de/server-linux/connected_apps_eas.md
canonical_url: https://help.tableau.com/current/server-linux/de-de/connected_apps_eas.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 75063a9b1a88f78ae207f91ee66656d6e19dfea50cd022a0761fbb7b8ae2866c
description: Configure connected apps with OAuth 2.0 trust by registering an external authorization server.
---
[Zum Hauptinhalt springen](#main-content)

# Konfigurieren von verbundenen Apps mit OAuth 2.0-Vertrauensstellung

Als Tableau Server\-Administrator können Sie einen externen Autorisierungsserver (External Authorization Server, EAS) oder auch mehrere registrieren, um mithilfe des OAuth 2.0-Standardprotokolls eine Vertrauensbeziehung zwischen Ihrem Tableau Server und dem EAS herzustellen.

**Wichtig:**

- Einige der in diesem Thema beschrieben Verfahren erfordern eine Konfiguration mit Software und Diensten von Drittanbietern. Wir haben uns nach Kräften bemüht, die Verfahren zur Aktivierung der EAS-Funktion in Tableau Server zu verifizieren. Software und Dienste von Drittanbietern können sich jedoch ändern oder in Ihrer Organisation anders ausfallen. Sollten Probleme auftreten, entnehmen Sie offizielle Konfigurationsdetails und Supportinformationen bitte der Dokumentation Ihrer Drittanbieter.
- Um das Einbetten über EAS zu ermöglichen, muss Tableau Server für die Verwendung von SSL für HTTP-Datenverkehr konfiguriert werden.
- Damit das Sitzungs-Token gültig ist, müssen die Uhren der externen Anwendung und des Servers, der die externe Anwendung hostet, auf koordinierte Weltzeit (UTC) eingestellt sein. Wenn eine der Uhren einen anderen Standard verwendet, wird der verbundenen App nicht vertraut.

## So funktionieren mit Tableau verbundene Apps mit OAuth 2.0-Vertrauensstellung

Die Vertrauensbeziehung zwischen Ihrer Tableau Server\-Site und externer Anwendung wird über einen Authentifizierungstoken im JWT-Standard (JSON Web Token) hergestellt und verifiziert.

Beim Laden eines eingebetteten Tableau-Inhalts in Ihre externe Anwendung wird Autorisierungscode-, OAuth-Schema verwendet. Nach der erfolgreichen Anmeldung beim IdP sind Benutzer automatisch bei Tableau Server angemeldet. Führen Sie die unten aufgeführten Schritte durch, um Ihren EAS mit Tableau Server\- zu registrieren.

### Hauptkomponenten einer verbundenen App

Die folgenden Komponenten der verbundenen App greifen mit dem JWT in Ihrer externen Anwendung ineinander, um Benutzer zu authentifizieren und eingebettete Inhalte anzuzeigen.

- **Externer Autorisierungsserver (EAS):** Der Server, meist Ihr IdP, der als Schnittstelle zwischen dem Benutzer und der externen Anwendung fungiert. Der Server authentifiziert und autorisiert den Benutzerzugriff auf die geschützten Tableau-Inhalte.
- **Aussteller-URL:** Die URL, die die EAS-Instanz eindeutig identifiziert.

### Workflow für verbundene Apps

#### Einbettungs-Workflows

Das folgende Diagramm zeigt, wie die Authentifizierung zwischen Ihrem EAS-Server, der externen Anwendung (Webserver und Webseite) und der verbundenen App funktioniert.

![](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_how_EAS.png)

1. **Benutzer besucht die Webseite:** Wenn ein Benutzer den eingebetteten Inhalt einer Webseite aufruft, sendet die Webseite eine GET-Anfrage an die externe Anwendung.
2. **Externe Anwendung leitet Anfrage an EAS weiter:** Die externe Anwendung antwortet mit einer Webseite, die zum externen Autorisierungsserver (EAS) weiterleitet.
3. **Benutzer authentifiziert sich bei EAS:** Der Benutzer authentifiziert und autorisiert sich beim EAS.
4. **EAS antwortet auf die Webseite mit einem Autorisierungscode:** Das EAS antwortet der Seite mit einem Autorisierungscode und leitet wieder zurück zu der Webseite.
5. **EAS konvertiert Autorisierungscode in JWT:** Die Webseite ruft den EAS auf, um den Autorisierungscode in ein JWT umzuwandeln, welches die Webseite dann in die URL des eingebetteten Inhalts einfügt.
6. **Webseite fordert Inhalte von Tableau an:** Die Webseite lädt das iFrame und sendet eine GET-Anfrage an Tableau.
7. **Tableau validiert das Token:** Tableau validiert das JWT in der URL mit der Signatur und antwortet mit dem Inhalt und respektiert die im JWT definierten Einbettungsbereiche.

## Erstellen einer verbundenen App

### Schritt 1: Bevor Sie beginnen

Um einen EAS bei Tableau Server\- zu registrieren, müssen Sie über einen EAS verfügen, der bereits konfiguriert ist. Außerdem muss der EAS ein gültiges JSON-Webtoken (JSON Web Token, JWT) senden, das die in der folgenden Tabelle aufgeführten registrierten Ansprüche und Header enthält.

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Anspruch</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Name</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Beschreibung oder erforderlicher Wert</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>kid</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Schlüssel-ID</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Erforderlich (im Header). Eine eindeutige Schlüsselkennung des Identitätsanbieters.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>iss</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Aussteller (Issuer)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Erforderlich (im Header oder als Anspruch). Eindeutiger Aussteller-URI, der die vertrauenswürdige verbundene App und ihren Signaturschlüssel identifiziert.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>alg</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Algorithmus (Algorithm)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Erforderlich (im Header). JWT-Signaturalgorithmus. Unterstützte Algorithmusnamen sind in der javadoc.io-Dokumentation auf der Seite <a href="https://www.javadoc.io/doc/com.nimbusds/nimbus-jose-jwt/2.21/com/nimbusds/jose/JWSAlgorithm.html" target="_blank">Class JWSAlgorithm</a> aufgeführt. Der Signaturalgorithmus kann mit dem Befehl <a href="https://help.tableau.com/current/server-linux/de-de/cli_configuration-set_tsm.htm#eas_algorithms" class="xref">vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms</a> konfiguriert werden.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>sub</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Betreff (Subject)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Benutzername  des authentifizierten <span class="mc-variable Variables.ProductName variable">Tableau Server</span>-Benutzers.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>aud</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Zielgruppe (Audience)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Der Wert muss sein: "<code>tableau</code>"</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>exp</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ablaufzeit (Expiration Time)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Ein gültiges JWT darf nicht abgelaufen sein. Die Ablaufzeit (in UTC) des JWT muss innerhalb der konfigurierten maximalen Gültigkeitsdauer liegen. Die maximale Gültigkeitsdauer kann mit dem Befehl <a href="https://help.tableau.com/current/server-linux/de-de/cli_configuration-set_tsm.htm#eas_max_expiration_period" class="xref">vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes</a> konfiguriert werden.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>jti</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT-ID (JWT ID)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Der JWT-ID-Anspruch stellt einen eindeutigen Bezeichner für das JWT bereit und unterscheidet zwischen Groß- und Kleinschreibung.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">"<code>scp</code>"</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Bereich</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Zu den unterstützten Werten für <i>Einbettungs-Workflows</i> gehören:</p><p>"<code>tableau:views:embed</code>"<br>"<code>tableau:views:embed_authoring</code>" (Hinzugefügt in Tableau Server&nbsp;2022.3)<br>"<code>tableau:metrics:embed</code>" (In Tableau Server&nbsp;2023.3 nicht mehr verfügbar)<br>„<code>tableau:ask_data:embed</code>“ (Hinzugefügt in Tableau Server 2023.1. Eingestellt in Tableau Server 2024.2)</p><p><b>Hinweise:</b></p><ul><li>Werte müssen als ein Listentyp übergeben werden.</li><li>Bei <code>tableau:views:embed</code> berücksichtigt der Bereich die bereits in <span class="mc-variable Variables.ProductName variable">Tableau Server</span> konfigurierten Benutzerberechtigungen und ermöglicht den Benutzern die Interaktion mit den Tools in der eingebetteten Ansicht, wenn diese in der ursprünglichen Ansicht verfügbar sind.</li><li>Wir empfehlen, den Parameter für die Symbolleiste im Einbettungscode nicht zu verwenden. Weitere Informationen finden Sie weiter unten unter <a href="#known_issues" class="xref">Bekannte Probleme (nur Einbettungs-Workflows)</a>.</li></ul><p>Informationen zu <i>REST&nbsp;API-Autorisierungs-Workflows</i> finden Sie unter <a href="https://help.tableau.com/current/server-linux/de-de/connected_apps_scopes.htm#scopes" class="xref">REST&nbsp;API-Methoden, die JWT-Autorisierung unterstützen</a>.</p><p>Für <i>Metadaten-API-Workflows, die die REST-API zur Authentifizierung verwenden</i>, ist der einzige unterstützte Bereich <code>tableau:content:read</code>.</p><p>Für <i>VizQL Data Service-Workflows, die die REST-API zur Authentifizierung verwenden</i>, ist der einzige unterstützte Bereich <code>tableau:viz_data_service:read</code>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>https://tableau.com/groups</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Dynamische Gruppenmitgliedschaft</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Nur für <i>Einbettungs-Workflows</i>.<p>Der Wert muss mit dem Namen einer oder mehrerer Gruppen in Tableau Server übereinstimmen. Weitere Informationen finden Sie unter <a href="https://help.tableau.com/current/server-linux/de-de/groups_create_local.htm#assertions" class="xref">Dynamische Gruppenmitgliedschaft mithilfe von Assertionen</a>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">(Benutzerattribute)</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">(Benutzerattributwerte)</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Nur für <i>Einbettungs-Workflows</i>.</p><p>Seit Tableau Server&nbsp;2025.1 können Sie  Benutzerattribute in das JWT einfügen. Wenn Benutzerattributfunktionen dann in eingebetteten Inhalten verwendet werden, überprüft Tableau den Kontext des authentifizierten Benutzers und stellt fest, welche Daten zur Laufzeit angezeigt werden können.</p><p><b>Hinweise:</b></p><ul><li><p>Überprüfen Sie, ob in der Hilfe zu <a href="https://help.tableau.com/current/api/embedding_api/de-de/docs/embedding_api_user_attributes.html#known-issues" target="_blank">Embedding API&nbsp;v3</a> <i>Bekannte Probleme</i> und <i>Einschränkungen</i> aufgeführt sind, die Ihren Workflow beeinträchtigen könnten.</p></li><li>Damit das Benutzerattribut funktioniert, müssen Sie 1.) die Benutzerattributfunktion mit der Methode <a href="https://help.tableau.com/current/api/rest_api/de-de/REST/rest_api_ref_site.htm#update_embedding_settings_for_site" target="_blank">Einbettungseinstellungen für eine Site aktualisieren</a> per Tableau-REST&nbsp;API aktivieren und optional die TSM-Option <a href="https://help.tableau.com/current/server/de-de/cli_configuration-set_tsm.htm#uaf" target="_blank">features.VizDataServiceClientEnable</a> aktivieren, und 2.) der Inhaltsautor muss eine <a href="https://help.tableau.com/current/pro/desktop/de-de/functions_functions_user.htm#user_attributes" target="_blank">Benutzerattributfunktion</a> erstellen.</li><li>Bei Benutzerattributen wird die Groß-/Kleinschreibung berücksichtigt.</li></ul></td></tr></tbody></table>

**Hinweis:** Die oben aufgeführten JWT-Ansprüche sind im Abschnitt [Registered Claim Names](https://datatracker.ietf.org/doc/html/rfc7519#section-4.1) (Namen registrierter Ansprüche) in der von der IETF (Internet Engineering Task Force) vertriebenen Dokumentation dokumentiert.

### Schritt 2: Registrieren Ihres EAS bei Tableau Server

Durch die Registrierung Ihres EAS bei Tableau Server stellen Sie eine Vertrauensbeziehung zwischen dem EAS und Tableau Server\- her. Das bedeutet, wenn Benutzer auf Tableau-Inhalte zugreifen, die in Ihre externe Anwendung eingebettet sind, werden sie umgeleitet, um sich beim IdP zu authentifizieren. Der EAS generiert das Authentifizierungstoken, das zur Überprüfung an Tableau Server übergeben wird. Nachdem die Vertrauensstellung überprüft wurde, wird Benutzern der Zugriff auf den eingebetteten Inhalt gewährt.

**Hinweis:** Einige EAS unterstützen die Option zum Anzeigen eines Dialogfelds, in dem die Benutzer um die Zustimmung gebeten werden, dass die Anwendung auf Tableau-Inhalte zugreifen darf. Um die beste Erfahrung für Ihre Benutzer zu gewährleisten, empfehlen wir Ihnen, Ihren EAS so zu konfigurieren, dass er auf die Anfrage der externen Anwendung automatisch im Namen der Benutzer die Zustimmung erteilt.

#### Informationen zu EAS auf Site-Ebene

Ab Tableau Server 2024.2 können Sie einen EAS auf Site-Ebene konfigurieren. Um einen EAS auf Site-Ebene zu registrieren, müssen verbundene Apps in Tableau Server Manager (TSM) aktiviert werden.

Sie können serverweite EAS auf zwei Arten registrieren: über die TSM-Web-Benutzeroberfläche oder über die TSM-CLI.

Nach der Registrierung des EAS gilt die hergestellte Vertrauensstellung für alle Sites auf Tableau Server.

### Option 1: TSM-Web-Benutzeroberfläche verwenden

1. Melden Sie sich als Tableau Server-Administrator bei der Weboberfläche von TSM (Tableau Services Manager) an. Weitere Informationen finden Sie unter [Anmelden bei der Webschnittstelle von Tableau Services Manager](https://help.tableau.com/current/server-linux/de-de/sign_in_tsm.htm#sign-in-to-the-tsm-web-ui).
2. Führen Sie _einen_ der folgenden Schritte aus:
    
    - Navigieren Sie in Tableau Server 2024.2 und höher zur Seite „Benutzeridentität und Zugriff“ > Registerkarte Verbundene Apps.
    - Navigieren Sie in Tableau Server 2023.3 und früheren Versionen zur Seite „Benutzeridentität und Zugriff“ > Registerkarte Autorisierungsserver.
3. Führen Sie _einen_ der folgenden Schritte aus:
    - In Tableau Server 2024.2 und höher:
        
        1. Aktivieren Sie das Kontrollkästchen Verbundene Apps aktivieren.
        2. Wählen Sie das zweite Optionsfeld aus: Verbundene Apps zulassen (auf Site-Ebene konfigurieren) und serverweite OAuth 2.0-Vertrauensstellung (unten konfigurieren).
        3. Fügen Sie im Textfeld Aussteller-URL die Aussteller-URL des EAS ein.
        4. Klicken Sie auf die Schaltfläche Ausstehende Änderungen speichern.
            
            ![](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_eas_register_new.png)
    - In Tableau Server 2023.3 und früher:
        
        1. Aktivieren Sie das Kontrollkästchen OAuth-Zugriff für eingebettete Inhalte aktivieren.
        2. Fügen Sie im Textfeld Aussteller-URL die Aussteller-URL des EAS ein.
        3. Klicken Sie auf die Schaltfläche Ausstehende Änderungen speichern.
            
            ![Formular zum Registrieren eines externen Autorisierungsservers.](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_eas_register.png)
4. Wenn Sie fertig sind, gehen Sie wie folgt vor:
    1. Klicken Sie rechts oben auf der Seite auf die Schaltfläche Ausstehende Änderungen.
    2. Klicken Sie rechts unten auf der Seite auf die Schaltfläche Änderungen übernehmen und neu starten, um Tableau Server zu beenden und neu zu starten.
        
        ![Eine Liste ausstehender externer Konfigurationsänderungen zur Autorisierung mit der Option zum Übernehmen oder Verwerfen der Änderungen.](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_eas_save.png)

### Option 2: TSM-CLI verwenden

1. Öffnen Sie als Administrator eine Eingabeaufforderung auf dem Ausgangsknoten (auf dem TSM installiert ist) in dem Cluster.
2. Führen Sie die folgenden Befehle aus:
    
    tsm configuration set -k vizportal.oauth.external\_authorization.enabled -v true
    tsm configuration set -k vizportal.oauth.external\_authorization\_server.issuer -v "<issuer\_url\_of\_EAS>"
    tsm restart

Ab Tableau Server 2024.2 können Sie einen oder mehrere EAS für eine Site registrieren. Nach der Registrierung des EAS auf Site-Ebene gilt die hergestellte Vertrauensbeziehung nur für die Site.

**Hinweis:** Voraussetzung für die Konfiguration von EAS auf Site-Ebene ist, dass verbundene Apps in TSM aktiviert sind.

### Schritt 1: Aktivieren von verbundenen Apps

1. Melden Sie sich als Tableau Server-Administrator bei der Weboberfläche von TSM (Tableau Services Manager) an. Weitere Informationen finden Sie unter [Anmelden bei der Webschnittstelle von Tableau Services Manager](https://help.tableau.com/current/server-linux/de-de/sign_in_tsm.htm#sign-in-to-the-tsm-web-ui).
2. Navigieren Sie zur Seite „Benutzeridentität und Zugriff“ > Registerkarte Verbundene Apps.
3. Aktivieren Sie das Kontrollkästchen Verbundene Apps aktivieren.
4. Führen Sie _einen_ der folgenden Schritte aus:
    
    - Wählen Sie das erste Optionsfeld aus: Verbundene Apps zulassen (auf Site-Ebene konfigurieren) um die Registrierung von EASs nur auf Site-Ebene zu ermöglichen.
        
        ![](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_eas_register_radio.png)
    - (Standard) Wählen Sie das zweite Optionsfeld aus: Verbundene Apps zulassen (auf Site-Ebene konfigurieren) und serverweite OAuth 2.0-Vertrauensstellung (unten konfigurieren), um das Registrieren von externen Autorisierungsservern (EAS) sowohl auf Site-Ebene als auch serverweit zu ermöglichen. Wenn Sie diese Option wählen, stellen Sie sicher, dass sich die auf Site-Ebene angegebene Aussteller-URL von der serverweiten Aussteller-URL unterscheidet.
        
        ![](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_eas_register_radio_default.png)
5. Klicken Sie auf die Schaltfläche Ausstehende Änderungen speichern.
6. Wenn Sie fertig sind, gehen Sie wie folgt vor:
    1. Klicken Sie rechts oben auf der Seite auf die Schaltfläche Ausstehende Änderungen.
    2. Klicken Sie rechts unten auf der Seite auf die Schaltfläche Änderungen übernehmen und neu starten, um Tableau Server zu beenden und neu zu starten.

### Schritt 2: Registrieren des EAS

1. Melden Sie sich als Tableau Server-Administrator bei Tableau Server an zu.
2. Wählen Sie im linken Bereich Einstellungen > Verbundene Apps aus.
3. Klicken Sie auf die Schaltfläche mit dem Dropdown-Pfeil "Neue verbundene App" und wählen Sie OAuth 2.0-Vertrauensstellung aus.
4. Gehen Sie im Dialogfeld „Verbundene App erstellen“ folgendermaßen vor:  
    1. Geben Sie im Textfeld für den Namen der verbundenen App einen Namen für die verbundene App ein.
    2. Fügen Sie im Textfeld Aussteller-URL die Aussteller-URL des EAS ein.
    3. Wählen Sie die Option Verbundene App aktivieren aus. Aus Sicherheitsgründen wird eine verbundene App beim Erstellen standardmäßig auf "Deaktiviert" gesetzt.
    4. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche Erstellen.
    ![](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_create_eas.png)
5. Nachdem die verbundene App erstellt wurde, kopieren Sie die Standort-ID der verbundenen App . Die Website-ID wird für den oben in Schritt 1 beschriebenen Anspruch „aud“ (Zielgruppe) des JWT verwendet.
    
    ![Details zum externen Autorisierungsserver mit einer Schaltfläche zum Kopieren der Site-ID.](/tableau/current/de-de/server-linux/de-de/Img/connectedapp_eas_button_luid.png)

### Schritt 3: Nächste Schritte

#### Für Einbettungs-Workflows

Nachdem Sie Tableau Server\- für die Verwendung Ihres EAS konfiguriert haben, müssen Sie Ihrer externen Anwendung Einbettungscode hinzufügen. Stellen Sie sicher, dass Sie das gültige JWT, das von Ihrem EAS generiert wurde (wie in Schritt 1 beschrieben), in die Webkomponente einschließen, die Ihre externe Anwendung aufruft.

Weitere Informationen zum Einbetten von Tableau-Inhalten finden Sie in den folgenden Abschnitten:

- Betten Sie Tableaucontent mithilfe der [Tableau Embedding-API v3](https://help.tableau.com/current/api/embedding_api/de-de/index.html) ein.
- Benutzerattribute für die attributbasierte Zugriffssteuerung (ABAC), den On-Demand-Zugriff und die dynamische Gruppenmitgliedschaft finden Sie unter [Anpassen und Steuern des Datenzugriffs](https://help.tableau.com/current/api/embedding_api/de-de/docs/embedding_api_user_attributes.html) in der Tableau Embedding API v3.
- Informationen zum Einbetten von Metriken finden Sie unter dem Thema [Einbetten von Metriken in Webseiten](https://help.tableau.com/current/pro/desktop/de-de/embed_metrics.htm) in der Tableau-Hilfe. (In Tableau Server 2023.3 hat Tableau die Möglichkeit zum Einbetten von Metriken eingestellt.)

**Hinweis:** Damit Benutzer beim Zugriff auf eingebettete Inhalte erfolgreich authentifiziert werden, müssen Browser so konfiguriert sein, dass sie Cookies von Drittanbietern zulassen.

##### Steuern, wo Inhalte eingebettet werden können, indem Sie die Domänen-Zulassungsliste zum Einbetten verwenden

Seit Tableau Server 2023.3 können Sie und Ihre Benutzer mithilfe der Methode „Einbettungseinstellungen für Website aktualisieren“ in der Tableau-REST-API steuern, ob Tableau-Inhalte ohne Einschränkung eingebettet werden können oder dies auf bestimmte Domänen beschränkt sein soll.

Standardmäßig ist die Site-Einstellung `unrestrictedEmbedding` für die Einbettung auf `true` festgelegt, um ein uneingeschränktes Einbetten zu ermöglichen. Alternativ können Sie und Ihre Benutzer die Einstellung auf `false` festlegen und mithilfe des Parameters `allowList` die Domänen angeben, in denen Tableau-Inhalte in externen Anwendungen eingebettet werden können.

Weitere Informationen finden Sie unter einem der beiden folgenden Themen:

- [Einbettungseinstellungen für die Website aktualisieren](https://help.tableau.com/current/api/rest_api/de-de/REST/rest_api_ref_site.htm#update_embedding_settings_for_site) in der Tableau REST API-Hilfe
- [Tableau-Site-Einstellung zum Einbetten](https://help.tableau.com/current/api/embedding_api/en-us/docs/embedding_api_site.html#about-tableau-site-settings-for-embedding) in der Tableau Embedding API v3-Hilfe.

#### Für REST API-Autorisierungs-Workflows

Nachdem das JWT konfiguriert wurde, müssen Sie das gültige JWT der REST API-Anmeldeanforderung für autorisierten Zugriff hinzufügen. Weitere Informationen finden Sie unter [Zugriffsbereiche für verbundene Apps](https://help.tableau.com/current/server-linux/de-de/connected_apps_scopes.htm).

#### Für Metadaten-API-Workflows

Nachdem das JWT konfiguriert wurde, müssen Sie das gültige JWT der REST API-Anmeldeanforderung hinzufügen. Weitere Informationen finden Sie unter [Zugriffsbereiche für verbundene Apps](https://help.tableau.com/current/server-linux/de-de/connected_apps_scopes.htm).

#### Für externe Token für SCIM-Workflows

Nach dem Konfigurieren des JWT müssen Sie die SCIM-Funktion aktivieren. Weitere Informationen finden Sie unter [Konfigurieren von verbundenen Apps mit OAuth 2.0-Vertrauensstellung](#scim).

### Bekannte Probleme (nur Einbettungs-Workflows)

Bei der Verwendung von verbundenen Apps gibt es einige bekannte Probleme, die in einer zukünftigen Version behoben werden.

- **Symbolleistenfeatures:** Wenn für eingebettete Inhalte der Symbolleistenparameter definiert ist, funktionieren manche Symbolleistenfeatures nicht. Um dieses Problem zu umgehen, empfehlen wir Ihnen, den Symbolleistenparameter (wie im folgenden Beispiel gezeigt) auszublenden.
    
    <tableau-viz id='tab-viz' src='https://<your\_server>/t/<your\_site>/...'
    	toolbar='hidden'>
    </tableau-viz>

- **Veröffentlichte Datenquellen:** Veröffentlichte Datenquellen, für die festgelegt ist, dass Benutzer Datenbankanmeldeinformationen eingeben müssen, werden nicht angezeigt. Um dieses Problem zu umgehen, empfehlen wir, dass Datenquellenbesitzer stattdessen ihre eigenen Datenbankanmeldeinformationen einbetten (sofern möglich).
- **Eingebettete Ansichten auf mehreren Sites:** In Tableau Server 2023.1 und früheren Versionen verursacht das Wechseln zwischen Ansichten auf verschiedenen Sites im selben Browser den Fehler 1008: Geheimnis für Connect-App konnte nicht abgerufen werden („1008: Could not fetch secret for connect app“). Um dieses Problem zu umgehen, führen Sie ein Upgrade auf Tableau Server 2023.3 (oder höher) durch.

### Problembehebung

Wenn eingebettete Inhalte in Ihrer externen Anwendung nicht angezeigt werden oder wenn die Tableau-REST API-Autorisierung fehlschlägt, können Sie die Entwicklertools eines Browsers verwenden, um Fehlercodes zu überprüfen und zu identifizieren, die möglicherweise mit dem in Tableau Server\- aktivierten EAS-Feature im Zusammenhang stehen.

In der folgenden Tabelle finden Sie die Beschreibungen der Fehlercodes und der möglichen Lösung.

<table style="width: 90%;margin-left: 0;margin-right: auto;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Fehlercode</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Zusammenfassung</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">Beschreibung</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">Mögliche Lösung oder Erklärung</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">5</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SYSTEM_USER_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau-Benutzer konnte nicht gefunden werden</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><br>Um dieses Problem zu beheben, überprüfen Sie, ob der Anspruchswert "<code>sub</code>" (Subjekt) im JWT der "username" (Benutzername) für den authentifizierten Tableau Server ist. Bei dem Wert wird die Groß-/Kleinschreibung berücksichtigt.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">16</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">LOGIN_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Fehler beim Anmelden</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Dieser Fehler wird meist durch eines der folgenden Anspruchsprobleme im JWT verursacht:<ul><li>Die Ablaufzeit "<code>exp</code>" (Expiration Time) überschreitet die standardmäßig maximale Gültigkeitsdauer. Um dieses Problem zu beheben, überprüfen Sie <a href="https://help.tableau.com/current/server/de-de/connected_apps_eas.htm#jwt" target="_blank">registrierte Ansprüche</a>, die für ein gültiges JWT erforderlich sind, und stellen Sie sicher, dass der richtige Wert verwendet wird. Um die maximale Gültigkeitsdauer zu ändern, können Sie den Befehl <a href="https://help.tableau.com/current/server-linux/de-de/cli_configuration-set_tsm.htm#eas_max_expiration_period" class="xref">vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes</a> verwenden.</li><li>Der Wert in "<code>sub</code>" (subject) ruft einen unbekannten Benutzer auf. Um dieses Problem zu beheben, vergewissern Sie sich, dass der Anspruch "<code>sub</code>" den Wert "username" hat. Bei dem Wert wird die Groß-/Kleinschreibung berücksichtigt.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">67</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">FEATURE_NOT_ENABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Der On-Demand-Zugriff wird nicht unterstützt</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Der On-Demand-Zugriff ist nur über lizenzierte Tableau Cloud-Sites verfügbar.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10081</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_RETRIEVE_IDP_METADATA</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EAS-Metadaten-Endpunkt fehlt</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um dieses Problem zu beheben, überprüfen Sie, ob der EAS richtig konfiguriert ist und der richtige Aussteller aufgerufen wird.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10082</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AUTHORIZATION_SERVER_ISSUER_NOT_SPECIFIED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Fehlender Aussteller</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um dieses Problem zu beheben, überprüfen Sie, ob der richtige Aussteller aufgerufen wird. Zum Ändern der Aussteller-URL können Sie den Befehl <a href="https://help.tableau.com/current/server-linux/de-de/cli_configuration-set_tsm.htm#eas_issuer" class="xref">vizportal.oauth.external_authorization_server.issuer</a> verwenden.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10083</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BAD_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Der JWT-Header enthält Probleme.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Im JWT-Header fehlen die Ansprüche "<code>kid</code>" (Secret ID, geheime ID) oder "<code>clientId</code>" (Issuer, Aussteller). Um dieses Problem zu beheben, stellen Sie sicher, dass diese Informationen enthalten sind.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10084</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_PARSE_ERROR</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT enthält Probleme</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Überprüfen Sie Folgendes, um dieses Problem zu beheben:<ul><li>Ob der im JWT referenzierte Wert "<code>aud</code>" (Audience, Zielgruppe) den Wert "tableau" verwendet. Bei dem Wert wird die Groß-/Kleinschreibung berücksichtigt.</li><li>Ob "<code>aud</code>" (Audience) und "<code>sub</code>" (Subject) im JWT enthalten sind.</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10085</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_FETCH_JWT_KEYS</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT konnte Schlüssel nicht finden</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Das Geheimnis konnte nicht gefunden werden.<p>Um dieses Problem zu beheben, überprüfen Sie, ob der richtige Aussteller aufgerufen wird. Zum Ändern der Aussteller-URL können Sie den Befehl <a href="https://help.tableau.com/current/server-linux/de-de/cli_configuration-set_tsm.htm#eas_issuer" class="xref">vizportal.oauth.external_authorization_server.issuer</a> verwenden.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10087</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGN</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Es gibt ein Problem mit dem JWT-Signaturalgorithmus.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um das Problem zu beheben, können Sie den Signaturalgorithmus entfernen. Weitere Informationen finden Sie unter <a href="https://help.tableau.com/current/server-linux/de-de/cli_configuration-set_tsm.htm#eas_algorithms" class="xref">vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms</a>.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10088</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">RSA_KEY_SIZE_INVALID</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ein Problem mit JWT-Signaturanforderungen liegt vor.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um dieses Problem zu beheben, überprüfen Sie mit dem EAS oder IdP, dass das JWT mit einer RSA-Schlüsselgröße von 2.048 signiert ist.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10091</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_ALREADY_USED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Eindeutiges JWT erforderlich</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Das JWT wurde bereits im Authentifizierungsprozess verwendet. Um dieses Problem zu beheben, muss der EAS oder IdP ein neues JWT generieren.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10092</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">NOT_IN_DOMAIN_ALLOW_LIST</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Die Domäne des eingebetteten Inhalts ist nicht angegeben.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um dieses Problem zu beheben, stellen Sie sicher, dass die Einstellung <code>unrestrictedEmbedding</code> auf <code>true</code> festgelegt ist oder der Parameter <code>domainAllowlist</code> die Domänen enthält, in die Tableau-Inhalte mithilfe der Methode <a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#embedding_settings_for_site" target="_blank">Einbettungseinstellungen für die Site aktualisieren</a> in der Tableau-REST&nbsp;API eingebettet werden.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10094</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MISSING_REQUIRED_JTI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Fehlende JWT-ID</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Um dieses Problem zu beheben, stellen Sie sicher, dass die "<code>jti</code>" (JWT-ID) im JWT enthalten ist.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10096</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Die Ablaufzeit "<code>exp</code>" (Expiration Time) überschreitet die standardmäßig maximale Gültigkeitsdauer. Um dieses Problem zu beheben, überprüfen Sie <a href="https://help.tableau.com/current/server/de-de/connected_apps_eas.htm#jwt" target="_blank">registrierte Ansprüche</a>, die für ein gültiges JWT erforderlich sind, und stellen Sie sicher, dass der richtige Wert verwendet wird. Um die maximale Gültigkeitsdauer zu ändern, können Sie den Befehl <a href="https://help.tableau.com/current/server-linux/de-de/cli_configuration-set_tsm.htm#eas_max_expiration_period" class="xref">vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes</a> verwenden. </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10097</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MALFORMED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Probleme mit Geltungsbereichsansprüchen</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Dieser Fehler kann auftreten, wenn der Anspruch "<code>scp</code>" (Scope) entweder im JWT fehlt oder nicht als Listentyp übergeben wird. Um dieses Problem zu beheben, überprüfen Sie, ob "<code>scp</code>" im JWT enthalten ist und als Listentyp übergeben wird. Hilfe zur Fehlerbehebung bei einem JWT finden Sie unter <a href="https://jwt.io/" target="_blank">Debugger</a> auf der auth0-Site.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10098</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_UNSIGNED_OR_ENCRYPTED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Das JWT ist unsigniert oder verschlüsselt</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Tableau unterstützt keine unsignierten oder verschlüsselten JWT.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10099</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MISSING_IN_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Anspruch für Bereiche fehlt</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Dem JWT fehlt der erforderliche Anspruch "<code>scp</code>" (Geltungsbereich). Um dieses Problem zu beheben, stellen Sie sicher, dass "<code>scp</code>" im JWT enthalten ist. Hilfe zur Fehlerbehebung bei einem JWT finden Sie unter <a href="https://jwt.io/" target="_blank">Debugger</a> auf der auth0-Site.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10100</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_PERSISTENCE_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Unerwarteter JWT-ID-Fehler</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Es ist ein unerwarteter Fehler mit der "<code>jti</code>" (JWT-ID) aufgetreten. Um dieses Problem zu beheben, muss ein neues JWT mit einem neuen "<code>jti</code>" generiert werden.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">10103</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">JWT_MAX_SIZE_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">JWT überschreitet die maximale Größe</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Dieser Fehler kann auftreten, wenn die JWT-Größe 8000 Byte überschreitet. Um dieses Problem zu beheben, stellen Sie sicher, dass nur die erforderlichen Ansprüche an <span class="mc-variable Variables.ProductName variable">Tableau Server</span> übergeben werden.</td></tr></tbody></table>