Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md #1

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Update README.md #1

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 19 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,46 +3,49 @@ cryptographic stuff

This is as a collection of cryptographic stuff, which is yet not included into a library or an application.

Password Hashing:
## Password Hashing

The package password hashing is still a bit raw.
It may perhaps be used in future to compare some password hashing schemes.
Bcrypt and Battcrypt require Bouncy Castles lightweight Crypto API.

Pomelo is a Password Hashing Scheme designed by Hongjun Wu. It was submitted to the Password Hashing Competition
**Bcrypt** and **Battcrypt** require Bouncy Castles lightweight Crypto API.

**Pomelo** is a Password Hashing Scheme designed by Hongjun Wu. It was submitted to the Password Hashing Competition
and became one of the nine finalists.
There is also key derivation function described in paper v3.

Battcrypt was designed by Steven Thomas and is also a finalist of the Password Hshing Comptition.
**Battcrypt** was designed by Steven Thomas and is also a finalist of the Password Hshing Competition.
This implementation does not contain the key derivation mode. It will be updated later.

Catena is a Password-Scrambling Framework designed by Christian Forler, Stefan Lucks and Jakob Wenzel. The Password Hashing Competition gave special recognition to Catena and three other schemes.
**Catena** is a Password-Scrambling Framework designed by Christian Forler, Stefan Lucks and Jakob Wenzel. The Password Hashing Competition gave special recognition to Catena and three other schemes.
There are two instances: Catena-Dragonfly and Catena-Butterfly. Both can be used with the round-reduced version H' of Blake2b and also as FULL version.
Note: This version here is Catena v3.2. There is also a new version v3.3. The code will be updated later.

The latest Realease 1.52 of Bouncy Castle now contains a slightly modified version of this implementation of Bcrypt.
The latest Release 1.52 of Bouncy Castle now contains a slightly modified version of this implementation of Bcrypt.
It is only available here for comparison reasons.

There are test classes with test vectors for all password hashing schemes. For Catena there is also a performance test class (tests Blake2b and SHA512).

Digests:
## Digests

Blake2b is a cryptographic hash function, designed by Jean-Philippe Aumasson, Samuel Neves, Zooko Wilcox-O'Hearn, and Christian Winnerlein.
Blake2b is a cryptographic hash function, designed by Jean-Philippe Aumasson, Samuel Neves, Zooko Wilcox-O'Hearn, and Christian Winnerlein.

You can simply use it in this way:

Blake2b b = new Blake2b(); // no key, no salt, no personalization
b.update( anyByteArray1 );
b.update( anyByteArray2 );
byte[] hash = new byte[64];// full length of hash value
b.doFinal(hash, 0); // result now holds the hash value (64 byte)
```java
Blake2b b = new Blake2b(); // no key, no salt, no personalization
b.update( anyByteArray1 );
b.update( anyByteArray2 );
byte[] hash = new byte[64]; // full length of hash value
b.doFinal(hash, 0); // result now holds the hash value (64 byte)
```

You can also set a 16 byte salt value and a 16 byte personalization string.
The Tree Hashing Mode is not implemented. There is also a Java implementation of Joubin Mohammad Houshyar which includs the Tree Hashing Mode and a JCE-Provider. You can find it at:
The Tree Hashing Mode is not implemented. There is also a Java implementation of Joubin Mohammad Houshyar which includes the Tree Hashing Mode and a JCE-Provider. You can find it at:
https://github.com/alphazero/Blake2b

SHA512Digest is a modified version of Bouncy Castles SHA512Digest. It is only used for performance comparison.
SHA512Digest and LongDigest are under Bouncy Castles MIT-like license.
* SHA512Digest is a modified version of Bouncy Castles SHA512Digest. It is only used for performance comparison.
* SHA512Digest and LongDigest are under Bouncy Castles MIT-like license.

Author: Axel von dem Bruch

Expand Down