README.md: imported from HTML doc.
This commit is contained in:
parent
7363315526
commit
a1eb0c69f1
1 changed files with 299 additions and 0 deletions
299
README.md
Normal file
299
README.md
Normal file
|
@ -0,0 +1,299 @@
|
|||
# CryptAfinity
|
||||
|
||||
1. Description
|
||||
1. Auteurs
|
||||
2. Pre-requis
|
||||
1. Sur un systeme Debian GNU/Linux
|
||||
2. Sur un systeme Apple MacOSX (≥10.3)
|
||||
3. Sur un systeme Microsoft Windows
|
||||
3. Se procurer CryptAfinity
|
||||
4. Utiliser CryptAfinity
|
||||
1. Compilation
|
||||
2. Utilisation
|
||||
5. Documentation
|
||||
1. Code
|
||||
2. Decodeur "Afine"
|
||||
3. Decodeur "Vigenere"
|
||||
|
||||
## 1. Description
|
||||
|
||||
CryptAfinity est un logiciel libre permettant de dechiffrer des texte
|
||||
obfusques par des systemes Afines ou l'algorithme de Vigenere. Il possede les
|
||||
caracteristiques suivantes :
|
||||
|
||||
* Il est distribue sous la licence [GNU General Public License](http://www.gnu.org/copyleft/gpl.html)
|
||||
* Il est ecrit en C++.
|
||||
* Il implemente pour l'instant uniquement une analyse par frequences, a partir d'une liste de "priorites" de lettres dans un texte clair, et de la proportion que representent les X premieres lettres "prioritaires" dans le texte.
|
||||
|
||||
### 1.1. Auteurs
|
||||
|
||||
CryptAfinity a ete entierement realise par Glenn ROLLAND
|
||||
<[glenux@glenux.net](mailto:glenux@glenux.net)> et Roland LAURÈS
|
||||
<[shamox@mac.com](mailto:shamox@mac.com)> a l'occasion de travaux pratiques du
|
||||
cours de systeme du Master 2 Ingenierie Informatique - Systèmes, Reseaux et
|
||||
Internet.
|
||||
|
||||
## 2. Pre-requis
|
||||
|
||||
CryptAfinity necessite les bibliotheques de fonctions suivantes (dans leur
|
||||
version de developpement si compilez le programme vous-meme):
|
||||
|
||||
* glib-2.0
|
||||
|
||||
### 2.1. Sur un systeme Debian GNU/Linux
|
||||
|
||||
Il vous suffit de taper (en tant qu'administrateur) les commandes suivantes
|
||||
pour installer le necessaire:
|
||||
|
||||
# apt-get install libglib-2.0-dev
|
||||
|
||||
### 2.2. Sur un systeme Apple MacOS X (>= 10.3)
|
||||
|
||||
Il est necessaire d'avoir installe les autotools (automake,
|
||||
autoconf...) dans leur derniere version. À partir de la, il
|
||||
suffit de taper les commandes suivantes dans un terminal :
|
||||
|
||||
# sudo fink install glib2-dev
|
||||
|
||||
### 2.3. Sur un systeme Microsoft Windows
|
||||
|
||||
Cela ne fut pas (encore) teste, mais il est tres probable que cela
|
||||
fonctionne sous Cygwin.
|
||||
|
||||
## 3. Se procurer CryptAfinity
|
||||
|
||||
Vous pouvez telecharger la derniere archive des sources, ou bien directement
|
||||
la version la plus recente du projet sur le depot Subversion du projet.
|
||||
|
||||
### 3.1. L'archive des sources
|
||||
|
||||
Elle est disponible a l'adresse :
|
||||
|
||||
[http://glenux2.free.fr/pub/projets/CryptAfinity/archives/](http://glenux2.fre
|
||||
e.fr/pub/projets/CryptAfinity/archives/)
|
||||
|
||||
### 3.2. Le depot Subversion
|
||||
|
||||
Afin d'obtenir les sources les plus a jour, vous pouvez utiliser le logiciel
|
||||
de controle de sources Subversion
|
||||
|
||||
$ svn checkout http://repository.glenux.ath.cx/svn/CryptAfinity/
|
||||
|
||||
Il n'y a pas de mot de passe, il suffit donc de presser la touche "Entree"
|
||||
pour l'utilisateur "anonymous", si ce dernier vous est demande.
|
||||
|
||||
## 4. Utiliser CryptAfinity
|
||||
|
||||
### 4.1. Compilation
|
||||
|
||||
Commencez par decompressez l'archive.
|
||||
|
||||
$ tar -xzvf CryptAfinity-0.1.tar.gz
|
||||
|
||||
Rendez vous ensuite dans le dossier qui vient d'etre cree lors de la
|
||||
decompression.
|
||||
|
||||
$ cd CryptAfinity-0.2
|
||||
|
||||
Puis lancez l'auto-configuration du logiciel, puis la compilation.
|
||||
|
||||
$ ./autogen
|
||||
|
||||
$ ./configure
|
||||
|
||||
$ make
|
||||
|
||||
Le programme sous forme binaire se trouvera alors dans le sous-dossier
|
||||
src/tools/, sous le nom break_afinity
|
||||
|
||||
### 4.2. Utilisation
|
||||
|
||||
CryptAfinity necessite de nombreux parametres, avec la syntaxe suivante:
|
||||
|
||||
Usage: break_afinity -a <fichier> -e <float> -f <float> -p <fichier> -t
|
||||
<fichier> -m
|
||||
|
||||
Ou les parametres sont les suivants: &nbs
|
||||
p_place_holder;
|
||||
|
||||
-a, --alphabet <file>
|
||||
Fichier contenant les lettres de l'alphabet, dans l'ordre.
|
||||
|
||||
|
||||
-e, --epsilon <float>
|
||||
Tolerance pour le test des clefs.
|
||||
|
||||
-f, --frequencies <float>
|
||||
Proportion moyenne que representent les 9 lettres "prioritaires" dans le texte
|
||||
clair.
|
||||
|
||||
-k, --keylength <int>
|
||||
Taille de la clef maximul (obsolete)
|
||||
|
||||
-p, --priorities <file>
|
||||
Lettres ordonnees par frequence decroissante d'apparition dans le texte clair.
|
||||
|
||||
-t, --text <file>
|
||||
Fichier contenant le texte chiffre.
|
||||
|
||||
-m, --mode <a|v>
|
||||
Selection du mode "Afine" ou "Vigenere"
|
||||
|
||||
## 5. Documentation
|
||||
|
||||
### 5.1. Code
|
||||
|
||||
Vous pouvez trouver la documentation du code de CryptAfinity dans le dossier
|
||||
doc/html de l'application, ou en suivant [ce lien](html/index.html).
|
||||
|
||||
### 5.2. Principe du "decodeur Afine"
|
||||
|
||||
On genere l'espace des clefs possibles pour l'alphabet donne
|
||||
en entree:
|
||||
|
||||
int alpha_size; //taille de l'alphabet
|
||||
|
||||
std::list<int> orb; // nombre premiers avec alpha_size
|
||||
|
||||
MathTools mt; // bibliotheque d'outils mathematiques
|
||||
|
||||
std::list<KeyAfine> keyList;
|
||||
|
||||
std::list<int>::iterator orbIt;
|
||||
|
||||
for (i=1; i<alpha_size; i++){
|
||||
|
||||
if (mt.pgcd(i,
|
||||
alpha_size) == 1) {
|
||||
|
||||
|
||||
orb.push_back(i);
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
// 1 - generer l'espace des 312 clefs
|
||||
|
||||
for (orbIt = orb.begin(); orbIt != orb.end(); orbIt++){
|
||||
|
||||
KeyAfine key;
|
||||
|
||||
|
||||
key.setCoefA((*orbIt));
|
||||
|
||||
for (i=0;
|
||||
i<alpha_size; i++){
|
||||
|
||||
|
||||
key.setCoefB(i);
|
||||
|
||||
|
||||
|
||||
keyList.push_back(key);
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
Puis on fait une attaque par analyse de frequence sur les textes obtenus par
|
||||
"decodage" du texte chiffre avec les clefs essayees.
|
||||
|
||||
float frequencies; // frequence cumulee des 9 lettres les
|
||||
plus presentes
|
||||
|
||||
float epsilon; // marge d'erreur
|
||||
|
||||
std::list<KeyAfine>::iterator kLIt;
|
||||
|
||||
for (kLIt = keyList.begin(); kLIt != keyList.end(); kLIt++){
|
||||
|
||||
float score = 0;
|
||||
|
||||
printf("Trying key
|
||||
%s\n", (*kLIt).toString().c_str());
|
||||
|
||||
|
||||
plainText =
|
||||
codec.decode(cypherText,
|
||||
*kLIt);
|
||||
|
||||
|
||||
plainText.setAlphabet(this->_config.getAlphabet());
|
||||
|
||||
for (int i=0; i<9;
|
||||
i++){
|
||||
|
||||
|
||||
score +=
|
||||
plainText.getCountOf(prio_conf[i]);
|
||||
|
||||
}
|
||||
|
||||
score = score /
|
||||
plainText.size();
|
||||
|
||||
if (fabs(score -
|
||||
frequencies) < epsilon){
|
||||
|
||||
printf("KEY =
|
||||
%s\n",(*kLIt).toString().c_str());
|
||||
|
||||
|
||||
printf("PLAIN TEXT(%f) = %s\n", fabs
|
||||
(score-frequencies),
|
||||
|
||||
|
||||
plainText.toAlphabet().c_str());
|
||||
|
||||
}
|
||||
|
||||
|
||||
}
|
||||
|
||||
### 5.3. Principe du "decodeur Vigenere"
|
||||
|
||||
On commence par faire recuperer les groupes de carateres qui se repetent dans
|
||||
le texte.
|
||||
|
||||
|
||||
Une fois les groupes repetes de lettres de plus grande longueur obtenus (dans
|
||||
l'ordre decroissant en fonction de la longueur), on calcule la distance
|
||||
separant les deux premiers groupes (note d1) puis la distance entre les deux
|
||||
suivant (d2).
|
||||
|
||||
On pose K = PGCD(d1, d2). Il est fortement probable que K soit un multiple de
|
||||
la longueur de la clef. L'hypothese sous-jacente est que ces groupes de
|
||||
lettres sont issue du chiffrement des memes bouts de mots avec les memes bouts
|
||||
de la clef. Si le K = 1 on peut raisonnablement supposer que ce n'est pas le
|
||||
cas, et qu'il n'y a pas de repetitions.
|
||||
|
||||
|
||||
L'etape suivante consiste a faire une analyse de frequence en decoupant le
|
||||
texte en K colonnes. On classe ensuite les lettres
|
||||
apparaissant dans les colonnes en fonction de leur nombre d'apparitions.
|
||||
|
||||
Dans un monde utopique, il suffirait de calculer la distance entre la lettre
|
||||
apparaissant le plus souvent dans la colonne, et celle apparaissant le plus
|
||||
souvent dans le langage attendu pour le texte clair (l'anglais en
|
||||
l'occurrence).
|
||||
|
||||
Cependant il arrive frequemment que l'ordre de lettre soit legerement change
|
||||
par rapport au resultat attendu. Dans le programme, on calcule donc pour
|
||||
chaque colonne les distances entre les X lettres les plus frequentes dans la
|
||||
colonne et la lettre la plus frequente dans le langage.
|
||||
|
||||
On genere ensuite un espace de X ^ K clefs a partir des combinaisons de ces
|
||||
differents decalages obtenus sur chaque colonne.
|
||||
|
||||
|
||||
Enfin, on decode ensuite le texte avec chacune des clef generees, et en
|
||||
fonction de donnees statistiques relative a notre connaissance prealable du
|
||||
texte et d'une petite marge d'erreur, on filtre les texte dechiffres.
|
||||
|
||||
(Exemple: les 9 lettres les plus frequentes representent 70% du texte, et on
|
||||
une marge de +/- 4%).
|
||||
|
||||
En jouant sur la marge d'erreur, on laisse passer plus ou moins de textes
|
||||
dechiffres, parmi lesquels devrait se trouver le texte clair attendu.
|
||||
|
Loading…
Reference in a new issue