Help voor Tableau Server op Windows

De connectors van Azure Synapse, Azure SQL Database, Azure Databricks, Azure Data Lake Gen2, OneDrive en SharePoint Online en SharePoint Lists (JDBC) ondersteunen verificatie via Azure AD door een OAuth-client voor Tableau Server te configureren.

Opmerking: OAuth-ondersteuning voor Azure AD wordt alleen ondersteund met Microsoft SQLServer-stuurprogramma 17.3(Link wordt in een nieuw venster geopend) en later.

Stap 1: Registreer een OAuth-client voor Azure

Volg de onderstaande stappen om een OAuth-toepassing voor Azure te registreren en te configureren onder een specifieke Azure-tenant.

1. Meld u aan bij de Azure-portal.
2. Als u toegang hebt tot meerdere tenants, selecteert u de tenant waarin u een toepassing wilt registreren.
3. Zoek en selecteer Azure Active Directory.
4. Selecteer onder Beheren de optie App-registraties en selecteer vervolgens Nieuwe registratie.
5. Voer 'Tableau Server OAuth' of een vergelijkbare waarde in als de Naam.
6. Selecteer onder het veld Ondersteunde accounttypen op de app-registratiepagina wie deze toepassing kan gebruiken.

Opmerking: als u de client-ID en het clientgeheim van uw toepassing wilt gebruiken voor accounts onder een andere tenant, kiest u de tweede optie (Multitenant).

7. Kies onder het veld Omleiding-URI (optioneel) de optie Weben voer vervolgens het internetadres van uw server in, aangevuld met de tekenreeks /auth/add_oauth_token.

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

8. Selecteer Registreren. Nadat de registratie is voltooid, geeft de Azure-portal het overzichtsvenster van de appregistratie weer met daarin de toepassings-ID (client). Deze waarde, ook wel client-ID genoemd, identificeert uw toepassing op unieke wijze in het Microsoft Identity-platform.
9. Kopieer de waarde. Deze wordt gebruikt als het veld [your_client_id] in de volgende stappen.
10. Selecteer Certificaten en geheimen in de linkerbalk en kies vervolgens Nieuw clientgeheim.
11. Voeg een beschrijving van het geheim toe.
12. Selecteer Levensduur van het clientgeheim.
13. Kies Toevoegen en kopieer vervolgens het geheim. Het geheim wordt in de volgende stappen gebruikt als [your_client_secret].
14. Selecteer API-machtigingen op de linkerbalk.
15. Kies Machtigingen toevoegen.
16. Selecteer Microsoft Graph.
17. Kies Gedelegeerde machtigingen.
18. Selecteer onder Machtigingen selecteren alle OpenId-machtigingen (e-mail, offline_access, openid en profile).
19. Kies Machtigingen toevoegen.
20. Voeg extra machtigingen toe. Volg de onderstaande stappen voor de connector(s) die u inschakelt:
    • Azure SQL-database
      1. Klik op Een machtiging toevoegen.
      2. Selecteer Mijn API's.
      3. Klik op Azure SQL-database en vervolgens op Gedelegeerde machtigingen.
      4. Selecteer user_impersonation en klik vervolgens op Machtigingen toevoegen.
    • OneDrive en SharePoint Online
    1. Klik op Een machtiging toevoegen.
    2. Selecteer Microsoft Graph.
    3. Klik op Gedelegeerde machtigingen.
    4. Voer onder Machtigingen selecteren in het filterzoekvak de volgende machtigingen in en voeg deze toe:
    • Files.Read.All
    • Sites.Read.All
    • User.Read
    • SharePoint-lijsten (JDBC)
    1. Klik op Een machtiging toevoegen.
    2. Selecteer Microsoft Graph.
    3. Klik op Gedelegeerde machtigingen.
    4. Voer onder Machtigingen selecteren in het filterzoekvak de machtiging User.Read in en voeg deze toe.
    5. Klik opnieuw op Machtiging toevoegen.
    6. Selecteer SharePoint.
    7. Klik op Gedelegeerde machtigingen.
    8. Vouw de sectie AllSites uit, en selecteer vervolgens de machtiging AllSites.Manage en voeg deze toe.

Stap 2: Configureer Tableau Server voor Azure

Voor het configureren van Tableau Server is het uitvoeren van een Tableau Server Manager-opdracht (TSM) vereist. Voor Azure Data Lake Storage Gen2 is een andere set opdrachten vereist dan de algemene opdracht die wordt uitgevoerd voor Azure Synapse, Azure SQL Database of Databricks.

De standaard OAuth-client voor Azure Data Lake Storage Gen2 configureren

Als u Tableau Server voor Data Lake Storage Gen2 wilt configureren, hebt u de volgende configuratieparameters nodig:

• Azure OAuth-client-ID: de client-ID wordt gegenereerd via de procedure in stap 1. Kopieer deze waarde voor [your_client_id] in de eerste TSM-opdracht.
• Azure OAuth-clientgeheim: het clientgeheim wordt gegenereerd via de procedure in stap 1. Kopieer deze waarde voor [your_client_secret] in de tweede TSM-opdracht.
• URL van Tableau Server: voer uw Tableau Server-URL in, zoals https://myco.com. Kopieer deze waarde voor [your_server_url] in de derde TSM-opdracht.

Voer de volgende TSM-opdrachten uit om Tableau Server OAuth te configureren voor Azure Data Lake Storage Gen2:

• 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

De standaardclient voor Azure Synapse, Azure SQL Database of Databricks configureren

Als u Tableau Server wilt configureren, hebt u de volgende configuratieparameters nodig:

• Azure OAuth-client-ID: gegenereerd op basis van de procedure in stap 1. Kopieer deze waarde voor [your_client_id] in de TSM-opdracht.
• Azure OAuthClient-geheim: gegenereerd op basis van de procedure in stap 1. Kopieer deze waarde voor [your_client_secret] in de tweede TSM-opdracht.
• Tableau-server-URL: dit is uw Tableau Server-URL, zoals https://myserver.com. Kopieer deze waarde voor [your_server_url] in de derde TSM-opdracht.
• Configuratie-ID: de waarde voor de parameter oauth.config.id in de volgende TSM-opdracht. Geldige waarden:
  • Azure Synapse: azure_sql_dw
  • Azure SQL-Database: azure_sqldb
  • Databricks: databricks

Voer de volgende TSM-opdrachten uit om Azure AD te configureren voor Azure Synapse, Azure SQL Database of Databricks. Bijvoorbeeld Azure Synapse instellen:

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

Een standaard OAuth-client voor OneDrive (verouderd) configureren

Als u Tableau Server voor OneDrive (verouderd) wilt configureren, hebt u de volgende configuratieparameters nodig:

• Azure OAuth-client-ID: de client-ID wordt gegenereerd via de procedure in stap 1. Kopieer deze waarde voor [uw_client_id] in de eerste TSM-opdracht.
• Azure OAuth-clientgeheim: het clientgeheim wordt gegenereerd via de procedure in stap 1. Kopieer deze waarde voor [your_client_secret] in de tweede TSM-opdracht.
• Tableau-server-URL: dit is uw Tableau Server-URL, zoals https://myco.com. Kopieer deze waarde voor [your_server_url] in de derde TSM-opdracht.

Ga verder door de volgende TSM-opdrachten uit te voeren om Tableau Server OAuth voor OneDrive te configureren (verouderd):

• 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

Scenario's om de server opnieuw op te starten

Nadat u een standaard OAuth-client hebt geconfigureerd, kunnen de volgende scenario's optreden.

• Er verschijnt een herstartprompt als de lopende wijzigingen een herstart van de server vereisen.
• U kunt de prompt onderdrukken met de optie --ignore-prompt, maar dit verandert niets aan de herstart.
• Als de wijzigingen geen herstart vereisen, worden de wijzigingen zonder prompt toegepast. Zie tsm pending-changes-apply voor meer informatie.

Meerdere connectors instellen

Als u meerdere connectors moet instellen, moet u ze allemaal in één opdracht opnemen. Bijvoorbeeld:

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

Aangepaste OAuth configureren voor een site

U kunt aangepaste Azure Data Lake Storage Gen2-, Azure Synapse-, Azure SQL Database- en Databricks OAuth-clients configureren voor een site.

Forward-proxy voor OAuth-verificatie

Zie Een forward-proxy voor OAuth-verificatie configureren(Link wordt in een nieuw venster geopend) in Tableau Help voor meer informatie over het instellen van een forward-proxy met OAuth-verificatie voor Tableau Server (alleen Windows).