Gesgocom.Acceso.Api 0.4.0
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>";
o.ClientesPermitidos = ["<cliente>"]; // client_id de la consola y apps de ESTA instalación
});
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 });
AddGesgocomAccesohace de JwtBearer el esquema por defecto. El metadata por HTTP solo se admite en Development.- Políticas:
RequiereMfa,AutenticacionReciente(max),RequiereScope(scope).IUserInfoAccesoda nombre y email verificados (userinfo).ICurrentUserdaSub,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(namespaceGesgocom.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_timedebe ser un entero (segundos Unix).
No packages depend on Gesgocom.Acceso.Api.
0.4.0: ClientesPermitidos (client_id aceptados) y client_id en EmisorPruebas. 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.
.NET 10.0
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 10.0.1)
- Microsoft.IdentityModel.JsonWebTokens (>= 8.17.0)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.17.0)