Troubleshooting
Erro ao instalar certificado SSL customizado
Erro ao instalar certificado SSL customizado
Publicado em 28/02/2025
•
Última atualização em 07/03/2025
Alguns erros podem ocorrer durante a instalação de certificados SSL customizados, funcionalidade disponível no VTEX Shield. Confira a seguir os erros possíveis e como solucioná-los.
Solução
Para identificar o significado e verificar a ação corretiva específica para cada mensagem de erro, consulte a tabela abaixo:
| Tipo de erro | Significado | Ação requerida |
|---|---|---|
| Esse host não está incluído no certificado | Você selecionou pelo menos um host que não corresponde aos hosts apresentados nos AltNames do certificado. |
|
| Formato inválido | O certificado enviado tem formato inválido. | Revisar o arquivo do certificado e garantir que seja um arquivo .CRT. |
| Esses hosts não existem mais | Pelo menos um dos hosts enviados foi excluído da conta antes do certificado ser instalado. Isso pode acontecer, por exemplo, quando outro usuário do Admin apagar o host durante a configuração. Os hosts descritos aparecem destacados em vermelho. | Ao atualizar a página e preencher novamente o formulário, os hosts excluídos não estarão mais entre as opções possíveis. É possível reconfigurar os hosts excluídos antes de instalar o certificado ou não selecionar os hosts excluídos. |
| Os hosts não estão completamente configurados. Verifique a documentação para completar os passos de configuração restantes. | Pelo menos um dos hosts enviados foi configurado de forma incompleta no passado, possivelmente sem a etapa de apontamento de DNS para a VTEX. | Seguir os passos descritos no guia Configurar o domínio da loja e garantir que o DNS do domínio aponta para a VTEX, conforme indicado em Realizar apontamento de DNS. |
| Tamanho inválido | O arquivo do certificado é maior do que 1MB. | Revisar o arquivo do certificado e garantir que tenha até 1MB. |
| Certificado inválido | O conteúdo em XML do certificado é inválido. | Revisar o arquivo do certificado e garantir que o conteúdo em XML está correto. |
| Acesso não autorizado. Entre em contato com o administrador da sua loja. | O usuário não tem permissão para instalar um certificado customizado. | Entrar em contato com o administrador da sua loja para revisar a configuração de perfis de acesso. É necessário ser um usuário associado a um perfil de acesso com os recursos do License Manager listados a seguir, para visualizar e gerenciar as informações da página:
|
| Ocorreu um erro ao instalar o certificado | Erro genérico para causas não determinadas. | Atualizar a página e, se o problema persistir, entrar em contato com o Suporte. |