Documentation
HashTag est une boîte à outils cryptographique qui fonctionne entièrement dans ton navigateur. Ce guide explique les notions essentielles et comment utiliser chaque outil.
Prise en main
- Va sur Clés et génère une paire OpenPGP « Ed25519 + X25519 » protégée par une passphrase.
- Télécharge ta clé privée et range-la en lieu sûr (gestionnaire de mots de passe, clé USB chiffrée).
- Connecte-toi avec Discord (facultatif) et publie ta clé publique pour apparaître dans l'annuaire.
- Pour écrire à quelqu'un, ouvre son profil puis « Chiffrer pour… ». Seul le destinataire pourra lire le message.
Clé publique, clé privée
Une paire de clés fonctionne comme un cadenas et sa clé. La clé publique (le cadenas) se partage librement : n'importe qui peut l'utiliser pour chiffrer un message pour toi. La clé privée (la clé du cadenas) reste secrète : elle seule permet de déchiffrer et de signer.
Toutes les clés ne servent pas à la même chose : Ed25519 et ECDSA servent à signer,X25519 sert à établir un secret partagé (chiffrement), RSA peut faire les deux. Une clé OpenPGP moderne combine une clé de signature Ed25519 et une sous-clé de chiffrement X25519.
Chiffrer un message
Avec un mot de passe
Le mot de passe est transformé en clé par Argon2id (64 Mio de mémoire, 3 passes) ou PBKDF2-SHA256 (600 000 itérations), puis le contenu est chiffré en AES-256-GCM. Transmets le mot de passe par un autre canal que le message.
Pour des destinataires
HashTag génère une clé de session aléatoire, chiffre le contenu une seule fois, puis protège cette clé de session pour chaque destinataire avec sa clé publique OpenPGP. Chacun déchiffre avec sa propre clé privée.
Avec une clé SSH ou age
Tu peux aussi chiffrer pour une clé ssh-ed25519, ssh-rsa ou une identité age (age1…, ou age1pq1… pour la version post-quantique ML-KEM-768 + X25519). Le résultat est un fichier au format standardage, que le destinataire peut aussi ouvrir avec l'outil age en ligne de commande. Une clé SSH Ed25519 est une clé de signature : age la convertit explicitement en clé X25519, de façon documentée.
Lien de partage
Un message chiffré peut être partagé sous forme de lien. Le message chiffré est placé après le # de l'adresse : cette partie n'est jamais envoyée au serveur. Le lien ne contient jamais de clé ni de mot de passe, et HashTag ne stocke rien.
Déchiffrer
Colle le message ou dépose le fichier : le format est détecté. Pour OpenPGP, HashTag affiche les identifiants des clés auxquelles le message est destiné. Le résultat n'est affiché qu'après vérification complète de l'intégrité : un message modifié ou tronqué est refusé.
Signer et vérifier
Une signature prouve que le message vient du détenteur de la clé privée et n'a pas été modifié. Elle ne cache pas le contenu. HashTag produit des signatures OpenPGP en clair (texte) ou détachées (fichiers), ainsi que des signatures Ed25519, ECDSA P-256 et RSA-PSS encodées en Base64.
Annuaire et vérification des clés
Se connecter avec Discord prouve que tu contrôles un compte Discord, pas que tu possèdes une clé. Une clé est donc d'abord « déclarée ». En signant un défi avec ta clé privée depuis Mes clés, elle devient « vérifiée » : tu as prouvé détenir la clé privée correspondante.
Même une clé vérifiée peut appartenir à un compte Discord compromis. Pour les échanges sensibles, compare l'empreinte avec ton correspondant par un canal indépendant (appel, rencontre). Un changement de clé principale apparaît dans l'historique.
Format de fichier HashTag v1
Les messages chiffrés par mot de passe utilisent un conteneur binaire documenté et versionné :
en-tête "HTAG" | version=1 | kdf | paramètres kdf | sel (16) | préfixe nonce (7) | taille de bloc (u32) | options (1)
méta longueur (u32) | AES-256-GCM(JSON { kind, name, type, size })
bloc i AES-256-GCM(données) nonce = préfixe | i (u32) | dernier (0/1)L'en-tête entier est authentifié avec chaque bloc. Le compteur empêche de réordonner les blocs, le drapeau « dernier » détecte la troncature. Les blocs font 64 Kio : un fichier de plusieurs Go est traité sans le charger entièrement en mémoire. En texte, le conteneur est encodé en Base64 entre -----BEGIN HASHTAG ENCRYPTED MESSAGE----- et la ligne END.
Compatibilité
| Format | Compatible avec |
|---|---|
| OpenPGP | GnuPG, Thunderbird, Kleopatra, ProtonMail, Sequoia |
| Signatures PEM | OpenSSL, Web Crypto, la plupart des langages |
| Conteneur HashTag | HashTag (spécification ouverte ci-dessus) |
| age (X25519, post-quantique, passphrase, SSH Ed25519 / RSA) | age, rage, typage — age -d -i ~/.ssh/id_ed25519 fichier.age |