Einrichten von OAuth für Dropbox
Dieses Thema beschreibt, wie Sie Dropbox-Datenquellen für die OAuth-Authentifizierung einrichten. Führen Sie die Schritte für jede Tableau Server-Instanz aus.
Das Einrichten von OAuth für Dropbox umfasst die folgenden Aufgaben:
- Erstellen Sie eine neue App in der App-Konsole Ihres Dropbox-Entwicklerportals.
- Verwenden Sie die Informationen, die Sie bei der Erstellung der neuen Anwendung erhalten, um Ihren Server zu konfigurieren.
- (Optional) Konfigurieren Sie Site-spezifisches OAuth.
Schritt 1: Erstellen einer neuen App
- Melden Sie sich bei Ihrer Dropbox-Entwicklerkonsole an und wählen Sie dann App-Konsole.
- Klicken Sie auf die Schaltfläche App erstellen.
- Konfigurieren und benennen Sie Ihre App und wählen Sie die Schaltfläche App erstellen.
- Nachdem die App erstellt wurde, navigieren Sie zur Registerkarte "Berechtigungen" und stellen Sie sicher, dass die Berechtigung "files.content.read" ausgewählt ist.
- Navigieren Sie zur Registerkarte Einstellungen und fügen Sie eine Umleitungs-URI mit der Internetadresse für Ihren Tableau Server hinzu.
- Fügen Sie den folgenden Text an das Ende des URI an: auth/add_oauth_token. Beispiel:
- https://your_server_url.com/auth/add_oauth_token
- Kopieren Sie den App-Schlüssel, das App-Geheimnis und die Umleitungs-URI von der Registerkarte Einstellungen.
Schritt 2: Konfigurieren von Tableau Server für Dropbox
Öffnen Sie die Bash-Shell auf dem Tableau Server-Computer und führen Sie folgende Befehle aus:
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
Wenn die ausstehenden Änderungen einen Neustart des Servers erfordern, zeigt der Befehl pending-changes apply eine Meldung an, um Sie darüber zu informieren, dass ein Neustart stattfinden wird. Diese Meldung wird auch angezeigt, wenn der Server angehalten ist. In diesem Fall erfolgt jedoch kein Neustart. Sie können diese Meldung mithilfe der Option --ignore-prompt unterdrücken, dies ändert jedoch nichts am Neustartverhalten. Wenn die Änderungen keinen Neustart erfordern, werden die Änderungen ohne Meldung angewendet. Weitere Informationen finden Sie unter tsm pending-changes apply.
Konfigurieren von benutzerdefinierten OAuth für eine Site
Sie können eine benutzerdefinierte Dropbox-OAuth für eine Site konfigurieren.
Erwägen Sie die Konfiguration eines benutzerdefinierten OAuth-Clients, um 1) einen OAuth-Client zu überschreiben, wenn er für den Server konfiguriert ist, oder 2) Unterstützung für die sichere Verbindung zu Daten zu aktivieren, die eindeutige OAuth-Clients erfordern.
Wenn ein benutzerdefinierter OAuth-Client konfiguriert ist, hat die Konfiguration auf Site-Ebene Vorrang vor jeder serverseitigen Konfiguration und alle neu erstellten OAuth-Anmeldeinformationen verwenden standardmäßig den OAuth-Client auf Site-Ebene. Damit die Konfigurationen wirksam werden, ist kein Neustart von Tableau Server erforderlich.
Wichtig: Vorhandene OAuth-Anmeldeinformationen, die vor der Konfiguration des benutzerdefinierten OAuth-Clients erstellt wurden, sind vorübergehend verwendbar, aber sowohl Serveradministratoren als auch Benutzer müssen ihre gespeicherten Anmeldeinformationen aktualisieren, um einen kontinuierlichen Datenzugriff zu gewährleisten.
Schritt 1: Vorbereiten der OAuth-Client-ID, des Client-Geheimnisses und der Weiterleitungs-URL
Bevor Sie den benutzerdefinierten OAuth-Client konfigurieren können, benötigen Sie die unten aufgeführten Informationen. Sobald Sie diese Informationen zur Verfügung haben, können Sie den benutzerdefinierten OAuth-Client für die Site registrieren.
OAuth-Client-ID und Client-Geheimnis: Registrieren Sie zunächst den OAuth-Client beim Datenanbieter (Connector), um die für Tableau Server generierte Client-ID sowie das dazugehörige Geheimnis abzurufen.
Weiterleitungs-URL: Notieren Sie sich die korrekte Weiterleitungs-URL. Sie benötigen diese für den Registrierungsprozess in Schritt 2 weiter unten.
https://<your_server_name>.com/auth/add_oauth_token
Beispiel: https://example.com/auth/add_oauth_token
Schritt 2: Registrieren der OAuth-Client-ID und des Client-Geheimnisses
Befolgen Sie das unten beschriebene Verfahren, um den benutzerdefinierten OAuth-Client bei der Site zu registrieren.
Melden Sie sich mit Ihren Administrator-Anmeldeinformationen bei Ihrer Tableau Server-Site an und navigieren Sie zur Seite Einstellungen.
Klicken Sie unter "OAuth-Clients-Registrierung" auf die Schaltfläche OAuth-Client hinzufügen.
Geben Sie die erforderlichen Informationen ein, einschließlich der Informationen aus Schritt 1 oben:
Wählen Sie bei Verbindungstyp den Connector aus, dessen benutzerdefinierten OAuth-Client Sie konfigurieren möchten.
Geben Sie für Client-ID, Client-Geheimnis und Weiterleitungs-URL die Informationen ein, die Sie in Schritt 1 oben zusammengestellt haben.
Klicken Sie auf die Schaltfläche OAuth-Client hinzufügen, um den Registrierungsprozess abzuschließen.
(Optional) Wiederholen Sie Schritt 3 für alle unterstützten Connectoren.
- Klicken Sie unten oder oben auf der Einstellungsseite auf die Schaltfläche Speichern, um die Änderungen zu speichern.
Schritt 3: Validieren und Aktualisieren gespeicherter Anmeldeinformationen
Zur Gewährleistung eines kontinuierlichen Datenzugriffs müssen Sie (und Ihre Site-Benutzer) die zuvor gespeicherten Anmeldeinformationen löschen und sie erneut hinzufügen, um den benutzerdefinierten OAuth-Client für die Site zu verwenden.
Navigieren Sie zur Seite Eigene Kontoeinstellungen.
Führen Sie unter Gespeicherte Anmeldeinformationen für Datenquellen Folgendes aus:
Klicken Sie neben den vorhandenen gespeicherten Anmeldeinformationen für den Connector, dessen benutzerdefinierten OAuth-Client Sie oben in Schritt 2 konfiguriert haben, auf Löschen.
Klicken Sie neben dem Namen des Connectors auf Hinzufügen und folgen Sie den Anweisungen, um 1) eine Verbindung mit dem benutzerdefinierten OAuth-Client herzustellen, der oben in Schritt 2 konfiguriert wurde, und 2) die neuesten Anmeldeinformationen zu speichern.
Schritt 4: Benachrichtigung der Benutzer hinsichtlich der Aktualisierung ihrer gespeicherten Anmeldeinformationen
Stellen Sie sicher, dass Sie Ihre Site-Benutzer darüber informieren, ihre gespeicherten Anmeldeinformationen für den Connector zu aktualisieren, dessen benutzerdefinierten OAuth-Client Sie oben in Schritt 2 konfiguriert haben. Site-Benutzer können dazu die Vorgehensweise verwenden, die unter Aktualisierung gespeicherter Anmeldeinformationen beschrieben ist, um ihre gespeicherten Anmeldeinformationen zu aktualisieren.
Forward-Proxy für OAuth-Authentifizierung
Weitere Informationen zum Einrichten eines Forward-Proxys mit OAuth-Authentifizierung für Tableau Server (nur Windows) finden Sie unter Konfigurieren eines Forward-Proxys für OAuth-Authentifizierung(Link wird in neuem Fenster geöffnet) in der Tableau-Hilfe.