Compare commits

..

No commits in common. "master" and "v1.0.6-alpha" have entirely different histories.

9 changed files with 51 additions and 93 deletions

2
.gitignore vendored
View file

@ -10,5 +10,3 @@
.DS_Store .DS_Store
.coverage .coverage
/*.md /*.md
/.eggs/
/devel/

View file

@ -2,40 +2,28 @@
![](docs/_assets/images/favpng_parrot-royalty-free-cartoon.png) ![](docs/_assets/images/favpng_parrot-royalty-free-cartoon.png)
**NOTE**: httpaste is publicly hosted at [httpaste.it](http://httpaste.it) and as a hidden Tor service ([https://paste77ubkwxy4fqezffsmthxdh3xerwi72tlsw2mch7ecjhw2xn7iyd.onion](https://paste77ubkwxy4fqezffsmthxdh3xerwi72tlsw2mch7ecjhw2xn7iyd.onion)). httpaste is a pastebin application for easily pasting and retrieving data over
Both services are to be considered evaluatory, as long as the source code HTTP from shell environments and web browsers. It is inspired by [sprunge.us](http://sprunge.us)
is in pre-release. Regarding voidance of pre-release status, see [Open Issues](https://victorykit.atlassian.net/issues/?jql=project%20%3D%20HTTPASTE%20AND%20fixVersion%20in%20(1.1.0-beta%2C%201.2.0-beta%2C%201.3.0)), for more information. and [ix.io](http://ix.io/), but focuses on extendability, advanced security, with little to
no trade-off to simplicity. It can be hosted through WSGI, CGI, Fast CGI, or
as a standalone evaluation server. It offers multiple storage backends, such as
a filesystem backend, SQLite backend, MySQL backend, or MongoDB backend.
This program offers an HTTP interface for storing public and private data All pastes are being encrypted on the fly and can only be retrieved by an
(a.k.a. pastes), commonly referred to as a pastebin application. It is inspired by [sprunge.us](http://sprunge.us) and [ix.io](http://ix.io/). It can be hosted through WSGI, CGI, Fast authorized user, either through knowing the paste id of a public paste, or
CGI, or as a standalone evaluation server. It offers multiple storage backends, having authentication credentials, as well as the paste id of a private paste.
such as a filesystem backend, SQLite backend, or MySQL backend. This makes httpaste ideal as a pastebin for sensitive environments such as the
Tor network. Authentication credentials are created on-the-fly and dont require a sign-up process.
Public data can be accessed through an URL, where as private pastes httpaste supports output formatting for syntax highlighting (powered by
additionally require HTTP basic authentication. Creation of authentication
credentials happens on the fly, there is no sign-up process. Public pastes can
only be accessed by knowing their paste ids, they are not listed on any index,
since it isnt technically possible (by design).
All pastes are symetrically encrypted server-side with an HMAC derived key and
SHA-256 hashing, a server-side salt and a randomly generated password. Public
pastes passwords are derived from their ids. Private pastes passwords are
randomly generated and stored inside a symetrically encrypted personal
database, with the encryption key also being derived through the same HMAC
mechanism, where the HTTP basic authentication credentials act as the master
password.
Paste ids, usernames, and any other identifiable attributes are only stored
inside storage backends as keyed and salted BLAKE2 hashes.
The program supports output formatting for syntax highlighting (powered by
[pygments](https://pygments.org/)), as well as MIME type output manipulation, and input encoding. [pygments](https://pygments.org/)), as well as MIME type output manipulation, and input encoding.
The program can therefore serve as a minimalist, anonymous object storage for Therefore httpaste can server as an anonymous object storage for small data.
small data.
Minute-based and burn-after-read paste expiration are also supported. Minute-based and burn-after-read paste expiration are supported.
# Getting Started httpaste focuses on security through cryptography, making it a computationally intensive application.
# Get Started
## Install ## Install

View file

@ -9,41 +9,28 @@ httpaste - versatile HTTP pastebin
.. image:: _assets/images/favpng_parrot-royalty-free-cartoon.png .. image:: _assets/images/favpng_parrot-royalty-free-cartoon.png
.. note:: httpaste is a pastebin application for easily pasting and retrieving data over
httpaste is publicly hosted at `httpaste.it`_ and as a hidden Tor service (`<https://paste77ubkwxy4fqezffsmthxdh3xerwi72tlsw2mch7ecjhw2xn7iyd.onion>`_). HTTP from shell environments and web browsers. It is inspired by `sprunge.us`_
Both services are to be considered evaluatory, as long as the source code and `ix.io`_, but focuses on extendability, advanced security, with little to
is in pre-release. Regarding voidance of pre-release status, see `Open Issues`_, for more information. no trade-off to simplicity. It can be hosted through WSGI, CGI, Fast CGI, or
as a standalone evaluation server. It offers multiple storage backends, such as
a filesystem backend, SQLite backend, MySQL backend, or MongoDB backend.
This program offers an HTTP interface for storing public and private data All pastes are being encrypted on the fly and can only be retrieved by an
(a.k.a. pastes), commonly referred to as a pastebin application. It is inspired by `sprunge.us`_ and `ix.io`_. It can be hosted through WSGI, CGI, Fast authorized user, either through knowing the paste id of a public paste, or
CGI, or as a standalone evaluation server. It offers multiple storage backends, having authentication credentials, as well as the paste id of a private paste.
such as a filesystem backend, SQLite backend, or MySQL backend. This makes httpaste ideal as a pastebin for sensitive environments such as the
Tor network. Authentication credentials are created on-the-fly and don't require a sign-up process.
Public data can be accessed through an URL, where as private pastes httpaste supports output formatting for syntax highlighting (powered by
additionally require HTTP basic authentication. Creation of authentication
credentials happens on the fly, there is no sign-up process. Public pastes can
only be accessed by knowing their paste ids, they are not listed on any index,
since it isn't technically possible (by design).
All pastes are symetrically encrypted server-side with an HMAC derived key and
SHA-256 hashing, a server-side salt and a randomly generated password. Public
paste's passwords are derived from their ids. Private paste's passwords are
randomly generated and stored inside a symetrically encrypted personal
database, with the encryption key also being derived through the same HMAC
mechanism, where the HTTP basic authentication credentials act as the master
password.
Paste ids, usernames, and any other identifiable attributes are only stored
inside storage backends as keyed and salted BLAKE2 hashes.
The program supports output formatting for syntax highlighting (powered by
`pygments`_), as well as MIME type output manipulation, and input encoding. `pygments`_), as well as MIME type output manipulation, and input encoding.
The program can therefore serve as a minimalist, anonymous object storage for Therefore httpaste can server as an anonymous object storage for small data.
small data.
Minute-based and 'burn-after-read' paste expiration are also supported. Minute-based and 'burn-after-read' paste expiration are supported.
.. include:: guide/getting-started.rst httpaste focuses on security through cryptography, making it a computationally intensive application.
.. include:: guide/get-started.rst
Documentation Documentation
------------- -------------
@ -83,7 +70,3 @@ This program uses licensed third-party software.
.. _sprunge.us: http://sprunge.us .. _sprunge.us: http://sprunge.us
.. _pygments: https://pygments.org/ .. _pygments: https://pygments.org/
.. _icon: https://favpng.com/png_view/parrot-parrot-royalty-free-cartoon-png/gps7HM42 .. _icon: https://favpng.com/png_view/parrot-parrot-royalty-free-cartoon-png/gps7HM42
.. _Open Issues: https://victorykit.atlassian.net/issues/?jql=project%20%3D%20HTTPASTE%20AND%20fixVersion%20in%20(1.1.0-beta%2C%201.2.0-beta%2C%201.3.0)
.. _httpaste.it: http://httpaste.it

View file

@ -1,5 +1,5 @@
Getting Started Get Started
=============== ===========
Install Install
""""""" """""""

View file

@ -4,7 +4,7 @@
:maxdepth: 1 :maxdepth: 1
:caption: Guides :caption: Guides
guide/getting-started guide/get-started
guide/advanced-usage guide/advanced-usage
guide/backend guide/backend
guide/cli guide/cli

View file

@ -1,8 +1,7 @@
[build-system] [build-system]
requires = [ requires = [
"setuptools", "setuptools",
"wheel", "wheel"
"setuptools-scm[toml]"
] ]
build-backend = "setuptools.build_meta" build-backend = "setuptools.build_meta"
@ -11,5 +10,3 @@ max_line_length = 80
aggressive = 3 aggressive = 3
recursive = true recursive = true
in-place = true in-place = true
[tool.setuptools_scm]

View file

@ -1,5 +1,6 @@
[metadata] [metadata]
name = httpaste-victorykit name = httpaste-victorykit
version = 1.0.6-alpha
author = Tiara Rodney author = Tiara Rodney
author_email = t.rodney@victoryk.it author_email = t.rodney@victoryk.it
description = a versatile HTTP pastebin description = a versatile HTTP pastebin
@ -38,6 +39,5 @@ console_scripts =
where = src where = src
[options.package_data] [options.package_data]
* = openapi_schema = src/httpaste/schema/httpaste.openapi.json
*.json sql_schema = *.sql
*.sql

View file

@ -144,7 +144,6 @@ from configparser import ConfigParser
from ast import literal_eval from ast import literal_eval
from io import StringIO from io import StringIO
from os import environ from os import environ
from importlib.resources import path as resource_path
from connexion import FlaskApp from connexion import FlaskApp
from connexion.resolver import RestyResolver from connexion.resolver import RestyResolver
@ -302,16 +301,13 @@ def get_flask_app(
options = {"swagger_ui": server_config.swagger_ui} options = {"swagger_ui": server_config.swagger_ui}
#context manager returns a pathlib.Path object application = FlaskApp(__name__, specification_dir='schema/')
with resource_path('httpaste.schema', 'httpaste.openapi.json') as path:
application = FlaskApp(__name__, specification_dir=path.parent) application.add_api(
'httpaste.openapi.json',
application.add_api( options=options,
path.name, resolver=RestyResolver('httpaste.controller')
options=options, )
resolver=RestyResolver('httpaste.controller')
)
for err_cls in [ for err_cls in [
BadRequestError, BadRequestError,

View file

@ -1,10 +1,6 @@
from random import choice from random import choice
from base64 import b64decode from base64 import b64decode
from urllib.parse import urljoin from urllib.parse import urljoin
from tempfile import mkdtemp
from pathlib import Path
from contextlib import contextmanager
class DecodeError(Exception): class DecodeError(Exception):
""" """