Use plain Mermaid diagrams again and drop the SVG images
The preview problems were caused by the diagram text, which is now fixed in every copy, so the pre-rendered SVGs (white background, harder to keep in sync) are no longer needed. Also updates docker/docs with the fixed text. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 27 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 25 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 25 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 26 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 25 KiB |
@@ -39,10 +39,6 @@ Mosquitto does **not** require passwords: with `allow_anonymous true` on a dedic
|
||||
|
||||
Only the backend may subscribe to `enroll/request/+`. Devices cannot publish to response topics.
|
||||
|
||||

|
||||
|
||||
<details><summary>Mermaid source of this diagram</summary>
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant B as Board
|
||||
@@ -61,8 +57,6 @@ sequenceDiagram
|
||||
B->>M: reconnect as FN / pw
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
- `sig` = Ed25519 signature by the backend over `S`, `B`, `n1`, and the Client ID. It stops a man in the middle from substituting their own key.
|
||||
- The password is never transmitted. First successful FN login is the enrollment acknowledgement.
|
||||
- Plaintext passwords are never stored; Dynamic Security keeps a hash, so re-issue means rotate.
|
||||
@@ -94,10 +88,6 @@ The database is authoritative for ownership. A successful broker command alone d
|
||||
|
||||
The board's credential is created once at enrollment and never changes. Activation only changes which roles the FN client holds.
|
||||
|
||||

|
||||
|
||||
<details><summary>Mermaid source of this diagram</summary>
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant O as Operator
|
||||
@@ -113,8 +103,6 @@ sequenceDiagram
|
||||
B->>M: use device/[SN]/... topics
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
- **Roles:** one assignment role per machine, `machine-<SN>`, with **literal** topics such as `device/SN000123/sales/report`. `%u` cannot express the SN here because the username is the FN. Plus shared capability roles (`vending`, `news`, `updates`).
|
||||
- **Backend** subscribes with wildcards (`device/+/...`), takes the SN from the topic, and checks in the database that this SN is assigned to the publishing board.
|
||||
- **Replacing a board for SN000123:** disable and kick `FN-old`, remove its roles; the new board enrolls as a new FN; activation attaches `machine-SN000123` to the new FN. The role's ACL text is unchanged; only which client holds it changes.
|
||||
@@ -124,10 +112,6 @@ sequenceDiagram
|
||||
|
||||
At activation the board gets a second, machine-level broker identity. The same X25519 exchange is reused.
|
||||
|
||||

|
||||
|
||||
<details><summary>Mermaid source of this diagram</summary>
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant O as Operator
|
||||
@@ -146,8 +130,6 @@ sequenceDiagram
|
||||
G->>M: disable FN client (or keep for rescue / re-enrollment)
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
- **One shared role** `vending-device` with `device/%u/...`, because the username equals the SN in the topic.
|
||||
- Use a **fresh** keypair on the board at each activation, not the enrollment one.
|
||||
- **Bind the SN client's Client ID** to the current board (for example its FN) with `setClientId`, if the deployed version supports it. A copied SN password is then useless from any other device, and the binding is readable with `getClient`.
|
||||
|
||||
@@ -111,10 +111,6 @@ Role `enroll` (assigned to the anonymous group):
|
||||
|
||||
### 7.2 Protocol
|
||||
|
||||

|
||||
|
||||
<details><summary>Mermaid source of this diagram</summary>
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant B as Board
|
||||
@@ -132,8 +128,6 @@ sequenceDiagram
|
||||
B->>B: persist FN and pw to flash, then reconnect as FN
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
- `sig` = Ed25519 over `S || B || n1 || clientid || FN`. Binding the FN and the Client ID means a reply for another request, board or identity does not verify.
|
||||
- The password is **hex of HKDF-SHA256(shared secret, salt = n1, info = "robot-market/mqtt-pw/v1|" + FN, 32 bytes)**. The label separates this use of the secret from any other.
|
||||
- The first successful FN login is the enrollment acknowledgement.
|
||||
@@ -161,10 +155,6 @@ The board logs in as `FN`, Client ID `FN`, with the derived password, sends `boa
|
||||
|
||||
### 9.2 Flow
|
||||
|
||||

|
||||
|
||||
<details><summary>Mermaid source of this diagram</summary>
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant O as Operator (UI)
|
||||
@@ -185,8 +175,6 @@ sequenceDiagram
|
||||
G->>G: DB: ACTIVE, disable the FN client, audit
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### 9.3 Rules that make it safe
|
||||
1. **SAS bound to the activation key.** The board shows a code derived from `B2` (and `n2`, FN). The operator compares it with what the backend received. An attacker who stole an FN password and sends a request with their own key produces a code that does not match what the real board displays. **This check is mandatory**, not optional; without it the operator could attach a stranger's FN to a real SN.
|
||||
2. **Activation code** (from the existing activation flow): single use, expiring, bound to one SN, attempt-limited. It proves the operator is physically at the machine.
|
||||
|
||||
Reference in New Issue
Block a user