Brak opisu

El RIDO 6f90df9545 updating tests by dropping PHPunit 4.6 support 5 lat temu
.github 4312f77385 experimentally enable PHP 8 beta unit testing 5 lat temu
cfg e61c44ef46 Make Opengraph really functional 6 lat temu
css 9914c37683 incrementing version 6 lat temu
doc 71797d1dd4 changes required for jsdoc, adding legacy.js to code coverage 6 lat temu
i18n bea9119ec6 New translations en.json (Ukrainian) 5 lat temu
img 0b6139fb42 updating change log and optimizing png 6 lat temu
js 5ec72f1d89 address false positive jsverify RngState 080d2f5b13a86e97c4 5 lat temu
lib 3668f1e3f4 attempt to accomodate Crowdin by providing a single source translation file that is not actually used or loaded by our code 5 lat temu
tpl 417b17f86d didn't figure out which StyleCI change suddenly requires this, so just apply the patch to stop it nagging about it 5 lat temu
tst 6f90df9545 updating tests by dropping PHPunit 4.6 support 5 lat temu
vendor 99f50f6de3 update composer dependencies - test phpunit 9 5 lat temu
.codeclimate.yml 82f2016214 removing PHPCS from CodeClimate, since it can't be configured and contradicts our code style enforced by other checkers 8 lat temu
.csslintrc 8b38e26735 add codeclimate settings 10 lat temu
.editorconfig 183ebe518b Force JSON request for getting paste data 9 lat temu
.eslintignore 2db412873b implementing ESlint suggestions 8 lat temu
.eslintrc a363b2ff95 eslint env cleanup 6 lat temu
.gitattributes fc1be18cbe Makefile should not become part of the release 6 lat temu
.gitignore 476b9c90e2 updating PHP dependencies (they remain unchanged), committing lock for github dependency graph support 6 lat temu
.htaccess.disabled da576baab9 Allow to upload bigger files 7 lat temu
.jshintrc 717e5b0e57 addressing issues found by codacy 7 lat temu
.nsprc 917f2dfa2b add Node Security configuration and enabling it in CodeClimate 8 lat temu
.php_cs b4293f5467 Add missing fixers from PHP CS 9 lat temu
.styleci.yml 33bb0c6bd6 trying to recreate former StyleCI behaviour in changed preset 6 lat temu
BADGES.md 15b3d67ba7 adding browserstack badge in order to be elegible for their OpenSource program (https://www.browserstack.com/open-source?ref=pricing) 6 lat temu
CHANGELOG.md 1614342248 update DOMpurify to version 2.0.14 6 lat temu
CODE_OF_CONDUCT.md 8d323c1da4 document the applicability of RFC 1855 / Netiquette 7 lat temu
CREDITS.md 3485922366 documenting change 6 lat temu
INSTALL.md 9914c37683 incrementing version 6 lat temu
LICENSE.md 6f480bf014 Merge branch 'master' into webcrypto, implementing base58, fixes #377 7 lat temu
Makefile b5ab38e657 adding a Makefile to simplify release related tasks as well as unit testing 6 lat temu
README.md 9914c37683 incrementing version 6 lat temu
SECURITY.md 9914c37683 incrementing version 6 lat temu
browserconfig.xml 7f4ed739de moved images to img folder 9 lat temu
composer.json 6f90df9545 updating tests by dropping PHPunit 4.6 support 5 lat temu
composer.lock 6f90df9545 updating tests by dropping PHPunit 4.6 support 5 lat temu
crowdin.yml 13b5c66e6d Update Crowdin configuration file 5 lat temu
index.php 9914c37683 incrementing version 6 lat temu
manifest.json 7f4ed739de moved images to img folder 9 lat temu
robots.txt 878f13a643 adding an example to opt-out of the privatebin directory 6 lat temu

README.md

PrivateBin

Current version: 1.3.4

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" to choose from 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)

  • QR code generation of URL, to easily transfer pastes over to a mobile device

Further resources

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