Skip to content

Commit 38872e9

Browse files
committed
docs: lotl quickstart guide
1 parent 75a2c63 commit 38872e9

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

tools/lotl/README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,23 @@ List of Trusted Lists (LoTL) producer and validator for the WP4 Trust Infrastruc
44

55
**JSON (LoTE) note:** the unsigned JSON from `json_generator.py` follows the ETSI TS 119 602-1 `1960201` JSON schema root shape (see [Task 3 implementation profile](../../task3-x509-pki-etsi/etsi_trusted_lists_implementation_profile.md)). Before signing, `produce` validates it with `lote_validate.py` using the vendored official ETSI full schema (`tools/lotl/schemas/1960201_json_schema.json`) plus semantic checks. `LOTE_JSON_SCHEMA` can override the schema path; the local subset schema remains a fallback.
66

7+
## Quick Start
8+
9+
```bash
10+
# 1) Create an ETSI-compliant signing certificate
11+
python -m tools.lotl.create_signing_cert
12+
13+
# 2) Produce and sign LoTL JSON + XML
14+
python -m tools.lotl \
15+
--tl-entries-dir lotl/tl_entries/ \
16+
--output-dir lotl/ \
17+
--signing-key lotl/certs/lotl_signing_key.pem \
18+
--signing-cert lotl/certs/lotl_signing_cert.pem
19+
20+
# 3) Validate input entries only (no signing)
21+
python -m tools.lotl --validate-only --tl-entries-dir lotl/tl_entries/
22+
```
23+
724
## Creating a Signing Certificate
825

926
The LoTL must be signed with an ETSI-compliant X.509 certificate. Use the provided command to generate a self-signed certificate:

0 commit comments

Comments
 (0)