SUPEE-6788 Technical Details

October 27, 2015

Magento Enterprise Edition, Community Edition and the patch bundle SUPEE-6788 address several security issues. Unfortunately, addressing these issues required some changes that may possibly break backward compatibility with customizations or extensions. Below you will find a list of changes and potential issues that may arise:

APPSEC-1034, addressing bypassing custom admin URL

  • Note: This part of the patch is disabled by default. To protect non-default admin URLs against automated attacks, the patch must be enabled by changing the routing compatibility mode in configuration. Use "Enable Admin routing compatibility mode" under System > Configuration > Admin > Security.

  • If a module has admin functionality that is not under the admin URL, it will need to be modified (eg. instead of

  • Developers need to change etc/config.xml and all code lines where they generate links to the admin part of the module.

  • For example the following config.xml file for a module:

  • Should be changed to:

                    <custom_module after="Mage_Adminhtml">CustomModule_Adminhtml</custom_module>

APPSEC-1063, addressing possible SQL injection

  • Modules that use SQL statements as field names or escape fields manually will need to be modified. Examples of code that is no longer allowed:

$collection->addFieldToFilter(‘(field1 – field2)’, array(‘eq’ => 3))

$collection->addFieldToFilter(‘`field`’, array(‘eq’ => 3))
  • Developers will need to change the way they generate filters for collections.

  • The following code:

$collection->addFieldToFilter('`field`', array('eq'=>3)); 
  • Should be changed to:

$collection->addFieldToFilter('field', array('eq'=>3));
  • The following code:

$collection->addFieldToFilter('(field1-field2)', array('eq'=>3));
  • Should be changed to:

$expression = '(field1-field2)';
$condition = $this->_getConditionSql($expression, array('eq'=>3));
  • The following approach could be used alternatively:

Class T extends Mage_Core_Model_Resource_Db_Collection_Abstract {
protected $_map = array('fields' => array(
    'condition' => '(field1 – field2)',
public function someMethod() {
    $this->addFieldToFilter('condition', array('eq' => 3));

APPSEC-1057, template processing method allows access to private information:

  • Magento now includes a white list of allowed blocks or directives. If a module or extension uses variables like {{config path=”web/unsecure/base_url”}} and {{block type=rss/order_new}} in CMS pages or emails, and the directives are not on this list, you will need to add them with your database installation script. Extensions or custom code that handles content (like blog extensions) might be affected.

  • A full list of allowed variables and blocks in the default installation is:


















enterprise_catalogevent/event_lister (in Magento Enterprise Edition)
  • Note: you can configure allowed variables and blocks in System > Permissions > Blocks and System > Permissions > Variables.

  • If your code uses some config variables or blocks, you need to create a data update script that adds variables or blocks to the white list tables:


APPSEC-1079, addressing potential Exploit with Custom Option File Type

  • This change will affect any customization that uses product custom options to save information as a PHP object. Such approach will no longer be possible.

APPSEC-1039/APPSEC-1228, Cross site scripting with error messages/CSRF/Session fixation

  • This change affects templates by adding form_key to customer registration page customer/form/register.phtml and persistent/customer/form/register.phtml. If your store includes customized registration page template, make sure to add this key there as well. Please refer to the patch source code for exact changes.

<input type="hidden" name="form_key" value="<?php echo Mage::getSingleton('core/session')->getFormKey() ?>" />

APPSEC-1027, Insufficient Protection of Password Reset Process

  • This change affects templates by changing form submission and adding token validation in password forgotten page. Files affected are layout/customer.xml and template/customer/form/resetforgottenpassword.phtml. If your store includes customized password forgotten template or layout, make sure to implement those changes there as well. Please refer to the patch source code for exact changes.