Reputation: 4723

How to secure database passwords in PHP?

When a PHP application makes a database connection it of course generally needs to pass a login and password. If I'm using a single, minimum-permission login for my application, then the PHP needs to know that login and password somewhere. What is the best way to secure that password? It seems like just writing it in the PHP code isn't a good idea.

Upvotes: 445

Answers (18)

theking2

Reputation: 2852

Many wrote correctly that storing you credentials outside a php in a configuration file and keep this file secure is the best way. This is a practical example how to do that.

Config file

Create a file config.ini (or any name you like) with this contents

[db]
server   = localhost
name     = dbname
user     = username
password = 'password'

Read the file

Reading this file is easy by doing this.

$settings = parse_ini_file( '/config.ini', true);

Connect to the database

try {
  $dsn = sprintf(
    'mysql:host=%s;dbname=%s',
    $settings['db']['server'],
    $settings['db']['name']);

  $db = new \PDO(
    $dsn,
    $settings['db']['user'],
    $settings['db']['password']
  );
} catch ( \PDOException $e ) {
  exit( $e->getMessage() );
}

(Some) Security on the config file

In Apache make sure ini files will never be served with this .htaccess file

<FilesMatch "\.(htaccess|ini)$">
Order allow,deny
Deny from all
</FilesMatch>

Make `$settings` global

Since PHP > 7.0.0 it is possible to define array constant. $settings is an array so we could do this:

$settings = parse_ini_file( '/config.ini', true );
define( 'SETTINGS', $settings );
unset( $settings ); // we don't need this anymore

/* some where else */
$db = new \PDO(
    "mysql:host={SETTINGS['db']['server']};dbname={SETTINGS['db']['name']}"
    SETTINGS['db']['user'],
    SETTINGS['db']['password'],

Constants are global so now we can use it everywhere. Of course you have to make sure this constant is not exposed somewhere in your project.

Upvotes: 1

Bruno Guignard

Reputation: 303

Actually, the best practice is to store your database crendentials in environment variables because :

These credentials are dependant to environment, it means that you won't have the same credentials in dev/prod. Storing them in the same file for all environment is a mistake.
Credentials are not related to business logic which means login and password have nothing to do in your code.
You can set environment variables without creating any business code class file, which means you will never make the mistake of adding the credential files to a commit in Git.
Environments variables are superglobales : you can use them everywhere in your code without including any file.

How to use them ?

Using the $_ENV array :
- Setting : $_ENV['MYVAR'] = $myvar
- Getting : echo $_ENV["MYVAR"]
Using the php functions :
- Setting with the putenv function - putenv("MYVAR=$myvar");
- Getting with the getenv function - getenv('MYVAR');
In vhosts files and .htaccess but it's not recommended since its in another file and its not resolving the problem by doing it this way.

You can easily drop a file such as envvars.php with all environment variables inside and execute it (php envvars.php) and delete it. It's a bit old school, but it still work and you don't have any file with your credentials in the server, and no credentials in your code. Since it's a bit laborious, frameworks do it better.

Example with Symfony (ok its not only PHP) The modern frameworks such as Symfony recommends using environment variables, and store them in a .env not commited file or directly in command lines which means you wether can do :

With CLI : symfony var:set FOO=bar --env-level
With .env or .env.local : FOO="bar"

Documentation :

Upvotes: 3

Bob Fanger

Reputation: 29917

if it is possible to create the database connection in the same file where the credentials are stored. Inline the credentials in the connect statement.

mysql_connect("localhost", "me", "mypass");

Otherwise it is best to unset the credentials after the connect statement, because credentials that are not in memory, can't be read from memory ;)

include("/outside-webroot/db_settings.php");  
mysql_connect("localhost", $db_user, $db_pass);  
unset ($db_user, $db_pass);

Upvotes: 11

Courtney Miles

Reputation: 4014

Previously we stored DB user/pass in a configuration file, but have since hit paranoid mode -- adopting a policy of Defence in Depth.

If your application is compromised, the user will have read access to your configuration file and so there is potential for a cracker to read this information. Configuration files can also get caught up in version control, or copied around servers.

We have switched to storing user/pass in environment variables set in the Apache VirtualHost. This configuration is only readable by root -- hopefully your Apache user is not running as root.

The con with this is that now the password is in a Global PHP variable.

To mitigate this risk we have the following precautions:

The password is encrypted. We extend the PDO class to include logic for decrypting the password. If someone reads the code where we establish a connection, it won't be obvious that the connection is being established with an encrypted password and not the password itself.
The encrypted password is moved from the global variables into a private variable The application does this immediately to reduce the window that the value is available in the global space.
phpinfo() is disabled. PHPInfo is an easy target to get an overview of everything, including environment variables.

Upvotes: 10

Asi Azulay

Reputation: 81

We have solved it in this way:

Use memcache on server, with open connection from other password server.
Save to memcache the password (or even all the password.php file encrypted) plus the decrypt key.
The web site, calls the memcache key holding the password file passphrase and decrypt in memory all the passwords.
The password server send a new encrypted password file every 5 minutes.
If you using encrypted password.php on your project, you put an audit, that check if this file was touched externally - or viewed. When this happens, you automatically can clean the memory, as well as close the server for access.

Upvotes: 7

Neil McGuigan

Reputation: 48287

This solution is general, in that it is useful for both open and closed source applications.

Create an OS user for your application. See http://en.wikipedia.org/wiki/Principle_of_least_privilege
Create a (non-session) OS environment variable for that user, with the password
Run the application as that user

Advantages:

You won't check your passwords into source control by accident, because you can't
You won't accidentally screw up file permissions. Well, you might, but it won't affect this.
Can only be read by root or that user. Root can read all your files and encryption keys anyways.
If you use encryption, how are you storing the key securely?
Works x-platform
Be sure to not pass the envvar to untrusted child processes

This method is suggested by Heroku, who are very successful.

Upvotes: 16

Marijn

Reputation: 2096

Just putting it into a config file somewhere is the way it's usually done. Just make sure you:

disallow database access from any servers outside your network,
take care not to accidentally show the password to users (in an error message, or through PHP files accidentally being served as HTML, etcetera.)

Upvotes: 4

Lars Nyström

Reputation: 6393

The most secure way is to not have the information specified in your PHP code at all.

If you're using Apache that means to set the connection details in your httpd.conf or virtual hosts file file. If you do that you can call mysql_connect() with no parameters, which means PHP will never ever output your information.

This is how you specify these values in those files:

php_value mysql.default.user      myusername
php_value mysql.default.password  mypassword
php_value mysql.default.host      server

Then you open your mysql connection like this:

<?php
$db = mysqli_connect();

Or like this:

<?php
$db = mysqli_connect(ini_get("mysql.default.user"),
                     ini_get("mysql.default.password"),
                     ini_get("mysql.default.host"));

Upvotes: 57

user11318

Reputation: 9343

Several people misread this as a question about how to store passwords in a database. That is wrong. It is about how to store the password that lets you get to the database.

The usual solution is to move the password out of source-code into a configuration file. Then leave administration and securing that configuration file up to your system administrators. That way developers do not need to know anything about the production passwords, and there is no record of the password in your source-control.

Upvotes: 265

kellen

Reputation: 7133

If you're hosting on someone else's server and don't have access outside your webroot, you can always put your password and/or database connection in a file and then lock the file using a .htaccess:

<files mypasswdfile>
order allow,deny
deny from all
</files>

Upvotes: 104

AviD

Reputation: 13112

Best way is to not store the password at all!
For instance, if you're on a Windows system, and connecting to SQL Server, you can use Integrated Authentication to connect to the database without a password, using the current process's identity.

If you do need to connect with a password, first encrypt it, using strong encryption (e.g. using AES-256, and then protect the encryption key, or using asymmetric encryption and have the OS protect the cert), and then store it in a configuration file (outside of the web directory) with strong ACLs.

Upvotes: 2

pdavis

Reputation: 3211

For extremely secure systems we encrypt the database password in a configuration file (which itself is secured by the system administrator). On application/server startup the application then prompts the system administrator for the decryption key. The database password is then read from the config file, decrypted, and stored in memory for future use. Still not 100% secure since it is stored in memory decrypted, but you have to call it 'secure enough' at some point!

Upvotes: 40

Bite code

Reputation: 597311

An additional trick is to use a PHP separate configuration file that looks like that :

<?php exit() ?>

[...]

Plain text data including password

This does not prevent you from setting access rules properly. But in the case your web site is hacked, a "require" or an "include" will just exit the script at the first line so it's even harder to get the data.

Nevertheless, do not ever let configuration files in a directory that can be accessed through the web. You should have a "Web" folder containing your controler code, css, pictures and js. That's all. Anything else goes in offline folders.

Upvotes: 4

Jim

Reputation: 73966

If you are using PostgreSQL, then it looks in ~/.pgpass for passwords automatically. See the manual for more information.

Upvotes: 10

Vagnerr

Reputation: 3007

Your choices are kind of limited as as you say you need the password to access the database. One general approach is to store the username and password in a seperate configuration file rather than the main script. Then be sure to store that outside the main web tree. That was if there is a web configuration problem that leaves your php files being simply displayed as text rather than being executed you haven't exposed the password.

Other than that you are on the right lines with minimal access for the account being used. Add to that

Don't use the combination of username/password for anything else
Configure the database server to only accept connections from the web host for that user (localhost is even better if the DB is on the same machine) That way even if the credentials are exposed they are no use to anyone unless they have other access to the machine.
Obfuscate the password (even ROT13 will do) it won't put up much defense if some does get access to the file, but at least it will prevent casual viewing of it.

Peter

Upvotes: 9

Jason Wadsworth

Reputation: 933

If you're talking about the database password, as opposed to the password coming from a browser, the standard practice seems to be to put the database password in a PHP config file on the server.

You just need to be sure that the php file containing the password has appropriate permissions on it. I.e. it should be readable only by the web server and by your user account.

Upvotes: 4