No Description

rugk 64165d9928 chore: always ignore composer PHP bin dir 11 months ago
.devcontainer bdfe74c077 chore: fix Codespace COmposer/PHPUnit PATH 11 months ago
.github 09bab8744f Bump actions/checkout from 4 to 5 11 months ago
.vscode 49a87c6038 add workspace settings with config files treated as INI 2 years ago
bin 99265e5464 avoid undefined variable warning 1 year ago
cfg 0808052acf Added shlink integration 11 months ago
css f68650ce5f upgrade bootstrap to 5.3.7 1 year ago
doc 6003f52dba incrementing version 1 year ago
i18n e31027d71e New translations en.json (Corsican) 11 months ago
img 2a27c767a5 optimized images 1 year ago
js 059e64adb1 Auto Shortening URLs 11 months ago
lib 2c1a17a07f Strengthen validation of URL in proxy services 11 months ago
tpl 4a39a2ad0f refactor: added AbstractProxy base class for shortener proxies 11 months ago
tst 77395c147f updated test cases, added clarity in error messages 11 months ago
vendor 7ec8bc6ef1 chore: moved proxy classes to different folder and namespaces 11 months ago
.codeclimate.yml 82f2016214 removing PHPCS from CodeClimate, since it can't be configured and contradicts our code style enforced by other checkers 8 years ago
.csslintrc 8b38e26735 add codeclimate settings 10 years ago
.editorconfig 183ebe518b Force JSON request for getting paste data 9 years ago
.eslintignore 2db412873b implementing ESlint suggestions 8 years ago
.eslintrc a363b2ff95 eslint env cleanup 6 years ago
.gitattributes 6dddf808c6 composer fixes #1222 2 years ago
.gitignore 64165d9928 chore: always ignore composer PHP bin dir 11 months ago
.htaccess.disabled 654bff65cc add config for older apache releases without included mime type 1 year ago
.jshintrc 717e5b0e57 addressing issues found by codacy 7 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
.scrutinizer.yml 48726f3abc enable xdebug for coverage in scrutinizer 1 year ago
.styleci.yml ca999b15ed limit files of StyleCI scan 4 years ago
BADGES.md 15b3d67ba7 adding browserstack badge in order to be elegible for their OpenSource program (https://www.browserstack.com/open-source?ref=pricing) 6 years ago
CHANGELOG.md 0808052acf Added shlink integration 11 months ago
CODE_OF_CONDUCT.md 8d323c1da4 document the applicability of RFC 1855 / Netiquette 7 years ago
CREDITS.md 4a39a2ad0f refactor: added AbstractProxy base class for shortener proxies 11 months ago
LICENSE.md a696069ead Update LICENSE.md 1 year ago
Makefile b6cf717405 chore: prepare for next release 1 year ago
Procfile 49d0b35dc8 Create Procfile 4 years ago
README.md 6003f52dba incrementing version 1 year ago
SECURITY.md 6003f52dba incrementing version 1 year ago
browserconfig.xml 7f4ed739de moved images to img folder 9 years ago
codacy-analysis.yml 15488d3405 bump checkout action 1 year ago
composer.json ddd2d72064 replaced the term "paste" with the more generic "document" 1 year ago
composer.lock 13869e46be updating jdenticon library to 2.0.0, minimum PHP version 7.4 1 year ago
crowdin.yml 13b5c66e6d Update Crowdin configuration file 5 years ago
index.php cebc9acce6 enable strict types in PHP 2 years ago
manifest.json 7f4ed739de moved images to img folder 9 years ago
robots.txt 878f13a643 adding an example to opt-out of the privatebin directory 6 years ago

README.md

PrivateBin

Current version: 2.0.0

PrivateBin is a minimalist, open source online pastebin where the server has zero knowledge of stored 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. PrivateBin was refactored to allow easier and cleaner extensions and has many additional features.

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 plausible deniability 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 code. For security, a PrivateBin installation has to be used over HTTPS! Otherwise you would also have to trust your internet provider, and any jurisdiction the traffic passes through. Additionally the instance should be secured by HSTS. It can use traditional certificate authorities and/or use 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, anyone can read it. Use a password if you want your paste to remain private. In that case, make sure to use a strong password and share it privately and end-to-end-encrypted.

  • A server admin can 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 abused or the server admin could be legally forced into sending malicious code to their users, which logs the decryption key and sends it to a server when a user accesses a paste. 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, image, media and PDF preview (disabled by default, size limit adjustable)

  • Templates: By default there are bootstrap5, bootstrap CSS and darkstrap 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 for paste URLs, to easily transfer them over to mobile devices

Further resources

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