Align AOC tasks for Excititor and Concelier
This commit is contained in:
@@ -1,52 +1,52 @@
|
||||
# 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 `src/Tools/` to capture fresh snapshots or regenerate
|
||||
the manifest:
|
||||
|
||||
```
|
||||
python src/Tools/certbund_offline_snapshot.py --output seed-data/cert-bund
|
||||
```
|
||||
|
||||
See the connector operations guide
|
||||
(`docs/modules/concelier/operations/connectors/certbund.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.
|
||||
# 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 `src/Tools/` to capture fresh snapshots or regenerate
|
||||
the manifest:
|
||||
|
||||
```
|
||||
python src/Tools/certbund_offline_snapshot.py --output seed-data/cert-bund
|
||||
```
|
||||
|
||||
See the connector operations guide
|
||||
(`docs/modules/concelier/operations/connectors/certbund.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.
|
||||
|
||||
Reference in New Issue
Block a user