mirror of
https://github.com/PrivateBin/PrivateBin.git
synced 2024-12-26 07:49:24 -05:00
05402ef304
- @version in file header level isn't used on code docs, it is intended for API versions at class or method level - avoids needing to update all these files on version increment - avoids needing to regenerate SRI hashes for privatebin.js through extra phpunit run - simplifies VERSION_FILES list - avoids having to filter above list during loop - adds a few missing doc bloc headers
87 lines
1.9 KiB
PHP
87 lines
1.9 KiB
PHP
<?php
|
|
/**
|
|
* PrivateBin
|
|
*
|
|
* a zero-knowledge paste bin
|
|
*
|
|
* @link https://github.com/PrivateBin/PrivateBin
|
|
* @copyright 2012 Sébastien SAUVAGE (sebsauvage.net)
|
|
* @license https://www.opensource.org/licenses/zlib-license.php The zlib/libpng License
|
|
*/
|
|
|
|
namespace PrivateBin\Persistence;
|
|
|
|
use PrivateBin\Data\AbstractData;
|
|
|
|
/**
|
|
* ServerSalt
|
|
*
|
|
* This is a random string which is unique to each PrivateBin installation.
|
|
* It is automatically created if not present.
|
|
*
|
|
* Salt is used:
|
|
* - to generate unique VizHash in discussions (which are not reproductible across PrivateBin servers)
|
|
* - to generate unique deletion token (which are not re-usable across PrivateBin servers)
|
|
*/
|
|
class ServerSalt extends AbstractPersistence
|
|
{
|
|
/**
|
|
* generated salt
|
|
*
|
|
* @access private
|
|
* @static
|
|
* @var string
|
|
*/
|
|
private static $_salt = '';
|
|
|
|
/**
|
|
* generate a large random hexadecimal salt
|
|
*
|
|
* @access public
|
|
* @static
|
|
* @return string
|
|
*/
|
|
public static function generate()
|
|
{
|
|
return bin2hex(random_bytes(256));
|
|
}
|
|
|
|
/**
|
|
* get server salt
|
|
*
|
|
* @access public
|
|
* @static
|
|
* @return string
|
|
*/
|
|
public static function get()
|
|
{
|
|
if (!empty(self::$_salt)) {
|
|
return self::$_salt;
|
|
}
|
|
|
|
$salt = self::$_store->getValue('salt');
|
|
if ($salt) {
|
|
self::$_salt = $salt;
|
|
} else {
|
|
self::$_salt = self::generate();
|
|
if (!self::$_store->setValue(self::$_salt, 'salt')) {
|
|
error_log('failed to store the server salt, delete tokens, traffic limiter and user icons won\'t work');
|
|
}
|
|
}
|
|
return self::$_salt;
|
|
}
|
|
|
|
/**
|
|
* set the path
|
|
*
|
|
* @access public
|
|
* @static
|
|
* @param AbstractData $store
|
|
*/
|
|
public static function setStore(AbstractData $store)
|
|
{
|
|
self::$_salt = '';
|
|
parent::setStore($store);
|
|
}
|
|
}
|