Compare commits
No commits in common. "master" and "v1.0.6-alpha" have entirely different histories.
master
...
v1.0.6-alp
9 changed files with 51 additions and 93 deletions
4
.gitignore
vendored
4
.gitignore
vendored
|
|
@ -9,6 +9,4 @@
|
|||
**/__pycache__/
|
||||
.DS_Store
|
||||
.coverage
|
||||
/*.md
|
||||
/.eggs/
|
||||
/devel/
|
||||
/*.md
|
||||
46
README.md
46
README.md
|
|
@ -2,40 +2,28 @@
|
|||
|
||||

|
||||
|
||||
**NOTE**: httpaste is publicly hosted at [httpaste.it](http://httpaste.it) and as a hidden Tor service ([https://paste77ubkwxy4fqezffsmthxdh3xerwi72tlsw2mch7ecjhw2xn7iyd.onion](https://paste77ubkwxy4fqezffsmthxdh3xerwi72tlsw2mch7ecjhw2xn7iyd.onion)).
|
||||
Both services are to be considered evaluatory, as long as the source code
|
||||
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.
|
||||
httpaste is a pastebin application for easily pasting and retrieving data over
|
||||
HTTP from shell environments and web browsers. It is inspired by [sprunge.us](http://sprunge.us)
|
||||
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
|
||||
(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
|
||||
CGI, or as a standalone evaluation server. It offers multiple storage backends,
|
||||
such as a filesystem backend, SQLite backend, or MySQL backend.
|
||||
All pastes are being encrypted on the fly and can only be retrieved by an
|
||||
authorized user, either through knowing the paste id of a public paste, or
|
||||
having authentication credentials, as well as the paste id of a private paste.
|
||||
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
|
||||
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
|
||||
httpaste supports output formatting for syntax highlighting (powered by
|
||||
[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
|
||||
small data.
|
||||
Therefore httpaste can server as an anonymous object storage for 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
|
||||
|
||||
|
|
|
|||
|
|
@ -9,41 +9,28 @@ httpaste - versatile HTTP pastebin
|
|||
|
||||
.. image:: _assets/images/favpng_parrot-royalty-free-cartoon.png
|
||||
|
||||
.. note::
|
||||
httpaste is publicly hosted at `httpaste.it`_ and as a hidden Tor service (`<https://paste77ubkwxy4fqezffsmthxdh3xerwi72tlsw2mch7ecjhw2xn7iyd.onion>`_).
|
||||
Both services are to be considered evaluatory, as long as the source code
|
||||
is in pre-release. Regarding voidance of pre-release status, see `Open Issues`_, for more information.
|
||||
httpaste is a pastebin application for easily pasting and retrieving data over
|
||||
HTTP from shell environments and web browsers. It is inspired by `sprunge.us`_
|
||||
and `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
|
||||
(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
|
||||
CGI, or as a standalone evaluation server. It offers multiple storage backends,
|
||||
such as a filesystem backend, SQLite backend, or MySQL backend.
|
||||
All pastes are being encrypted on the fly and can only be retrieved by an
|
||||
authorized user, either through knowing the paste id of a public paste, or
|
||||
having authentication credentials, as well as the paste id of a private paste.
|
||||
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
|
||||
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
|
||||
httpaste supports output formatting for syntax highlighting (powered by
|
||||
`pygments`_), as well as MIME type output manipulation, and input encoding.
|
||||
The program can therefore serve as a minimalist, anonymous object storage for
|
||||
small data.
|
||||
Therefore httpaste can server as an anonymous object storage for 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
|
||||
-------------
|
||||
|
|
@ -82,8 +69,4 @@ This program uses licensed third-party software.
|
|||
.. _ix.io: http://ix.io/
|
||||
.. _sprunge.us: http://sprunge.us
|
||||
.. _pygments: https://pygments.org/
|
||||
.. _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
|
||||
.. _icon: https://favpng.com/png_view/parrot-parrot-royalty-free-cartoon-png/gps7HM42
|
||||
|
|
@ -1,5 +1,5 @@
|
|||
Getting Started
|
||||
===============
|
||||
Get Started
|
||||
===========
|
||||
|
||||
Install
|
||||
"""""""
|
||||
|
|
@ -4,7 +4,7 @@
|
|||
:maxdepth: 1
|
||||
:caption: Guides
|
||||
|
||||
guide/getting-started
|
||||
guide/get-started
|
||||
guide/advanced-usage
|
||||
guide/backend
|
||||
guide/cli
|
||||
|
|
|
|||
|
|
@ -1,8 +1,7 @@
|
|||
[build-system]
|
||||
requires = [
|
||||
"setuptools",
|
||||
"wheel",
|
||||
"setuptools-scm[toml]"
|
||||
"wheel"
|
||||
]
|
||||
build-backend = "setuptools.build_meta"
|
||||
|
||||
|
|
@ -10,6 +9,4 @@ build-backend = "setuptools.build_meta"
|
|||
max_line_length = 80
|
||||
aggressive = 3
|
||||
recursive = true
|
||||
in-place = true
|
||||
|
||||
[tool.setuptools_scm]
|
||||
in-place = true
|
||||
|
|
@ -1,5 +1,6 @@
|
|||
[metadata]
|
||||
name = httpaste-victorykit
|
||||
version = 1.0.6-alpha
|
||||
author = Tiara Rodney
|
||||
author_email = t.rodney@victoryk.it
|
||||
description = a versatile HTTP pastebin
|
||||
|
|
@ -38,6 +39,5 @@ console_scripts =
|
|||
where = src
|
||||
|
||||
[options.package_data]
|
||||
* =
|
||||
*.json
|
||||
*.sql
|
||||
openapi_schema = src/httpaste/schema/httpaste.openapi.json
|
||||
sql_schema = *.sql
|
||||
|
|
|
|||
|
|
@ -144,7 +144,6 @@ from configparser import ConfigParser
|
|||
from ast import literal_eval
|
||||
from io import StringIO
|
||||
from os import environ
|
||||
from importlib.resources import path as resource_path
|
||||
|
||||
from connexion import FlaskApp
|
||||
from connexion.resolver import RestyResolver
|
||||
|
|
@ -302,16 +301,13 @@ def get_flask_app(
|
|||
|
||||
options = {"swagger_ui": server_config.swagger_ui}
|
||||
|
||||
#context manager returns a pathlib.Path object
|
||||
with resource_path('httpaste.schema', 'httpaste.openapi.json') as path:
|
||||
application = FlaskApp(__name__, specification_dir='schema/')
|
||||
|
||||
application = FlaskApp(__name__, specification_dir=path.parent)
|
||||
|
||||
application.add_api(
|
||||
path.name,
|
||||
options=options,
|
||||
resolver=RestyResolver('httpaste.controller')
|
||||
)
|
||||
application.add_api(
|
||||
'httpaste.openapi.json',
|
||||
options=options,
|
||||
resolver=RestyResolver('httpaste.controller')
|
||||
)
|
||||
|
||||
for err_cls in [
|
||||
BadRequestError,
|
||||
|
|
|
|||
|
|
@ -1,10 +1,6 @@
|
|||
from random import choice
|
||||
from base64 import b64decode
|
||||
from urllib.parse import urljoin
|
||||
from tempfile import mkdtemp
|
||||
from pathlib import Path
|
||||
from contextlib import contextmanager
|
||||
|
||||
|
||||
class DecodeError(Exception):
|
||||
"""
|
||||
|
|
@ -33,4 +29,4 @@ def decode(data: str, encoding: str) -> bytes:
|
|||
|
||||
def join_url(base:str, url: str) -> str:
|
||||
|
||||
return urljoin(base, url, True)
|
||||
return urljoin(base, url, True)
|
||||
Loading…
Add table
Add a link
Reference in a new issue