Gesgocom.Acceso.Api 0.3.1

Gesgocom.Acceso.Api

Configura JwtBearer para aceptar los access tokens de Gesgocom Acceso (IdP OIDC) en una API ASP.NET Core.

Uso rápido

dotnet nuget add source https://nuget.gesgocom.es/v3/index.json -n Gesgocom
dotnet add package Gesgocom.Acceso.Api
builder.Services.AddGesgocomAcceso(o =>
{
    o.Issuer = "https://acceso.ejemplo.es/";
    o.Audiencia = "api.<producto>";
});
builder.Services.AddAuthorization(o =>
{
    o.AddPolicy("mfa", p => p.RequiereMfa());
    o.AddPolicy("sensible", p => p.AutenticacionReciente(TimeSpan.FromMinutes(10)));
    o.AddPolicy("escritura", p => p.RequiereScope("escribir"));
});
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapGet("/yo", [Authorize] (ICurrentUser u) => new { u.Sub, u.EntidadId, u.TieneMfa });
  • AddGesgocomAcceso hace de JwtBearer el esquema por defecto. El metadata por HTTP solo se admite en Development.
  • Políticas: RequiereMfa, AutenticacionReciente(max), RequiereScope(scope). IUserInfoAcceso da nombre y email verificados (userinfo). ICurrentUser da Sub, EntidadId, Sid, Amr, AuthTime, Soporte, Scopes, TieneMfa.
  • Tras una rotación de claves del IdP puede haber un 401 transitorio por réplica hasta refrescar el JWKS; el IdP debe publicar la clave nueva en su JWKS antes de firmar con ella.
  • Tests del producto: EmisorPruebas (namespace Gesgocom.Acceso.Api.Pruebas) emite tokens con claves en memoria; no usar en producción.

Guía completa: docs/uso.md.

Diferencias con la librería Python

  • Si el JWKS del IdP no está disponible, la librería .NET responde 401 (JwtBearer no distingue el fallo de configuración de un token inválido); la Python responde 503.
  • auth_time debe ser un entero (segundos Unix).

No packages depend on Gesgocom.Acceso.Api.

0.3.0: esquema JwtBearer nombrado, opt-in de esquema predeterminado y callback posterior a ClaimsValidos. 0.2.0: IUserInfoAcceso y EmisorPruebas.UserInfoEndpoint. 0.1.0: validación de access tokens at+jwt, ICurrentUser, políticas y EmisorPruebas.

Version Downloads Last updated
0.4.0 18 11/03/2026
0.3.1 14 10/22/2026
0.2.0 9 10/21/2026