Departemen hukum menangani kontrak, berkas bukti, dan dokumen sangat rahasia lainnya. Alur kerja umum mengunggah PDF ke layanan berbagi berbasis cloud secara langsung menimbulkan risiko keamanan: berkas berada di luar perimeter perusahaan Anda, dan Anda kehilangan kontrol granular tentang siapa yang dapat melihatnya dan berapa lama.
Bagaimana jika Anda dapat menyematkan penampil PDF yang aman dan terenkripsi langsung ke portal web .NET Anda, menjamin bahwa dokumen tidak pernah menyentuh server pihak ketiga?
Dalam panduan ini kami menjelaskan arsitektur praktis yang dibangun di sekitar Doconut Viewer, SDK penampil dokumen .NET. SDK ini dipasang ke dalam aplikasi Anda sendiri dan tidak melakukan panggilan ke server Doconut, sehingga dokumen tidak pernah meninggalkan infrastruktur Anda.
Dua hal yang harus jelas sebelum langkah pertama, karena sisanya bergantung pada hal tersebut. Doconut.app adalah penampil web gratis — sebuah situs web, bukan komponen, dan bukan yang Anda pasang di sini. Dan enkripsi, token, serta log audit di bawah ini adalah milik Anda untuk dibangun: SDK merender dokumen, tidak menyertakan program kepatuhan. Doconut tidak memiliki sertifikat ISO 27001, laporan SOC 2, maupun attestation HIPAA, sehingga argumen kepatuhan yang dapat Anda sampaikan kepada regulator bersifat arsitektural — berkas tetap berada dalam batas yang sudah Anda kendalikan.
Mengapa Berbagi Cloud Tradisional Tidak Memadai
| Risiko | Layanan Cloud Umum | Apa yang dilakukan arsitektur ini sebagai gantinya |
|---|---|---|
| Pengasingan data - berkas disimpan di server eksternal | Berkas disimpan di penyimpanan penyedia, seringkali di wilayah yang tidak dapat Anda kontrol. | PDF tetap berada di infrastruktur Anda sendiri. SDK merendernya di sana dan tidak memanggil siapa pun. |
| Kehilangan kontrol atas masa hidup akses | Tautan berbagi dapat diteruskan tanpa batas. | Anda mengeluarkan token yang berumur pendek, satu kali pakai. Ini adalah kode yang Anda tulis, bukan saklar yang Anda aktifkan. |
| Kekurangan kepatuhan | Log audit sering terbatas pada peristiwa "unduh". | Anda mencatat setiap permintaan pratinjau, karena permintaan tersebut menuju ke endpoint Anda sendiri. |
| Ketergantungan plugin | Banyak penampil memerlukan Flash, ActiveX, atau ekstensi browser. | Tidak ada yang dipasang di mesin pembaca; browser menerima halaman yang dirender. |
Gambaran Solusi
- Pasang Doconut Viewer ke dalam proyek .NET Anda.
- Enkripsi PDF saat disimpan dengan kunci sisi server, menggunakan kriptografi .NET sendiri.
- Sematkan penampil dalam halaman Razor atau tampilan MVC, di belakang token yang dikeluarkan aplikasi Anda.
- Catat setiap permintaan pratinjau untuk jejak audit dan deteksi anomali.
Langkah 2, 3, dan 4 adalah pekerjaan aplikasi Anda. Bagian SDK adalah langkah 1 dan proses rendering; semua perlindungan dalam desain ini adalah kode milik Anda, yang juga menjadi alasan mengapa dapat diaudit oleh tim Anda sendiri.
Berikut adalah penjelasan rinci setiap langkah, termasuk rekomendasi praktik terbaik untuk manajemen kunci, keamanan token, dan pencatatan kepatuhan.
Langkah 1 – Siapkan Lingkungan .NET Anda
- Buka solusi Anda di Visual Studio (disarankan 2022 atau lebih baru).
- Pilih kerangka target Anda. Doconut Viewer mendukung ASP.NET, MVC, .NET Core, .NET 6+ dan Blazor. Catat versi yang Anda pilih — detail integrasi bersifat spesifik versi.
- Pasang SDK dari halaman unduhan Doconut, menggunakan paket dan dokumentasi yang sesuai dengan versi yang Anda pilih. Ambil nama paket dan langkah-langkah pemasangan dari dokumentasi tersebut, bukan dari artikel; keduanya telah berubah di setiap rilis.
Jaga konfigurasi lisensi agar tidak masuk ke kontrol sumber selama proses tersebut. Itu adalah hal paling umum yang bocor dari prototipe yang berfungsi.
Tips Tambahan
- Simpan referensi paket dalam file
Directory.Packages.propsuntuk manajemen versi terpusat di seluruh layanan.
Langkah 2 – Simpan PDF dengan Enkripsi Kuat
2.1 Pilih Algoritma Enkripsi
Ini adalah keputusan Anda dan kode Anda. System.Security.Cryptography di .NET memberikan Anda AES-256-GCM, yang menyediakan enkripsi terautentikasi — kerahasiaan dan integritas bersama — dan merupakan default yang dapat dipertahankan untuk dokumen yang disimpan.
Tidak ada algoritma enkripsi yang membuat sistem mematuhi GDPR, HIPAA, atau ISO 27001. Kerangka kerja tersebut menanyakan tentang proses, kontrol akses, retensi, dan bukti. Enkripsi adalah satu kontrol di antara banyak kontrol, dan pustaka penampil tidak dapat menyediakan sisanya.
2.2 Terapkan Manajemen Kunci yang Aman
- Jangan pernah menuliskan kunci secara keras. Gunakan Azure Key Vault, AWS KMS, atau HashiCorp Vault untuk mengambil kunci enkripsi pada saat runtime.
- Putar kunci secara teratur — setiap 90 hari adalah praktik umum. Rencanakan pekerjaan re-enkripsi sebelum Anda membutuhkannya; menemukan bahwa Anda tidak memiliki cara untuk mengganti kunci adalah hal yang buruk dipelajari selama insiden.
Langkah 3 – Hasilkan Token Berbatas Waktu, Sekali Pakai
Token pratinjau berfungsi seperti lencana sekali pakai yang kedaluwarsa secara otomatis. Token ini menyertakan:
- User ID – Siapa yang diizinkan melihat dokumen.
- PDF ID – File terenkripsi mana yang akan di-stream.
- Expiration – Biasanya 5–10 menit, dapat dikonfigurasi sesuai kebijakan.
- Signature – Ditandatangani HMAC atau RSA untuk mencegah manipulasi.
3.1 Pertimbangan Keamanan
- TLS di mana saja – Selalu layani token melalui HTTPS.
- Prinsip hak paling sedikit – Enkode hanya data yang diperlukan untuk pratinjau; hindari menyertakan klaim tambahan.
- Pencabutan token – “Daftar hitam” sederhana di Redis memungkinkan pencabutan segera jika hak akses pengguna berubah.
Langkah 4 – Sematkan Penampil DoconutApp
4.1 Titik Akhir Streaming Sisi Server
- Dekripsi di memori jika model ancaman Anda memerlukannya, sehingga plaintext tidak pernah tersimpan di disk. Ini adalah titik akhir Anda, jadi keputusan dan kode Anda untuk ditinjau.
- Rendering terjadi di server Anda, bukan di browser pembaca. Itulah yang memungkinkan browser menampilkan dokumen tanpa pernah menerima file sumber — dan juga alasan untuk memeriksa di mana SDK menulis output render sementara, dan apa yang menghapusnya.
4.2 Tidak Memerlukan Plugin
Pembaca menerima halaman yang dirender melalui teknologi web standar, sehingga penampil berfungsi di Chrome, Edge, Firefox, dan Safari tanpa plugin, kontrol ActiveX, atau ketergantungan Flash. Tidak ada yang diinstal pada laptop pengacara, yang biasanya menjadi perbedaan antara tinjauan keamanan yang selesai dan yang tidak.
Langkah 5 – Audit & Catat Akses untuk Kepatuhan
Tim hukum sering memerlukan jejak anti-manipulasi tentang siapa yang melihat kontrak mana dan kapan. Terapkan pipeline pencatatan terstruktur:
| Field | Description |
|---|---|
UserId | Pengidentifikasi profesional hukum yang meminta |
PdfId | Referensi internal ke dokumen terenkripsi |
Timestamp | Waktu UTC dari permintaan pratinjau |
IpAddress | IP sumber (bermanfaat untuk pemeriksaan geolokasi) |
UserAgent | String browser untuk analisis forensik |
Result | Berhasil / Gagal (mis., token tidak valid, kesalahan dekripsi) |
Praktik Terbaik
- Simpan log dalam datastore hanya-tambah, tidak dapat diubah (mis., Azure Log Analytics, Splunk, atau bucket S3 yang hanya dapat menulis sekali).
- Aktifkan peringatan untuk pola abnormal—seperti token yang sama digunakan dari dua IP berbeda dalam hitungan detik.
- Kebijakan retensi: Simpan log selama periode yang diwajibkan oleh yurisdiksi Anda (biasanya 7 tahun untuk catatan hukum).
Ringkasan Cepat
- Instal Doconut Viewer ke dalam proyek .NET Anda, menggunakan dokumentasi untuk versi Anda.
- Enkripsi PDF saat menulis dengan AES-256-GCM dari pustaka kriptografi .NET; kelola kunci melalui layanan vault.
- Keluarkan token pratinjau singkat, sekali pakai ketika pengguna meminta tampilan.
- Render di server Anda dan sematkan penampil dalam halaman Razor. Dokumen tidak pernah pergi ke pihak ketiga, dan tidak ada yang diinstal pada mesin pembaca.
- Catat setiap pratinjau untuk auditabilitas, dengan peringatan untuk pola mencurigakan.
Poin 2, 3, dan 5 adalah kode Anda. Itu adalah pembagian kerja yang jujur, dan layak dinyatakan secara jelas dalam dokumentasi keamanan Anda, karena peninjau pada akhirnya akan menanyakan pihak mana yang bertanggung jawab atas apa.
Kesimpulan
Berbagi PDF yang aman tidak harus melibatkan layanan pihak ketiga. Dengan Doconut Viewer di dalam portal .NET Anda sendiri, departemen hukum Anda dapat menyajikan kontrak rahasia, bukti litigasi, dan kebijakan internal tanpa file pernah meninggalkan infrastruktur Anda.
Apa yang diberikan SDK kepada Anda adalah bagian terakhir itu: rendering, di lingkungan Anda, tanpa panggilan ke luar. Enkripsi ujung‑ke‑ujung, kontrol akses, dan jejak audit adalah milik Anda — itulah intinya, karena penampil yang mengklaim menyediakan hal tersebut akan meminta Anda mempercayai kepatuhan vendor alih‑alih milik Anda sendiri.
Siap mencobanya? Kunjungi doconut.com — lisensi percobaan gratis, dan demo langsung adalah cara tercepat untuk melihat apakah rendering tetap baik pada bukti terburuk Anda sebelum menulis kode apa pun di atas.
Menerapkan langkah‑langkah ini akan memberi petugas kepatuhan ketenangan pikiran, mengurangi permukaan serangan, dan menjaga PDF Anda tetap berada di dalam firewall korporat — tepat sesuai postur keamanan yang dibutuhkan setiap tim hukum.
Tetap aman, tetap patuh, dan simpan amplop tersegel di tempatnya: di dalam brankas Anda sendiri.
