PrivateBin/README.md

117 lines
6.2 KiB
Markdown
Raw Normal View History

# [<img alt="PrivateBin" src="https://cdn.rawgit.com/PrivateBin/assets/master/images/minified/logo.svg" width="500" />](https://privatebin.info/)
2016-07-09 20:43:50 +08:00
[![Build Status](https://travis-ci.org/PrivateBin/PrivateBin.svg?branch=master)](https://travis-ci.org/PrivateBin/PrivateBin) [![Build Status](https://scrutinizer-ci.com/g/PrivateBin/PrivateBin/badges/build.png?b=master)](https://scrutinizer-ci.com/g/PrivateBin/PrivateBin/build-status/master)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/094500f62abf4c9aa0c8a8a4520e4789)](https://www.codacy.com/app/PrivateBin/PrivateBin)
2016-07-09 19:59:50 +08:00
[![Code Climate](https://codeclimate.com/github/PrivateBin/PrivateBin/badges/gpa.svg)](https://codeclimate.com/github/PrivateBin/PrivateBin)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/PrivateBin/PrivateBin/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/PrivateBin/PrivateBin/?branch=master)
[![SensioLabsInsight](https://insight.sensiolabs.com/projects/57c9e74e-c6f9-4de6-a876-df66ec2ea1ff/mini.png)](https://insight.sensiolabs.com/projects/57c9e74e-c6f9-4de6-a876-df66ec2ea1ff)
[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/094500f62abf4c9aa0c8a8a4520e4789)](https://www.codacy.com/app/PrivateBin/PrivateBin)
2016-07-09 19:59:50 +08:00
[![Test Coverage](https://codeclimate.com/github/PrivateBin/PrivateBin/badges/coverage.svg)](https://codeclimate.com/github/PrivateBin/PrivateBin/coverage) [![Code Coverage](https://scrutinizer-ci.com/g/PrivateBin/PrivateBin/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/PrivateBin/PrivateBin/?branch=master)
2013-02-23 07:44:06 +08:00
*Current version: 1.1.1*
2016-08-20 23:57:02 +08:00
2016-07-18 17:23:47 +08:00
**PrivateBin** is a minimalist, open source online pastebin where the server has
2016-07-09 20:35:50 +08:00
zero knowledge of pasted data.
2012-04-22 17:48:39 +08:00
Data is encrypted and decrypted in the browser using 256bit AES in [Galois Counter mode](https://en.wikipedia.org/wiki/Galois/Counter_Mode).
2012-04-22 17:48:39 +08:00
This is a fork of ZeroBin, originally developed by
[Sébastien Sauvage](https://github.com/sebsauvage/ZeroBin). 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
2017-03-22 03:44:46 +08:00
without losing any data.
2016-07-09 18:23:53 +08:00
## 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.
2016-07-09 20:35:50 +08:00
+ Possibility to set a password which is required to read the paste. It further
2015-09-04 04:22:59 +08:00
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
2017-08-11 03:54:38 +08:00
- 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
2017-08-11 03:54:38 +08:00
the traffic passes through.
Additionally the instance should be secured by
2015-11-10 03:43:24 +08:00
[HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security) and
ideally by [HPKP](https://en.wikipedia.org/wiki/HTTP_Public_Key_Pinning) using a
certificate. It can use traditional certificate authorities and/or use
2016-07-09 20:35:50 +08:00
[DNSSEC](https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions)
protected
2015-11-10 03:43:24 +08:00
[DANE](https://en.wikipedia.org/wiki/DNS-based_Authentication_of_Named_Entities)
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.
2016-07-09 20:35:50 +08:00
- 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
2016-07-09 20:35:50 +08:00
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
2016-07-09 20:43:50 +08:00
PrivateBin.
Therefore, do not access any PrivateBin instance if you think it has been
2016-07-09 20:43:50 +08:00
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](https://github.com/PrivateBin/PrivateBin/wiki/Configuration):
* Password protection
2015-09-04 04:22:59 +08:00
2016-08-22 16:34:37 +08:00
* Discussions, anonymous or with nicknames and IP based identicons or vizhashes
* Expiration times, including a "forever" and "burn after reading" option
2016-08-22 16:34:37 +08:00
* Markdown format support for HTML formatted pastes, including preview function
2016-07-09 20:35:50 +08:00
* Syntax highlighting for source code using prettify.js, including 4 prettify
themes
2016-07-09 20:35:50 +08:00
* File upload support, images get displayed (disabled by default, possibility
to adjust size limit)
2016-08-22 16:34:37 +08:00
* 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.
2016-07-09 20:35:50 +08:00
* Translation system and automatic browser language detection (if enabled in
browser)
* Language selection (disabled by default, as it uses a session cookie)
## Further resources
2012-04-22 17:48:39 +08:00
* [Installation guide](https://github.com/PrivateBin/PrivateBin/wiki/Installation)
2012-04-22 17:48:39 +08:00
2016-07-09 20:35:50 +08:00
* [Upgrading from ZeroBin 0.19 Alpha](https://github.com/PrivateBin/PrivateBin/wiki/Upgrading-from-ZeroBin-0.19-Alpha)
2012-04-22 17:48:39 +08:00
* [Configuration guide](https://github.com/PrivateBin/PrivateBin/wiki/Configuration)
2012-04-22 17:48:39 +08:00
* [Templates](https://github.com/PrivateBin/PrivateBin/wiki/Templates)
2012-04-22 17:48:39 +08:00
* [Translation guide](https://github.com/PrivateBin/PrivateBin/wiki/Translation)
2012-04-22 17:48:39 +08:00
* [Developer guide](https://github.com/PrivateBin/PrivateBin/wiki/Development)
2012-04-22 17:48:39 +08:00
Run into any issues? Have ideas for further developments? Please
[report](https://github.com/PrivateBin/PrivateBin/issues) them!