Prodest.AuthNZ 6.0.8

Prodest.AuthNZ

Sobre

Pacote com a configuração necessária para realizar a autenticação e autorização de usuários.

Como usar?

A configuração abaixo é a mais comum para uma api/webapp que precisa integrar com o login do Acesso Cidadao:

// Program.cs

var builder = WebApplication.CreateBuilder(Environment.GetCommandLineArgs());

builder.Services
    .ConfigureAuthenticationDataProtection(builder.Configuration, "SutFactory")
    .ConfigureOpenIdAuthentication(
        builder.Configuration,
        cookieDomain: "localhost",
        cookieName: "SutFactory_Cookie"
    );

builder.Services
    .ConfigureAuthorization();

builder.Services
    .InjectAcessoCidadaoIntegration(builder.Configuration);

var app = builder.Build();

await app.RunAsync();

Primeiramente precisamos configurar o DataProtection, ele é usado para criar uma chave de criptografia para proteger informações sensíveis da aplicação, como por exemplo, o cookie de autenticação. Essa configuração irá armazenar essa chave em um banco SqlServer definido na seção de ConnectionStrings do appsettings. Essa extensão precisa de um objeto IConfiguration e o nome da aplicação (para identificação da chave) passados via parâmetro, também é possível informar o nome do schema no banco de dados que irá receber a tabela que armazena as chaves, o padrão é dbo e a tabela é criada automaticamente, caso não exista.

// Program.cs

builder.Services
    .ConfigureAuthenticationDataProtection(builder.Configuration, "SutFactory"[, databaseSchema: "SchemaXYZ"])

Autenticação

A integração com o login do acesso cidadão é feita com a extensão que configura e usa o protocolo OpenId. Essa extensão também define a autenticação e configura um cookie com configurações e eventos padronizados.

// Program.cs

builder.Services
    .ConfigureOpenIdAuthentication(
        builder.Configuration,
        cookieDomain: "localhost",
        cookieName: "SutFactory_Cookie"
    );

É necessário, para o funcionamento correto, a criação de uma seção no appsettings chamada LoginWeb:

// appsettings.json

"LoginWeb": {
    "Authority": "https://acessocidadao.es.gov.br/is/",
    "ClientId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ClientSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "GetClaimsFromUserInfoEndpoint": "true",
    "RequireHttpsMetadata": "true",
    "ResponseType": "code",
    "SaveTokens": "false",
    "Scopes": [
        "xxxxxxxx",
        "yyyyyyyy"
    ],
    "UsePkce": false
}

Autorização

Podemos definir políticas de autorização com a extensão ConfigureAuthorization:

// Program.cs

builder.Services
    .ConfigureAuthorization([policyOptions: (options, string[]) => { }]);

Essa extensão pode ser invocada sem parâmetro, onde a política padrão requer usuários autenticados, para definir políticas mais granulares, utilize a action que recebe o AuthorizationOptions e um array de string com o schema de autorização do OpenId.

Compartilhamento de cookies entre aplicações

Existem casos onde é necessário o compartilhamento do cookie de autenticação entre aplicações. Essas aplicações compartilham a mesma configuração de DataProtection, onde uma aplicação X é responsável por fazer o login com OpenId e as demais são configuradas como a mesma configuração de cookies e assim consumindo o cookie criado em outra aplicação, obtendo o efeito parecido com o de um SSO.

// Program.cs

builder.Services
    .ConfigureAuthenticationDataProtection(builder.Configuration, "AppCompartilhado")
    .ConfigureSharedCookieAuthentication(
        cookieDomain: "localhost",
        cookieName: "SutFactory_Cookie"
        [, configureCookieEvents: options => { }]
    )

Integração com o acesso cidadão

// Program.cs

builder.Services
    .InjectAcessoCidadaoIntegration(builder.Configuration);

A integração com o acesso cidadão é feita através da extensão InjectAcessoCidadaoIntegration, mais detalhes sobre a extensão estão em Integrations.AcessoCidadao.