Go to file
Alfredo Fabián Altamirano Tena 910c3b3f9d Add Spanish to supported languages 2016-12-30 20:40:23 -06:00
.github Add note for reproduction on official site 2016-10-21 22:14:44 +02:00
cfg Use default csp value by default 2016-09-18 12:21:42 +02:00
css tagging 1.1 release and updating documentation 2016-12-26 12:13:50 +01:00
doc added note for phpdoc with PHP 7 2016-08-22 10:58:01 +02:00
i18n Create es.json 2016-12-30 20:37:58 -06:00
img shrinking icon to avoid renderering glitches 2016-08-21 20:42:58 +02:00
js Add Spanish to supported languages 2016-12-30 20:40:23 -06:00
lib tagging 1.1 release and updating documentation 2016-12-26 12:13:50 +01:00
tpl tagging 1.1 release and updating documentation 2016-12-26 12:13:50 +01:00
tst written unit test to reproduce #149 2016-12-25 12:04:47 +01:00
vendor Update random_compat to v2.0.4 2016-11-08 16:52:43 +01:00
.codeclimate.yml reverting some of the changes done to try to support HHVM building, simplifying the dependencies 2016-07-11 15:52:08 +02:00
.csslintrc add codeclimate settings 2016-07-06 13:20:14 +02:00
.dockerignore Add .dockerignore 2016-12-23 20:01:17 +01:00
.editorconfig Add missing fixers from PHP CS 2016-10-31 11:29:25 +01:00
.eslintignore add codeclimate settings 2016-07-06 13:20:14 +02:00
.eslintrc Minor JS code improvments 2016-07-19 14:13:52 +02:00
.gitattributes excluding some development files from being packaged 2016-12-26 12:19:33 +01:00
.gitignore Exclude doch folder 2016-08-17 20:43:59 +02:00
.htaccess.disabled Add a (disabled by default) .htaccess file to block out robots and other link scanning agents. 2016-02-16 17:36:28 +05:30
.php_cs Add missing fixers from PHP CS 2016-10-31 11:29:25 +01:00
.styleci.yml Add missing fixers from PHP CS 2016-10-31 11:29:25 +01:00
.travis.yml reverting some of the changes done to try to support HHVM building, simplifying the dependencies 2016-07-11 15:52:08 +02:00
CHANGELOG.md tagging 1.1 release and updating documentation 2016-12-26 12:13:50 +01:00
CREDITS.md tagging 1.1 release and updating documentation 2016-12-26 12:13:50 +01:00
Dockerfile Add a Dockerfile 2016-12-23 18:56:49 +01:00
INSTALL.md tagging 1.1 release and updating documentation 2016-12-26 12:13:50 +01:00
LICENSE.md updating docs 2016-08-22 10:34:37 +02:00
README.md tagging 1.1 release and updating documentation 2016-12-26 12:13:50 +01:00
android-chrome-192x192.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
android-chrome-512x512.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
apple-touch-icon.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
browserconfig.xml Make favicons subdir-compatible (again) 2016-07-19 14:03:18 +02:00
composer.json Merge branch 'master' into prng, resolve merge conflicts 2016-08-15 18:15:57 +02:00
favicon-16x16.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
favicon-32x32.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
favicon.ico replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
index.php bumping version number to 1.0 2016-08-25 09:53:31 +02:00
manifest.json Make favicons subdir-compatible (again) 2016-07-19 14:03:18 +02:00
mstile-70x70.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
mstile-144x144.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
mstile-150x150.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
mstile-310x150.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
mstile-310x310.png replacing favicons with new design by @rugk, resolves #23 2016-07-18 16:25:06 +02:00
robots.txt Some rewording 2016-07-19 13:05:07 +02:00
safari-pinned-tab.svg 🔧 Update Safari favicon SVG with minified version 2016-07-19 12:39:10 +02:00

README.md

PrivateBin

Build Status Build Status
Codacy Badge Code Climate Scrutinizer Code Quality SensioLabsInsight
Codacy Badge Test Coverage Code Coverage

Current version: 1.1

PrivateBin is a minimalist, open source online pastebin where the server has zero knowledge of pasted data.

Data is encrypted/decrypted in the browser using 256bit AES in Galois Counter mode.

This is a fork of ZeroBin, originally developed by Sébastien Sauvage. It was refactored to allow easier and cleaner extensions and has now much more features than the original. It is however still fully compatible to the original ZeroBin 0.19 data storage scheme. Therefore such installations can be upgraded to this fork without loosing any data.

What PrivateBin provides

  • As a server administrator you don't have to worry if your users post content that is considered illegal in your country. You have no knowledge of any of the pastes content. If requested or enforced, you can delete any paste from your system.

  • Pastebin-like system to store text documents, code samples, etc.

  • Encryption of data sent to server.

  • Possibility to set a password which is required to read the paste. It further protects a paste and prevents people stumbling upon your paste's link from being able to read it without the password.

What it doesn't provide

  • As a user you have to trust the server administrator, your internet provider and any country the traffic passes not to inject any malicious javascript code. For a basic security the PrivateBin installation has to provide HTTPS! Additionally it should be secured by HSTS and ideally by HPKP using a certificate either validated by a trusted third party (check the certificate when first using a new PrivateBin instance) or self-signed by the server operator, validated using a DNSSEC protected DANE record.

  • The "key" used to encrypt the paste is part of the URL. If you publicly post the URL of a paste that is not password-protected, everybody can read it. Use a password if you want your paste to be private. In this case make sure to use a strong password and do only share it privately and end-to-end-encrypted.

  • A server admin might be forced to hand over access logs to the authorities. PrivateBin encrypts your text and the discussion contents, but who accessed it first might still be disclosed via such access logs.

  • In case of a server breach your data is secure as it is only stored encrypted on the server. However the server could be misused or the server admin could be legally forced into sending malicious JavaScript to all web users, which grabs the decryption key and send it to the server when a user accesses a PrivateBin.
    Therefore do not access any PrivateBin instance if you think it has been compromised. As long as no user accesses this instance with a previously generated URL, the content can''t be decrypted.

Options

Some features are optional and can be enabled or disabled in the configuration file:

  • Password protection

  • Discussions, anonymous or with nicknames and IP based identicons or vizhashes

  • Expiration times, including a "forever" and "burn after reading" option

  • Markdown format support for HTML formatted pastes, including preview function

  • Syntax highlighting for source code using prettify.js, including 4 prettify themes

  • File upload support, images get displayed (disabled by default, possibility to adjust size limit)

  • Templates: By default there are bootstrap CSS, darkstrap and "classic ZeroBin" themes and it is easy to adapt these to your own websites layout or create your own.

  • Translation system and automatic browser language detection (if enabled in browser)

  • Language selection (disabled by default, as it uses a session cookie)

Further resources

Run into any issues? Have ideas for further developments? Please report them!