Tratamos do código de erro 403 (Proibido) do HTTP em detalhes em outro momento, mas ele tem um irmão quase gêmeo.

Qual é, exatamente, a diferença entre os códigos de status 401 (Não autorizado) e 403 (Proibido)? Será que eles significam a mesma coisa? Vamos ver!

Padrões RFC

O padrão RFC mais atualizado definindo o status 401 (Não autorizado) é o RFC 7235

O código de status 401 (Não autorizado) indica que a solicitação não foi aplicada por falta de credenciais de autenticação válidas para o recurso de destino... O agente do usuário PODE repetir a solicitação com um campo de cabeçalho Authorization novo ou diferente.

O código de status 403 (Proibido), por sua vez, tem sua definição mais recente no RFC 7231

O status 403 (Proibido) indica que o servidor entendeu a solicitação, mas se recusa a autorizá-la... Se as credenciais de autenticação foram fornecidas na solicitação, o servidor as considera insuficientes para liberar o acesso.

Causas comuns

Conforme mencionamos no artigo anterior, o erro 403 pode ocorrer quando um usuário está conectado (logado) mas não tem privilégios suficientes para acessar o recurso solicitado. Por exemplo, um usuário genérico pode estar tentando carregar algo na rota do 'admin'.

A situação mais óbvia em que você poderá encontrar um erro 401, por outro lado, é quando você não está conectado ou quando forneceu uma senha incorreta.

Essas são as duas causas mais comuns para esses erros.

Causas menos comuns

Existem algumas instâncias, porém, onde as coisas não são tão claras.

Os erros 403 podem ocorrer devido a restrições não inteiramente dependentes das credenciais do usuário conectado.

Por exemplo, um servidor pode ter bloqueado recursos específicos para permitir acesso apenas a um intervalo definido de endereços IP, ou ainda pode utilizar o bloqueio por localização geográfica. Nesse caso, é possível contornar o bloqueio por meio de uma VPN.

Os erros 401 podem ocorrer mesmo se o usuário inserir as credenciais corretas. Isso é raro de acontecer e pode ser algo que você somente encontrará ao desenvolver seu próprio back-end autenticado. Porém, se o cabeçalho de autorização não tiver sido criado corretamente, retornará um status 401.

Para exemplificar, você pode ter um JWT (JSON Web Token) que você quer incluir no cabeçalho da solicitação, o qual espera o formato Authorization: Bearer eyJhbGci......yJV_adQssw5c. Se você esquecer a palavra 'Bearer' (em português, portador) antes do JWT, veria um erro 401 acontecer.

Já tive esse problema ao testar APIs em desenvolvimento com o Postman e esquecer a sintaxe correta para os cabeçalhos de autenticação!

Conclusão

Espero ter esclarecido algumas das confusões que podem ocorrer relativas a esses erros bastante semelhantes.

Se você achou este artigo útil ou se quiser contestar ou ampliar algumas das questões levantadas aqui, fique à vontade para entrar em contato com o autor do artigo pelo Twitter.

Erros acontecem – pode ter havido uma manutenção inesperada, um bug que passou despercebido ou uma página que todo mundo começa a acessar e o fluxo de conexões derruba o servidor.

Se você já esteve on-line por algum tempo, com certeza já viu a mensagem de erro bastante vaga dizendo: 503 Service Unavailable (503 Serviço indisponível).

Neste artigo, analisaremos códigos de status do HTTP, o que representa o erro 503 e algumas maneiras possíveis de resolvê-lo – para um site que você está tentando visitar ou para seu próprio site.

Uma visão geral dos códigos de status do HTTP

Os servidores que hospedam páginas da web escutam solicitações dos navegadores ou dos dispositivos, também conhecidos como clients. O servidor, então, usa alguns códigos de status diferentes para se comunicar.

Esses códigos de status são organizados em classes diferentes, indicadas pelo primeiro número do código de status:

• 1xx: Informações – o servidor ainda está processando a solicitação
• 2xx: Sucesso – a solicitação teve êxito e o servidor responde com a página ou com o recurso
• 3xx: Redirecionamento – a página ou o recurso foi movido e o servidor responderá com o novo local
• 4xx: Erro do client – há um erro na solicitação do navegador ou do dispositivo
• 5xx: Erro do servidor – há um erro com o servidor

Os últimos dois algarismos de cada código de status do HTTP representam um status mais específico para cada classe. Por exemplo, 301 significa que a página ou recurso foi movido permanentemente, enquanto 302 significa que a mudança é apenas temporária.

Confira esta página para ver uma lista de códigos de status comuns do HTTP e seu significado: https://pt.wikipedia.org/wiki/Lista_de_códigos_de_estado_HTTP

A maioria dos códigos de status passa totalmente despercebida, o que não é um problema, pois isso significa que tudo está funcionando bem. Somente quando recebemos uma mensagem de erro no intervalo 4xx-5xx é que percebemos um código de status, já que é nessa situação que você poderá ver uma página assim:

Agora que você tem um entendimento básico dos códigos de status do HTTP, vamos examinar o erro 503 Serviço indisponível em mais detalhes.

O que significa o código de erro 503?

Como mencionamos acima, os códigos de status 5xx significam que há um problema com o servidor.

Um erro 503 Serviço indisponível significa que a página ou recurso está indisponível. Pode haver muitas razões para um servidor retornar um erro 503. Algumas das razões mais comuns são uma manutenção, um erro ou bug no código do servidor ou ainda um aumento drástico no tráfego que faz com que o servidor seja derrubado.

A mensagem que é enviada com o erro 503 pode variar dependendo do servidor de onde ela está vindo, mas abaixo vemos algumas das mensagens mais comuns:

- 503 Serviço indisponível
- 503 Serviço temporariamente indisponível
- Erro de servidor HTTP 503
- Erro de HTTP 503
- Erro 503 Serviço indisponível
- O servidor está temporariamente incapacitado de atender à sua solicitação devido a um período de manutenção ou a problemas de capacidade. Tente novamente mais tarde.

Fonte

Seja qual for a razão para o erro 503, ele geralmente é temporário – o servidor reiniciará, o tráfego será reduzido e o problema se resolverá sozinho.

Como resolver o erro 503 Serviço indisponível

Ao tentar resolver um erro 503, existem duas situações gerais.

A primeira é quando você é o usuário final e está tentando visitar um site do qual você não é o dono. Na segunda, você é o dono do site que está lançando erros do tipo 503 para aqueles que estão tentando visitá-lo.

O método para resolver os erros do tipo 503 difere, dependendo de qual das situações é a sua. Vamos ver algumas das coisas que podemos fazer quando somos os usuários finais ao vermos um erro 503.

Como resolver um erro 503 Serviço indisponível como usuário final

Como os códigos de status 5xx representam que o erro é do lado do servidor, não há muito que você possa fazer diretamente.

Mesmo que os erros 503 sejam, em geral, temporários, há algumas coisas que você pode fazer enquanto aguarda.

Nº 1: Atualizar a página

Às vezes, o erro é tão temporário que uma simples atualização já basta para resolvê-lo. Com a página aberta, apenas pressione Ctrl - R no Windows e no Linux, ou Cmd - R no macOS para atualizar a página.

Nº 2: Veja se a página também está fora do ar para outras pessoas

A próxima coisa que você pode fazer é usar um serviço como o Is It Down Right Now? ou o Down For Everyone Or Just Me para ver se outras pessoas estão tendo o mesmo erro.

Você só precisa ir a um desses sites e inserir o URL para a página que você está tentando visitar.

O serviço fará o ping para o URL que você inseriu e vai ver se obtém uma resposta. Em seguida, ele mostrará a você algumas estatísticas e gráficos interessantes sobre a página:

Se rolar para baixo, você verá alguns comentários de outras pessoas. Em geral, as pessoas darão uma localização geral e outros dados. Assim, essa pode ser uma boa maneira de descobrir se o erro está afetando apenas determinadas regiões ou dispositivos específicos.

Nº 3: Reinicie seu roteador

Às vezes, o problema tem a ver com uma falha do servidor de DNS.

DNS é a sigla para Domain Name System (em português, sistema de nome de domínio).  Basicamente, ele atua como um tradutor entre os endereços IP e os URLs, que podem ser lidos mais facilmente.

Por exemplo, você pode visitar o Google inserindo seu endereço IP diretamente (172.217.25.206) ou simplesmente inserindo o URL www.google.com.

É o DNS, geralmente hospedado em um servidor, que trata disso internamente.

Isso tudo serve para dizer que muitos roteadores mantêm respostas dos servidores DNS em cache (www.google.com <==> 172.217.25.206). Algumas vezes, no entanto, esse cache pode ficar corrompido e causar erros.

Um modo fácil de redefinir ou de fazer o "flush" do cache (limpá-lo) é reiniciar seu roteador. Basta tirar seu roteador da tomada por cinco segundos e, depois, conectá-lo à rede elétrica novamente.

Ele deve reiniciar após um minuto e todos os seus dispositivos devem se reconectar automaticamente. Após eles se conectarem, tente visitar o site novamente.

Como resolver um erro 503 Serviço indisponível como proprietário do site

Se você é o proprietário/desenvolvedor do site que está retornando erros do tipo 503, há mais algumas coisas que você pode fazer para diagnosticar e resolver o problema.

Aqui temos algumas dicas gerais para se começar:

Nº 1: Reiniciar o servidor

Desenvolver é difícil – mesmo uma simples página estática pode ter várias partes interconectadas, podendo ser difícil detectar o que está causando o erro 503.

Às vezes, o melhor a se fazer é reiniciar o servidor e ver se isso resolve o problema.

O método exato para se reiniciar o sistema pode variar, mas, em geral, você pode acessá-lo a partir do painel do seu provedor ou usando o SSH para entrar no servidor e executando um comando de reinicialização.

O servidor deverá reiniciar após alguns minutos. Se você configurou tudo para executar automaticamente no momento do boot, pode visitar seu site e ver se tudo está funcionando.

Nº 2: Verificar os logs do servidor

A próxima coisa a se fazer é verificar os logs (em português, registros).

O local dos logs do servidor pode variar. Ele depende do tipo de serviço que você está executando, mas normalmente os encontramos em /var/log/....

Dê uma olhada nesse diretório e veja se pode encontrar algo. Se não puder, confira o manual dos seus programas executando man nome_do_programa.

Nº 3: Confira se há uma manutenção automática em andamento

Alguns provedores de serviços oferecem atualizações de pacotes e manutenção automatizadas. Normalmente, isso é bom – elas geralmente ocorrem durante um tempo de inatividade e ajudam a garantir que tudo está atualizado.

Por vezes, no entanto, erros 503 ocorrem devido a essas sessões de manutenção programada.

Por exemplo, alguns provedores de hospedagem que se especializam na hospedagem de WordPress atualizam o WordPress automaticamente sempre que há uma nova versão. O WordPress retorna automaticamente um erro 503 Serviço indisponível quando está sendo atualizado.

Verifique com seu provedor de serviços para ver se o erro 503 está sendo causado por uma manutenção programada.

Nº 4: Verifique as configurações do firewall do servidor

Às vezes, erros do tipo 503 Serviço indisponível são causados por um firewall mal configurado, onde as conexões podem até passar, mas não conseguem retornar ao client.

Seu firewall também pode precisar de configurações especiais para um CDN, onde várias conexões para uma pequena quantidade de endereços IP podem ser interpretadas incorretamente como um ataque do tipo DDoS.

O método exato de ajustar as configurações do seu firewall dependerão de diversos fatores. Examine seus processos e os painéis do provedor de serviços para ver onde você configura o firewall.

Nº 5: Confira o código

Bugs e erros podem acontecer. Por mais que você tente, é impossível pegar todos eles. Às vezes, um deles pode escapar e acabar causando um erro do tipo 503.

Se você já tentou de tudo e seu site ainda estiver mostrando um erro 503 Serviço indisponível, a causa pode estar em algum ponto do código.

Confira o código do lado do servidor. Preste especial atenção a tudo o que tenha a ver com expressões regulares – um pequeno bug de regex (texto em inglês) foi o que causou um grande aumento no uso de CPU, períodos fora do ar e cerca de três dias de pânico aqui no freeCodeCamp.

Por sorte, você poderá encontrar o culpado, fazer o conserto do problema e tudo voltará ao normal.

Em resumo

O que vimos aqui deve ser tudo o que você precisa saber sobre os erros 503 Serviço indisponível. Embora, normalmente, não haja muito o que você possa fazer ao ver um erro 503, talvez alguns desses passos possam ajudá-lo da próxima vez em que você encontrar algum.

Permaneça seguro e siga atualizando até fazer funcionar :)

Receber um código de erro enquanto estamos on-line pode ser uma experiência frustrante. Ao mesmo tempo em que estamos acostumados com páginas "404 Not Found" (Não Encontrado, em português), se tornou comum ver páginas de placeholder fofas para nos entreter sempre que nos perdemos. Um dos mais erros mais intrigantes é a resposta "403 Forbidden" (Proibido, em português).

O que isso significa?

Colocando de uma forma simples: o servidor determinou que você não está autorizado para acessar aquilo que você requisitou.

De acordo com o padrão RFC 7231 (texto em inglês):

O código de status 403 (Proibido) indica que o servidor entendeu a solicitação, mas se recusa a autorizá-la... Se as credenciais de autenticação foram fornecidas na solicitação, o servidor as considera insuficientes para conceder acesso.

A resposta 403 pertence ao intervalo 4xx de respostas HTTP: Erros do client. Isso significa que você ou seu navegador fez algo errado.

Se você se deparar com esse erro, geralmente significa que você já se autenticou com o servidor, ou seja, você efetuou login, mas o recurso que você solicitou espera alguém com privilégios mais altos.

Mais comumente, você pode estar logado como usuário padrão, mas está tentando acessar uma página de administração.

Como você corrige isso?

Como um usuário sem acesso ao servidor você terá apenas algumas poucas opções:

Se autentique com uma conta mais apropriada

Novamente, de acordo com o padrão RFC 7231 (texto em inglês):

Se as credenciais de autenticação foram fornecidas na solicitação, o servidor as considera insuficientes para conceder acesso. O cliente NÃO DEVE repetir automaticamente a solicitação com as mesmas credenciais. O cliente PODE repetir o pedido com credenciais novas ou diferentes.

Este é o único meio que lhe dá condições reais para corrigir o problema.

Se você tem várias contas em um site e está tentando fazer algo que normalmente pode fazer, mas desta vez está proibido de fazer, esta é a opção que você deve tentar. Faça login com sua outra conta.

Você pode descobrir que essa opção também requer a limpeza do cache ou dos cookies, caso o login de outro usuário não libere suficientemente os tokens de autenticação anteriores. Mas isso geralmente é desnecessário.

Como uma jogada desesperada, você também pode tentar desabilitar as extensões do navegador que possam estar interferindo no uso do site. No entanto, isso é improvável, pois um 403 indica que você está autenticado, mas não autorizado.

Notifique o dono do site que o erro 403 está sendo retornado quando você esperaria o contrário

Se você espera poder acessar o recurso em questão, mas ainda está vendo esse erro, é aconselhável informar a equipe responsável pelo site - isso pode ser um erro da parte deles.

Novamente, o padrão RFC 7231  (texto em inglês) diz:

No entanto, uma solicitação pode ser proibida por motivos não relacionados às credenciais.

Uma causa comum para isso acontecer de forma não intencional é o fato de um servidor usar listas de permissão ou negação para endereços IP específicos ou regiões geográficas.

Eles podem ter um bom motivo para bloquear seu acesso fora de seus parâmetros estritamente definidos, mas também pode ser apenas um descuido.

Desistir

Talvez você simplesmente não deveria mesmo ser capaz de acessar esse recurso. Acontece. A internet é grande e é razoável esperar que existam algumas áreas que estão além dos limites do que você pode acessar.

Você pode visitar http.cat enquanto pensa sobre a razão para que sua solicitação original tenha sido proibida.

Como leitor do freeCodeCamp News, você quase certamente não está proibido de seguir @JacksonBates no Twitter para mais conteúdo relacionado à tecnologia e à programação.