Nexttag.Auth.Identity 1.1.2

Nexttag.Auth.Identity

ASP.NET Identity integrado: login, registro e troca de senha usando banco local, sem serviço externo.

Instalar

dotnet add package Nexttag.Auth.Identity

Requer .NET 10. Depende de Nexttag.Auth.Jwt (incluso transitivamente).

Registrar (Program.cs)

// Usando o usuário padrão (NexttagIdentityUser)
builder.Services.AddNexttagIdentity<AppDbContext>(builder.Configuration);

// OU com usuário customizado (herda de NexttagIdentityUser)
builder.Services.AddNexttagIdentity<AppDbContext, MeuUsuario>(builder.Configuration);

// ...

app.UseAuthentication();
app.UseAuthorization();

O AppDbContext deve herdar de IdentityDbContext<NexttagIdentityUser, IdentityRole<Guid>, Guid>:

public class AppDbContext : IdentityDbContext<NexttagIdentityUser, IdentityRole<Guid>, Guid>
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
}

Configurar

{
  "ConnectionStrings": {
    "Default": "Host=localhost;Database=meudb;Username=admin;Password=senha"
  },
  "Jwt": {
    "Key": "<chave-secreta-minimo-32-chars>",
    "Issuer": "https://api.seudominio.com.br",
    "Audience": "meu-app",
    "ExpirationMinutes": "480"
  }
}

Regras de senha configuradas internamente:

• Mínimo 6 caracteres, ao menos 1 dígito e 1 minúscula.
• Lockout: 5 tentativas → bloqueio de 5 minutos.
• E-mail único obrigatório.

Usar

Login

public class AuthController(IdentityAuthService<NexttagIdentityUser> auth) : ControllerBase
{
    [HttpPost("login")]
    public async Task<IActionResult> Login(LoginDto dto)
    {
        var result = await auth.LoginAsync(dto.Email, dto.Senha);
        if (!result.IsSuccess) return Unauthorized(result.Error);
        return Ok(result.Value); // { Token, UsuarioId, Email, Nome }
    }
}

Registro

[HttpPost("registro")]
public async Task<IActionResult> Registrar(RegistroDto dto)
{
    var result = await auth.RegistrarAsync(dto.Nome, dto.Email, dto.Senha);
    if (!result.IsSuccess) return BadRequest(result.Error);
    return Ok(result.Value);
}

Alterar senha

[Authorize]
[HttpPut("senha")]
public async Task<IActionResult> AlterarSenha(AlterarSenhaDto dto,
    [FromServices] ICurrentUserProvider usuario)
{
    var result = await auth.AlterarSenhaAsync(usuario.UsuarioId!.Value, dto.SenhaAtual, dto.NovaSenha);
    if (!result.IsSuccess) return BadRequest(result.Error);
    return NoContent();
}

Usuário customizado

public class AppUsuario : NexttagIdentityUser
{
    public string? Departamento { get; set; }
}

// No Program.cs:
builder.Services.AddNexttagIdentity<AppDbContext, AppUsuario>(builder.Configuration);

// No controller, injete IdentityAuthService<AppUsuario>

Receitas

Criar usuário com role após registro:

var result = await auth.RegistrarAsync("João Silva", "joao@email.com", "Senha123");
if (result.IsSuccess)
{
    var user = await userManager.FindByEmailAsync("joao@email.com");
    await userManager.AddToRoleAsync(user!, "operador");
}

Endpoint protegido por role:

[Authorize(Roles = "admin")]
[HttpDelete("{id}")]
public async Task<IActionResult> Excluir(Guid id) { ... }

Notas

• IdentityAuthService<TUser> usa Result<T> de Nexttag.Common — verifique result.IsSuccess antes de acessar .Value.
• Lockout retorna AppError.TooManyRequests — mapeie para HTTP 429 no seu ExceptionMiddleware.
• EmailConfirmed é definido como true no registro — se precisar verificação de e-mail, implemente fluxo separado.
• Requer migration do EF Core para criar as tabelas do Identity (AspNetUsers, AspNetRoles, etc.).