Re-arrange motivation section of the README

Signed-off-by: Alek Ratzloff <alekratz@gmail.com>
This commit is contained in:
2024-05-30 12:03:31 -07:00
parent a28a39a63f
commit c0ebb960da

View File

@@ -27,16 +27,18 @@ No dependencies required, everything is vanilla Python >=3.10.
# Motivation
> If you see the picture is different, the key is different.
>
> If the picture looks the same, you still know nothing.
([From OpenSSH sshkey.c fingerprint_randomart() function](https://github.com/openssh/openssh-portable/blob/8054b906983ceaed01fabd8188d3dac24c05ba39/sshkey.c#L993))
Cryptographic hashes are often visually distinct, however, sometimes they are not. This can become
vitally important in matters of security, when you are comparing two key hashes or verifying the
checksum of a file from the internet. The goal of this project is to give more fuel for human
pattern recognition so that two extremely similar hashes, maliciously crafted or not, have more
visual depth to their distinction.
This is not a perfect solution. [From OpenSSH sshkey.c](https://github.com/openssh/openssh-portable/blob/8054b906983ceaed01fabd8188d3dac24c05ba39/sshkey.c#L993):
> If you see the picture is different, the key is different.
> If the picture looks the same, you still know nothing.
# Examples