Interne aangepaste certificaten configureren voor Tableau Server
Versie: toegevoegd in versie 2026.3.0.
Standaard gebruikt Tableau Server zelfondertekende certificaten om de communicatie tussen interne services en componenten te versleutelen.Vanaf versie 2026.3.0 hebben serverbeheerders de optie om deze door TSM gegenereerde certificaten te vervangen door aangepaste certificaten die zijn uitgegeven door hun eigen bedrijfs-PKI of certificaatautoriteit (CA).In dit onderwerp leest u hoe u Tableau Server configureert om in plaats van de standaard, zelfondertekende certificaten aangepaste certificaten te gebruiken voor de interne service-naar-service communicatie.(Sommige certificaten zijn servicespecifiek en andere zijn bedoeld voor componenten die meerdere services gebruiken.Gemakshalve verwijzen we hier met de term 'services' naar beide gevallen.)
Opmerking: de hier besproken aangepaste certificaten en tsm-opdrachten voor het configureren van Tableau Server betreffen specifiek de interne communicatie tussen Tableau Server-services.Deze certificaten verschillen van externe (gateway) SSL, die gericht is op browsers en andere externe clients.Zie SSL configureren voor extern HTTP-verkeer naar en vanaf Tableau Server voor informatie over het configureren van externe SSL.We raden u aan om een afzonderlijk certificaat te gebruiken voor externe gateway SSL.
Waarom zou u aangepaste certificaten gebruiken?
Niet elke installatie van Tableau Server heeft aangepaste certificaten nodig, maar voor bedrijven die moeten voldoen aan de nalevingsvereisten in gereguleerde sectoren (zoals FIPS in de VS), is de mogelijkheid om aangepaste certificaten in plaats zelfondertekende certificaten te gebruiken cruciaal.Ze kunnen ook nodig zijn om door beveiligingsscans aangegeven problemen op te lossen als deze zelfondertekende interne certificaten markeren.Uw IT- en beveiligingsteams kunnen u vertellen of u aangepaste certificaten moet gebruiken.
Services die aangepaste certificaten ondersteunen
De volgende interne services ondersteunen aangepaste certificaten.Gebruik de servicenaam met de --name-optie tsm security internal-cert set en tsm security internal-cert reset.Voer tsm security internal-cert list uit zonder de optie --name om de namen van beschikbare services te zien.
Eenvoudige TLS (servercertificaat en -sleutel, met een optionele keten):
apiGateway,gatewayInternal,hyper,jmx,thrift,tsigLogs,relationshipService,recommendationsService,vizportalMetadataApienbackgrounderMetadataApiWederzijdse TLS (mTLS), waarvoor naast het servercertificaat ook een clientcertificaat en -sleutel nodig zijn:
activemqMTLS,coordinationServiceOpmerking: de coördinatieservice kan ook worden geconfigureerd met een eigen opdracht als u ervoor kiest om daarvoor een apart certificaat te gebruiken.Zie (Optioneel) Een afzonderlijk aangepast certificaat voor de coördinatieservice configureren hieronder voor meer informatie.
Daarnaast orkestreert tsm security internal-cert set-all de volgende reeds bestaande subsystemen:
Opslagplaats-SSL (PostgreSQL), TSM-controller SSL en OpenSearch (indexerings- en zoekserver).
Wanneer u
set-allgebruikt, wordt het servercertificaat toegewezen aan de knooppunt- en servicecertificaten, wordt het clientcertificaat toegewezen aan de ActiveMQ-client en de OpenSearch-beheerder en wordt de keten toegewezen aan de OpenSearch CA (certificaatautoriteit).
Certificaatvereisten
De certificaten en sleutels die u aan deze opdrachten verstrekt, moeten voldoen aan de volgende vereisten:
Certificaten moeten met PEM versleutelde X.509-certificaten zijn.Privésleutels moeten de PKCS#1- of PKCS#8-indeling hebben.
De sleutelalgoritmen RSA en ECC (EC/ECDSA) worden ondersteund.DSA-sleutels worden afgewezen.
Versleutelde sleutels worden ondersteund.Gebruik de opties
--passphraseen--client-passphraseom de wachtwoordzin op te geven.Het aanleveren van een ketenbestand is optioneel, maar voor de meeste implementaties is dit vereist.Voor een privé- of interne CA moet de root-CA in de keten worden opgenomen.De root-CA kan alleen worden weggelaten als het certificaat is uitgegeven door een bekende openbare CA die al door de JVM wordt vertrouwd.De root-CA moet ook in het besturingssysteem en in de Java-vertrouwensopslag op alle knooppunten worden geïnstalleerd.
Hostnaamverificatie: het TSM-controllercertificaat moet de FQDN (Fully Qualified Domain Name) van het controllerknooppunt bevatten als de algemene naam (CN) of als een DNS SAN (Subject Alternative Name), bijvoorbeeld
DNS:<value returned by the Linux hostname command>.Alleen dat volstaat voor validatie.Andere interne certificaten valideren momenteel geen hostnamen.Als u wilt dat het certificaat geldig blijft als de TSM-controller ooit naar een ander knooppunt verhuist, geeft u het certificaat uit met SAN's die elk knooppunt in het cluster dekken waarop de controller kan worden uitgevoerd. U kunt ook een SAN met jokerteken gebruiken voor het gedeelde domein (bijvoorbeeldDNS:*.corp.example.com).EKU (Extended Key Usage): stel de EKU niet uitsluitend in op
serverAuthofclientAuth.Het is mogelijk om de EKU niet in te stellen of om de EKU op beide waarden in te stellen, maar u kunt de EKU niet op één waarde afzonderlijk instellen.
Tableau Server configureren met aangepaste certificaten voor interne communicatie
De Tableau Server-functie voor aangepaste certificaten introduceert een aantal nieuwe TSM CLI-opdrachten.Hiermee kunnen beheerders certificaten aanwijzen die Tableau Server moet gebruiken voor communicatie tussen interne services.De nieuwe opdrachten omvatten een reeks subopdrachten onder tsm security internal-cert en een vergelijkbare reeks subopdrachten onder tsm security coordination-service-internal-cert die specifiek zijn voor de coördinatieservice.
Aangepaste certificaten configureren voor afzonderlijke services
Een serverbeheerder kan een aangepast certificaat instellen voor afzonderlijke services.
Aangepaste certificaten configureren voor een afzonderlijke service:
Gebruik
tsm security internal-cert listom de geconfigureerde interne certificaten weer te geven.Gebruik
tsm security internal-cert resetom een intern certificaat voor een opgegeven service terug te zetten naar het standaard, zelfondertekende certificaat.Gebruik
tsm security internal-cert setom een intern certificaat te configureren voor een opgegeven service.Gebruik
tsm security coordination-service-internal-cert setom een intern certificaat te configureren voor de coördinatieservice.
Aangepaste certificaten bulksgewijs configureren
Een serverbeheerder kan aangepaste certificaten ook bulksgewijs instellen voor alle toepasselijke services.
Aangepaste certificaten bulksgewijs configureren (alle toepasselijke services):
Gebruik
tsm security internal-cert listom de geconfigureerde interne certificaten weer te geven.Gebruik
tsm security internal-cert reset-allom de interne certificaten voor alle toepasselijke services terug te zetten naar het standaard, zelfondertekende certificaat.Gebruik
tsm security internal-cert set-allom een intern certificaat te configureren voor alle toepasselijke services.
Opmerking: als u specifieke services wilt uitsluiten bij het gebruik van de opdrachten set-all of reset-all, gebruikt u de optie --exclude <service>.
(Optioneel) Een afzonderlijk aangepast certificaat voor de coördinatieservice configureren
Het certificaat van de coördinatieservice (ZooKeeper) kan afzonderlijk worden geconfigureerd met behulp van de opdrachten tsm security coordination-service-internal-cert. Voor dit certificaat gelden specifieke vereisten en beperkingen.Mogelijk wilt u de coördinatieservice uit veiligheidsoverwegingen afzonderlijk configureren of wilt u de impact beperken als er iets misgaat en u een certificaat opnieuw moet instellen.
Gebruik
tsm security coordination-service-internal-cert listom het geconfigureerde interne certificaat voor de coördinatieservice weer te geven.Gebruik
tsm security coordination-service-internal-cert resetom een intern certificaat voor de coördinatieservice terug te zetten naar het standaard, zelfondertekende certificaat.Gebruik
tsm security coordination-service-internal-cert setom een aangepast certificaat te configureren voor de coördinatieservice.
Als er problemen zijn met het certificaat van de coördinatieservice, dient u specifieke stappen te ondernemen om een volledige herinstallatie met een back-up van Tableau Server te voorkomen.Zie Een aangepast certificaat voor de coördinatieservice herstellen voor meer informatie.
