CakePHP - 安全性

更新于 2025/12/7 13:13:00

安全性是构建 Web 应用程序时的另一个重要功能。它向网站用户保证他们的数据是安全的。CakePHP 提供了一些工具来保护您的应用程序。

加密和解密

CakePHP 中的安全库提供了一些方法，我们可以通过这些方法加密和解密数据。以下是两种方法，它们用于相同的目的。

static Cake\Utility\Security::encrypt($text, $key, $hmacSalt = null)
static Cake\Utility\Security::decrypt($cipher, $key, $hmacSalt = null)

encrypt 方法将以文本和密钥作为参数来加密数据，返回值将是带有 HMAC 校验和的加密值。

要对数据进行哈希处理，请使用 hash() 方法。以下是 hash() 方法的语法。

static Cake\Utility\Security::hash($string, $type = NULL, $salt = false)

CSRF

CSRF 代表 跨站点请求伪造。通过启用 CSRF 组件，您可以获得针对攻击的保护。CSRF 是 Web 应用程序中常见的漏洞。

它允许攻击者捕获和重放以前的请求，有时还会使用图像标签或其他域上的资源提交数据请求。只需将 CsrfComponent 添加到您的组件数组即可启用 CSRF，如下所示 −

public function initialize(): void {
   parent::initialize();
   $this->loadComponent('Csrf');
}

CsrfComponent 与 FormHelper 无缝集成。每次使用 FormHelper 创建表单时，它都会插入一个包含 CSRF 令牌的隐藏字段。

虽然不建议这样做，但您可能希望在某些请求上禁用 CsrfComponent。您可以在 beforeFilter() 方法期间使用控制器的事件调度程序来执行此操作。

public function beforeFilter(Event $event) {
   $this->eventManager()->off($this->Csrf);
}

安全组件

安全组件为您的应用程序提供更严格的安全性。它为各种任务提供方法，例如 −

限制您的应用程序接受的 HTTP 方法 − 您应该始终在执行副作用之前验证所使用的 HTTP 方法。您应该检查 HTTP 方法或使用 Cake\Network\Request::allowMethod() 来确保使用了正确的 HTTP 方法。
表单篡改保护 − 默认情况下，SecurityComponent 会阻止用户以特定方式篡改表单。 SecurityComponent 将阻止以下事情 −
- 无法将未知字段添加到表单。
- 无法从表单中删除字段。
- 无法修改隐藏输入中的值。
要求使用 SSL − 所有操作都需要 SSL 保护
限制跨控制器通信 − 我们可以限制哪些控制器可以向此控制器发送请求。我们还可以限制哪些操作可以向此控制器的操作发送请求。

示例

在 config/routes.php 文件中进行更改，如以下程序所示。

config/routes.php

<?php
use Cake\Http\Middleware\CsrfProtectionMiddleware;
use Cake\Routing\Route\DashedRoute;
use Cake\Routing\RouteBuilder;
$routes->setRouteClass(DashedRoute::class);
$routes->scope('/', function (RouteBuilder $builder) {
   $builder->registerMiddleware('csrf', new CsrfProtectionMiddleware([
      'httpOnly' => true,
   ]));
   $builder->applyMiddleware('csrf');
   //$builder->connect('/pages',
      ['controller'=>'Pages','action'=>'display', 'home']);
   $builder->connect('login',['controller'=>'Logins','action'=>'index']);
   $builder->fallbacks();
});

在 src/Controller/LoginsController.php 创建一个 LoginsController.php 文件。将以下代码复制到控制器文件中。

src/Controller/LoginsController.php

<?php
   namespace App\Controller;
   use App\Controller\AppController;
   class LoginsController extends AppController {
      public function initialize() : void {
         parent::initialize();
         $this->loadComponent('Security');
      }
         public function index(){
      }
   }
?>

在 src/Template 处创建一个目录 Logins，并在该目录下创建一个名为 index.php 的 View 文件。将以下代码复制到该文件中。

src/Template/Logins/index.php

<?php
   echo $this->Form->create(NULL,array('url'=>'/login'));
   echo $this->Form->control('username');
   echo $this->Form->control('password');
   echo $this->Form->button('Submit');
   echo $this->Form->end();
?>

通过访问以下 URL 执行上述示例 − http://localhost/cakephp4/login