Konfiguration interner benutzerdefinierter Zertifikate für Tableau Server
Version: Hinzugefügt in Version 2026.3.0
Standardmäßig verwendet Tableau Server selbstsignierte Zertifikate, um die Kommunikation zwischen internen Diensten und Komponenten zu verschlüsseln.Ab Version 2026.3.0 haben Serveradministratoren die Möglichkeit, diese TSM-generierten Zertifikate durch benutzerdefinierte Zertifikate zu ersetzen, die von ihrer eigenen Unternehmens-PKI oder Zertifizierungsstelle (CA) ausgestellt wurden.Auf dieser Themenseite wird erläutert, wie Sie Tableau Server so konfigurieren, dass anstelle der standardmäßigen, selbstsignierten Zertifikate benutzerdefinierte Zertifikate für die interne Service-to-Service-Kommunikation verwendet werden.(Einige Zertifikate sind dienstspezifisch und andere gelten für Komponenten, die mehrere Dienste verwenden.Der Einfachheit halber verwenden wir hier den Begriff „Dienste“, um beide Fälle zu umfassen.)
Hinweis: Die hier beschriebenen benutzerdefinierten Zertifikate und tsm-Befehle zur Konfiguration von Tableau Server beziehen sich speziell auf die interne Kommunikation zwischen Tableau Server-Diensten.Diese Zertifikate unterscheiden sich von externem (Gateway) SSL, das für Browser und andere externe Clients bestimmt ist.Informationen zum Konfigurieren von externem SSL finden Sie unter Konfigurieren von SSL für den externen HTTP-Verkehr von und an Tableau Server.Wir empfehlen, ein separates Zertifikat für externes Gateway-SSL zu verwenden.
Warum benutzerdefinierte Zertifikate verwenden?
Nicht jede Installation von Tableau Server benötigt benutzerdefinierte Zertifikate, aber für Unternehmen, die Compliance-Anforderungen für regulierte Branchen (z. B. FIPS) einhalten müssen, ist die Möglichkeit, benutzerdefinierte Zertifikate anstelle der selbstsignierten Zertifikate zu verwenden, entscheidend.Diese können auch erforderlich sein, um Sicherheitsscans zu lösen, die selbstsignierte interne Zertifikate beanstanden.Ihre IT- und Sicherheitsteams sollten Ihnen mitteilen, ob Sie benutzerdefinierte Zertifikate verwenden müssen.
Dienste, die benutzerdefinierte Zertifikate unterstützen
Die folgenden internen Dienste unterstützen benutzerdefinierte Zertifikate.Verwenden Sie den Dienstnamen mit der Option --name von tsm security internal-cert set und tsm security internal-cert reset.Um die verfügbaren Dienstnamen anzuzeigen, führen Sie tsm security internal-cert list ohne die Option --name aus.
Einfaches TLS (Serverzertifikat und Schlüssel, mit einer optionalen Kette):
apiGateway,gatewayInternal,hyper,jmx,thrift,tsigLogs,relationshipService,recommendationsService,vizportalMetadataApiundbackgrounderMetadataApiGegenseitiges TLS (Mutual TLS, mTLS), bei dem zusätzlich zum Serverzertifikat ein Clientzertifikat und ein Schlüssel erforderlich sind:
activemqMTLS,coordinationServiceHinweis: Der Koordinationsdienst kann auch mit einem eigenen Befehl konfiguriert werden, wenn Sie dafür lieber ein separates Zertifikat verwenden möchten.Weitere Informationen finden Sie unter (Optional) Konfigurieren eines separaten benutzerdefinierten Zertifikats für den Koordinationsdienst weiter unten.
Darüber hinaus orchestriert tsm security internal-cert set-all die folgenden bereits vorhandenen Subsysteme:
Repository-SSL (PostgreSQL), TSM-Controller-SSL und OpenSearch (Indizierungs- und Suchserver).
Wenn Sie
set-allverwenden, wird das Serverzertifikat den Knoten- und Dienstzertifikaten zugeordnet, das Clientzertifikat wird dem ActiveMQ-Client und dem OpenSearch-Administrator zugeordnet, und die Kette wird der OpenSearch-Zertifizierungsstelle zugeordnet.
Zertifikatsanforderungen
Die Zertifikate und Schlüssel, die Sie in diesen Befehlen angeben, müssen die folgenden Anforderungen erfüllen:
Zertifikate müssen PEM-codierte X.509-Zertifikate sein.Private Schlüssel müssen im Format „PKCS#1“ oder „PKCS#8“ vorliegen.
Die Schlüsselalgorithmen RSA und ECC (EC/ECDSA) werden unterstützt.DSA-Schlüssel werden abgelehnt.
Verschlüsselte Schlüssel werden unterstützt.Verwenden Sie die Optionen
--passphraseund--client-passphrase, um die Passphrase anzugeben.Die Angabe einer Kettendatei ist optional, für die meisten Bereitstellungen ist jedoch eine erforderlich.Für eine private oder interne Zertifizierungsstelle muss die Stammzertifizierungsstelle in der Kette enthalten sein.Die Stammzertifizierungsstelle kann nur weggelassen werden, wenn das Zertifikat von einer bekannten öffentlichen Zertifizierungsstelle ausgestellt wurde, der die JVM bereits vertraut.Die Stammzertifizierungsstelle sollte auch in dem Betriebssystem und im Java-Truststore auf allen Knoten installiert sein.
Hostnamenüberprüfung: Das TSM-Controller-Zertifikat muss den vollständig qualifizierten Domänennamen (FQDN) des Controller-Knotens als den allgemeinen Namen (CN) oder als einen DNS-SAN (Subject Alternative Name) enthalten – zum Beispiel
DNS:<value returned by the Linux hostname command>.Dies allein reicht für die Validierung aus.Andere interne Zertifikate validieren derzeit keine Hostnamen.Damit das Zertifikat gültig bleibt, falls der TSM-Controller jemals auf einen anderen Knoten wechselt, stellen Sie das Zertifikat mit SANs aus, die jeden Knoten in dem Cluster abdecken, auf dem der Controller ausgeführt werden könnte, oder verwenden Sie einen Platzhalter-SAN für die gemeinsam genutzte Domäne (z. B.DNS:*.corp.example.com).Erweiterte Schlüsselverwendung (Extended Key Usage, EKU): Legen Sie die EKU nicht allein auf
serverAuthoderclientAuthfest.Sie können die EKU entweder undefiniert belassen oder auf beide Werte festlegen, jedoch nicht auf einen einzelnen Wert.
Konfigurieren von Tableau Server mit benutzerdefinierten Zertifikaten für die interne Kommunikation
Das Tableau Server-Feature für benutzerdefinierte Zertifikate bringt eine Reihe neuer TSM-CLI-Befehle mit sich.Diese geben Administratoren die Möglichkeit, Zertifikate festzulegen, die Tableau Server für die Kommunikation zwischen internen Diensten verwenden soll.Die neuen Befehle umfassen eine Reihe von Unterbefehlen unter tsm security internal-cert und eine ähnliche Reihe von Unterbefehlen unter tsm security coordination-service-internal-cert, die für den Koordinationsdienst spezifisch sind.
Konfigurieren benutzerdefinierter Zertifikate für einzelne Dienste
Ein Serveradministrator kann ein benutzerdefiniertes Zertifikat für einzelne Dienste festlegen.
So konfigurieren Sie benutzerdefinierte Zertifikate für einzelne Dienste:
Verwenden Sie
tsm security internal-cert list, um die konfigurierten internen Zertifikate anzuzeigen.Verwenden Sie
tsm security internal-cert reset, um ein internes Zertifikat für einen bestimmten Dienst wieder auf das standardmäßige, selbstsignierte Zertifikat zurückzusetzen.Verwenden Sie
tsm security internal-cert set, um ein internes Zertifikat für einen bestimmten Dienst zu konfigurieren.Verwenden Sie
tsm security coordination-service-internal-cert set, um ein internes Zertifikat für den Koordinationsdienst zu konfigurieren.
Konfigurieren mehrerer benutzerdefinierter Zertifikate auf einmal
Ein Serveradministrator kann benutzerdefinierte Zertifikate auch in einem Sammelvorgang für alle entsprechenden Dienste festlegen.
So konfigurieren Sie benutzerdefinierte Zertifikate als Sammelvorgang (für alle entsprechenden Dienste):
Verwenden Sie
tsm security internal-cert list, um die konfigurierten internen Zertifikate anzuzeigen.Verwenden Sie
tsm security internal-cert reset-all, um die internen Zertifikate für alle entsprechenden Dienste wieder auf das standardmäßige, selbstsignierte Zertifikat zurückzusetzen.Verwenden Sie
tsm security internal-cert set-all, um ein internes Zertifikat für alle entsprechenden Dienste zu konfigurieren.
Hinweis: Um bei Verwendung der Befehle set-all oder reset-all bestimmte Dienste auszuschließen, verwenden Sie die Option --exclude <service>.
(Optional) Konfigurieren eines separaten benutzerdefinierten Zertifikats für den Koordinationsdienst
Das Zertifikat für den Koordinationsdienst (ZooKeeper) kann mithilfe der tsm security coordination-service-internal-cert-Befehle separat konfiguriert werden, und für das Zertifikat gibt es spezielle Anforderungen und Einschränkungen.Möglicherweise möchten Sie den Koordinationsdienst aus Sicherheitsgründen separat konfigurieren oder um die Auswirkungen zu begrenzen, falls ein Fehler auftritt und Sie ein Zertifikat zurücksetzen müssen.
Verwenden Sie
tsm security coordination-service-internal-cert list, um das konfigurierte interne Zertifikat für den Koordinationsdienst anzuzeigen.Verwenden Sie
tsm security coordination-service-internal-cert reset, um ein internes Zertifikat für den Koordinationsdienst wieder auf das standardmäßige, selbstsignierte Zertifikat zurückzusetzen.Verwenden Sie
tsm security coordination-service-internal-cert set, um ein benutzerdefiniertes Zertifikat für den Koordinationsdienst zu konfigurieren.
Wenn Probleme mit dem Zertifikat des Koordinationsdienstes auftreten, müssen Sie bestimmte Schritte durchführen, um eine vollständige Neuinstallation mit Sicherung von Tableau Server zu vermeiden.Weitere Informationen finden Sie unter Wiederherstellen eines benutzerdefinierten Koordinationsdienst-Zertifikats.
