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:
- Maak een nieuwe app in de appconsole van de Dropbox-ontwikkelaarsportal.
- Gebruik de informatie die u ontvangt bij het maken van de nieuwe app om de server te configureren.
- (Optioneel) Configureer een sitespecifieke OAuth.
Stap 1: Maak een nieuwe app
- Meld u aan bij de Dropbox-ontwikkelaarsconsole en kies vervolgens Appconsole.
- Klik op de knop App maken.
- Configureer de app, geef hem een naam en kies de knop App maken.
- Nadat de app is gemaakt, gaat u naar het tabblad Machtigingen en controleert u of de machtiging files.content.read is geselecteerd.
- Ga naar het tabblad Instellingen en voeg een Omleiding-URI toe met behulp van het internetadres van de Tableau Server.
- Voeg aan het einde van de URI de volgende tekst toe: auth/add_oauth_token. Bijvoorbeeld:
- https://your_server_url.com/auth/add_oauth_token
- 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.
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.
Meld u aan bij uw Tableau Server-site met uw beheerdersreferenties en navigeer naar de pagina Instellingen.
Ga naar Register OAuth-clients en klik op de knop OAuth-client toevoegen.
Vul de vereiste informatie in, inclusief de informatie van Stap 1 hierboven:
Bij Verbindingstype selecteert u de connector waarvan u de aangepaste OAuth-client wilt configureren.
URL voor OAuth-instantie is vereist als er meerdere OAuth-clients worden geregistreerd. Anders is het optioneel.
Bij Klant-ID, Klantgeheim en Omleiding-URL, voert u de informatie in die u hebt voorbereid in Stap 1 hierboven.
Klik op de knop OAuth-client toevoegen om het registratieproces te voltooien.
(Optioneel) Herhaal stap 3 voor alle ondersteunde connectors.
- 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.
Navigeer naar uw pagina Mijn accountinstellingen.
Voer de volgende stappen uit onder Opgeslagen referenties voor databronnen:
Klik op Verwijderen naast de bestaande opgeslagen referenties voor de connector waarvan u de aangepaste OAuth-client hebt geconfigureerd in Stap 2 hierboven.
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.
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).