
Satu endpoint carian produk atau penjanaan laporan PDF selalunya nampak sangat ringan ketika diuji oleh lima orang di persekitaran staging. Tetapi sebaik sahaja sistem masuk ke produksi, satu skrip bot yang menghantar 200 permintaan sesaat ke /api/search—atau skrip brute-force yang mencuba ratusan gabungan kata laluan pada /api/auth/login—sudah cukup untuk memenuhkan connection pool pangkalan data dan melumpuhkan keseluruhan aplikasi untuk pengguna lain yang sah.
Di sinilah Rate Limiting berfungsi sebagai pemutus litar (circuit breaker) di pintu masuk API anda.
Gunakan middleware rasmi ASP.NET Core dan asingkan mengikut kos laluan
Sejak .NET 7 dan ke atas, anda tidak lagi perlu menulis penjejak ConcurrentDictionary secara manual atau bergantung kepada pakej pihak ketiga yang berat. Middleware rate limiting terbina dalam ASP.NET Core sudah menyokong algoritma seperti Fixed Window, Sliding Window, dan Token Bucket terus dari kotak.
Prinsip paling penting ialah jangan kenakan satu had rata yang sama untuk semua laluan. Endpoint bacaan profil atau data rujukan statik boleh menerima trafik lebih tinggi, manakala endpoint yang mahal dari segi CPU atau sensitif dari segi keselamatan—seperti log masuk, permintaan OTP SMS, atau eksport laporan berat—perlu dikawal jauh lebih ketat.
Berikut ialah contoh konfigurasi PartitionedRateLimiter dalam Program.cs yang membezakan pengguna log masuk dengan pengguna awam:
using System.Security.Claims;
using System.Threading.RateLimiting;
using Microsoft.AspNetCore.RateLimiting;
builder.Services.AddRateLimiter(options =>
{
options.RejectionStatusCode = StatusCodes.Status429TooManyRequests;
options.AddPolicy("auth-strict", httpContext =>
{
var ip = httpContext.Connection.RemoteIpAddress?.ToString() ?? "unknown";
return RateLimitPartition.GetFixedWindowLimiter(
partitionKey: $"auth:{ip}",
factory: _ => new FixedWindowRateLimiterOptions
{
PermitLimit = 10,
Window = TimeSpan.FromMinutes(1),
QueueLimit = 0
});
});
options.AddPolicy("api-user", httpContext =>
{
var userId = httpContext.User.FindFirstValue(ClaimTypes.NameIdentifier);
var key = !string.IsNullOrEmpty(userId)
? $"user:{userId}"
: $"ip:{httpContext.Connection.RemoteIpAddress}";
return RateLimitPartition.GetSlidingWindowLimiter(
partitionKey: key,
factory: _ => new SlidingWindowRateLimiterOptions
{
PermitLimit = 60,
Window = TimeSpan.FromMinutes(1),
SegmentsPerWindow = 6,
QueueLimit = 2
});
});
options.OnRejected = async (context, token) =>
{
if (context.Lease.TryGetMetadata(MetadataName.RetryAfter, out var retryAfter))
{
context.HttpContext.Response.Headers.RetryAfter =
((int)Math.Ceiling(retryAfter.TotalSeconds)).ToString();
}
await context.HttpContext.Response.WriteAsJsonAsync(
new { error = "Terlalu banyak percubaan. Sila cuba semula sebentar lagi." },
cancellationToken: token);
};
});
Susunan middleware dalam Program.cs juga kritikal: panggil app.UseForwardedHeaders() terlebih dahulu, diikuti app.UseRouting(), app.UseAuthentication(), app.UseAuthorization(), dan kemudian app.UseRateLimiter() sebelum app.MapControllers(). Jika UseRateLimiter() diletakkan sebelum UseAuthentication(), nilai httpContext.User akan sentiasa kosong dan polisi berasaskan UserId tidak akan berfungsi. Selepas itu, pasangkan polisi pada laluan tertentu sahaja menggunakan [EnableRateLimiting("auth-strict")] atau .RequireRateLimiting("api-user").
Tiga perangkap praktikal sebelum diaktifkan di produksi
1. Jangan sekat mengikut IP semata-mata (kes pejabat korporat dan CGNAT Malaysia)
Di Malaysia, situasi ribuan pelanggan rangkaian mudah alih berada di belakang CGNAT dan berkongsi satu alamat IP awam yang sama adalah perkara biasa. Begitu juga ratusan staf dalam satu bangunan pejabat atau pelajar di kampus universiti. Jika anda menetapkan had 20 permintaan seminit mengikut IP untuk keseluruhan API, seorang pengguna yang menekan refresh berkali-kali boleh menyebabkan rakan sepejabatnya turut disekat. Sebab itu untuk endpoint selepas log masuk, gunakan UserId atau TenantId sebagai partition key. Selain itu, jika aplikasi berada di belakang Cloudflare atau Nginx, pastikan ForwardedHeadersOptions dikonfigurasi dengan betul (X-Forwarded-For atau CF-Connecting-IP); jika tidak, semua trafik akan kelihatan datang dari satu IP pelayan proksi yang sama.
2. Pulangkan status 429 dan header Retry-After yang boleh dibaca oleh frontend
Apabila pengguna biasa tersalah tekan butang hantar dua kali ketika liputan internet kurang stabil, aplikasi frontend patut membaca kod 429 dan nilai Retry-After untuk memaparkan mesej yang membantu—misalnya “Sila tunggu 15 saat sebelum mencuba lagi”—bukannya keluar ralat generik “Server Error 500” yang mengelirukan pengguna dan pasukan sokongan.
3. Pelayan tunggal berbanding berbilang instance
AddRateLimiter lalai menyimpan kaunter di dalam memori satu pelayan sahaja. Jika API anda berjalan di atas tiga kontena atau beberapa pelayan di belakang load balancer, had 10 permintaan seminit akan berubah menjadi 30 permintaan seminit secara tidak sengaja. Untuk seni bina berbilang instance, pindahkan kaunter ke storan teragih seperti Redis, atau letakkan lapisan had kadar pertama di pinggir rangkaian menggunakan Cloudflare WAF Rate Limiting supaya serangan disekat sebelum sempat menyentuh pelayan aplikasi anda.
Rate limiting bukanlah pengganti kepada pembaikan query SQL yang perlahan atau pengesahan input yang lemah, tetapi ia lapisan pertahanan asas yang memastikan seorang pengguna nakal tidak mampu menjatuhkan sistem untuk semua orang lain.