Hilfe zu Tableau Server für Linux

Die Connectoren Azure Synapse, Azure SQL Database, Azure Databricks, Azure Data Lake Gen2, OneDrive und SharePoint Online sowie SharePoint Lists (JDBC) unterstützen die Authentifizierung über Azure AD durch die Konfiguration eines OAuth-Clients für Tableau Server.

Hinweis: Die OAuth-Unterstützung für Azure AD wird nur von Microsoft SQLServer-Treiber 17.3(Link wird in neuem Fenster geöffnet) und höher unterstützt.

Schritt 1: OAuth-Client für Azure registrieren

Führen Sie die folgenden Schritte aus, um eine OAuth-Anwendung für Azure unter einem bestimmten Azure-Mandanten zu registrieren und zu konfigurieren.

1. Melden Sie sich beim Azure-Portal an.
2. Wenn Sie Zugang zu mehreren Mandanten haben, wählen Sie den Mandanten aus, in dem Sie eine Anwendung registrieren möchten.
3. Suchen Sie Azure Active Directory und wählen Sie es aus.
4. Wählen Sie unter Verwalten die Option App-Registrierungen und dann Neue Registrierung.
5. Geben Sie "Tableau Server OAuth" oder einen ähnlichen Wert als Namen ein.
6. Wählen Sie unter dem Feld Unterstützte Kontotypen auf der App-Registrierungsseite aus, wer diese Anwendung verwenden darf.

Hinweis: Wenn Sie die Client-ID und das Client-Geheimnis Ihrer Anwendung für Konten unter verschiedenen Mandanten verwenden möchten, wählen Sie die zweite Option (mehrere Mandanten) aus.

7. Unter Uri umleiten (optionales) Feld, wählen Sie Web und geben Sie dann die Internetadresse Ihres Servers ein, an die Sie die Zeichenfolge anhängen: /auth/add_oauth_token.

Beispiel: https://your_server_url.com/auth/add_oauth_token

8. Wählen Sie Registrieren. Nach Abschluss der Registrierung zeigt das Azure-Portal den Übersichtsbereich der App-Registrierung an, der die Anwendungs-ID (Client-ID) enthält. Dieser Wert wird auch als Client-ID bezeichnet und identifiziert Ihre Anwendung in der Microsoft Identity-Plattform eindeutig.
9. Kopieren Sie den Wert, der als Feld [your_client_id] in den folgenden Schritten verwendet wird.
10. Wählen Sie Zertifikate & Geheimnisse auf der linken Leiste und dannNeues Client-Geheimnis.
11. Fügen Sie eine Beschreibung der Abbildung hinzu.
12. Wählen Sie Client-Secret-Lebensdauer.
13. Wählen Sie Hinzufügen und kopieren Sie dann das Geheimnis. Das Geheimnis wird in den folgenden Schritten als [your_client_secret] verwendet.
14. Wählen Sie API-Berechtigungen auf der linken Leiste.
15. Wählen Sie Berechtigungen hinzufügen.
16. Wählen Sie Microsoft Graph.
17. Wählen Sie Delegierte Berechtigungen.
18. Wählen Sie unter Berechtigungen auswählen alle OpenId-Berechtigungen aus (E-Mail, offline_access, OpenID, Profil).
19. Wählen Sie Berechtigungen hinzufügen.
20. Fügen Sie zusätzliche Berechtigungen hinzu. Führen Sie die folgenden Schritte für die Connectoren aus, die Sie aktivieren:
    • Azure-SQL-Datenbank
      1. Klicken Sie auf Berechtigung hinzufügen.
      2. Wählen Sie Meine APIs.
      3. Klicken Sie auf Azure SQL-Datenbank, dann auf Delegierte Berechtigungen.
      4. Wählen Sie user_impersonation aus und klicken Sie dann auf Berechtigungen hinzufügen.
    • OneDrive und SharePoint Online
    1. Klicken Sie auf Berechtigung hinzufügen.
    2. Wählen Sie Microsoft Graph.
    3. Klicken Sie auf Delegierte Berechtigungen.
    4. Geben Sie unter Berechtigungen auswählen im Filtersuchfeld die folgenden Berechtigungen ein und fügen Sie sie hinzu:
    • Files.Read.All
    • Sites.Read.All
    • User.Read
    • SharePoint-Listen (JDBC)
    1. Klicken Sie auf Berechtigung hinzufügen.
    2. Wählen Sie Microsoft Graph.
    3. Klicken Sie auf Delegierte Berechtigungen.
    4. Geben Sie unter Berechtigungen auswählen im Filtersuchfeld Folgendes ein und fügen Sie dann die Berechtigung „User.Read“ hinzu.
    5. Klicken Sie erneut auf Berechtigung hinzufügen.
    6. Wählen Sie SharePoint.
    7. Klicken Sie auf Delegierte Berechtigungen.
    8. Erweitern Sie den Abschnitt AllSites, wählen Sie die Berechtigung „AllSites.Manage“ aus und fügen Sie sie hinzu.

Schritt 2: Konfigurieren von Tableau Server für Azure

Zum Konfigurieren von Tableau Server muss ein TSM-Befehl (Tableau Server Manager) ausgeführt werden. Azure Data Lake Storage Gen2 erfordert einen anderen Satz von Befehlen als der übliche Befehl, der für Azure Synapse, Azure SQL Database oder Databricks zum Einsatz kommt.

Konfigurieren des Standard-OAuth-Clients für Azure Data Lake Storage Gen2

Zum Konfigurieren von Tableau Server für Data Lake Storage Gen2 müssen Sie über die folgenden Konfigurationsparameter verfügen:

• Azure OAuth-Client-ID: Die Client-ID wird durch das Verfahren in Schritt 1 generiert. Kopieren Sie diesen Wert als [your_client_id] in den ersten tsm-Befehl.
• Azure OAuth-Client-Geheimnis: Das Client-Geheimnis wird durch das Verfahren in Schritt 1 generiert. Kopieren Sie diesen Wert als [your_client_secret] in den zweiten tsm-Befehl.
• Tableau Server-URL: Geben Sie Ihre Tableau Server-URL ein (z. B. https://myco.com). Kopieren Sie diesen Wert als [your_server_url] in den dritten tsm-Befehl.

Führen Sie die folgenden tsm-Befehle aus, um Tableau Server-OAuth für Azure Data Lake Storage Gen2 zu konfigurieren:

• tsm configuration set -k oauth.azuredatalake_storage_gen2.client_id -v [your_client_id] --force-keys
• tsm configuration set -k oauth.azuredatalake_storage_gen2.client_secret -v [your_client_secret] --force-keys
• tsm configuration set -k oauth.azuredatalake_storage_gen2.redirect_uri -v http://[your_server_url]/auth/add_oauth_token --force-keys
• tsm pending-changes apply

Konfigurieren des Standard-Clients für Azure Synapse, Azure SQL Database oder Databricks

Zum Konfigurieren von Tableau Server müssen Sie über die folgenden Konfigurationsparameter verfügen:

• Azure OAuth-Client-ID: Wird durch das Verfahren in Schritt 1 generiert. Kopieren Sie den Wert für [your_client_id] in den tsm-Befehl.
• Azure OAuth-Client-Geheimnis: Wird durch das Verfahren in Schritt 1 generiert. Kopieren Sie diesen Wert als [your_client_secret] in den zweiten tsm-Befehl.
• Tableau Server-URL: Dies ist Ihre Tableau Server-URL, wie z. B. https://myserver.com. Kopieren Sie diesen Wert als [your_server_url] in den dritten tsm-Befehl.
• Konfigurations-ID: Der Wert für den oauth.config.id-Parameter in dem folgenden tsm-Befehl. Gültige Werte:
  • Azure Synapse: azure_sql_dw
  • Azure SQL Database: azure_sqldb
  • Databricks: databricks

Führen Sie die folgenden tsm-Befehle aus, um Azure AD für Azure Synapse, Azure SQL Database oder Databricks zu konfigurieren. So richten Sie beispielsweise Azure Synapse ein:

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

Konfigurieren eines standardmäßigen OAuth-Clients für OneDrive (veraltet)

Zum Konfigurieren von Tableau Server für OneDrive (veraltet) müssen Sie über die folgenden Konfigurationsparameter verfügen:

• Azure OAuth-Client-ID: Die Client-ID wird durch das Verfahren in Schritt 1 generiert. Kopieren Sie diesen Wert als [your_client_id] in den ersten tsm-Befehl.
• Azure OAuth-Client-Geheimnis: Das Client-Geheimnis wird durch das Verfahren in Schritt 1 generiert. Kopieren Sie diesen Wert als [your_client_secret] in den zweiten tsm-Befehl.
• Tableau Server-URL: Dies ist Ihre Tableau Server-URL (z. B. https://myco.com). Kopieren Sie diesen Wert als [your_server_url] in den dritten tsm-Befehl.

Führen Sie zum Fortfahren die folgenden tsm-Befehle aus, um Tableau Server OAuth für OneDrive (veraltet) zu konfigurieren:

• tsm configuration set -k oauth.onedrive.client_id -v [your_client_id] --force-keys
• tsm configuration set -k oauth.onedrive.client_secret -v [your_client_secret] --force-keys
• tsm configuration set -k oauth.onedrive.redirect_uri -v http://[your_server_url]/auth/add_oauth_token --force-keys
• tsm pending-changes apply

Szenarien für einen Server-Neustart

Nachdem Sie einen standardmäßigen OAuth-Client konfiguriert haben, kann es zu den folgenden Szenarien kommen.

• Eine Aufforderung zum Neustart wird angezeigt, wenn die ausstehenden Änderungen einen Neustart des Servers erfordern.
• Sie können diese Aufforderung mithilfe der Option --ignore-prompt unterdrücken, wobei jedoch der Neustart nicht verhindert wird.
• Wenn die Änderungen keinen Neustart erfordern, werden die Änderungen ohne weitere Aufforderung angewendet. Weitere Informationen finden Sie unter tsm pending-changes apply.

Einstellen mehrerer Connectoren

Wenn Sie mehrere Connectoren einstellen möchten, müssen Sie diese alle in einen einzigen Befehl aufnehmen. Beispiel:

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"databricks\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

Konfigurieren von benutzerdefinierten OAuth für eine Site

Sie können benutzerdefinierte Azure Data Lake Storage Gen2-, Azure Synapse-, Azure SQL Database- und Databricks-OAuth-Clients für eine Site konfigurieren.