Cara Menyematkan Penampil Dokumen Tanpa Plugin di ASP.NET
7/10/2026

Cara Menyematkan Penampil Dokumen Tanpa Plugin di ASP.NET

Panduan langkah‑demi‑langkah untuk insinyur .NET yang perlu menyematkan penampil dokumen aman tanpa plugin dari Doconut App ke dalam proyek ASP.NET Core, MVC, atau WebForms.

Ya—Anda dapat menyematkan penampil file daring yang aman dan tanpa plugin ke dalam aplikasi ASP.NET Core, MVC, atau WebForms apa pun dalam hitungan menit, dan Doconut App menangani semua pekerjaan berat.
Perusahaan yang melayani kontrak, gambar, atau aset desain memerlukan penampil yang menghormati kebijakan keamanan korporat dan tidak pernah memaksa pengguna menginstal plugin browser lama. Doconut menyediakan SDK penampil dokumen .NET untuk alur kerja PDF, Office, CAD, email, dan gambar berbasis browser. Posting ini menjelaskan keputusan integrasi tanpa mengandalkan kode contoh yang spesifik versi.

Penampil dokumen yang disematkan terhubung ke backend ASP.NET yang terkontrol
Penampil dokumen yang disematkan terhubung ke backend ASP.NET yang terkontrol

1. Mengapa keamanan dan rendering tanpa plugin penting untuk aplikasi web .NET

Perusahaan modern memperlakukan setiap dokumen sebagai potensi kebocoran data. Ketika Anda menyematkan penampil yang bergantung pada ActiveX, Flash, atau klien native, Anda mewarisi tiga risiko:

RisikoDampak pada aplikasi .NET AndaBagaimana Doconut App menghilangkannya
Ketergantungan pluginPengguna harus menginstal atau mengaktifkan plugin browser, yang menyebabkan tiket dukungan dan masalah kepatuhan.Doconut berjalan sepenuhnya di HTML5/Canvas, memerlukan tanpa plugin.
Transmisi tidak terenkripsiFile melintasi HTTP atau disimpan dalam teks biasa, melanggar GDPR, HIPAA, atau kebijakan internal.Semua unggahan melewati SSL dan disimpan dengan enkripsi AES‑256.
Siklus hidup tidak terkontrolFile dapat tertinggal di server, meningkatkan permukaan pelanggaran.Doconut secara otomatis menghapus file setelah dilihat, memastikan jendela retensi yang singkat.

Karena penampil disajikan sebagai komponen JavaScript yang berkomunikasi dengan layanan rendering aman Doconut, Anda menjaga stack .NET tetap bersih—tanpa pustaka native tambahan, tanpa binari pihak ketiga, dan tanpa audit kepatuhan ekstra.


2. Siapkan proyek .NET

Gunakan paket, dokumentasi, dan contoh yang cocok dengan versi Doconut yang dipilih untuk proyek. Halaman Halaman unduhan Doconut resmi adalah titik awal yang dapat diandalkan.

Sebelum integrasi, pastikan runtime .NET target, catat versi paket, simpan konfigurasi lisensi di luar kontrol sumber, dan mulailah dengan dokumen perwakilan. ASP.NET Core, MVC, dan WebForms memiliki siklus hidup aplikasi yang berbeda, sehingga penyiapannya tidak boleh diperlakukan identik.


3. Membangun endpoint unggahan aman – AES‑256, SSL, dan hapus otomatis

Penampil tidak pernah mengakses file secara langsung di sistem file Anda. Sebagai gantinya, Anda mengunggah dokumen ke lokasi penyimpanan sementara yang terenkripsi yang dibaca Doconut sesuai permintaan. Berikut adalah deskripsi tingkat tinggi langkah‑langkah yang diperlukan untuk ASP.NET Core; ide yang sama berlaku untuk MVC dan WebForms.

Alur kerja sisi server

  1. Terima file yang diunggah – Gunakan IFormFile standar (atau HttpPostedFile di WebForms) untuk menerima dokumen dari klien.
  2. Enkripsi file dengan AES‑256 – Sebelum menyimpan aliran, enkripsi menggunakan pustaka terbukti seperti System.Security.Cryptography.Aes. Simpan blob terenkripsi di lokasi aman (misalnya Azure Blob Storage dengan enkripsi sisi server diaktifkan, atau bucket S3 dengan SSE‑AES256).
  3. Hasilkan URL bertanda tangan yang berumur pendek – Buat URL yang berlaku selama beberapa menit (misalnya 5 menit). URL harus HTTPS dan menyertakan token kriptografis yang dapat divalidasi Doconut. Kebanyakan penyedia cloud menawarkan fitur “pre‑signed URL” yang cocok untuk kebutuhan ini.
  4. Kembalikan URL bertanda tangan ke klien – Kirim respons JSON yang berisi URL tersebut. Klien akan menyerahkan URL ini ke penampil Doconut.
  5. Jadwalkan penghapusan otomatis – Setelah URL bertanda tangan kedaluwarsa, pekerjaan latar belakang (Hangfire, Azure Functions, dll.) menghapus blob terenkripsi, menjamin file tidak tetap berada di server.

Equivalen MVC / WebForms

  • MVC – Tempatkan logika yang sama di dalam aksi kontroler reguler dan kembalikan JsonResult.
  • WebForms – Implementasikan handler .ashx atau metode halaman yang mengikuti langkah yang sama: terima Request.Files[0], enkripsi, hasilkan URL pre‑signed, dan tulis respons JSON.

Satu‑satunya perbedaan adalah sintaks routing; alur kerja keamanan tetap identik.


4. Render dokumen melalui SDK yang terpasang

Pertahankan akses dokumen di server dan tegakkan otorisasi sebelum memproses file atau aliran. Urutan rendering dan inisialisasi UI yang tepat bersifat spesifik versi; ikuti dokumentasi resmi yang disertakan dengan build yang dipasang daripada menyalin API JavaScript global yang belum terverifikasi.

Mengapa ini bekerja untuk semua varian .NET

  • ASP.NET Core Razor – Skrip berada di tampilan yang sama dengan formulir unggahan, sehingga alurnya mulus.
  • MVC – Gunakan @section Scripts untuk menyuntikkan potongan kode yang sama; kontroler mengembalikan JSON yang dapat dikonsumsi $.ajax MVC.
  • WebForms – Daftarkan skrip dengan ClientScript.RegisterStartupScript setelah unggahan selesai, lalu panggil launchViewer dengan cara yang sama.

Karena Doconut men-stream dokumen langsung dari URL bertanda tangan, server tidak lagi menyentuh file setelah langkah unggahan. Penampil merender PDF, file Word, gambar CAD, dan semua format lain yang tercantum dalam fakta produk—tanpa konversi sisi server tambahan.


5. Menyesuaikan penampil agar cocok dengan merek Anda – haluskan penampil file daring

Perusahaan sering membutuhkan penampil yang tampak seperti bagian native portal mereka. UI sepenuhnya dapat disesuaikan dari Doconut App memungkinkan Anda:

KustomisasiCara menerapkannya di .NET
Tata letak toolbarKirim toolbar: false dan bangun tombol Anda sendiri yang memanggil API JavaScript penampil (misalnya zoomIn(), print()).
Skema warnaSetel theme: "dark" atau sediakan file CSS khusus yang menimpa kelas default.
Bahasa & aksesibilitasDoconut menghormati atribut lang pada kontainer; Anda juga dapat menyuntikkan label ARIA melalui opsi accessibility.
Hook acaraCallback seperti onPageChange, onError, dan onDownload memungkinkan Anda mencatat metrik penggunaan ke dalam pipeline telemetri yang sudah ada.

Semua hook ini dikonfigurasi dalam objek JavaScript yang sama seperti pada bagian sebelumnya. Karena penampil berada sepenuhnya di klien, tidak ada beban server tambahan—backend .NET Anda tetap fokus pada otentikasi, enkripsi, dan logika bisnis.


6. Kinerja dan skalabilitas – jaga pengalaman tetap responsif

Menyematkan penampil dalam portal dengan lalu lintas tinggi menimbulkan dua kekhawatiran praktis: waktu muat dan rendering bersamaan. Doconut App menangani keduanya secara default, namun Anda dapat memperkuat envelope kinerja dengan beberapa trik khusus .NET.

KekhawatiranKeunggulan bawaan DoconutTips tambahan untuk .NET
Unduhan awalSkrip penampil hanya ~150 KB, terkompresi gzip.Aktifkan kompresi file statis (app.UseResponseCompression()) dan caching (Cache‑Control: public, max‑age=31536000).
Streaming fileDoconut hanya men-stream halaman yang diperlukan, menggunakan permintaan rentang HTTP.Simpan blob terenkripsi di CDN regional (Azure Front Door, Amazon CloudFront) untuk mengurangi latensi.
Pengguna bersamaanRendering terjadi di klien; server hanya menyajikan file terenkripsi sekali per tampilan.Batasi endpoint unggahan dengan IApplicationRateLimiter untuk melindungi dari lonjakan.
Jejak memoriTidak ada pustaka konversi PDF sisi server, sehingga proses ASP.NET tetap ringan.Jalankan layanan unggahan dalam mikrolayanan terpisah jika Anda sudah memiliki antrian pekerjaan latar belakang yang berat.

Dengan mengikuti panduan ini, Anda dapat mendukung ribuan penampil bersamaan tanpa harus menskalakan lapisan web .NET melebihi apa yang sudah Anda miliki.


Kesimpulan Utama

  • Doconut App menyediakan penampil tanpa plugin, 100 % aman yang berfungsi dengan ASP.NET Core, MVC, dan WebForms.
  • Unggahan bersifat hanya SSL, disimpan dengan enkripsi AES‑256, dan otomatis dihapus setelah URL bertanda tangan kedaluwarsa.
  • Integrasi hanya memerlukan skrip CDN, elemen <div> kontainer, dan endpoint server‑sisi kecil yang mengembalikan URL bertanda tangan.
  • Penampil mendukung PDF, Office, CAD, dan lebih dari 50 format gambar—tanpa konversi sisi server.
  • UI dapat sepenuhnya disesuaikan agar selaras dengan identitas merek perusahaan, dan penampil menawarkan zoom, pengukuran, serta alat lapisan bawaan untuk file CAD.
  • Kinerja ditangani di sisi klien; pengembang .NET hanya perlu memastikan kompresi file statis dan caching CDN opsional.
  • Seluruh alur kerja—dari unggahan aman hingga rendering di browser—terpadu bersih ke dalam pipeline otentikasi dan otorisasi .NET yang sudah ada.

Pertanyaan Umum

T1: Apakah saya perlu menginstal paket NuGet untuk menggunakan Doconut?
J: Tidak. Penampil disediakan sebagai bundel JavaScript sisi klien dari CDN Doconut. Server Anda hanya memerlukan middleware ASP.NET Core standar untuk unggahan file dan enkripsi, yang kemungkinan sudah Anda miliki.

T2: Bagaimana Doconut memastikan file dihapus setelah dilihat?
J: Doconut menghasilkan URL bertanda tangan yang berumur pendek dan kedaluwarsa setelah periode yang dapat dikonfigurasi (biasanya lima menit). Setelah URL kedaluwarsa, Anda (atau pekerjaan pembersihan latar belakang) menghapus blob terenkripsi. Ini menjamin dokumen tidak disimpan lebih lama dari yang diperlukan, memenuhi kebijakan retensi data yang ketat.

T3: Bisakah saya menggunakan penampil untuk mencetak atau mengekspor dokumen?
J: Ya. Toolbar bawaan Doconut mencakup opsi cetak dan ekspor yang mempertahankan kualitas serta tata letak asli file sumber.


Siap menyematkan penampil dokumen aman tanpa plugin ke dalam aplikasi .NET Anda? Mulailah dengan Doconut App hari ini dan sediakan PDF, Office, CAD, serta puluhan format lainnya secara aman dan instan.