# 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.

> 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.

João Rizzon · 2026-10-19 · Painéis

---

## 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)](https://docs.cpanel.net/whm/service-configuration/cpanel-web-disk-configuration/), 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:

- Ativar o suporte a Digest Authentication no servidor.
- **Depois disso**, redefinir a senha de cada conta de Web Disk que vai ser usada no Windows.
- 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:

- **Acesso de root ao WHM.** A opção de Digest fica em configuração de serviço, não dentro do cPanel do cliente. Se você administra apenas uma conta de revenda ou uma conta individual, quem liga isso é o provedor, e o pedido correto é "habilitar Digest Authentication para Web Disk no servidor", não "liberar porta".
- **A conta de Web Disk existe e está com o diretório certo.** Em geral vale apontar para a pasta do site, não para a home inteira, e evitar dar acesso de leitura e escrita a quem só precisa publicar imagens.
- **O endereço usado no mapeamento.** Anote qual host o cliente vai digitar e se o acesso será com ou sem SSL. Isso muda a porta e muda o comportamento do cliente Windows.
- **Uma máquina Windows real para testar.** Não é detalhe. Veja a seção de testes.

| 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](https://docs.cpanel.net/whm/service-configuration/cpanel-web-disk-configuration/). É 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:

- Trate como mudança de serviço, com janela e registro. Não é um toggle de tema. Anote data, quem ligou e em qual servidor, porque daqui a seis meses outro servidor vai apresentar o mesmo sintoma e você vai querer o histórico.
- Se você administra vários servidores, padronize: ou todos com Digest habilitado, ou nenhum. Metade ligada é o cenário em que o mesmo procedimento funciona para um cliente e falha para outro sem explicação aparente.

## 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).

## 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.

## 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:

- **Na entrada de um servidor novo:** verificar, no WHM, se o suporte a Digest Authentication do Web Disk está habilitado. Registrar o estado no inventário.
- **Ao criar qualquer conta de Web Disk:** criar depois de o Digest estar ligado. Conta nascida em servidor já configurado não precisa de redefinição.
- **Ao migrar um cliente:** redefinir a senha das contas de Web Disk no destino, por padrão. É mais barato que diagnosticar depois.
- **No roteiro de entrega:** teste em Windows real antes de enviar o passo a passo ao cliente. Anexe o print da unidade montada.
- **Quando o cliente não usa o recurso:** desative a conta de Web Disk. Acesso que ninguém usa é só superfície exposta e senha para vazar.

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:

> **** "A senha está certa. O Windows exige um tipo de autenticação específico para abrir a pasta do site como unidade de rede, e esse recurso foi ativado agora no servidor. Como ele só passa a valer para senhas definidas depois da ativação, precisei redefinir a sua senha de acesso aos arquivos. Use esta nova senha, e, se o computador tentar entrar sozinho com a antiga e der erro, remova a credencial salva do Windows e conecte de novo."

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.

