Certisign Login - Desenvolvedores
Parabéns, falta pouco para você inserir o Certisign Login na sua loja virtual e desfrutar de todos os benefícios da identificação por meio do Certificado Digital.
1º Passo: cadastro
Clique aqui e cadastre-se.
2º Passo: iniciar a implementação
Selecione a sua plataforma:
1ª Etapa: download do Client
Faça o download do client aqui.
Este client se refere ao componente de manipulação da chave criptográfica que rodará na sua aplicação.
2ª Etapa: download de Chave Criptográfica
Entre na aba Chaves Criptográfias e realize o download de sua chave criptográfica, criada no momento de seu cadastro, clicando no botão azul.
Caso queira criar uma nova chave criptográfica, siga o fluxo ao clicar em "Gerar Nova Chave".
3ª Etapa: enviar requisição de acesso
Esta etapa realiza uma chamada no servidor da Certisign para que a mesma valide a identidade do usuário que quer entrar na sua aplicação.
GET: https://autenticador.certisign.com.br/CertisignLogin/certificado/login?
id={idDaChave}
&nome={nomeDaChave}
&retorno={urlDeRetorno}Exemplo de post:
<form action="https://autenticador.certisign.com.br/CertisignLogin/certificado/login" method="get"> <input type="hidden" value="209" id="id" name="id"> <input type="hidden" value="CHAVE CRIPTOGRAFICA INICIAL" id="nome" name="nome"> <input type="hidden" value="http://www.seusite.com.br/suaAplicacao/retorno" id="retorno" name="retorno"> <div> <input type="image" src="images/ico-certisign_30x30.png" alt="Submit" id="btnLoginCertisign"> </div> </form>
4ª Etapa: decriptar o retorno
Segue exemplo de código para utilizar o client e decriptografar a mensagem recebida da certisign utilizando a sua chave criptográfica.
Na sua URL de retorno, você receberá os parâmetros, conforme abaixo:
// obter retorno encriptado da resposta String ret = request.getParameter("cb"); // obter chave que foi feito o download InputStream chave = getServletContext().getResourceAsStream("/WEB-INF/keys/<sua_chave.pk>"); String schave = IOUtils.toString(chave, "UTF-8"); // usar client e chave para decriptar o retorno encriptado String decriptado = CryptoLogin.decrypt(ret, schave); </sua_chave.pk>
Exemplo
Ainda com dúvidas? Baixe a aplicação de exemplo.
Maven
Descompacte o arquivo da aplicação de exemplo, entre na pasta descompactada via linha de comando e execute:
$> mvn clean package tomcat7:run
1ª Etapa: download do Client
Faça o download do client aqui.
Este client se refere ao componente de manipulação da chave criptográfica que rodará na sua aplicação.
2ª Etapa: download de Chave Criptográfica
Entre na aba Chaves Criptográfias e realize o download de sua chave criptográfica, criada no momento de seu cadastro, clicando no botão azul.
Caso queira criar uma nova chave criptográfica, siga o fluxo ao clicar em "Gerar Nova Chave".
3ª Etapa: enviar requisição de acesso
Esta etapa realiza uma chamada no servidor da Certisign para que a mesma valide a identidade do usuário que quer entrar na sua aplicação.
GET: https://autenticador.certisign.com.br/CertisignLogin/certificado/login?
id={idDaChave}
&nome={nomeDaChave}
&retorno={urlDeRetorno}Exemplo de post:
<form action="https://autenticador.certisign.com.br/CertisignLogin/certificado/login" method="get"> <input type="hidden" value="209" id="id" name="id"> <input type="hidden" value="CHAVE CRIPTOGRAFICA INICIAL" id="nome" name="nome"> <input type="hidden" value="http://www.seusite.com.br/suaAplicacao/retorno" id="retorno" name="retorno"> <div> <input type="image" src="images/ico-certisign_30x30.png" alt="Submit" id="btnLoginCertisign"> </div> </form>
4ª Etapa
Segue exemplo de código para utilizar o client e decriptografar a mensagem recebida da certisign utilizando a sua chave criptográfica.
Na sua URL de retorno, você receberá os parâmetros, conforme abaixo:
string retorno = Request["cb"]; string encryptionKey = "<conteúdo da chave criptográfica descarregada na etapa 2>"; retorno = CryptoLogin.Instance.DecryptText(retorno,encryptionKey);</conteúdo>
Exemplo
Ainda com dúvidas? Baixe a aplicação de exemplo.
3º Passo: mensagem de Retorno
Após a implementação dos códigos, a mensagem (variável "retorno") ficará com o seguinte layout:
CertificadoBean:
{
emissor: Certisign Autoridade Certificadora TESTE,
nome: "PROPRIETARIO DO CERTIFICADO DE TESTE",
cpf: "001.002.003-44",
cnpj: "",
OAB: "",
validade: "2015-05-27 20:59:59",
emissao: "2014-05-27 21:00:00",
email: "proprietario.teste@certisign.com.br",
certificadoBase64: "MIIFmDCCBICgAwI...... BAQUFADCCARAx"
}
Utilize esses dados para realizar o login do usuário em sua aplicação, de acordo com as suas regras de negócio.
Pronto!
Agora, só falta baixar a imagem para representar o botão do Certisign Login.
Salve a opção desejada.
Está com dúvidas? Precisa de ajuda?
suporte@certisign.com.br | 11 3546-3712