Enable and disable an administrative tool
How to disable Sitecore administrative tools on production instances.
Applies to | Content Management and Content Delivery. |
Sitecore Installation Framework | Most administrative tools are not disabled by default. In Sitecore 9.0.2 and later, |
Azure Toolkit | Most administrative tools are not disabled by default. In Sitecore 9.0.2 and later, |
You can use the Sitecore administrative tools to troubleshoot issues in a production environment, but for security reasons you must:
Always disable them as part of the deployment process.
Always disable them when you are not using them.
Never enable them on the Content Delivery, xDB Reporting, and xDB Processing roles. You can safely delete the administrative tools folder on these roles.
Only enable them on Content Management roles that are not exposed to the internet.
The administrative tools are ASPX files with .aspx
extensions. You find them in the <webroot>\sitecore\admin\
folder and its subfolders.
Disable an administrative tool
To disable an administrative tool:
In the administrative tools folder, click the tool you want to disable.
Add
.disabled
to the tools filename. For example, renamecache.aspx
tocache.aspx.disabled
.
Enable an administrative tool that is disabled by default
To enable the SqlShell.aspx
tool:
Go to the administrative tools folder.
Create an empty file named
enabled
. TheSqlShell.aspx
tool checks for the presence of this file.
To enable the unlock_admin.aspx
tool:
Go to the administrative tools folder.
Open the
unlock_admin.aspx
file.Locate the
enableUnlockButton
property.Change the value from
false
totrue
.private bool enableUnlockButton = true;
Save the
unlock_admin.aspx
file.