Limit repeated access code requests via caching

Introduced a mechanism to limit repeated access code requests
within a configurable time period using `IMemoryCache` and a
new `RepeatRequestBlockingPeriod` configuration in
`SendAccessCodeParams`.

Key changes:
- Added `SendAccessCodeParams` configuration to `appsettings.json`.
- Updated DI in `DependencyInjection.cs` to include `SendAccessCodeParams`.
- Enhanced `SendAccessCodeCommand` with `MultipleRequestsAllowed`.
- Updated `SendAccessCodeCommandHandler` to handle caching logic:
  - Added `IsAccessCodeRequestsDisabled` and `DisableAccessCodeRequests`.
- Modified `AuthController` to support `autoGenerated` query parameter.
- Improved error handling and documentation.

These changes ensure better control over access code requests
and prevent abuse by limiting repeated requests within a
configurable time window.
This commit is contained in:
2026-11-16 13:11:31 +01:00
parent 93d9aa0742
commit 6c9b8ad3a8
5 changed files with 76 additions and 8 deletions

View File

@@ -93,6 +93,7 @@ public partial class AuthController(
/// The operation is idempotent: if the code was already requested, it returns 200 without re-sending.
/// </summary>
/// <param name="key">Envelope receiver key.</param>
/// <param name="autoGenerated">If the access code was auto-generated while page is loading.</param>
/// <param name="sender">MediatR instance.</param>
/// <param name="cancel">Cancellation token.</param>
/// <response code="200">Access code is already available or requested successfully.</response>
@@ -100,8 +101,8 @@ public partial class AuthController(
/// <response code="500">Access code could not be persisted or e-mail could not be sent.</response>
[AllowAnonymous]
[HttpPost("envelope-receiver/{key}/request-access-code")]
public async Task<IActionResult> RequestEnvelopeReceiverAccessCode([FromRoute] string key, [FromServices] ISender sender, CancellationToken cancel)
=> await sender.Send(new SendAccessCodeCommand(key), cancel) switch
public async Task<IActionResult> RequestEnvelopeReceiverAccessCode([FromServices] ISender sender, [FromRoute] string key, [FromQuery] bool autoGenerated = true, CancellationToken cancel = default)
=> await sender.Send(new SendAccessCodeCommand(key).AllowMultipleRequests(!autoGenerated), cancel) switch
{
SendAccessCodeResult.Sent => Ok(),
SendAccessCodeResult.AlreadySigned => Conflict(),

View File

@@ -289,5 +289,8 @@
"ESignParams": {
"ApplicationName": "signFLOW",
"DefaultReason": " Bestätigt"
},
"SendAccessCodeParams": {
"RepeatRequestBlockingPeriod": "00:01:00"
}
}