Nexttag.Auth 1.1.0

Nexttag.Auth

Contratos universais de autenticação compartilhados pelas libs Nexttag.Auth.*. Hoje: ICurrentUserProvider (quem é o usuário do request atual) — provedor-agnóstico (Jwt, Identity, Keycloak, NextAuth implementam).

ℹ️ v1.1.0: o contrato de emissão de token (IJwtService) saiu desta base e vive em Nexttag.Auth.Jwt — emitir token é mecanismo específico (Keycloak/NextAuth não emitem, só validam). O namespace segue Nexttag.Auth, então o código consumidor não muda, só recompila.

Instalar

dotnet add package Nexttag.Auth

Requer .NET 10.

Registrar (Program.cs)

Este pacote não tem registro próprio — é instalado como dependência transitiva de Nexttag.Auth.Jwt, Nexttag.Auth.Identity, Nexttag.Auth.Keycloak ou Nexttag.Auth.NextAuth. Não é necessário chamá-lo diretamente.

Configurar

Sem configuração obrigatória.

Usar

Para emitir tokens (IJwtService), use o pacote Nexttag.Auth.Jwt (veja o README de lá). Esta base expõe só o contrato universal abaixo.

ICurrentUserProvider

Lê os claims do usuário autenticado no request atual:

public class MeuController(ICurrentUserProvider usuario)
{
    public IActionResult Info()
    {
        var id    = usuario.UsuarioId;   // Guid?
        var nome  = usuario.Nome;        // string?
        var email = usuario.Email;       // string?
        var claim = usuario.GetClaim("tenantId"); // string?
        return Ok(new { id, nome, email });
    }
}

Receitas

Injetar em qualquer serviço de domínio:

public class PedidoService(ICurrentUserProvider usuarioAtual, IPedidoRepository repo)
{
    public async Task CriarPedido(PedidoDto dto)
    {
        var autorId = usuarioAtual.UsuarioId
            ?? throw new UnauthorizedAccessException();
        await repo.AdicionarAsync(new Pedido { AutorId = autorId, ... });
    }
}

Notas

• ICurrentUserProvider retorna null quando não há usuário autenticado — trate o caso.
• A implementação concreta (CurrentUserProvider) é registrada automaticamente por AddNexttagJwtAuth.
• Emissão de token (IJwtService) agora vive em Nexttag.Auth.Jwt (namespace Nexttag.Auth mantido).