53 lines
1.8 KiB
Markdown
53 lines
1.8 KiB
Markdown
# CERT-Bund Offline Kit Seed Data
|
||
|
||
This directory stores **offline snapshots** for the CERT-Bund connector.
|
||
The artefacts mirror the public JSON search and export endpoints so
|
||
air‑gapped deployments can hydrate the connector without contacting the
|
||
portal.
|
||
|
||
> ⚠️ **Distribution notice** – CERT-Bund advisories are published by BSI
|
||
> (Federal Office for Information Security, Germany). Review the portal
|
||
> terms of use before redistributing the snapshots. Always keep the JSON
|
||
> payloads and accompanying SHA-256 sums together.
|
||
|
||
## Recommended layout
|
||
|
||
```
|
||
seed-data/cert-bund/
|
||
├── search/ # paginated search JSON files
|
||
│ ├── certbund-search-page-00.json
|
||
│ └── …
|
||
├── export/ # yearly export JSON files
|
||
│ ├── certbund-export-2014.json
|
||
│ └── …
|
||
├── manifest/
|
||
│ └── certbund-offline-manifest.json
|
||
└── certbund-offline-manifest.sha256
|
||
```
|
||
|
||
Use `certbund-offline-manifest.json` to feed the Offline Kit build: every
|
||
entry contains `source`, `from`, `to`, `sha256`, `capturedAt`, and the
|
||
relative file path. The manifest is deterministic when regenerated with
|
||
the tooling described below.
|
||
|
||
## Tooling
|
||
|
||
Run the helper under `tools/` to capture fresh snapshots or regenerate
|
||
the manifest:
|
||
|
||
```
|
||
python tools/certbund_offline_snapshot.py --output seed-data/cert-bund
|
||
```
|
||
|
||
See the connector operations guide
|
||
(`docs/ops/concelier-certbund-operations.md`) for detailed usage,
|
||
including how to provide cookies/tokens when the portal requires manual
|
||
authentication.
|
||
|
||
## Git hygiene
|
||
|
||
- JSON payloads and checksums are **ignored by Git**. Generate them
|
||
locally when preparing an Offline Kit bundle.
|
||
- Commit documentation, scripts, and manifest templates only – never the
|
||
exported advisory data itself.
|