com.jopss:captcha-logico

captcha-logico

API para implementação de um Captcha com perguntas lógicas em português, ao invés de imagens e textos. Isso possibilita a implementação de acessibilidade e melhora a usabilidade do sistema. Será criado em tela uma questão com 4 respostas objetivas, a ser selecionado somente 1 correta.

É utilizado um banco de dados leve interno (hsqldb memory) para retornar a pergunta e respostas.

Os fontes foram propositadamente escrito e voltado para português BR.

Quantidade de perguntas diferentes cadastradas: 20.

Encoding: UTF-8.

Licença

O projeto foi concebido na licença Mozilla 2.0, ou seja, pode-se utilizar o jar em qualquer projeto, comercial ou não. Mas alterações na API devem ser obrigatoriamente disponibilizada na mesma licença.

É OpenSource, e como tal, qualquer um pode melhorar o código, corrigindo ou adicionando novas funcionalidades. Basta dar um fork neste repo.

Maven

<dependency>
	<groupId>com.jopss</groupId>
	<artifactId>captcha-logico</artifactId>
	<version>1.0</version>
</dependency>

Uso

Para utilizar o Captcha Logico na sua aplicação, basta configurar a dependência maven no seu projeto, utilizar a classe "CaptchaLogico" para carregar, criar as perguntas e referenciar a tag html na página web.

Controlador/Serviço

No seu controlador ou serviço web você deve carregar uma pergunta e as respostas na requisição:

CaptchaLogico.carregar(session, request).criarNovaPerguntaRespostas();

Isso irá fazer com que guarde o valor real da resposta em sessão no servidor, e retorna parâmetros da requisição (escopo de Request) com os valores da pergunta e respostas. Ao retornar no submit da sua página, verifique a resposta digitada com o valor guardado na sessão com:

CaptchaLogico.carregar(session, request).validarRespostaUsuario( form.getRespostaUsuario() );

Ao retornar do submit (controlador para a página), lembre-se de recarregar os dados da requisição.

HTML/JSP

Em tela deve criar referenciar o diretorio de tags da API no cabeçalho na página:

<%@ taglib prefix="cp-componentes" tagdir="/WEB-INF/tags/cp-componentes"%>

E em sua página, posicionar a tag que ira exibir as perguntas:

<cp-componentes:captcha-logico nameRadiosRespostas="respostaCaptcha" />

O HTML gerado não irá conter nenhum tipo de CSS ou estilo. Cabe a cada projeto gerar o layout adequado. Os parâmetros possíveis para esta tag são:

• nameRadiosRespostas: Atributo a ser inserido no 'name' de todos os radios de respostas. Normalmente ele deve referenciar algum atributo do 'backend bean' do formulario a receber o valor da resposta selecionada.
• classDivConteudo: Classe CSS para estilizacao do div content. Este div esta em volta de todos os componentes.
• classPergunta: Classe CSS para o paragrado (p) da pergunta.
• classSpanRespostas: Classe CSS para o span das respostas. Dentro deste estarão os radios com as respostas.

Status

Finalizado primeira release. Em manutenção.