O que é um CSR?

Uma solicitação de assinatura de certificado (CSR, na sigla em inglês) é o arquivo que você envia a uma autoridade certificadora para obter um certificado SSL/TLS para seu site ou servidor. Ele contém os nomes de domínio, dados opcionais sobre sua organização e a parte pública de um novo par de chaves. A solicitação é assinada com a parte privada para comprovar que você é o proprietário da chave. A autoridade certificadora verifica a solicitação e envia um certificado para essa chave.

A chave privada nunca é incluída na solicitação. Você a mantém no servidor, onde ela funciona em conjunto com o certificado.

Como gerar um CSR

  1. Insira o nome de domínio para o qual o certificado será emitido, como shop.example.com, ou um curinga como *.example.com.
  2. Em Mais nomes de domínio, adicione outros nomes que o certificado deve cobrir, um por linha, como www.shop.example.com. Endereços IP também são aceitos.
  3. Preencha os dados da organização, da cidade, do estado e do país, caso a autoridade certificadora solicite. Os certificados validados por domínio geralmente ignoram esses campos.
  4. Escolha um tipo de chave e clique em Gerar CSR.
  5. Baixe ou copie o CSR e envie-o à autoridade certificadora. Salve a chave privada imediatamente: não é possível gerá-la novamente, e o certificado não tem utilidade sem ela.

Qual tipo de chave devo escolher?

  • RSA 2048 funciona com todas as autoridades certificadoras, servidores e clientes, e é a opção usada pela maioria das pessoas.
  • RSA 3072 e RSA 4096 são chaves RSA maiores. São mais lentas e raramente necessárias.
  • ECDSA P-256 gera chaves menores e conexões mais rápidas, com segurança comparável à de RSA 3072. Todos os navegadores e servidores atuais oferecem suporte a ela.
  • ECDSA P-384 é uma chave de curva elíptica maior, indicada para políticas que exigem esse tipo de chave.

O que é incluído na solicitação

  • O nome de domínio se torna o nome comum (CN) e é sempre repetido como nome alternativo da entidade (SAN), já que os navegadores leem apenas os SANs.
  • Os nomes de domínio são escritos em letras minúsculas. Nomes internacionais, como bücher.example, são convertidos para o formato xn--.
  • Os dados da organização, da cidade, do estado ou província e do país são adicionados apenas quando você os preenche. As autoridades certificadoras públicas não incluem mais unidades organizacionais nem endereços de e-mail em certificados TLS, por isso a ferramenta omite esses campos.
  • As solicitações RSA são assinadas com SHA-256; as solicitações ECDSA P-256, com SHA-256; e as solicitações P-384, com SHA-384.

A chave privada é salva no formato padrão PKCS#8 (-----BEGIN PRIVATE KEY-----), que servidores web como nginx, Apache e Caddy leem diretamente.

Como funciona

O par de chaves é gerado pela API Web Crypto integrada ao navegador, e a solicitação é criada e assinada com a biblioteca PKI.js. Tudo acontece no seu dispositivo: nem a chave nem a solicitação são enviadas para nenhum lugar.

Recursos

  • Chaves RSA 2048, 3072 e 4096, e ECDSA P-256 e P-384
  • Vários nomes de domínio, curingas e endereços IP em uma única solicitação
  • Conversão automática de nomes de domínio internacionais
  • Organização, cidade, estado e país opcionais
  • Baixe o CSR e a chave privada como arquivos
  • Funciona no navegador