O conjunto aceito pela aplicação
Uma allowlist é uma definição explícita dos valores ou recursos permitidos em uma aplicação. O sistema compara a entrada com esse conjunto e recusa o que não corresponde a ele. A mesma abordagem pode limitar os formatos de um relatório ou os destinos que um serviço consulta.
Para um campo com opções fixas, a conferência pode comparar o valor recebido com uma lista curta. Outros campos exigem uma definição de formato ou intervalo. Um número de páginas entre 1 e 10 representa um conjunto permitido, embora a aplicação não precise escrever cada número em uma lista.
A escolha do formato de exportação
Em um exemplo didático, uma função exporta relatórios somente em csv e pdf. O servidor aceita esses dois valores no campo formato e recusa executavel. A interface pode mostrar apenas as opções permitidas, mas uma requisição enviada diretamente ao servidor também precisa passar pela validação.
Você deve conferir o valor que a função realmente processará. Se a aplicação normaliza letras maiúsculas ou remove espaços, essa transformação precisa ocorrer de forma consistente com a comparação. Validar uma representação e executar outra pode fazer a função receber um valor diferente daquele que foi aceito.
Validação e autorização verificam condições distintas
O formato pdf pode ser permitido para uma exportação, mas o relatório solicitado pode pertencer a outro cliente. A allowlist do formato não verifica essa permissão de acesso. O servidor precisa relacionar a sessão ao relatório e recusar a consulta quando ela não for autorizada.
Nos testes, envie um formato ausente da lista e confira a recusa da entrada. Depois use um formato aceito com o identificador de um relatório de outro cliente. Esse segundo teste verifica a autorização e deve recusar o acesso mesmo com o formato válido.
Dúvidas frequentes
Perguntas frequentes sobre allowlist
- Como uma allowlist difere de uma denylist?
- A allowlist descreve o conjunto permitido e recusa o que fica fora dele. A denylist descreve itens proibidos. Usada isoladamente, a denylist pode aceitar uma entrada indesejada que ainda não foi incluída nela.
- A lista precisa enumerar todos os valores?
- Ela pode enumerar opções fixas ou definir formatos e intervalos permitidos. Um campo numérico pode aceitar apenas inteiros de 1 a 10, por exemplo. A escolha depende do significado daquele campo.
- Um identificador aceito dá acesso ao registro?
- A validação confirma que o identificador atende ao formato ou conjunto esperado. O servidor ainda precisa verificar se a sessão tem permissão para acessar aquele registro.
Para continuar
Recursos relacionados
Documentação
OWASP: validação de entrada
Orienta a definir o conjunto aceito por campo e a conferir a autorização separadamente da validade da entrada.
Abrir recursoAplicação na formação
Developer Workspace
A configuração de acesso e a validação das entradas precisam indicar exatamente o que é aceito pelo sistema.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.