No Description

El RIDO 917f2dfa2b add Node Security configuration and enabling it in CodeClimate 8 years ago
.github 674ebbc6fb Remove bullet point 9 years ago
cfg 414ab0eb71 Add config and basic page template support 8 years ago
css 414ab0eb71 Add config and basic page template support 8 years ago
doc db2778c64f introduced JSDoc: changes for JSDoc compatibility and resolving inconsistencies in documentation, both semantic and in the logic 9 years ago
i18n 78f9f5279a Remove the last ")" 8 years ago
img 6eb8822059 optimizing PNG 8 years ago
js 2db412873b implementing ESlint suggestions 8 years ago
lib 414ab0eb71 Add config and basic page template support 8 years ago
tpl 5e070db6a1 reverting escaping just for Markdown formatting, as discussed in #269 8 years ago
tst fe54889b99 fixing failing unit test 8 years ago
vendor 0ae952e63f Add note about PostgreSQL 9 years ago
.codeclimate.yml 917f2dfa2b add Node Security configuration and enabling it in CodeClimate 8 years ago
.csslintrc 8b38e26735 add codeclimate settings 10 years ago
.dockerignore 77f464f650 Add .dockerignore 9 years ago
.editorconfig b4293f5467 Add missing fixers from PHP CS 9 years ago
.eslintignore 2db412873b implementing ESlint suggestions 8 years ago
.eslintrc 2db412873b implementing ESlint suggestions 8 years ago
.gitattributes 414693fa90 testing both cases of the logic required for #167 8 years ago
.gitignore bccb349226 adjust .gitignore to use new config file name 8 years ago
.htaccess.disabled eb6d994672 Add Facebook to robot block list 9 years ago
.jshintrc f90ad11bcd adding JSHint configuration 8 years ago
.nsprc 917f2dfa2b add Node Security configuration and enabling it in CodeClimate 8 years ago
.php_cs b4293f5467 Add missing fixers from PHP CS 9 years ago
.styleci.yml 4652b5af7b preferring pre-increment StyleCI recommendation 8 years ago
.travis.yml 49feb300b6 further tweaking travis CI scripts 8 years ago
CHANGELOG.md 6fa2bfe30e updated documentation, incremented version 8 years ago
CREDITS.md ab2e789aee Add JS refactor to credits 9 years ago
Dockerfile f45367fac2 Add a Dockerfile 9 years ago
INSTALL.md 6fa2bfe30e updated documentation, incremented version 8 years ago
LICENSE.md 313b5d34d2 updating docs 10 years ago
README.md 87e88e3159 linking to pastebin wiki article for explanation 8 years ago
browserconfig.xml 7f4ed739de moved images to img folder 9 years ago
composer.json 76c14795ef removing unnecessary repository from composer: We do not depend on ourselves 8 years ago
index.php 4a036aea80 updated SRI hashes, added missing formula for slowene plurals and unit test for it, updated credits and changelog 9 years ago
manifest.json 7f4ed739de moved images to img folder 9 years ago
robots.txt 7875d7b0a3 Some rewording 10 years ago

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.1

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

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

This is a fork of ZeroBin, originally developed by Sébastien Sauvage. ZeroBin was refactored to allow easier and cleaner extensions. PrivateBin has many more features than the original ZeroBin. It is, however, still fully compatible to the original ZeroBin 0.19 data storage scheme. Therefore, such installations can be upgraded to PrivateBin without losing 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 not to inject any malicious javascript code. For basic security, the PrivateBin installation has to provide HTTPS! Otherwise you would also have to trust your internet provider, and any country the traffic passes through. Additionally the instance should be secured by HSTS and ideally by HPKP using a certificate. It can use traditional certificate authorities and/or use 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, anyone 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 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 a paste (first) might still be disclosed via 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 sends 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!