Hardwareveiligheid: wat Kshana met hardware doet en wat het nooit doet

Status: juridische beoordeling door de eigenaar nog in behandeling. De juridische opmerkingen hieronder zijn de lezing van de beheerders van openbare bronnen, geschreven zodat een gebruiker weet waar de grenzen liggen. Het is geen juridisch advies, ze zijn niet beoordeeld door een jurist en de wet verschilt per land. Lees ze als reden om een jurist te raadplegen, niet als toestemming.

Adviserende software voor onderzoek, simulatie en test. Het is geen typegoedgekeurde apparatuur en beoordeelt of keurt geen ontvanger, klok of laboratorium goed. Zie de adviserende verklaring in de README.

De regel#

Ontvangen is het product. Zenden zit nooit in de open engine.

• Kshana bevat geen code die een zender aanstuurt. Er is geen zendpad voor SDR (geen zendaanroep van UHD, HackRF, bladeRF of Soapy), en er wordt geen jamming- of spoofinggolfvorm geschreven naar een bestand dat bedoeld is om te worden afgespeeld.
• Bestanden die Kshana schrijft (IQ-scènes, SigMF- en ION-.sdrx-opnamen, NMEA- en bench-exports) beschrijven gesimuleerde, legitieme signalen of bewegingen, en de metadata die Kshana voor een scène schrijft vermeldt dat zij door kshana iq scene is geschreven (de ION-.sdrx-opmerking zegt dat het een gesimuleerde scène is en geen opname).
• Waar een experiment RF op een bench nodig heeft, wordt die geproduceerd door de eigen apparatuur van de exploitant, in de eigen behuizing van de exploitant, onder de eigen machtiging van de exploitant. Kshana legt vast wat de exploitant zegt te hebben gedaan en leidt dat nooit zelf af.

Fasen#

Elke fase noemt wat Kshana doet, welke hardware erbij betrokken is, wie RF uitzendt (als iemand dat doet) en de voorwaarde die moet gelden voordat Kshana het resultaat als bewijs behandelt.

"Geleverd" betekent dat de code in deze release zit. Niets in deze tabel zegt dat een fase met een partner, laboratorium of autoriteit is gebruikt; dat is niet gebeurd.

Principes#

1. Ontvangen is het product en zenden zit nooit in de open code.
2. Elke hardwaresessie levert een bewijspakket op met hashes van de invoer, de omstandigheden en de gebruikte drempels.
3. Een attestatie van geleide of afgeschermde opstelling wordt vastgelegd en nooit afgeleid.
4. Getallen die van hardware komen blijven MODELLED totdat een onafhankelijke externe referentie ermee instemt (bijvoorbeeld een referentietraject van een laboratorium of een referentieklok). Een vooraf vastgelegde drempel wordt na een run niet versoepeld.
5. Antennes met gestuurde patronen, inertiële eenheden en atoomklokken op chipschaal worden behandeld als gegevensbronnen (patronen, logboeken, gepubliceerde stabiliteitscurves) en niet als apparaten die Kshana aanstuurt.
6. Formulering: een resultaat is "gemeten tegen het masker" of "levert bewijs voor" een eis. Kshana zegt niet dat een apparaat aan een norm voldoet, en niemand heeft het beoordeeld of goedgekeurd.

Juridische opmerkingen (juridische beoordeling door de eigenaar nog in behandeling)#

GNSS-signalen ontvangen is bijna overal legaal. Zenden in GNSS-banden is dat niet.

• Verenigde Staten. Opzettelijke interferentie met radiocommunicatie is verboden krachtens 47 U.S.C. §333, en de FCC treedt op tegen jammers (https://www.fcc.gov/general/jammer-enforcement). Een uitzending vanaf een bench kan verder reiken dan de bench.
• Elders. De beheerders hebben de wetgeving van andere landen niet beoordeeld. De gemeenschap rond gps-sdr-sim stelt dat het uitzenden van de uitvoer ervan in de meeste landen bij wet verboden is; beschouw dat als de werkhypothese overal waar een jurist niets anders heeft gezegd.
• Een afgeschermde of geleide opstelling is een waarborg, geen vergunning. De attestatie hieronder legt de waarborg vast die volgens de exploitant aanwezig was. Ze maakt een uitzending niet rechtmatig.
• Opnemen. Het opnemen van radiosignalen kan op sommige plaatsen vragen over privacy en wettigheid oproepen. iq monitor --follow en elk opnamerecept zijn uitsluitend ontvangend, en de exploitant is verantwoordelijk voor waar en wat hij opneemt.
• Exportcontrole. Hardware-in-the-loop-software die signaalgeneratoren aanstuurt, kan onder exportcontroleregels vallen. Daarom valt fase 3 buiten de open engine.
• Niets hier is een onderschrijving of een overeenkomst. Geen toezichthouder, testterrein, laboratorium of leverancier is over dit document geraadpleegd of is het eens met iets daarin.

Het veld lab-attestation#

Voor fase 2 en hoger bevat een run waarbij laboratoriumapparatuur is gebruikt een object lab-attestation, vastgelegd in het bewijspakket naast de hashes van de invoer. Het is een verklaring van een genoemde exploitant, geen meting, en Kshana verifieert haar niet.

[lab-attestation]                                     # or the same keys at the top level of the file
operator = "name or role of the person responsible"   # required
organisation = "laboratory or company"                # required
date = "2026-11-02"                                   # required, the day of the session
setup = "conducted"                                   # required: "conducted" or "shielded"
attenuation_db = 60.0                                 # required for "conducted": total, emitter to device
enclosure = "RF-shielded box, model and ID"           # required for "shielded"
emitter = "laboratory-owned simulator, model"         # required: what produced any RF
statement = "No emission outside the enclosure or cable path."   # required, free text
signature = "ed25519:..."                             # optional: the operator's own detached signature, recorded as given

Wat in 0,38 is geïmplementeerd:

• kshana receiver-trust evidence ... --lab-attestation <file.toml> valideert het bestand en legt de attestatie vast in de manifest.json van het pakket. Het manifest valt onder de Ed25519-handtekening van het pakket, zodat de vastlegging niet kan worden gewijzigd zonder de verificatie te breken. Hetzelfde is beschikbaar als het argument lab_attestation van de Python-functie evidence_create en het argument lab_attestation_toml van het MCP-hulpmiddel create_evidence_pack (de browserbuild maakt geen pakketten).
• Een pakket zonder attestatie is byte voor byte gelijk aan wat het eerder was.
• kshana evidence verify meldt de attestatie en zegt dat ze "bevestigd is door de genoemde exploitant; niet geverifieerd door Kshana".
• Een attestatie die onvolledig is, of waarvan setup noch conducted noch shielded is (een opstelling via de lucht wordt niet als labrun geaccepteerd), wordt geweigerd en er wordt geen pakket gemaakt.

Wat nog niet is geïmplementeerd: de regel van fase 2 dat Kshana weigert een labrun zonder attestatie te scoren. Geen enkele opdracht kent in 0,38 een vlag voor labruns, dus er valt niets te weigeren; de regel komt met de opdrachten voor laborganisatie. Een attestatie legt de verklaring van de exploitant over een waarborg vast. Ze maakt geen enkele uitzending rechtmatig en wijzigt het label van een resultaat niet: een gescoorde labrun is MODELLED, tenzij een externe referentie ermee instemt.

Wat dit betekent voor een bijdrager#

• Voeg geen zendpad, geen zendafhankelijkheid en geen zendvoorbeeld toe aan de open engine.
• Voeg geen golfvormgenerator toe waarvan de uitvoer een jamming- of spoofingsignaal is dat bedoeld is om te worden afgespeeld.
• Nieuwe hardware-ingangen zijn standaard alleen lezend; schrijven vereist een expliciete vlag en een regel in dit bestand.
• Een nieuwe opdracht die hardware aanraakt, komt op elk oppervlak of wordt met een reden als N/A gemarkeerd in SURFACES.md, en vermeldt hier haar fase.