Pembangun menyemak kod backend pada monitor

Borang web yang mempunyai kawalan ketat di pelayar—lengkap dengan atribut required, corak regex JavaScript dan mesej amaran berwarna merah—masih boleh menerima data cacat pada bila-bila masa. Sesiapa sahaja boleh membuka DevTools, mengubah nilai <select>, atau menghantar permintaan terus ke titik akhir API menggunakan curl dan Postman tanpa menyentuh UI langsung.

Validasi di bahagian klien memang penting untuk memberi maklum balas pantas kepada pengguna biasa supaya mereka tidak perlu menunggu pusingan pelayan hanya kerana tersilap taip alamat e-mel. Namun dari sudut keselamatan dan integriti data, sempadan sebenar sistem anda bermula apabila request sampai ke pelayan.

Pisahkan bentuk input daripada peraturan perniagaan

Kesilapan yang kerap saya temui dalam projek ASP.NET Core ialah mencampurkan semua jenis semakan di satu tempat, atau cuba memaksa semuanya masuk ke dalam atribut validasi model. Cara yang lebih bersih ialah memisahkan dua lapisan ini:

  1. Validasi bentuk (sintaks): Adakah medan wajib diisi? Adakah panjang teks berada dalam had munasabah? Adakah format e-mel sah dan nilai tarikh boleh dihuraikan? Ini tugas DTO dan pengawal API di sempadan luar.
  2. Peraturan perniagaan (domain): Adakah baki kuota tempahan masih ada? Adakah pengguna ini berhak mengubah rekod organisasi tersebut? Adakah kod diskaun masih aktif pada tarikh hari ini? Perkara ini memerlukan akses pangkalan data dan logik aplikasi di lapisan servis.

Memisahkan kedua-duanya menjadikan kod lebih mudah diuji. Anda tidak perlu menghidupkan pangkalan data semata-mata mahu menguji sama ada medan NoTelefon menolak rentetan melebihi 20 aksara.

Contoh kod di sempadan API ASP.NET Core

Dalam ASP.NET Core, meletakkan [ApiController] pada pengawal memberi kelebihan besar: rangka kerja akan mengesahkan DataAnnotations secara automatik sebelum kod tindakan anda dijalankan, lalu memulangkan format ValidationProblemDetails (RFC 9457) yang seragam.

using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc;

public sealed record TempahanRequest(
    [Required(ErrorMessage = "Nama penuh diperlukan.")]
    [StringLength(100, MinimumLength = 2)]
    string Nama,

    [Required(ErrorMessage = "Alamat e-mel diperlukan.")]
    [EmailAddress(ErrorMessage = "Format e-mel tidak sah.")]
    [StringLength(150)]
    string Emel,

    [Range(1, 10, ErrorMessage = "Bilangan peserta mesti antara 1 hingga 10 orang.")]
    int BilanganPeserta
);

[ApiController]
[Route("api/tempahan")]
public class TempahanController : ControllerBase
{
    private readonly ITempahanService _service;

    public TempahanController(ITempahanService service) => _service = service;

    [HttpPost]
    [RequestSizeLimit(32_768)] // Hadkan saiz payload ke 32 KB
    public async Task<IActionResult> Cipta([FromBody] TempahanRequest request, CancellationToken ct)
    {
        var hasil = await _service.CiptaTempahanAsync(request, ct);
        if (!hasil.Berjaya)
        {
            return UnprocessableEntity(new ProblemDetails
            {
                Title = "Tempahan tidak dapat diproses",
                Detail = hasil.MesejRalat
            });
        }

        return CreatedAtAction(nameof(Cipta), new { id = hasil.Id }, new { hasil.Id });
    }
}

Perhatikan bagaimana ralat bentuk input ditapis awal tanpa menyentuh servis, manakala ralat perniagaan seperti kuota penuh dipulangkan dengan status 422 Unprocessable Entity dan mesej yang jelas—bukan sekadar "Invalid input" yang memaksa pengguna atau pembangun frontend meneka medan mana bermasalah. Untuk panduan lengkap tentang integrasi model binding dan pengesahan tersuai, dokumentasi rasmi ASP.NET Core menerangkan aliran terperinci termasuk cara menulis IValidatableObject.

Uji terus dengan curl dan jaga laluan keluar

Jangan anggap borang siap selagi anda hanya mengujinya melalui pelayar. Sebelum menggabungkan kod, jalankan ujian ringkas terus dari terminal:

curl -i -X POST https://localhost:5001/api/tempahan \
  -H "Content-Type: application/json" \
  -d '{"nama":"","emel":"bukan-emel","bilanganPeserta":99}'

Pastikan respons memulangkan status 400 Bad Request dengan senarai medan yang tepat, bukan ralat 500 Internal Server Error atau kebocoran stack trace.

Akhir sekali, data yang sudah melepasi validasi di sempadan tidak bermakna ia selamat untuk terus dicampak ke mana-mana. Gunakan pertanyaan berparameter dalam EF Core atau Dapper untuk mengelakkan SQL injection, pastikan output HTML dikodkan sewajarnya bagi menghalang XSS, dan elakkan menulis input mentah pengguna terus ke dalam log sistem tanpa pembersihan aksara baris baharu (log forging). Validasi ialah benteng pertama di pintu masuk, bukan pengganti kawalan keselamatan di bahagian dalam.