OAuth instellen voor Dropbox

In dit onderwerp wordt beschreven hoe u de Dropbox-databronnen instelt voor OAuth-verificatie. Voltooi de stappen voor elke Tableau Server-instantie.

Het instellen van OAuth voor Dropbox bestaat uit de volgende taken:

  1. Maak een nieuwe app in de appconsole van de Dropbox-ontwikkelaarsportal.
  2. Gebruik de informatie die u ontvangt bij het maken van de nieuwe app om de server te configureren.
  3. (Optioneel) Configureer een sitespecifieke OAuth.

Stap 1: Maak een nieuwe app

  1. Meld u aan bij de Dropbox-ontwikkelaarsconsole en kies vervolgens Appconsole.
  2. Klik op de knop App maken.
  3. Configureer de app, geef hem een naam en kies de knop App maken.
  4. Nadat de app is gemaakt, gaat u naar het tabblad Machtigingen en controleert u of de machtiging files.content.read is geselecteerd.
  5. Ga naar het tabblad Instellingen en voeg een Omleiding-URI toe met behulp van het internetadres van de Tableau Server.
  6. Voeg aan het einde van de URI de volgende tekst toe: auth/add_oauth_token. Bijvoorbeeld:
  7. https://your_server_url.com/auth/add_oauth_token
  8. Kopieer de appcode, het appgeheim en de omleiding-URI uit het tabblad Instellingen.

Stap 2: Configureer Tableau Server voor Dropbox

Open op de Tableau Server-computer de bash-shell en voer de volgende TSM-opdrachten uit:

tsm configuration set -k oauth.dropbox.redirect_uri -v <your_authorized_redirect_uri>

tsm configuration set -k oauth.dropbox.client_id -v <your_app_key>

tsm configuration set -k oauth.dropbox.client_secret -v <your_app_secret>

tsm pending-changes apply

Als de lopende wijzigingen een herstart van de server vereisen, geeft de opdracht pending-changes apply een prompt weer om u te laten weten dat er een herstart zal plaatsvinden. Deze prompt verschijnt ook als de server is gestopt, maar in dat geval vindt er geen herstart plaats. U kunt de prompt onderdrukken met de optie --ignore-prompt, maar dit verandert niets aan het herstartgedrag. Als de wijzigingen geen herstart vereisen, worden de wijzigingen zonder prompt toegepast. Zie tsm pending-changes-apply voor meer informatie.

Aangepaste OAuth configureren voor een site

U kunt de aangepaste Dropbox OAuth configureren voor een site.

U kunt een aangepaste OAuth-client configureren om 1) een OAuth-client te overschrijven, als deze voor de server is geconfigureerd, of 2) ondersteuning te bieden voor een veilige verbinding met data waarvoor unieke OAuth-clients nodig zijn.

Wanneer een aangepaste OAuth-client is geconfigureerd, heeft de configuratie op siteniveau voorrang op eventuele configuraties aan de serverzijde en maken alle nieuwe OAuth-referenties standaard gebruik van de OAuth-client op siteniveau. U hoeft Tableau Server niet opnieuw op te starten om de configuraties van kracht te laten worden.

Belangrijk: Bestaande OAuth-referenties die zijn ingesteld voordat de aangepaste OAuth-client is geconfigureerd, zijn tijdelijk bruikbaar, maar zowel serverbeheerders als gebruikers moeten hun opgeslagen referenties bijwerken om ononderbroken toegang tot gegevens te garanderen.

1: Bereid de OAuth-client-ID, het clientgeheim en de omleiding-URL voor

Voordat u de aangepaste OAuth-client kunt configureren, hebt u de onderstaande informatie nodig. Nadat u deze informatie hebt voorbereid, kunt u de aangepaste OAuth-client voor de site registreren.

  • OAuth-client-ID en clientgeheim: Registreer eerst de OAuth-client bij de dataprovider (connector) om de client-ID en het geheim op te halen die voor Tableau Server zijn gegenereerd.

  • Omleiding-URL: Let op de juiste omleiding-URL. U hebt dit nodig tijdens het registratieproces in Stap 2 hieronder.

    https://<uw_servernaam>.com/auth/add_oauth_token

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

2: Registreer de OAuth-client-ID en het clientgeheim

Voer de hieronder beschreven procedure uit om de aangepaste OAuth-client op de site te registreren.

  1. Meld u aan bij uw Tableau Server-site met uw beheerdersreferenties en navigeer naar de pagina Instellingen.

  2. Ga naar Register OAuth-clients en klik op de knop OAuth-client toevoegen.

  3. Vul de vereiste informatie in, inclusief de informatie van Stap 1 hierboven:

    1. Bij Verbindingstype selecteert u de connector waarvan u de aangepaste OAuth-client wilt configureren.

    2. URL voor OAuth-instantie is vereist als er meerdere OAuth-clients worden geregistreerd. Anders is het optioneel.

    3. Bij Klant-ID, Klantgeheim en Omleiding-URL, voert u de informatie in die u hebt voorbereid in Stap 1 hierboven.

    4. Klik op de knop OAuth-client toevoegen om het registratieproces te voltooien.

  4. (Optioneel) Herhaal stap 3 voor alle ondersteunde connectors.

  5. Klik op de knop Opslaan onderaan of bovenaan de pagina Instellingen om de wijzigingen op te slaan.

3: Valideer de opgeslagen referenties en werk deze bij

U (en uw sitegebruikers) moeten de eerder opgeslagen referenties verwijderen en deze opnieuw toevoegen om de aangepaste OAuth-client voor de site te gebruiken.

  1. Navigeer naar uw pagina Mijn accountinstellingen.

  2. Voer de volgende stappen uit onder Opgeslagen referenties voor databronnen:

    1. Klik op Verwijderen naast de bestaande opgeslagen referenties voor de connector waarvan u de aangepaste OAuth-client hebt geconfigureerd in Stap 2 hierboven.

    2. Klik naast de connectornaam op Toevoegen en volg de aanwijzingen om 1) verbinding te maken met de aangepaste OAuth-client die is geconfigureerd in Stap 2 hierboven en 2) om de meest recente referenties op te slaan.

4: Informeer gebruikers dat ze hun opgeslagen referenties moeten bijwerken

Zorg ervoor dat u uw sitegebruikers op de hoogte stelt om hun opgeslagen referenties bij te werken voor de connector waarvan u de aangepaste OAuth-client hebt geconfigureerd in Stap 2 hierboven. Sitegebruikers kunnen hun opgeslagen referenties bijwerken aan de hand van de procedure die wordt beschreven in Opgeslagen referenties bijwerken.