Pular para conteúdo

Política de senha por Opções da Empresa

As flags da aba Controles em Opções da Empresa (ct_controle) valem na criação de usuário e no reset de senha. A API do masterdata é a fonte da verdade; a tela só antecipa o erro.

Quando vale

Se nenhuma empresa vinculada ao usuário tiver Controlar Senhas ligado, a senha não é validada por estas regras e a área de detalhe some na tela de Opções.

Se qualquer empresa tiver Controlar Senhas = verdadeiro, as regras ligadas dessas empresas são unidas de forma mais restritiva:

Campo na tela Efeito
Tamanho Mínimo Comprimento ≥ valor (união: o maior mínimo)
Tamanho Máximo Comprimento ≤ valor (união: o menor máximo)
Número de Tentativas Tentativas de login antes do bloqueio (união: o menor valor > 0). Persistido para o fluxo de lockout.
Desbloqueio Automático (minutos) 0 = desbloqueio manual; > 0 = minutos até liberar. União: se alguma empresa for 0, prevalece 0; senão o maior tempo.
Bloqueia Senhas Antigas Quantidade de senhas anteriores bloqueadas no reset (nrsenhasantigas). 0 = não verifica reuso. União: o maior número. A coluna legada permitesenhasant é só espelho (false se 0, true se > 0) e não deve ser usada na regra.
Exige Número Pelo menos um dígito 0-9
Exige Maiúscula e Minúscula Pelo menos um A-Z e um a-z
Exige Caracter Especial Pelo menos um de !@#$%^&*()_+-=[]{}|;:,.<>?/~

Exemplo (mín. 5, máx. 8, caracteres especiais): aceitas 123a@ e AABBCCd#; recusadas 1234, 123456789, 123AA e AABBCCDD.

A senha é do usuário, não da empresa escolhida no header. No reset a política sai das empresas do cadastro do usuário.

Histórico

Cada reset bem-sucedido grava o hash anterior em gr_user_password_history (Flyway V0.7.00.19). A validação compara a senha nova com a atual e com até N hashes do histórico (nrsenhasantigas). O armazenamento guarda no máximo 20 hashes.

O que ainda não bloqueia login

  • O número de tentativas e o desbloqueio automático já são gravados em ct_controle (nrtentativas, desbloqueiominutos), mas o lockout no POST /api/auth/signin ainda não consome esses campos.
  • Troca de senha na edição de usuário (o backend ainda não regrava senha nesse fluxo)
  • Bootstrap POST /createadminuser, login IdP e usuário técnico B2B

APIs

  • GET /password-policy?companyIds= — política efetiva para o cadastro (inclui oldPasswordHistoryCount, minLength, maxLength, maxAttempts, autoUnlockMinutes)
  • GET /getusersettings/{id} — inclui passwordPolicy
  • POST /usersettings (criação) e POST /usersetting/resetPass — recusam senha fora da política com HTTP 400