79 lines
3.0 KiB
C#
79 lines
3.0 KiB
C#
using Microsoft.AspNetCore.Mvc;
|
|
using Microsoft.Extensions.Logging;
|
|
using SlpModularCms.Core.Availability;
|
|
using SlpModularCms.Core.Observability;
|
|
using SlpModularCms.Modules.Availability.Models;
|
|
using SlpModularCms.Modules.Availability.Services;
|
|
|
|
namespace SlpModularCms.Modules.Availability.Controllers;
|
|
|
|
[ApiController]
|
|
[Route("[controller]")]
|
|
public class MasterController : ControllerBase
|
|
{
|
|
private readonly IMasterAvailabilityService _svc;
|
|
private readonly ILogger<MasterController> _logger;
|
|
|
|
public MasterController(IMasterAvailabilityService svc, ILogger<MasterController> logger)
|
|
{
|
|
_svc = svc;
|
|
_logger = logger;
|
|
}
|
|
|
|
[HttpPost("register")]
|
|
public async Task<IActionResult> Register([FromBody] RegisterMasterRequest request)
|
|
{
|
|
var apiKey = Request.Headers["X-Master-Api-Key"].FirstOrDefault();
|
|
if (string.IsNullOrEmpty(apiKey)) return RejectKey();
|
|
|
|
// The address is stored and polled later: refuse one that cannot be used, and say so without echoing it.
|
|
if (!MasterUrlRules.IsValid(request.MasterUrl))
|
|
{
|
|
_logger.LogWarning("Master registration refused: the master URL is not an absolute http(s) address (invalid_master_url).");
|
|
return BadRequest(new { code = "invalid_master_url", detail = "The master URL must be an absolute http(s) address, for example https://master.example.com." });
|
|
}
|
|
|
|
var success = await _svc.RegisterAsync(request.MasterUrl.Trim(), apiKey);
|
|
return success ? Ok() : RejectKey();
|
|
}
|
|
|
|
[HttpPost("status")]
|
|
public async Task<IActionResult> PushStatus([FromBody] PushStatusRequest request)
|
|
{
|
|
var apiKey = Request.Headers["X-Master-Api-Key"].FirstOrDefault();
|
|
if (string.IsNullOrEmpty(apiKey)) return RejectKey();
|
|
|
|
var success = await _svc.PushStatusAsync(apiKey, request.IsAvailable, request.DisableMessage);
|
|
return success ? Ok() : RejectKey();
|
|
}
|
|
|
|
[HttpGet("registered-url")]
|
|
public async Task<IActionResult> GetRegisteredUrl()
|
|
{
|
|
var apiKey = Request.Headers["X-Master-Api-Key"].FirstOrDefault();
|
|
if (string.IsNullOrEmpty(apiKey)) return RejectKey();
|
|
|
|
var url = await _svc.GetRegisteredUrlAsync(apiKey);
|
|
return url is not null ? Ok(new { MasterUrl = url }) : RejectKey();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Reports the rejection and returns 401. Never logs the key or any part of it.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This event is ambiguous by nature: it means either an intruder, or that the Data
|
|
/// Protection key ring has become unreadable so a legitimate master can no longer be
|
|
/// recognised. The durability work exists to make the second cause impossible, but if it ever
|
|
/// happens this is the first sign of it — and the two need telling apart quickly.
|
|
/// </remarks>
|
|
private IActionResult RejectKey()
|
|
{
|
|
SecurityEvents.MasterApiKeyRejected(
|
|
_logger,
|
|
Request.Path,
|
|
HttpContext.Connection.RemoteIpAddress?.ToString() ?? "(unknown)");
|
|
|
|
return Unauthorized();
|
|
}
|
|
}
|