blog
Painéis

Senha recusada ao mapear o site no Windows: é o Digest

A opção fica no WHM, mas ligá-la é só o primeiro passo. A ordem correta (ativar, redefinir senha, testar em Windows real) é o que separa o chamado resolvido do chamado que volta.

JR · · 9 min de leitura · 2 tabelas · 1 bloco de código

Resposta curta: o Windows recusa porque o cliente WebDAV dele exige autenticação Digest e nem chega a enviar a credencial. Habilite o suporte em WHM, Service Configuration » cPanel Web Disk Configuration. Ativar não converte senhas antigas: redefina a senha de cada conta de Web Disk depois.

Neste artigo
  1. O Windows recusa o formato de autenticação, não a senha
  2. Sem redefinir a senha depois de ativar, o hash de Digest nunca existe
  3. O que conferir antes de abrir o WHM
  4. Service Configuration, cPanel Web Disk Configuration
  5. A ordem importa: ativar, redefinir, só então testar
  6. Por que um teste no Mac não prova nada sobre o Explorer
  7. Seis sintomas, seis causas e como confirmar cada uma
  8. Como transformar isso em rotina de onboarding de servidor
  9. O que ficou de fora e por quê

O Windows recusa o formato de autenticação, não a senha

O cliente mandou a senha certa, você conferiu no gerenciador de contas, a senha entra no webmail e entra no FTP. Mas o assistente de "Mapear unidade de rede" do Windows devolve que o nome de usuário ou a senha estão incorretos. Nada está incorreto: o que falta é um formato de autenticação.

O Web Disk do cPanel expõe os arquivos da conta via WebDAV. O cliente WebDAV embutido no Windows (o serviço WebClient, que é o que o Explorer usa quando você mapeia um endereço http:// ou https://) é mais exigente que um cliente de FTP: em determinadas situações ele só aceita autenticação Digest, e simplesmente não envia a credencial em texto quando o canal não atende ao que ele espera. O servidor nunca chega a comparar sua senha. Para o Windows, isso aparece como senha errada.

A documentação oficial do cPanel trata esse caso em cPanel Web Disk Configuration (WHM), com uma opção específica para habilitar o suporte a Digest Authentication no servidor. E, mais importante, com a ressalva que quase nenhum tutorial repete: ativar a opção não converte as senhas que já existem.

Sem redefinir a senha depois de ativar, o hash de Digest nunca existe

Autenticação Digest não compara senha em texto. Ela depende de um hash próprio, calculado a partir de usuário, realm e senha, guardado no servidor no momento em que a senha é definida. Se a conta de Web Disk foi criada antes de o suporte a Digest estar ligado, esse hash nunca foi gerado. O servidor passa a oferecer Digest, o Windows aceita o desafio, e a conta falha porque não há com o que comparar.

Daí a sequência que vira regra de bolso na agência:

  1. Ativar o suporte a Digest Authentication no servidor.
  2. Depois disso, redefinir a senha de cada conta de Web Disk que vai ser usada no Windows.
  3. Só então testar.

Redefinir antes de ativar é trabalho jogado fora: a senha nova nasce sem o hash de Digest exatamente como a antiga. Esse é o erro mais comum e o mais frustrante, porque o técnico jura que fez tudo e o sintoma não muda.

O que conferir antes de abrir o WHM

Antes de mexer em configuração de serviço, confirme o terreno. Checklist curto:

Item Onde se resolve Quem faz
Suporte a Digest Authentication WHM, Service Configuration, cPanel Web Disk Configuration root do servidor ou provedor
Senha da conta de Web Disk cPanel da conta, Web Disk agência ou cliente
Credencial em cache Windows, Gerenciador de Credenciais quem está na máquina
Porta bloqueada na rede do cliente firewall local ou rede corporativa TI do cliente

Service Configuration, cPanel Web Disk Configuration

No WHM, a tela é Service Configuration » cPanel Web Disk Configuration, documentada em docs.cpanel.net. É nela que fica o controle de suporte a Digest Authentication e as demais opções do serviço de Web Disk.

Duas observações de operação:

A ordem importa: ativar, redefinir, só então testar

Ative o suporte a Digest Authentication no servidor

Entre no WHM como root, vá em Service Configuration » cPanel Web Disk Configuration, habilite o suporte a Digest Authentication e salve. Confirme na própria tela que a opção ficou marcada depois do save.

Depois de ativar, redefina a senha de cada conta de Web Disk

No cPanel da conta, em Web Disk, edite cada conta de acesso e defina a senha novamente. Pode ser a mesma senha de antes, do ponto de vista do usuário nada muda; o que importa é que ela passe por uma nova gravação agora que o servidor suporta Digest.

Se o cliente tem três pessoas com acesso, são três redefinições. Não existe atalho de "converter tudo": a senha em texto não é conhecida pelo servidor, então não há como recalcular o hash sem alguém digitar de novo.

Antes de testar, apague o mapeamento e a credencial em cache

O Windows guarda a credencial que falhou e a reenvia sozinho, o que faz um teste limpo parecer falha persistente. No prompt da máquina de teste:

net use
net use X: /delete /y
cmdkey /list

net use lista o que está mapeado. net use X: /delete /y desfaz só a unidade indicada, com o /y respondendo à confirmação interativa; troque X: pela letra que apareceu na listagem. Evite net use * /delete: ele remove todos os mapeamentos da máquina, inclusive unidades corporativas que nada têm a ver com o Web Disk, e no computador do cliente isso vira um segundo chamado. Se quiser usar a forma com *, use na sua VM de teste. cmdkey /list mostra as credenciais guardadas; se houver uma entrada apontando para o host do site, remova-a pelo Gerenciador de Credenciais do Painel de Controle antes de tentar de novo.

Mapeie a unidade e valide com um arquivo de teste

No Explorer, "Mapear unidade de rede", marque "Conectar usando credenciais diferentes", informe o endereço do Web Disk e a senha recém-definida. O resultado esperado é a unidade montar e listar o conteúdo da pasta configurada. Crie um arquivo de teste e apague: montar sem conseguir escrever é um problema diferente (permissão da conta de Web Disk, não autenticação).

Ordem correta para o Web Disk no WindowsAtivar Digest no WHMService Configuration, Web DiskRedefinir senha de cada contaNo cPanel, uma por umaLimpar mapeamento e credencialnet use e cmdkey /listMapear e gravar arquivoTeste em Windows real
Inverter a ordem anula o efeito: senha definida antes da ativação nasce sem hash de Digest.

Por que um teste no Mac não prova nada sobre o Explorer

O Finder do macOS fala WebDAV por um caminho próprio e aceita combinações que o WebClient do Windows recusa. Conectar pelo Mac prova que o serviço está no ar e que a senha está correta, nada além disso. Se você avisar o cliente com base em um teste no Mac e o cliente usa Windows, o chamado volta no mesmo dia e agora com desgaste.

Monte um ambiente de validação que você reutiliza: uma máquina virtual Windows, atualizada, com o serviço WebClient ativo e sem credenciais antigas. Testar nela leva poucos minutos e é a diferença entre "resolvido" e "tente de novo".

Detalhe do próprio Windows: o serviço WebClient precisa estar em execução para que o mapeamento WebDAV funcione. Em algumas instalações de Windows Server ele nem está instalado. Confira com sc query webclient antes de culpar o servidor de hospedagem.

Seis sintomas, seis causas e como confirmar cada uma

Sintoma Causa provável Como confirmar
Senha recusada em todas as contas, no Windows, e funciona no Mac Digest não habilitado no servidor Checar a opção no WHM
Habilitou o Digest e continua recusando Senha não foi redefinida depois de ativar Redefinir a senha e tentar outra vez
Uma conta funciona, outra não Só a conta que funciona teve a senha redefinida Redefinir a senha da conta que falha
Funciona em uma máquina e não em outra Credencial em cache na máquina que falha cmdkey /list e Gerenciador de Credenciais
Nem chega a pedir senha, trava na conexão Rede ou firewall bloqueando a porta do serviço Testar de outra rede, por exemplo 4G do celular
Monta, mas não deixa salvar arquivo Permissão da conta de Web Disk Revisar leitura e escrita no cPanel

A linha que mais economiza tempo é a de "Nem chega a pedir senha, trava na conexão": bloqueio de porta não se parece com senha recusada. Se o Windows exibiu a caixa de usuário e senha e reclamou da credencial, a conexão TCP aconteceu. Ficar pedindo liberação de firewall nesse cenário é perseguir o problema errado. Já o travamento sem prompt, ou um erro de "não foi possível encontrar o caminho de rede", é candidato legítimo a rede corporativa filtrando a porta: nesse caso, teste a mesma máquina em outra conexão antes de abrir chamado.

Triagem rápida do erro de Web DiskPediu usuário e senha?Se não pediu, suspeite da redeTravou sem promptTestar em outra conexão, 4GRecusou a credencialDigest ligado no servidor?Falha só em uma contaSenha não redefinida após ativarFalha só em uma máquinaCredencial em cache no WindowsMonta mas não salvaPermissão da conta, não autenticação
Bloqueio de porta não se parece com senha recusada: se o prompt apareceu, a conexão TCP aconteceu.

Como transformar isso em rotina de onboarding de servidor

Transforme o procedimento em um item de onboarding de servidor, não em um conserto pontual:

E vale dizer o óbvio contra o próprio interesse: se o uso real é publicar um punhado de arquivos por mês, SFTP com um cliente decente resolve com menos atrito que WebDAV mapeado como unidade. Web Disk é ótimo quando a pessoa precisa abrir, editar e salvar direto do Office ou do Explorer. Fora disso, você está adicionando uma peça só para manter.

A explicação que você pode copiar e enviar ao cliente

Quando precisar explicar sem jargão, algo nesta linha funciona:

Duas frases a mais, zero reclamação depois. O cliente entende que não foi erro dele e entende por que a senha mudou.

O que ficou de fora e por quê

A parte documentada aqui vem da documentação oficial do cPanel sobre a configuração do Web Disk. Não há medição própria neste texto: nada de latência, taxa de sucesso ou comparação de desempenho entre WebDAV e SFTP. O que está descrito é procedimento e ordem de execução.

Também não cobrimos comportamento de clientes WebDAV de terceiros (Cyberduck, WinSCP em modo WebDAV, clientes móveis). Eles podem funcionar sem Digest e, por isso mesmo, não servem para validar o caso do Explorer do Windows. Se o cliente for abrir a pasta pelo Explorer, teste pelo Explorer.

Referências

  1. Documentação oficial (cpanel) — cPanel Web Disk Configuration (WHM). Consultado em 2026-10-14.
Leia também