> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adicionar um certificado SSL/TLS

> Guarda no painel um certificado que não é do Let's Encrypt, por um de três caminhos: gerar o pedido para uma autoridade certificadora (CSR), gerar um certificado autoassinado, ou…

**Caminho no painel:** menu da esquerda > **SEGURANÇA** > **Certificados SSL/TLS** >
**Adicionar certificado SSL/TLS**

![Formulário Adicionar certificado com Gerar certificado autoassinado escolhido: nome, proprietário, tamanho da chave, país, estado, cidade, empresa, domínio, nomes alternativos, e-mail e período de validação](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/certificados-adicionar.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=81d281dc2b5b03a02ae2af6d33b760bc)

1. Em **Nome do certificado**, escreva um nome para achar o certificado no painel.
2. Em **Escolher ação**, marque uma das três opções, explicadas abaixo.
3. Preencha os campos que aparecem.
4. Clique em **Salvar**.

O painel responde *"O certificado SSL/TLS foi adicionado com sucesso. Agora você
pode atribuí-lo ao(s) domínio(s) correspondente(s)."* O certificado entra na lista
de [Certificados SSL/TLS](/keyhelp-admin/certificados-ssl-tls), e passa a aparecer na aba
**Segurança** dos domínios, em [Editar um domínio](/keyhelp-admin/editar-dominio).

> [!WARNING]
>
> **O Proprietário escolhido aqui é ignorado**
>
> Medido quatro vezes, com a conta escolhida no campo e enviada pelo formulário: o
> certificado nasceu sempre como **Sistema (root)**, mesmo com o domínio da própria
> conta. Para dar o certificado a um cliente, edite-o depois e troque o
> **Proprietário** lá: pela edição, a troca vale.

| Ação | Para quê |
| - | - |
| **Gerar CSR** | comprar um certificado: o painel cria a chave e o pedido, e você leva o pedido à autoridade certificadora |
| **Gerar certificado autoassinado (self-signed)** | testar: o próprio painel assina, e o navegador avisa que a conexão não é segura |
| **Enviar um certificado existente** | usar um certificado que você já tem, com a chave dele |

## Os dados do pedido, nas duas primeiras ações

| Campo | O que é |
| - | - |
| **Tamanho da chave** | **2048 Bit** ou **4096 Bit** |
| **País** | vem em **Afeganistão**, o primeiro da lista: escolha **Brasil** |
| **Estado / Província / Região**, **Localidade / Cidade** e **Organização / Empresa** | obrigatórios, gravados no certificado |
| **Nome do departamento na organização** | opcional |
| **Domínio** | o nome exato a proteger. Aceita curinga, como `*.seudominio.com.br` |
| **Nomes de domínio alternativos** | outros nomes, um por linha |
| **E-mail do responsável** | obrigatório |

> [!WARNING]
>
> **Sem acento nos campos**
>
> A tela pede para evitar caracteres especiais, e o motivo foi medido: com *"São
> Paulo"*, o certificado gravou *"SÃ£o Paulo"*, e a tela de editar mostra assim. O
> acento é gravado estragado dentro do certificado.

## Gerar CSR

O CSR é o pedido de certificado: leva o domínio e os dados da empresa, e é o que a
autoridade certificadora assina.

O painel mostra o pedido na própria mensagem de sucesso, de `-----BEGIN
CERTIFICATE REQUEST-----` a `-----END CERTIFICATE REQUEST-----`. Na lista, o item
fica sem validade e sem emissor até receber o certificado. **A chave privada é
criada e guardada pelo painel**, junto com o pedido.

**Para completar, depois que a autoridade devolver o certificado:**

1. Na linha do item, clique no lápis.
2. Em **Atualizar componentes de certificado**, cole ou envie o **Certificado** e, se a autoridade mandou, o **Certificado CA**.
3. Clique em **Salvar**.

Medido com um pedido do painel assinado por uma autoridade de teste: o item passou
a mostrar o emissor, a validade e os componentes **Chave privada**, **Certificate
signing request (CSR)**, **Certificado** e **Certificado CA**. O pedido volta a ser
lido a qualquer hora, clicando no nome dele em **Componentes do certificado**.

## Gerar certificado autoassinado

O **Período de validação** vem com **100** e **Dias**, e a unidade pode ser **Dias**,
**Semanas** ou **Anos**. Medido: 100 dias deram 100 dias, e 2 anos deram 730 dias.

| Validade digitada | O que o painel fez, medido |
| - | - |
| `0`, número negativo ou texto | criou o certificado com **1 dia**, sem aviso |
| `100` anos | aceitou: o certificado vai até 2126 |

> [!WARNING]
>
> **O autoassinado não protege o Domínio para os navegadores atuais**
>
> Navegadores atuais conferem o nome pela lista de nomes alternativos do
> certificado (SAN). Medido no certificado gerado: **sem nomes alternativos, a lista
> não existe**; com eles, a lista traz **só os alternativos**, sem o **Domínio**. A
> lista do painel mostra os dois nomes, e o certificado não. Além do aviso de
> autoassinado, o navegador acusa nome errado no domínio principal.

## Enviar um certificado existente

![Parte do formulário para enviar um certificado: os campos Chave privada, Certificado e Certificado CA, cada um com Escolher arquivo](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/certificados-enviar.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=6f41b0340dc7a6bb586584f08f5298bd)

Cada componente pode ser colado no campo de texto ou enviado como arquivo, em
**Escolher arquivo**. Os dois jeitos foram medidos.

| Campo | Obrigatório | O que é |
| - | - | - |
| **Chave privada** | sim | a chave que gerou o pedido do certificado |
| **Certificado** | sim | o certificado emitido para o domínio |
| **Certificado CA** | não | a cadeia da autoridade certificadora. Com ela, o **Emissor** mostra a organização e o nome da autoridade |

O painel recusa, com estas mensagens:

| Situação | Mensagem |
| - | - |
| chave e certificado que não formam par | *"Combinação inválida da chave particular Certificado."* |
| sem a chave ou sem o certificado | *"Envie todos os componentes necessários do certificado."* |
| texto que não é chave ou certificado | *"Componente Chave privada SSL/TLS inválido."* e *"Componente Certificado SSL/TLS inválido."* |

**O painel não confere a validade:** um certificado já vencido entrou sem aviso,
marcado **Expirado** na lista. E o mesmo certificado entrou duas vezes, com nomes
diferentes.

## O que o formulário recusa

| Situação | Mensagem |
| - | - |
| **Nome do certificado** vazio | *"Entrada inválida no campo Nome do certificado."* |
| nome que já existe | *"Um certificado com o nome ... já existe."* |
| **Domínio** com espaço, com `https://` ou sem ponto | *"Entrada inválida no campo Domínio."* |
| nome alternativo inválido | *"Entrada inválida no campo Nomes de domínio alternativos."* |
| e-mail inválido | *"Entrada inválida no campo E-mail do responsável."* |
| **Estado / Província / Região** vazio | *"Entrada inválida no campo Estado / Província / Região."* |

O navegador pede os campos obrigatórios antes; as mensagens acima são as do
painel quando o pedido chega sem eles.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O certificado é do Sistema, e eu escolhi um cliente** | o **Proprietário** do adicionar é ignorado | editar o certificado e trocar o **Proprietário** |
| **O navegador acusa nome errado no autoassinado** | o certificado não traz o **Domínio** na lista de nomes alternativos | para uso real, comprar um certificado pelo CSR ou usar o Let's Encrypt |
| O CSR não aparece na aba **Segurança** do domínio | o item ainda não tem certificado | enviar o certificado emitido pela edição |
| *"Combinação inválida da chave particular Certificado."* | a chave não é a do pedido que gerou o certificado | enviar a chave certa |
| O certificado mostra letras estranhas no lugar do acento | o formulário grava acento estragado | refazer sem acento |
| O certificado autoassinado saiu com 1 dia | a validade estava em `0`, negativa ou com texto | refazer com um número |

## Ver também

* [Certificados SSL/TLS](/keyhelp-admin/certificados-ssl-tls), a lista, os serviços do servidor, a edição e a exclusão
* [Editar um domínio](/keyhelp-admin/editar-dominio), onde o domínio passa a usar o certificado


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.