Cara Menginstal sertifikat SSL di server 4D

Dalam tutorial ini, Anda akan mempelajari cara menginstal sertifikat SSL di 4D Server. 4D mengamankan web server bawaannya dengan dua file PEM, cert.pem (sertifikat Anda) dan key.pem (kunci privat Anda), yang ditempatkan di sebelah folder proyek, setelah itu Anda mengaktifkan HTTPS di pengaturan 4D.

Membuat kode CSR di 4D Server

CSR (Certificate Signing Request) adalah blok teks terenkode berisi data kontak Anda yang diperlukan oleh Certificate Authority untuk memvalidasi dan menerbitkan sertifikat SSL Anda. Anda memiliki dua pilihan:

• Gunakan CSR Generator kami untuk membuat CSR secara otomatis. Caranya mudah dan tidak memerlukan pengetahuan teknis apa pun.
• Ikuti tutorial langkah demi langkah kami tentang cara membuat CSR di 4D Server.

Buka file CSR Anda dengan editor teks dan salin isinya ke kotak yang sesuai selama proses pemesanan SSL. Kirimkan CSR ke Certificate Authority, dan setelah CA memvalidasinya dan menerbitkan sertifikat Anda, lanjutkan dengan instalasi di bawah ini.

Menginstal sertifikat SSL di 4D Server

4D menggunakan filenya sendiri untuk TLS alih-alih direktif konfigurasi. Anda menyediakan sertifikat dan kunci sebagai file PEM di lokasi tetap, menambahkan sertifikat perantara apa pun, lalu mengaktifkan HTTPS di pengaturan.

Langkah 1: Siapkan file PEM Anda

Setelah Certificate Authority mengirimkan sertifikat Anda melalui email, unduh arsip ZIP dan ekstrak. 4D hanya menerima sertifikat dalam format PEM (x509 teks biasa). Nama filenya tetap:

• cert.pem: sertifikat domain Anda. Jika CA Anda mengirimkan file .crt, buka file tersebut di editor teks dan simpan isinya ke dalam file teks biasa bernama cert.pem. Nama file harus tepat cert.pem.
• key.pem: kunci privat yang Anda buat bersama dengan CSR. Nama file harus tepat key.pem.

Sertifikat PEM adalah teks biasa yang dibatasi oleh baris header dan footer, seperti ini:

-----BEGIN CERTIFICATE-----
MIIFazCCA1OgAwIBAgIRA...
...your encoded certificate...
-----END CERTIFICATE-----

Di mana meletakkan file. Untuk 4D atau 4D Server dalam mode lokal, letakkan cert.pem dan key.pem di sebelah folder proyek (folder yang menyimpan struktur database Anda). Untuk klien 4D dalam mode remote, letakkan file tersebut di folder database klien pada mesin remote. Jika Anda membangun jalur dalam kode, perintah Get 4D folder mengembalikan folder 4D aktif sehingga Anda dapat menemukan direktori yang tepat.

Langkah 2: Tambahkan sertifikat perantara dan root

Browser memerlukan rantai lengkap, jadi paket CA (perantara, dan terkadang root) harus tersedia bersama sertifikat Anda. Di 4D Anda memiliki dua cara untuk menyediakannya:

• File PEM terpisah (disarankan). Simpan setiap sertifikat perantara (dan root) sebagai file .pem sendiri di folder yang sama dengan cert.pem. File tambahan tersebut dapat menggunakan nama apa saja selama ekstensinya .pem. 4D membaca setiap file .pem di folder tersebut dan menyusun rantainya.
• Satu file gabungan. Sebagai alternatif, tempelkan sertifikat Anda diikuti oleh setiap sertifikat perantara (secara berurutan, leaf terlebih dahulu) ke dalam satu cert.pem, dengan tetap mempertahankan setiap baris BEGIN/END.

Jaga agar folder tetap bersih. 4D memuat setiap file .pem yang ditemukannya di sebelah folder proyek. Hapus file .pem sisa dari sertifikat sebelumnya, karena file yang usang atau tidak cocok dapat membuat web server menolak koneksi HTTPS.

Versi 4D yang lebih lama. Rilis sebelum model folder PEM saat ini memerlukan komponen TLS yang harus ada: 4DSLI.DLL di Windows (di sebelah executable 4D atau 4D Server) atau 4DSLI.bundle di macOS (di subfolder Native Components pada paket 4D). Versi 4D saat ini menangani TLS secara internal, jadi Anda tidak perlu lagi menambahkan komponen ini secara manual. Jika Anda menjalankan versi lama, pastikan komponen tersebut sudah ada sebelum mengaktifkan HTTPS.

Langkah 3: Aktifkan HTTPS di pengaturan 4D

Setelah file-file tersebut siap, aktifkan HTTPS untuk web server 4D:

1. Buka Settings (di 4D versi terbaru, menu Design atau Structure; di versi lama dialog ini disebut Database Settings).
2. Pilih bagian Web.
3. Buka halaman Configuration dan centang Enable HTTPS. Biarkan HTTPS Port pada nilai default 443 kecuali pengaturan Anda memerlukan port lain.
4. Klik OK untuk menyimpan.

Secara default, protokol minimum yang diterima oleh 4D adalah TLS 1.2. Anda dapat menaikkan batas ini ke TLS 1.3 dengan properti web server minTLSVersion jika kebijakan keamanan Anda mengharuskannya, atau menurunkannya hanya jika Anda harus mendukung klien yang lebih lama. Pertahankan minimum di TLS 1.2 atau lebih tinggi.

Langkah 4: Mulai ulang web server dan verifikasi

Hentikan dan jalankan kembali web server 4D agar memuat file sertifikat. Pada saat pertama kali HTTPS dijalankan, jika file dhparams.pem belum ada, 4D akan membuatnya (2048-bit) dan meletakkannya di sebelah cert.pem dan key.pem. Proses ini dapat memakan waktu satu hingga dua menit, jadi biarkan hingga selesai.

Buka situs Anda di https:// dan pastikan ikon gembok muncul. Setelah instalasi, pindai sertifikat untuk mengetahui masalah rantai atau konfigurasi dengan SSL Checker kami, yang memberikan laporan instan mengenai sertifikat dan cara penyajiannya. Sertifikat perantara yang hilang adalah masalah paling umum, dan alat pemeriksa akan langsung mendeteksinya.

Opsional, aktifkan HSTS. Setelah HTTPS berfungsi dengan andal, Anda dapat memberi tahu browser untuk selalu menggunakan versi yang aman. Di Settings, buka bagian Web, buka halaman Options (II), dan centang Enable HSTS. Aktifkan ini hanya setelah Anda memastikan HTTPS stabil, karena sulit untuk membatalkannya saat kebijakan tersebut sudah tersimpan (cached) di browser.

Pertanyaan yang Sering Diajukan