python-tuf/examples/repository/README.md
Jussi Kukkonen b6465ddedf examples: Add missing link in repository README
Signed-off-by: Jussi Kukkonen <jkukkonen@google.com>
2023-02-08 10:53:59 +02:00

25 lines
1 KiB
Markdown

# TUF Repository Application Example
:warning: This example uses the repository module which is not considered
part of the python-tuf stable API quite yet.
This TUF Repository Application Example has the following features:
- Initializes a completely new repository on startup
- Stores everything (metadata, targets, signing keys) in-memory
- Serves metadata and targets on localhost (default port 8001)
- Simulates a live repository by automatically adding a new target
file every 10 seconds.
- Exposes a small API for the [uploader tool example](../uploader/). API POST endpoints are:
- `/api/role/<ROLE>`: For uploading new delegated targets metadata. Payload
is new version of ROLEs metadata
- `/api/delegation/<ROLE>`: For modifying or creating a delegation for ROLE.
Payload is a dict with one keyid:Key pair
### Usage
```console
./repo
```
Your repository is now running and is accessible on localhost, See e.g.
http://127.0.0.1:8001/metadata/1.root.json. The
[client example](../client/README.md) uses this address by default.