Cara Membuat CSR di Tableau Server

Tutorial ini menunjukkan kepada Anda cara membuat CSR (Certificate Signing Request) dan private key untuk Tableau Server di Windows dan Linux. Tableau Server tidak memiliki generator CSR bawaan, jadi Anda menggunakan biner OpenSSL yang tersedia di dalam paket Apache bundel-nya. Buat key dan CSR di node Tableau Server, ajukan CSR ke Certificate Authority Anda, dan setelah sertifikat yang ditandatangani diterima, impor melalui Tableau Services Manager.

Apa yang Anda perlukan

• Akses Administrator (Windows) atau sudo (Linux) pada node Tableau Server.
• Versi paket Apache yang persis sama dengan yang dibundel bersama rilis Tableau Server Anda. Buat daftar C:Program FilesTableauTableau Serverpackages di Windows atau /opt/tableau/tableau_server/packages/ di Linux untuk menemukan folder bernama apache.X.Y.Z. Bagian X.Y.Z berubah setiap kali ada rilis baru Tableau Server.
• Fully qualified domain name (FQDN) yang persis, yang akan dilayani oleh Tableau Server, misalnya tableau.yourdomain.com, ditambah hostname tambahan lain yang ingin Anda sertakan pada sertifikat yang sama (untuk bidang SAN).
• Detail legal organisasi Anda (negara, provinsi, kota, nama organisasi) untuk Distinguished Name pada CSR.

Catatan ukuran key untuk 2026. Tableau Server 2025.3 dan versi setelahnya berjalan pada OpenSSL 3.4.x dengan keamanan Level 2, yang menolak key RSA lebih pendek dari 2048 bit. Gunakan RSA 2048-bit sebagai minimum; 3072 atau 4096 bit merupakan peningkatan yang wajar untuk key yang Anda rencanakan untuk digunakan selama beberapa tahun. Dokumentasi Tableau sendiri menggunakan RSA 4096-bit dalam contohnya.

Membuat CSR di Tableau Server untuk Windows

Jika Anda sudah membuat CSR, lanjutkan ke ajukan CSR ke Certificate Authority Anda lalu ke instal sertifikat SSL Anda pada Tableau Server.

Langkah 1: Buka Command Prompt dengan hak istimewa (elevated)

Tekan tombol Windows, ketik cmd, lalu klik kanan Command Prompt dan pilih Run as administrator. Hak istimewa yang lebih tinggi diperlukan karena OpenSSL bundel berada di bawah C:Program Files.

Langkah 2: Masuk ke direktori bin Apache bundel

Tableau menyertakan OpenSSL-nya sendiri di dalam paket Apache. Tampilkan daftar folder packages untuk memastikan versi persis yang terpasang di server Anda:

dir "C:Program FilesTableauTableau Serverpackages"

Anda akan melihat folder bernama apache.X.Y.Z (misalnya apache.20243.24.1015.1532). Masuk ke direktori bin di dalamnya, ganti dengan kode versi Anda sendiri:

cd "C:Program FilesTableauTableau Serverpackagesapache.20243.24.1015.1532bin"

Langkah 3: Buat private key

Buat private key RSA 2048-bit. Ganti tableau dengan nama file dasar yang Anda sukai; key dan CSR akan menggunakan nama dasar yang sama:

openssl.exe genrsa -out tableau.key 2048

Jaga keamanan tableau.key. Inilah private key yang berpasangan dengan sertifikat yang akan diterbitkan oleh CA, dan Tableau Server tidak dapat menyajikan TLS tanpanya. Contoh dokumentasi Tableau menggunakan 4096 alih-alih 2048; keduanya diterima oleh CA publik.

Langkah 4: Buat CSR dengan ekstensi SAN

Browser dan klien TLS modern memvalidasi sertifikat berdasarkan ekstensi Subject Alternative Name (SAN), bukan hanya berdasarkan Common Name, jadi sertakan daftar SAN dalam permintaan. Ganti hostname setelah DNS: dengan FQDN yang harus dijawab oleh Tableau Server:

openssl.exe req -new -key tableau.key -out tableau.csr -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

Jika OpenSSL memberi peringatan bahwa file konfigurasi tidak dapat dimuat (peringatan tentang /usr/local/ssl/openssl.cnf di Windows aman untuk diabaikan, tetapi error yang menghentikan perintah harus ditangani), arahkan secara eksplisit ke konfigurasi OpenSSL yang disertakan Tableau dengan menambahkan -config ..confopenssl.cnf:

openssl.exe req -new -key tableau.key -out tableau.csr -config ..confopenssl.cnf -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

Langkah 5: Isi detail organisasi Anda

OpenSSL akan meminta bidang-bidang yang masuk ke dalam Distinguished Name CSR. Gunakan nilai yang tepat dan legal: Certificate Authority publik akan menolak ketidaksesuaian dengan catatan bisnis.

• Country Name (2 letter code): kode ISO dua huruf untuk negara Anda, misalnya US, GB, DE.
• State or Province Name: nama lengkap negara bagian atau provinsi tempat organisasi Anda terdaftar, misalnya California. Jangan gunakan singkatan dua huruf.
• Locality Name: nama kota lengkap, misalnya San Francisco.
• Organization Name: nama resmi lengkap perusahaan Anda, misalnya Your Company LLC. Untuk sertifikat domain-validated (DV), bidang ini tidak divalidasi dan boleh dikosongkan, tetapi jangan hanya menekan Enter: OpenSSL kemudian akan menyisipkan nilai default apa pun yang ditentukan konfigurasinya, dan konfigurasi bawaan menyertakan Internet Widgits Pty Ltd, yang akan masuk ke CSR Anda. Ketik satu titik (.) untuk mengosongkan bidang tersebut secara benar-benar. Hal yang sama berlaku untuk Country dan State, yang nilai default bawaannya adalah AU dan Some-State.
• Organizational Unit Name: sudah usang dan tidak lagi diterbitkan oleh CA publik. Tekan Enter untuk melewatinya.
• Common Name: FQDN persis yang akan diketik pengguna untuk mengakses Tableau Server, misalnya tableau.yourdomain.com. Cantumkan nilai yang sama dengan entri SAN pertama Anda.
• Email Address: alamat email kontak yang valid, atau tekan Enter untuk melewatinya.
• A challenge password dan An optional company name: biarkan keduanya kosong. CA publik mengabaikan bidang ini.

Setelah prompt selesai, OpenSSL menulis CSR ke tableau.csr di direktori saat ini. Lanjutkan dengan memverifikasi CSR di bawah ini.

Membuat CSR di Tableau Server untuk Linux

Langkah 1: Temukan direktori bin Apache bundel

Tableau Server di Linux menyertakan OpenSSL-nya sendiri di dalam /opt/tableau/tableau_server/packages/apache.X.Y.Z/bin. Tampilkan daftar folder packages untuk menemukan versi persis yang terpasang di server Anda:

ls /opt/tableau/tableau_server/packages/ | grep apache

Anda akan melihat direktori bernama apache.X.Y.Z (misalnya apache.20243.24.1015.1532). Gunakan nama persis tersebut dalam perintah-perintah di bawah ini. Anda tidak perlu cd ke direktori bin; contoh-contoh berikut memanggil OpenSSL bundel dengan jalur absolutnya sehingga Anda dapat menjalankannya dari direktori home Anda.

Langkah 2: Buat private key

Buat private key RSA 2048-bit, memanggil biner OpenSSL bundel melalui jalur absolutnya. Ganti kode versi dengan milik Anda sendiri:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl genrsa -out tableau.key 2048

Jaga keamanan tableau.key dan pastikan hanya dapat dibaca oleh pengguna yang akan menjalankan proses impor. Contoh dokumentasi Tableau menggunakan 4096 alih-alih 2048; keduanya diterima oleh CA publik.

Langkah 3: Buat CSR dengan ekstensi SAN

Sertakan daftar Subject Alternative Name langsung pada baris perintah. Ganti hostname setelah DNS: dengan FQDN yang harus dijawab oleh Tableau Server:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl req -new -key tableau.key -out tableau.csr -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

Jika OpenSSL menolak untuk berjalan karena tidak dapat memuat konfigurasi default, arahkan ke konfigurasi OpenSSL yang disertakan Tableau dengan menambahkan flag -config:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl req -new -key tableau.key -out tableau.csr -config /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/conf/openssl.cnf -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

Langkah 4: Isi detail organisasi Anda

OpenSSL akan meminta bidang Distinguished Name yang sama seperti di Windows. Gunakan nilai yang tepat dan legal:

• Country Name (2 letter code): kode negara ISO dua huruf, misalnya CA.
• State or Province Name: nama lengkap negara bagian atau provinsi, misalnya Ontario.
• Locality Name: nama kota lengkap, misalnya Ottawa.
• Organization Name: nama resmi lengkap perusahaan Anda, misalnya Your Company LLC. Untuk sertifikat domain-validated (DV), bidang ini tidak divalidasi dan boleh dikosongkan, tetapi jangan hanya menekan Enter: OpenSSL kemudian akan menyisipkan nilai default apa pun yang ditentukan konfigurasinya, dan konfigurasi bawaan menyertakan Internet Widgits Pty Ltd, yang akan masuk ke CSR Anda. Ketik satu titik (.) untuk mengosongkan bidang tersebut secara benar-benar. Hal yang sama berlaku untuk Country dan State, yang nilai default bawaannya adalah AU dan Some-State.
• Organizational Unit Name: sudah usang. Tekan Enter untuk melewatinya.
• Common Name: FQDN persis yang akan dilayani oleh Tableau Server, misalnya tableau.yourdomain.com. Cantumkan nilai yang sama dengan entri SAN pertama Anda.
• Email Address: alamat email kontak yang valid, atau tekan Enter untuk melewatinya.
• A challenge password dan An optional company name: biarkan keduanya kosong.

OpenSSL menulis CSR ke tableau.csr di direktori tempat Anda menjalankan perintah tersebut.

Verifikasi CSR sebelum Anda mengajukannya

Temukan kesalahan penulisan pada Distinguished Name atau entri SAN yang hilang sebelum CA memvalidasinya. Cetak CSR dengan OpenSSL bundel yang sama. Di Linux:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl req -noout -text -in tableau.csr

Di Windows, dari direktori bin Apache yang sama:

openssl.exe req -noout -text -in tableau.csr

Pastikan tiga hal dalam output tersebut: Subject menunjukkan DN Anda secara tepat, blok X509v3 Subject Alternative Name mencantumkan setiap hostname yang Anda butuhkan, dan ukuran Public-Key sesuai dengan yang Anda buat. Anda juga dapat menempelkan CSR ke CSR Decoder kami untuk pemeriksaan yang sama melalui browser.

Ajukan CSR ke Certificate Authority Anda

Buka tableau.csr di editor teks. File tersebut berupa teks biasa, dimulai dengan -----BEGIN CERTIFICATE REQUEST----- dan diakhiri dengan -----END CERTIFICATE REQUEST-----. Salin seluruh blok tersebut, termasuk baris header dan footer tersebut, dan tempelkan ke bidang CSR saat proses checkout dengan CA Anda.

Jika Anda lebih suka melewati langkah editor manual, CSR Generator kami dapat menghasilkan CSR dan private key di browser menggunakan default OpenSSL yang sama, siap ditempelkan ke alur checkout CA Anda.

Instal sertifikat yang telah ditandatangani pada Tableau Server

Setelah CA memvalidasi permintaan Anda dan mengirimkan email berisi sertifikat yang ditandatangani beserta chain (CA bundle), Anda mengimpor ketiga file (sertifikat, private key, chain) melalui Tableau Services Manager. Anda dapat menggunakan antarmuka web TSM di https://<tsm-host>:8850 pada Configuration > Security > External SSL, atau baris perintah tsm, misalnya:

tsm security external-ssl enable --cert-file tableau.crt --key-file tableau.key --chain-file tableau-chain.crt
tsm pending-changes apply

Perhatikan ekstensi file. Tableau mengharuskan file chain diakhiri dengan .crt, bukan .pem atau .ca-bundle, dan file sertifikat juga harus berekstensi .crt. Certificate Authority umumnya mengirimkan chain sebagai file .ca-bundle, jadi ganti namanya sebelum Anda mengimpornya, jika tidak, Tableau akan menolaknya.

Tableau Server akan restart untuk memuat sertifikat baru. Untuk prosedur lengkap (format file, penanganan passphrase, verifikasi pasca-instalasi), lihat panduan cara menginstal sertifikat SSL pada Tableau Server kami.

Pertanyaan yang Sering Diajukan