Tired of Drupal admin access denied error? Here’s how to fix it
For as long as Drupal has existed, users have seen this error one time or the other:
You are not authorized to access this page.
It might have appeared after a site migration, a server update or for no reason at all.
Drupal admins won’t be able to login to the admin panel, and no amount of cache clearing, or browser restarts would solve the issue.
Today we’ll take a look at the top 5 causes we’ve seen for Drupal’s “Access denied” error when accessing the admin area.
What is Drupal Admin access denied error?
A Drupal site admin can access all pages, and change any setting.
This is like having a super power over the site.
And how does Drupal make sure hackers won’t get that power?
By using something called “sessions”.
When an admin user logs in, that login is stored in a “session” file in the user’s browser as well as the website’s database.
As long as the session in these two locations remain accessible, the admin will have access to the site.
If the session details are lost or inaccessible in any of these two locations, Drupal will suspect a foul play and deny access to the pages.
So, how do session files become inaccessible? Read on.
Causes of Access denied error, and its solutions
Drupal depends on PHP, Databases, server file system, browser cache, and more to keep track of session files.
Even if one of them fails, the session tracking breaks, and Drupal will show the Access denied error to be on the safe side.
Here are the top 5 causes we’ve seen for this error:
1. Corrupted sessions table in the Drupal database
Drupal stores the session details in its database, within a table called “sessions”.
In busy websites, this table will have hundreds of even thousands of writes & reads, which can eventually cause the table to be corrupted.
Once it is corrupted, Drupal can no longer access it.
This will cause all open sessions to fail, including that of the admin.
Evidence of this issue can be seen in the log files. The error will state something like :
Can't open file: 'sessions.MYI'
Solution : To fix this we repair the corrupted table with the command :
mysql> repair table sessions;
2. Incorrect $cookie_domain setting in settings.php
Drupal uses small text files called “cookies” to store session information in the browsers.
This session information contains the website name as well, which is set using $cookie_domain in settings.php.
We’ve seen $cookie_domain set wrongly after a template export, website migration, or hosting update (say subdomain to standalone).
When the domain name used in the access URL is different from the domain name set in $cookie_url, Drupal shows Access denied error.
3. PHP configuration errors
Website migrations can mess up Drupal dependencies.
For eg. Drupal requires a setting called “magic_quotes_gpc” in PHP to set to OFF.
But different servers configure this setting in different places. Some allow it to be specified in .htaccess, and others in a custom php.ini file. Some servers will need a mod_php based configuration, others might need suPHP based configuration.
We’ve seen customers trying to import their old PHP settings to a new server without customizing for the new environment.
Solution : There’s no single solution to this. When faced with such an issue, we inspect the log files, find out which PHP setting is blocking access, and rewrite the old setting to match the new environment.
4. PHP – Drupal version conflicts
Drupal is a pretty stable website platform, which meets almost all needs of an average business owner.
A downside of this stability is that people never upgrade to new versions.
The latest version of Drupal is v8, but we’ve seen sites still running Drupal 6 or even Drupal 5.
But web hosts will keep upgrading their PHP every few months or every year. We’ve seen these newer versions of PHP conflicting with older Drupal causing functions to fail.
Solution : When we see a Drupal site showing this error immediately after a server update, or after a migration, we look at the logs for deprecated function errors. If we detect version conflicts, we either help the user upgrade their Drupal or setup multi-PHP handlers so that the user can continue using the old PHP version.
5. Theme or module installation issues
Drupal puts theme and module files in a Cache to speed up the site.
We’ve seen sites break after a new theme or module installation. This is caused by stale cache messing up the site access.
One way to fix this is to clear the tables cache, cache_bootstrap, cache_block and sessions.
If that did not fix the issue, we then disable all modules and themes via the database, and enable only the default theme.
Then we enable each module one by one and bring the site back to the pre-update state.
There’s more – File permissions, incorrect security settings, etc..
Drupal admin access denied errors can happen due to a lot of other reasons as well.
It includes incorrect file and directory permissions, incorrect PHP security settings, web server misconfiguration and more.
So, if you are still facing the Access denied error, click here to talk to our Drupal experts. We are online 24/7 and come to your help in a few minutes.
Drupal admin access denied error is caused by database errors, incorrect Drupal settings, PHP config errors, and more. Today we’ve covered the top 5 causes for this error, and how to fix them.