StackSpot.Authentication 1.0.2

StackSpot Authentication

Componente projetado para permitir que API verifique se o usuário está autenticado e tem acesso a um recurso restrito.

Versões suportadas

• net5.0
• net6.0

Uso

1. Adicione o pacote NuGet StackSpot.Authentication ao seu projeto.

dotnet add package StackSpot.Authentication

2. Adicione ao seu IServiceCollection via services.AddTokenAuthentication() no Startup da aplicação ou Program tendo como parametro de entrada a url do seu provedor de Autenticação e Autorização.

services.AddTokenAuthentication(url);

Caso econtre o erro System.ArgumentOutOfRangeException: Valid values are between -62135596800 and 253402300799, inclusive. (Parameter 'seconds') utilize a sobrecarga do serviço definindo o parametro ConvertExpirationMillisecondsToSeconds como true.
Isso ocorre somente em casos muito específicos.

services.AddTokenAuthentication(serverAuthenticatonUrl,
                                new HttpClientHandlerOptions()
                                {
                                    ConvertExpirationMillisecondsToSeconds = true
                                });

Implementação

• Definir o [Authorize] para suas Controllers e/ou Endpoints.

[Authorize]
public class MyController : ControllerBase
{
    ...
}

• Em seu arquivo Startup ou Program garantir as configurações básicas de ApplicationBuilder para app.Authorization() e app.Authentication().

...
app.UseRouting();

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

app.UseEndpoints();
...

• E também configurar sua IServiceCollection para que as Controllers possuam o filtro de Autorização.

...
services.AddControllers(options => 
{
    options.Filters.Add(new AuthorizeFilter());

});
...

• Se utilizar o Swagger em sua aplicação, configure as definições de segurança para a autenticação. Exemplo:

...
services.AddSwaggerGen(c => 
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "MyApi", Version = "v1" })
    c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme()
    {
        In = ParameterLocation.Header,
        Description = "Autenticação com Token",
        Name = "Authorization",
        Type = SecuritySchemeType.OAuth2
    });
});
...