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:

Java

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);
 
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

.Net

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);
 
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.

Certisign Login - Opção 1 Certisign Login - Opção 2

Está com dúvidas? Precisa de ajuda?
suporte@certisign.com.br | 11 3546-3712