12 KiB
VERCORS — prototype x86-64 en assembleur
Variable Encryption Rendez-vous Clock-Over-Radio System — écosystème Gastinel Frame, boîtiers radio bas-débit 169 MHz en montagne.
Cette passe est un prototype x86-64 sur PC, pas la cible finale. Objectif : valider la logique du protocole en assembleur pur avant portage STM32U5 (Cortex-M33, Thumb-2).
Construire et exécuter
./build.sh
Sans argument, le script détecte la plate-forme : win64 sous MinGW/MSYS,
elf64 ailleurs. On peut forcer : ./build.sh elf64 ou ./build.sh win64.
Puis :
./build/test_vercors.exe
Choix de build. Pas de Makefile : make n'est pas installé sur la machine
de développement, et le projet ne compte qu'une dizaine d'unités de compilation. Un
script sh sans dépendance coûte moins cher à maintenir qu'un Makefile qu'on
ne peut pas exécuter. Les fonctions assembleur sont appelées depuis un harnais
C compilé avec gcc — c'était le seul moyen de confronter le code aux vecteurs
officiels FIPS/NIST, ce qui était l'enjeu principal de cette passe.
État actuel : 86 tests, tous au vert.
Ce qui est fait
Cryptographie — assembleur pur, aucune dépendance externe
Pas d'OpenSSL, pas de libsodium, pas une ligne de C dans le chemin cryptographique.
| Module | Contenu | Validation |
|---|---|---|
asm/sha256.asm |
SHA-256 complet (init/update/final + one-shot) | 4 vecteurs FIPS 180-4, dont 1 Mo, plus l'équivalence incrémental/one-shot |
asm/aes256.asm |
AES-256 logiciel, chiffrement + mode CTR | FIPS 197 C.3, NIST SP 800-38A F.5.5, bloc partiel, retenue de compteur |
asm/const_time.asm |
Comparaisons et sélections à temps constant | Écarts en tête et en fin de zone, bornes non signées |
asm/csprng.asm |
DRBG maison à base de SHA-256 | Déterminisme, divergence, cohérence de préfixe |
Protocole — points spécifiés
| Point du cahier des charges | État |
|---|---|
| [2] Heure Cible | Fait — SHA-256 → 4 octets big-endian → méthode de rejet → uniforme sur 0–86399 |
| [4] Gating temporel avant déchiffrement | Fait — rejet sans lancer AES, rendu en masque |
| [7] Bourrage aléatoire à 64 octets | Fait — bruit CSPRNG |
| [8] Chiffrement/déchiffrement AES-256 CTR | Fait — compteur avancé et chaîné |
Protocole — points sur hypothèses
Ces quatre points ne reposent pas sur une spécification. Le manifeste Gastinel Frame ne descend pas à ce niveau de détail. Les constructions ci-dessous viennent d'hypothèses de travail, complétées ici par des choix d'encodage. Chacune est documentée en ADR avec le statut hypothèse provisoire. Rien de tout cela ne doit être déployé sans validation.
| Point | Construction retenue | ADR |
|---|---|---|
| [1] Grain de Sel Temporel | SHA256(K_M ‖ BE16(semaine ISO) ‖ BE32(compteur anti-rejeu)) — ne transite jamais par la radio |
0007 |
| [3] Fenêtre de Garde | Élargissement linéaire calé sur la dérive du quartz (20 ppm), plafonné à 30 s, resserrement immédiat | 0008 |
| [5] Bascule de clé | Chaînage : clé N+1 chiffrée sous la clé N avant d'être logée dans le bourrage | 0009 |
| [6] Cold Start | Déclenchement local : reboot, ou 7 jours sans paquet valide → repli sur K_M | 0010 |
Trois points méritent d'être lus avant d'aller plus loin :
- L'époque d'origine des semaines n'est pas définie (ADR 0007).
Un
uint16ne porte pas d'année : « semaine 36 » est ambigu. Deux implémentations partant d'origines différentes dérivent des grains différents et ne se parleront jamais — sans erreur visible, juste un silence radio permanent. - La bascule de clé fait tomber la charge utile de 63 à 31 octets les jours de renouvellement. Une clé AES-256 occupe la moitié d'une trame de 64 octets : c'est arithmétique. À confirmer que 31 octets suffisent.
- La séparation de domaine des compteurs CTR n'est pas négociable
(ADR 0009). Sans elle, le
créneau de clé et la trame partageraient un flot de clé sous la même clé du
jour, ce qui révélerait la clé N+1.
vc_ctr_set_domainexiste pour rendre cette contrainte explicite plutôt que laissée à la discipline de l'appelant.
Clé Maîtresse d'Usine
asm/factory_key.asm contient un placeholder de test valant littéralement
PLACEHOLDER-NE-PAS-UTILISER-PROD, en ASCII lisible pour qu'un dump mémoire
crie ce qu'il est. Cette clé est publique : elle vit en clair dans un fichier
versionné.
TODO PORTAGE — ce n'est pas un simple remplacement de constante. Sur cible,
K_M vivra dans l'élément sécurisé STSAFE-A110. Les octets de la clé ne
doivent alors jamais transiter par la RAM du STM32U5, sinon l'élément sécurisé
ne sert à rien. L'API devra donc passer d'une exposition de clé
(vc_factory_key retourne un pointeur) à une API par opération, le STSAFE
faisant le calcul lui-même : vc_derive_grain(km, ...) deviendra
vc_derive_grain_stsafe(week, counter, out), sans paramètre de clé. C'est la
différence structurante entre ce prototype et la cible, et le premier point à
traiter au portage. Détail dans l'ADR 0010.
Couche d'abstraction matérielle
hal/ — stubs en C, comme demandé, avec des .h définissant l'interface
pérenne que le portage STM32U5 devra honorer :
vc_radio.h/radio_stub.c— bouclage mémoire tenant lieu de transceiver 169 MHz ;vc_radio_send,vc_radio_recv,vc_radio_last_rx_secondsvc_imu.h/imu_stub.c— accéléromètre, drapeau de chutevc_baro.h/baro_stub.c— pression, température
Chaque stub expose en plus une ou deux fonctions *_stub_* absentes des
en-têtes : ce sont des points de contrôle réservés au harnais de test
(déplacer l'horloge d'arrivée, armer une chute). Le code protocolaire ne les
appelle jamais, et la cible ne les aura pas.
Confirmation demandée sur la trame
L'octet d'en-tête (longueur + drapeau de bascule) est déjà à l'intérieur du
chiffré : vc_frame_pad / vc_frame_build construisent les 64 octets en
clair, puis l'appelant chiffre le bloc entier en AES-256-CTR. Ni la
longueur ni le drapeau ne circulent en clair sur l'air, et toutes les trames
font 64 octets quel que soit leur contenu — l'exigence d'indifférenciabilité du
cas C est satisfaite. Aucune correction n'était nécessaire ; l'ADR 0006 a été
reformulé pour que ce soit explicite plutôt que déductible.
Point ouvert : aucune authentification de trame
CTR ne fournit aucune intégrité. Un attaquant peut retourner des bits arbitraires du clair sans être détecté. Le gating temporel filtre l'inondation, pas la falsification ciblée.
La bascule de clé aggrave l'enjeu : sans MAC, un attaquant ne peut pas choisir la clé N+1, mais il peut la corrompre, et provoquer une désynchronisation permanente des deux extrémités avec un seul bit retourné. L'authentification n'est pas un raffinement ici — c'est ce qui empêche un déni de service définitif à coût nul.
Il manque donc un MAC (HMAC-SHA-256 tronqué, ou AES-CMAC) ou un mode AEAD. Le SHA-256 nécessaire est déjà présent dans ce dépôt. C'est la place du MAC dans les 64 octets qui reste à décider — et le budget est serré les jours de bascule, où il ne reste que 31 octets utiles. Voir ADR 0003 et ADR 0009.
Écarts par rapport au cahier des charges, et pourquoi
| Écart | Justification |
|---|---|
| Cible Win64 exécutable en plus d'ELF64/System V | WSL n'est pas installé : assembler en ELF sans pouvoir exécuter aurait produit du code jamais lancé, alors que l'objet de la passe est de valider. Une abstraction d'ABI (include/abi.inc) rend les mêmes sources valides dans les deux formats. System V reste la cible de référence. ADR 0001 |
| AES logiciel, pas AES-NI | Le prompt l'autorisait à condition de le signaler ; le choix inverse a été fait pour que le code testé soit celui qui sera porté. ADR 0002 |
| Pas de Makefile | make absent de la machine ; six unités de compilation. |
| Disposition interne de la trame | Hypothèse explicite faute de manifeste, isolée dans quatre fonctions. ADR 0006, 0009 |
| Points [1] [3] [5] [6] | Implémentés sur hypothèses, pas sur spécification. Chaque ADR concerné porte le statut hypothèse provisoire. ADR 0007 à 0010 |
ADR/CHANGELOG : conventions non reprises de server-infra |
Le prompt demande la cohérence avec server-infra, mais ce dépôt ne contient ni CHANGELOG ni ADR (vérifié). Format MADR standard retenu par défaut ; à réaligner si une convention existe ailleurs. |
Ce qui devra être réécrit pour Cortex-M33
Le découpage a été fait pour que cette liste soit courte et localisée. La
logique — planning de message SHA-256, S-box AES, MixColumns, méthode de
rejet, construction du DRBG — est portable telle quelle.
| Élément x86-64 | Équivalent / travail Thumb-2 |
|---|---|
include/abi.inc en entier |
À remplacer par un équivalent AAPCS (arguments dans r0-r3). Aucune logique protocolaire n'y réside. |
r8d..r15d pour l'état SHA-256 (a..h) |
Thumb-2 n'a que r0-r12 utilisables : il faudra spiller une partie de l'état sur la pile. |
bswap |
rev |
ror 32 bits |
ror — portable tel quel |
rep movsb / rep stosb / rep stosq |
Boucles explicites |
div (reste modulo 86400) |
Le M33 n'a pas de division entière avec reste sur 64 bits : udiv + mls, ou réduction par soustractions à temps constant |
sbb reg, reg (masque depuis la retenue) |
sbc r, r, r |
cmovb |
it/mov conditionnel, ou arithmétique de masque |
Demi-registre haut ah dans SUBWORD |
Pas d'équivalent : ubfx / bfi |
Tableau W de 256 octets sur la pile (SHA-256) |
À vérifier vis-à-vis de la taille de pile des tâches embarquées |
| Amorçage du CSPRNG | À câbler sur le TRNG matériel du STM32U5 — point de vérification obligatoire de la revue de portage |
asm/factory_key.asm en entier |
Disparaît : K_M passe dans l'élément sécurisé STSAFE-A110, avec changement de forme d'API. ADR 0010 |
xchg al, ah (encodage BE16 du grain) |
Pas d'équivalent : rev16, ou ubfx/bfi |
Aucune extension SIMD, AES-NI ou SHA-NI n'est utilisée nulle part.
Arborescence
asm/ sha256, aes256, const_time, csprng,
vercors_protocol (points 2, 4, 7, 8)
vercors_keysched (points 1, 3, 5, 6 -- hypotheses)
factory_key (placeholder K_M, disparait au portage)
include/ abi.inc (macros d'ABI), vercors.h (interface C)
hal/ stubs radio / IMU / baromètre, en C
test/ harnais de cycle complet
docs/adr/ décisions d'architecture numérotées
build.sh assemblage et édition de liens
Sécurité — ce qui est garanti et ce qui ne l'est pas
Garanti : comparaisons de secrets à temps constant (const_time.asm,
aucun saut conditionnel sur une valeur secrète) ; effacement non optimisable
des tampons sensibles ; gating temporel strictement antérieur à AES ; bourrage
en bruit et non en zéros.
Garanti aussi : séparation de domaine des compteurs CTR entre trame et créneau de clé ; clé N+1 jamais en clair, même avant le chiffrement de trame ; fenêtre de garde bornée quoi qu'il arrive, y compris horloge qui recule.
Non garanti : résistance au timing de cache d'AES logiciel (ADR 0002, assumé pour cette cible) ; intégrité/authenticité des trames sous CTR (ADR 0003 et 0009, ouvert) ; qualité de l'entropie d'amorçage, qui dépend de l'appelant (ADR 0004) ; protection de K_M, qui n'existe pas sur ce prototype (ADR 0010).
Non validé : les quatre constructions [1] [3] [5] [6] sont des hypothèses. Elles sont cohérentes et testées, mais rien ne dit qu'elles correspondent au protocole VERCORS réel.