adac321938
Paket je nastao u asp-terminia/licence/ ali je sav posao serverski, pa se seli ovde. Firmverska strana je gotova od FW 0.10.0 i ne dira se. - docs/asp-terminia/ - 6 dokumenata: postojece stanje servera i FW klijenta, tacan API ugovor koji firmware ocekuje, zadaci Z1-Z6 sa kriterijumima prihvatanja, pravila rada na produkciji, enforcement pitanja E1-E6 - reference prepravljene: "ASP repo" = https://git.terminia.net/djuka/asp-terminia (ranije su pokazivale na lokalnu putanju D:\priv\... koja vise ne postoji) - CLAUDE.md: sekcija o cetvrtom proizvodu + pokazivac na paket ASP-Terminia se od ESIR/ARV/LIGHT_TICKET razlikuje po tome sto je machine_fingerprint MAC cipa (eFuse), a uredjaj radi offline - mrezna greska ne sme da ga obori. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
# API ugovor koji FIRMWARE očekuje (merodavno za server stranu)
|
|
|
|
> Ovo je ugovor kakav je VEĆ implementiran u firmveru (0.10.0+). Server strana se
|
|
> usklađuje sa OVIM (ili se promena dogovara pa se menja i firmware — nikad tiho).
|
|
|
|
## 1. Aktivacija
|
|
|
|
```
|
|
POST {licUrl}/activate
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"license_key": "ASP-XXXX-XXXX-XXXX",
|
|
"machine_fingerprint": "sha256:<sha256hex od 'AA:BB:CC:DD:EE:FF'>",
|
|
"app_version": "0.11.0",
|
|
"os": "esp32s3",
|
|
"hostname": "TERM-001"
|
|
}
|
|
```
|
|
|
|
Očekivan odgovor `200`:
|
|
|
|
```
|
|
{
|
|
"license": {
|
|
... polja licence, među njima:
|
|
"machine_fingerprint": "sha256:...", ← ako postoji, MORA biti otisak uređaja
|
|
"expires_at": "2027-01-01T00:00:00Z", ← ili prazno/odsutno = trajna
|
|
"grace_days": 14,
|
|
"edition": "...", "customer": "...", "license_id": "..."
|
|
},
|
|
"signature": "RSA-SHA256:<base64 potpisa nad SIROVIM bajtovima license objekta>"
|
|
}
|
|
```
|
|
|
|
**Kritično:** potpis se računa nad TAČNIM bajtovima `license` objekta onako kako su
|
|
poslati u HTTP telu (od `{` do para `}`). Firmware iseca taj isečak iz sirovog tela
|
|
(string-safe brojanje zagrada) i verifikuje. **Nikakvo „lepše" formatiranje odgovora
|
|
naknadno** — menja bajtove → lomi potpis.
|
|
|
|
## 2. Provera
|
|
|
|
```
|
|
POST {licUrl}/validate
|
|
{ "license_key": "...", "machine_fingerprint": "sha256:..." }
|
|
```
|
|
|
|
Očekivano: `{"valid": true/false, "expires_at": "...", "revoked": true/false}`.
|
|
Firmware tumači: `revoked` → poruka „licenca OPOZVANA na serveru"; `!valid` →
|
|
„server kaže da licenca ne važi". Mrežna/HTTP greška NE dira lokalno stanje.
|
|
|
|
## 3. Greške
|
|
|
|
HTTP ≠ 200 → firmware čita JSON polje `"error"` i prikazuje ga korisniku uz HTTP kod
|
|
(npr. `HTTP 403 (KEY_REVOKED)`). Poželjno je da server uvek vraća `{"error":"KOD"}`.
|
|
|
|
## 4. Ponašanje klijenta koje server sme da računa
|
|
|
|
- Klijent NIKAD ne šalje privatne podatke — samo gore navedena polja.
|
|
- Klijent poštuje odgovor samo ako je potpis valjan; HTTP 200 bez valjanog potpisa
|
|
se odbacuje (zaštita i od MITM na self-signed kanalu).
|
|
- Nakon uspešne aktivacije klijent NE zove server pri svakom startu — offline
|
|
verifikacija iz NVS. `validate` se zove ručno iz UI (kasnije: periodično uz sync).
|
|
|
|
## 5. Otvorena pitanja za usklađivanje (uneti odgovore ovde)
|
|
|
|
| # | Pitanje | Status |
|
|
|---|---|---|
|
|
| P1 | Tačna formula `machine_fingerprint` u Go kodu (ulazni string, velika/mala slova, dvotačke?) | ⬜ proveriti u kodu servera |
|
|
| P2 | Da li `activate` na VEĆ aktiviran ključ + ISTI fingerprint vraća licencu ponovo (re-aktivacija posle brisanja NVS) ili `ALREADY_ACTIVATED`? Za teren nam treba: isti uređaj sme ponovo. | ⬜ proveriti/podesiti |
|
|
| P3 | Tačan skup polja `license` objekta za ASP proizvod (limits/features imena) | ⬜ definisati uz Z1 |
|
|
| P4 | `expires_at` format (ISO8601?) — firmware poredi prvih 10 znakova (`YYYY-MM-DD`) | ⬜ potvrditi |
|