Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
3.7 KiB
3.7 KiB
SecuBox Master-Link
Integration securisee en maillage pour les appliances SecuBox. Un noeud maitre genere des jetons d'adhesion a usage unique, sert le bundle IPK secubox et approuve les nouveaux pairs via une confiance basee sur la blockchain. Supporte la hierarchie gigogne (imbriquee) ou les noeuds approuves peuvent devenir des sous-maitres.
Apercu
MAITRE (profondeur 0)
├── Pair A (profondeur 1)
├── Sous-Maitre B (profondeur 1)
│ ├── Pair C (profondeur 2)
│ └── Pair D (profondeur 2)
└── Pair E (profondeur 1)
Installation
opkg install secubox-master-link luci-app-master-link
Configuration
# /etc/config/master-link
config master-link 'main'
option enabled '1'
option role 'master' # master | peer | sub-master
option upstream '' # IP du maitre amont (pairs/sous-maitres)
option depth '0' # profondeur gigogne (0 = maitre racine)
option max_depth '3' # profondeur d'imbrication maximale
option token_ttl '3600' # validite du jeton en secondes
option auto_approve '0' # approuver automatiquement les demandes
option ipk_path '/www/secubox-feed/secubox-master-link_*.ipk'
Protocole d'Adhesion
- Le maitre genere un jeton — jeton HMAC-SHA256 a usage unique avec TTL
- Le nouveau noeud ouvre la page d'accueil —
http://<maitre>:7331/master-link/?token=... - Le nouveau noeud telecharge l'IPK — telechargement valide par jeton via
/api/master-link/ipk - Le nouveau noeud envoie une demande d'adhesion — empreinte + adresse soumises au maitre
- Le maitre approuve — echange de cles TOFU, bloc blockchain enregistre, pair ajoute au maillage
- Optionnel : promouvoir en sous-maitre — le pair approuve peut integrer ses propres pairs
Points de Terminaison CGI
Tous servis sur le port 7331 sous /api/master-link/.
| Point | Methode | Auth | Description |
|---|---|---|---|
/token |
POST | Local uniquement | Generer un jeton d'adhesion |
/join |
POST | Jeton | Soumettre une demande d'adhesion |
/approve |
POST | Local uniquement | Approuver/rejeter un pair |
/status |
GET | Public/Local | Statut du maillage |
/ipk |
POST | Jeton | Telecharger l'IPK secubox |
API RPCD
ubus call luci.master_link status '{}'
ubus call luci.master_link peers '{}'
ubus call luci.master_link tree '{}'
ubus call luci.master_link token_generate '{}'
ubus call luci.master_link approve '{"fingerprint":"...","action":"approve"}'
ubus call luci.master_link approve '{"fingerprint":"...","action":"reject","reason":"..."}'
ubus call luci.master_link approve '{"fingerprint":"...","action":"promote"}'
ubus call luci.master_link token_cleanup '{}'
Types de Blocs Blockchain
| Type | Description |
|---|---|
join_request |
Nouveau noeud demandant a rejoindre |
peer_approved |
Maitre a approuve le pair |
peer_rejected |
Maitre a rejete le pair |
peer_promoted |
Pair promu en sous-maitre |
token_generated |
Audit : jeton cree |
Securite
- Jetons : HMAC-SHA256, usage unique, duree limitee (defaut 1h)
- TOFU : La premiere adhesion etablit la confiance via l'echange d'empreintes
- Limitation de profondeur :
max_depthempeche l'imbrication illimitee - Integrite de la chaine : Toutes les actions enregistrees comme blocs blockchain
- Piste d'audit : Cycle de vie des jetons et evenements des pairs interrogeables via la chaine
Dependances
secubox-p2p— reseau maille et blockchainopenssl-util— generation de jetons HMACcurl— notification des pairs
Licence
Apache-2.0