Skip to content
This repository was archived by the owner on Jan 31, 2025. It is now read-only.

Commit ece30d6

Browse files
committed
[mod] refactored libsphinx into seperate repo
1 parent b1da643 commit ece30d6

28 files changed

+14
-3426
lines changed

README.md

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,12 @@
1-
libdecaf-based sphinx password storage implementation
1+
sphinx: a password **S**tore that **P**erfectly **H**ides from **I**tself
2+
(**N**o **X**aggeration)
23

3-
sphinx: a password *S*tore that *P*erfectly *H*ides from *I*tself
4-
(*N*o *X*aggeration)
5-
6-
pitchforked sphinx is a cryptographic password storage as described in
4+
libsphinx is a cryptographic password storage as described in
75
https://eprint.iacr.org/2015/1099
86

97
and as presented by the Levchin Prize winner 2018 Hugo Krawczyk on
108
Real World Crypto https://www.youtube.com/watch?v=px8hiyf81iM
119

12-
pitchforked sphinx comes with variety of interfaces: a library, a
13-
python wrapper around that library, a network server/client written in
14-
python and simple command-line binaries.
15-
1610
## What is this thing?
1711

1812
It allows you to have only a few (at least one) passwords that you
@@ -44,19 +38,19 @@ it's unique and cannot be used to login to other sites or services.
4438
## Installing
4539

4640
Install `libsodium` using your operating system provided package
47-
management. And if you use any of the python goodies you need to
48-
install also `pysodium` using either your OS package manager or pip.
41+
management.
4942

50-
Building everything should be quite simple afterwards:
43+
Building everything should (hopefully) be quite simple afterwards:
5144

5245
```
5346
git submodule init
47+
cd src
5448
make
5549
```
5650

5751
## Library
5852

59-
Pitchforked sphinx builds a library, which you can use to build your
53+
libsphinx builds a library, which you can use to build your
6054
own password manager either in C/C++ or any other language that can
6155
bind to this library. The library also contains an experimental
6256
version of the PKI-free PAKE protocol from page 18 of the paper.
@@ -156,7 +150,7 @@ function return 1, otherwise 0.
156150

157151
## Standalone Binaries
158152

159-
pitchforked sphinx comes with very simple binaries, so you can build
153+
libsphinx comes with very simple binaries, so you can build
160154
your own password storage even from shell scripts. Each step in the
161155
protocol is handled by one binary:
162156

@@ -190,12 +184,14 @@ The derived password is sent to standard output and currently is a 32 byte
190184
binary string.
191185

192186
### step 4 - transform into ASCII password
187+
193188
The output from step 3 is a 32 byte binary string, most passwords have some
194189
limitations to accept only printable - ASCII - chars. `bin2pass.py` is a python
195-
script which takes a binary input on standard input and transforms it into an
196-
ASCII password. It can have max two parameters the classes of characters
197-
allowed ([*u*]pper-, [*l*]ower-case letters, [*d*]igits and [*s*]ymbols) and
198-
the size of the password. The following examples should make this clear:
190+
script in the [pwdsphinx](https://github.com/stef/pwdsphinx) python module which takes a binary input on standard
191+
input and transforms it into an ASCII password. It can have max two parameters
192+
the classes of characters allowed ([**u**]pper-, [**l**]ower-case letters,
193+
[**d**]igits and [**s**]ymbols) and the size of the password. The following
194+
examples should make this clear:
199195

200196
Full ASCII, max size:
201197
```

python/MANIFEST.in

Lines changed: 0 additions & 2 deletions
This file was deleted.

python/README.md

Lines changed: 0 additions & 170 deletions
This file was deleted.

python/pwdsphinx/__init__.py

Whitespace-only changes.

python/pwdsphinx/bin2pass.py

Lines changed: 0 additions & 81 deletions
This file was deleted.

python/pwdsphinx/config.py

Lines changed: 0 additions & 18 deletions
This file was deleted.

0 commit comments

Comments
 (0)