Fichiers
radio/Protocole VERCORS/README.md
T
2026-10-11 01:55:11 +02:00

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 :

  1. L'époque d'origine des semaines n'est pas définie (ADR 0007). Un uint16 ne 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.
  2. 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.
  3. 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_domain existe 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_seconds
  • vc_imu.h / imu_stub.c — accéléromètre, drapeau de chute
  • vc_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.