AnjozAuthentication 1.2.1

Pacote com implementações padrão para autenticação

• Nesse pacote foi realizado a implementação de algumas funcionalidades básicas para especializar e facilitar a utilização do ClaimsIdentity/IIdentity.

  Assim possibilitando ao desenvolvedor barrar o acesso diretamente no endpoint através das permissões e obter informações do usuário da requisição.

  Informações relevantes:

• As permissões que o usuário possui serão obtidas através do tipo de claim: "Permissoes", exemplo:

  new Claim(Permissoes, "Claim1")
  
  IAnjozPrincipal.Permissions irá conter todas as permissões de claims do tipo Permissoes
  
  Assim quando o usuário possuir as claims será possível adicionar o atributo no endpoint do controlador ou no controlador:
  
  [AnjozPermissionAuthorize("PERMISSAO_NECESSARIA")]
  

• Anjoz principal interface:

  public interface IAnjozPrincipal : IIdentity
  {
      string Id { get; } (Id usuário)
      string Email { get; } (Email usuário)
      ICollection<string> Permissions { get; } (Todas permissões vinculadas ao usuário)
      IEnumerable<Claim> Claims { get; } ( Todas claims do usuário geradas pelo servidor)
      public bool HasPermission(params string[] valoresPermissoes); (Método para verificação se usuário possui determinadas claims)
  }
  

• Como utilizar:

• • Instalar o pacote e realizar a injeção da authenticação chamando o método:

    "AddAnjozAuthentication"

    Exemplo:

      IServiceProvider IStartup.ConfigureServices(IServiceCollection services)
      {
    
          services.AddMvc()
              .SetCompatibilityVersion(CompatibilityVersion.Version_2_1)
              .AddFluentValidation(config => config.RegisterValidatorsFromAssemblyContaining(typeof(BootstrapDomain)));
    
          services.AddAnjozAuthentication()
    
          return services.BuildServiceProvider();
      }
    

    Para Utilizar a autenticação é necessário chamar o método:

    "UseAuthetication"

    Exemplo:

      public void Configure(IApplicationBuilder app)
      {               
          app.ConfigurarSwagger();
          app.UseHttpsRedirection();
          app.UseAuthetication();               
          app.UseMvc();
      }
    

    Para Registrar a autenticação obrigatória para todos os endpoints da api utilize o método:

    "RegisterFilterAnjozAuthorizantionGlobal"

    Exemplo:

          IServiceProvider IStartup.ConfigureServices(IServiceCollection services)
          {                   
              services.AddMvc(opt => opt.RegisterFilterAnjozAuthorizantionGlobal())                       
              services.AddAnjozAuthentication();                           
              return services.BuildServiceProvider();
          }
    

• • Utilizando "IAnjozPrincipal" em um serviço

    Após instalado o pacote e configurado, será possível utiliza a interface IAnjozPrincipal nos serviços se necessário, exemplo:

    public class ClaimService : CrudService<Claim, int>, IClaimService
    {
        private readonly IAnjozPrincipal _anjozPrincipal;
    
        public ClaimService(IClaimRepository claimRepository, IDomainServiceValidator<Claim> validador,
            IAnjozPrincipal anjozPrincipal) 
            : base(claimRepository, validador)
        {
            _anjozPrincipal = anjozPrincipal;
        }
    
        protected override Task<Claim> AoCriarAsync(Claim entity)
        {
            if (_anjozPrincipal.TemPermissao("PODE_GERAR_CLAIM"))
            {
                entity.Valor = entity.Valor.ToUpperInvariant();
                return base.AoCriarAsync(entity);
            }
    
            return default;
        }
    }   
    

• • Restringindo acesso a um endpoint pelas baseado nas permissões que o usuário possui, exemplo:

    public class CheckController : ControllerBase
    {
        [HttpGet]
        [AnjozPermissionAuthorize("PODE_ACESSAR_CHECK")]
        public IActionResult Check()
        {
            return Ok("ONLINE");
        }
    }
    

Obs:

Para o funcionamento deste pacote é necessário que a autenticação jwt ou outra forma de autenticação esteja configurada no projeto princípal.

De forma que o usuário da request esteja preenchido.