:Como criar um arquivo CSR?

Este tópico explica como gerar um arquivo de Certificate Signing Request (CSR) com OpenSSL ou Keytool antes de solicitar um certificado SSL.

Antes de começar

Para solicitar um certificado SSL, são necessários um arquivo de chave privada e um arquivo CSR. O arquivo CSR contém sua chave pública e informações organizacionais, que a autoridade certificadora (CA) usa para validação.

O SSL Certificates Service oferece duas ferramentas para gerar arquivos CSR:

Requisitos do arquivo CSR:

• A chave deve ser do tipo RSA, com 2.048 bits.

• Em certificados multidomínio ou curinga, especifique apenas um nome de domínio no campo Common Name (ou What is your first and last name? no Keytool).

• Se inserir caracteres chineses, codifique-os em UTF-8. O Keytool oferece suporte nativo a essa codificação; já o OpenSSL requer configuração específica para UTF-8.

Sempre que possível, use o CSR gerado pelo sistema no SSL Certificates Service para evitar falhas de validação por formatação incorreta. Para saber como resolver problemas de validação, consulte O erro "Primary domain name cannot be empty" é retornado quando faço upload do meu arquivo CSR. O que devo fazer?. Caso gere o CSR manualmente, mantenha a chave privada em sigilo e faça backup imediatamente.

Gerar um arquivo CSR

Gerar um arquivo CSR com OpenSSL

1. Faça login no servidor e acesse o diretório onde deseja armazenar os arquivos de chave e CSR.

2. Instale o OpenSSL se ainda não estiver instalado. Para instruções de instalação, consulte o site do OpenSSL.

3. Execute o comando abaixo para gerar simultaneamente uma chave privada e um arquivo CSR:

   openssl req -new -nodes -sha256 -newkey rsa:2048 -keyout [$Key_File] -out [$OpenSSL_CSR]

   Nota

   Nota: Descrição dos parâmetros do comando:

   Parâmetro	Descrição
   -new	Gera um novo arquivo CSR
   -nodes	Crie um arquivo de chave privada sem criptografia
   -sha256	Usa SHA-256 como algoritmo de resumo
   -newkey rsa:2048	Gera uma nova chave privada RSA de 2.048 bits
   [$Key_File]	Nome do arquivo da chave privada
   [$OpenSSL_CSR]	Caminho onde salvar o arquivo CSR

   O sistema exibe a seguinte saída.

   

4. Quando solicitado, insira as informações necessárias:

   Campo	Descrição
   Organization Name	Nome da empresa (chinês ou inglês)
   Organizational Unit Name	Nome do departamento (chinês ou inglês)
   Country Code	Código ISO de país de duas letras da organização. Exemplo: CN para China.
   State or Province	Nome do estado ou província (chinês ou inglês)
   Locality	Nome da cidade (chinês ou inglês)
   Common Name	Domínio para o qual você solicita o certificado
   Email Address	Opcional
   A challenge password	Opcional

5. Obtenha o arquivo de chave privada e o arquivo CSR gerados no diretório atual.

Gerar um arquivo CSR com Keytool

1. Faça login no servidor e acesse o diretório onde deseja armazenar os arquivos de keystore e CSR.

2. Verifique a disponibilidade do Keytool. Essa ferramenta integra o Java Development Kit (JDK).

   Nota

   Nota: Geralmente, o Keytool vem instalado com o JDK. Execute keytool -help para confirmar.

3. Execute o comando abaixo para gerar um arquivo de keystore:

   keytool -genkey -alias [$Alias] -keyalg RSA -keysize 2048 -keystore [$Keytool_Path]

   Nota

   Nota: Descrição dos parâmetros do comando:

   Parâmetro	Descrição
   -keyalg	Tipo da chave. Obrigatório: RSA.
   -keysize	Comprimento da chave. Obrigatório: 2048.
   [$Alias]	Alias personalizado para o certificado. Use o mesmo alias em todos os comandos subsequentes do Keytool referentes a este certificado.
   [$Keytool_Path]	Caminho onde salvar o arquivo de keystore

4. Ao receber a solicitação, defina uma senha para proteger o keystore. Armazene-a com segurança, pois será necessária para acessar a chave privada e gerar o CSR posteriormente.

5. Quando solicitado, insira as informações necessárias:

   Campo	Descrição
   First and last name	Domínio para o qual você solicita o certificado
   Name of your organizational unit	Nome do departamento
   Name of your organization	Nome da empresa
   Name of your city or locality	Nome da cidade
   Name of your state or province	Nome do estado ou província
   Two-letter country code for this unit	Código ISO de país de duas letras da organização

6. Confirme os dados digitando Y.

7. Insira a senha da chave quando solicitado. Pressione Enter para reutilizar a senha do keystore.

8. Execute o comando abaixo para exportar um arquivo CSR do keystore:

   keytool -certreq -sigalg SHA256withRSA -alias [$Alias] -keystore [$Keytool_Path] -file [$Keytool_CSR]

   Nota

   Nota: Descrição dos parâmetros do comando:

   Parâmetro	Descrição
   -sigalg SHA256withRSA	Algoritmo de resumo para assinar o CSR
   [$Alias]	Deve corresponder ao alias usado na criação do keystore
   [$Keytool_Path]	Caminho para o arquivo de keystore
   [$Keytool_CSR]	Caminho onde salvar o arquivo CSR

9. Digite a senha do keystore quando solicitado para confirmar e concluir a geração do CSR.

Escopo de aplicação

• SSL Certificates Service