Cara Menginstal Sertifikat SSL di Sentora

Panduan ini menunjukkan cara menginstal sertifikat SSL di Sentora, panel kontrol hosting web open-source hasil fork dari ZPanel. Panduan ini mencakup pembuatan CSR, menempelkan sertifikat, kunci, dan CA bundle ke dalam modul Apache Admin milik Sentora, serta memperkuat virtual host yang dihasilkan dengan pengaturan TLS modern.

Catatan tentang status pemeliharaan Sentora

Sebelum Anda mulai: pengembangan resmi Sentora telah melambat drastis selama beberapa tahun terakhir. Rilis stabil terbaru pada repositori sentora/sentora-core adalah v2.0.2 (Mei 2024, PHP 7.4); cabang 2.1.x yang menyasar PHP 8.x masih ditandai sebagai versi pengembangan saja dan tidak untuk digunakan di lingkungan produksi. Sebuah fork komunitas, Sentora-NG, memang ada tetapi skalanya kecil. Jika Anda sedang menyiapkan server baru, penerus open-source yang masih aktif dipelihara dan menjadi pilihan sebagian besar administrator adalah HestiaCP, sebuah fork dari VestaCP dengan antarmuka serupa, dukungan PHP dan TLS terkini, serta Let’s Encrypt bawaan. Untuk dukungan komersial, Plesk adalah pilihan yang umum. Langkah-langkah di bawah ini tetap berlaku untuk instalasi Sentora yang sudah ada, dan alur kerja SSL-nya tidak berubah.

Membuat kode CSR di Sentora

Jika Anda sudah membuat CSR dan menerima sertifikat yang diterbitkan dari CA Anda, langsung lompat ke bagian instalasi.

Setiap sertifikat SSL/TLS komersial dimulai dengan CSR (Certificate Signing Request), sebuah blok teks terenkode yang berisi detail domain dan kontak Anda serta dipasangkan dengan kunci privat. Anda memiliki dua pilihan:

• Membuat CSR secara otomatis dengan CSR Generator kami. CSR dan kunci privatnya dihasilkan di browser Anda, jadi simpan kuncinya di tempat yang aman: Anda akan menempelkannya di server sebagai yourdomain.key saat proses instalasi.
• Membuat CSR langsung di server dengan mengikuti tutorial kami tentang cara membuat CSR di Sentora.

Buka CSR dengan editor teks apa pun (misalnya Notepad), salin seluruh blok teks (termasuk baris BEGIN CERTIFICATE REQUEST dan END CERTIFICATE REQUEST), lalu tempelkan ke dalam formulir pemesanan. Setelah validasi, CA akan mengirimkan file sertifikat yang diterbitkan melalui email.

Menginstal sertifikat SSL di Sentora

Sentora tidak memiliki formulir bawaan untuk menempelkan sertifikat SSL pihak ketiga seperti yang dimiliki cPanel atau VestaCP. Proses instalasi ini terdiri dari dua bagian: menyalin file sertifikat ke server, lalu menghubungkannya ke Apache melalui modul Apache Admin milik Sentora agar panel menulis ulang virtual host pada sinkronisasi berikutnya.

Langkah 1: Siapkan file SSL Anda

Setelah Certificate Authority menerbitkan sertifikat Anda, unduh arsip ZIP dan ekstrak. Anda akan mendapatkan tiga file:

• Sertifikat server utama untuk domain Anda (file .crt).
• Kunci privat yang dihasilkan bersamaan dengan CSR (file .key).
• CA bundle yang berisi sertifikat perantara (file .ca-bundle atau .crt dari CA).

Beberapa CA mengirimkan satu file rantai gabungan; yang lain mengirimkan root dan perantara sebagai file terpisah. Jika terpisah, buka keduanya di editor teks biasa dan tempelkan sertifikat perantara terlebih dahulu, kemudian root, ke dalam satu file yang disimpan sebagai yourdomain.ca-bundle.crt. Jangan meninggalkan baris kosong di antara sertifikat, dan pastikan setiap blok tetap memiliki penanda BEGIN CERTIFICATE dan END CERTIFICATE.

Langkah 2: Salin file ke server

Buka sesi SSH ke server dan masuk sebagai root, baik dengan menambahkan awalan sudo pada setiap perintah atau dengan membuka shell root melalui sudo -i. Buat direktori SSL di bawah Apache dan salin ketiga file tersebut ke dalamnya (gunakan scp, sftp, atau editor pilihan Anda untuk mengunggahnya terlebih dahulu):

sudo mkdir -p /etc/apache2/ssl
sudo cp yourdomain.crt /etc/apache2/ssl/yourdomain.crt
sudo cp yourdomain.key /etc/apache2/ssl/yourdomain.key
sudo cp yourdomain.ca-bundle.crt /etc/apache2/ssl/yourdomain.ca-bundle.crt
sudo chmod 600 /etc/apache2/ssl/yourdomain.key

Mengetatkan file kunci ke mode 600 mencegah pengguna lokal lain membaca kunci privat tersebut.

Langkah 3: Aktifkan modul SSL Apache

Jika modul SSL belum aktif, aktifkan dan mulai ulang Apache:

sudo a2enmod ssl
sudo service apache2 restart

Perintah a2enmod ssl secara otomatis membuat symlink mods-enabled/ssl.conf dan mods-enabled/ssl.load untuk Anda, jadi Anda tidak perlu membuatnya secara manual. Anda dapat memastikan modul telah dimuat dengan apache2ctl -M | grep ssl.

Langkah 4: Tambahkan virtual host SSL melalui Apache Admin

Masuk ke Sentora sebagai pengguna admin, lalu navigasikan ke Admin > Module Admin > Apache Admin. Tempelkan kode berikut ke dalam kotak Global Sentora entry, sesuaikan jalur file dan nama host agar cocok dengan instalasi Anda:

##################################################
# Apache vhost configuration for Sentora
# Adds an HTTPS virtual host that uses your cert
##################################################

<VirtualHost *:443>
    ServerAdmin zadmin@localhost
    DocumentRoot "/etc/sentora/panel/"
    ServerName panel.example.com
    ServerAlias sentora.example.com

    SSLEngine on
    SSLCertificateFile      /etc/apache2/ssl/yourdomain.crt
    SSLCertificateKeyFile   /etc/apache2/ssl/yourdomain.key
    SSLCertificateChainFile /etc/apache2/ssl/yourdomain.ca-bundle.crt

    # Modern TLS only. SSLv2, SSLv3, TLS 1.0 and TLS 1.1
    # are deprecated and unsafe (POODLE, BEAST).
    SSLProtocol             all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1
    SSLHonorCipherOrder     on
    SSLCipherSuite          HIGH:!aNULL:!MD5:!3DES:!RC4
    SSLCompression          off
</VirtualHost>

Ganti panel.example.com dan nama file dengan nama host serta jalur sertifikat Anda yang sebenarnya. Simpan entri tersebut. Sentora akan menulis ulang konfigurasi Apache pada sinkronisasi daemon berikutnya (dan saat disimpan), jadi jangan mengedit /etc/apache2/sites-available secara langsung: panel akan menimpanya.

Tentang SSLProtocol SSLv3: tutorial Sentora yang lebih lama, termasuk versi sebelumnya dari tutorial ini, menempelkan SSLProtocol SSLv3 ke dalam kotak Apache Admin. Jangan gunakan nilai tersebut. SSL 3.0 telah rusak sejak pengungkapan POODLE pada tahun 2014 (CVE-2014-3566) dan dinonaktifkan di setiap browser modern; virtual host Apache yang memaksa SSLv3 akan menolak klien modern dan tetap tidak aman meskipun ada klien yang menerimanya. Blok kode di atas mengunci Apache hanya pada TLS 1.2 dan 1.3, yang merupakan standar aman saat ini.

Langkah 5: Mulai ulang Apache

Setelah menyimpan entri Apache Admin, uji konfigurasinya dan muat ulang layanan:

sudo apache2ctl configtest
sudo service apache2 restart

Jika configtest melaporkan Syntax OK, virtual host baru sudah aktif. Buka panel melalui https://panel.example.com dan periksa ikon gemboknya.

Opsional: gunakan Let’s Encrypt melalui modul Sencrypt

Jika Anda tidak memerlukan sertifikat berbayar, modul komunitas Sencrypt (dipelihara di TGates71/sencrypt oleh salah satu pengembang asli Sentora) menerbitkan dan memperbarui secara otomatis sertifikat Let’s Encrypt gratis untuk panel maupun domain yang di-hosting. Modul ini sudah terpasang pada beberapa instalasi Sentora dan tersedia sebagai add-on terpisah untuk yang lain; setelah terpasang, buka Admin > Module Admin > Sencrypt SSL (atau Sencrypt di bawah Domain Management untuk situs yang di-hosting), pilih domain, dan jalankan aksi penerbitan. Sencrypt melakukan tantangan HTTP-01 terhadap port 80 dan menempatkan sertifikat, kunci, serta rantai yang dihasilkan secara otomatis. Domain tersebut harus sudah mengarah ke server ini di DNS agar tantangan berhasil.

Menguji instalasi SSL

Setelah memulai ulang Apache, buka situs Anda melalui https:// dan periksa ikon gemboknya. Untuk pemeriksaan yang lebih mendalam guna memastikan rantai perantara dan dukungan protokol, jalankan nama host melalui SSL Checker kami. Jika laporan menunjukkan adanya sertifikat perantara yang hilang, buka kembali Apache Admin, pastikan jalur pada SSLCertificateChainFile menunjuk ke CA bundle yang Anda salin di Langkah 2, simpan, lalu mulai ulang Apache lagi.

Pertanyaan yang Sering Diajukan