Docs
...

Certificados

A seção de Certificados exibe os certificados cadastrados para o aplicativo e permite ações como download ou revogação de certificados.

Info

Para acessar, basta clicar em editar no aplicativo desejado na tela de Desenvolvimento e selecionar a aba Certificados.

Campo Descrição
Identificador ID único do certificado.
Válido desde Data de início da validade do certificado.
Válido até Data de expiração do certificado.
Status Indica se o certificado está ativo (Válido) ou revogado.
Revoga o certificado.
Permite o download do certificado.

Adicionar um Certificado

  1. Copie a chave pública no formato PEM.
    • Exemplo de chave PEM:

      -----BEGIN PUBLIC KEY-----
      MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv3cvl1i9Oyf/UturDBFo
      ...
      -----END PUBLIC KEY-----
      
  2. Cole a chave no campo Cole sua chave pública aqui (formato PEM).
  3. Clique no botão .
  4. O certificado será salvo e exibido na lista de certificados.

Aviso

  • Certifique-se de que a chave pública está no formato correto para evitar erros de validação.

  • Gerencie seus certificados com cuidado para garantir a integridade e a segurança das integrações.

Perigo

Mantenha sua chave privada em locais seguros e com permissões restritas para evitar acessos não autorizados. Ela não fica armazenada na iugu para garantir a integridade das integrações. Não compartilhe a chave privada com terceiros, é sua responsabilidade.

Como Gerar um Par de Chaves Privada e Pública do Zero

Este guia explica como gerar um par de chaves privada e pública utilizando o OpenSSL.

Info

Caso esteja usando o windows os comandos são os mesmos com exceção da extensão do cat que deve ser usada para exibir o conteúdo do arquivo. Use type em vez de cat.

Passo a Passo

1. Gerar a Chave Privada

Execute o comando abaixo para criar uma chave privada no formato PEM:

openssl genrsa -out private_key.pem 2048
  • private_key.pem: Nome do arquivo que conterá a chave privada.
  • 2048: Tamanho da chave em bits (pode usar 4096 para maior segurança).

2. Gerar a Chave Pública

A partir da chave privada gerada no passo anterior, execute o comando para criar a chave pública:

openssl rsa -pubout -in private_key.pem -out public_key.pem
  • -in private_key.pem: Indica o arquivo de chave privada de entrada.
  • -out public_key.pem: Nome do arquivo que conterá a chave pública.

3. Verificar as Chaves Geradas

Use os comandos abaixo para confirmar que as chaves foram geradas corretamente:

  • Exibir a chave privada: bash cat private_key.pem
  • Exibir a chave pública: bash cat public_key.pem

4. Testar o Funcionamento das Chaves

Certifique-se de que as chaves estão funcionando corretamente ao assinar e verificar um arquivo.

Criar um arquivo para teste:

echo "Teste de assinatura" > teste.txt

Assinar o arquivo com a chave privada:

openssl dgst -sha256 -sign private_key.pem -out teste.sig teste.txt

Verificar a assinatura com a chave pública:

openssl dgst -sha256 -verify public_key.pem -signature teste.sig teste.txt
  • Se a assinatura estiver correta, você verá a mensagem: Verified OK

Info

  • Chave Privada: Usada para assinar dados ou realizar operações sensíveis. Mantenha este arquivo seguro.
  • Chave Pública: Usada para verificar dados ou compartilhada com terceiros para autenticação.

Aviso

Certifique-se de guardar as chaves em locais seguros e com permissões restritas para evitar acessos não autorizados.