---
title: "Erste Schritte mit JASCON"
description: "Einen nationalen Katalog im Browser öffnen, den Referenzvalidator ausführen, eine erste Anforderung schreiben, OSCAL importieren, die Risikoabdeckung berechnen und den Skill für Coding-Agenten installieren. Jeder Schritt dauert Minuten."
lang: de
url: https://jascon.net/de/start.html
---

Erste Schritte

# Vom Browser-Tab zum validierten Bundle

Sieben Schritte, in der Reihenfolge, in der die meisten sie gehen. Der erste braucht einen Browser. Der zweite braucht Python oder einen Windows-Rechner. Keiner braucht ein Konto, einen Server oder einen Lizenzschlüssel.

## Einen Katalog öffnen, den Sie kennen

Die App lädt ein Bundle über einen Link und behält es in Ihrem Browser. Beginnen Sie mit dem Framework, mit dem Sie arbeiten: Der Objektbrowser bildet seine Filter aus den Daten, deshalb bietet SP 800-53 Familien und Baselines an und Grundschutz++ Modalverben, Schutzziele und Zielobjekte.

| Korpus | Objekte | Typen | Lizenz des Inhalts |  |
|---|---|---|---|---|
| AU.ISMInformation Security ManualAustralian Signals Directorate | 1.731 | 1.150 Requirements · 581 RequirementSets1.150 Controls; Baselines nach Einstufung und Essential Eight als Sets | [CC BY 4.0](https://jascon.net/converted_examples/AU.ISM/SOURCE-LICENSE.md) | [In der App öffnen](https://jascon.net/app/index.html#load=../converted_examples/AU.ISM/ism-core-bundle/&tool=browse) |
| DE.BSIGrundschutz++ AnwenderkatalogBSI, Deutschland | 1.289 | 1.000 Requirements · 289 RequirementSetsFließtext auf Deutsch, Satzgrammatik und Schutzziele als Facetten | [CC BY-SA 4.0](https://jascon.net/converted_examples/DE.BSI/SOURCE-LICENSE.md) | [In der App öffnen](https://jascon.net/app/index.html#load=../converted_examples/DE.BSI/bsi-core-bundle/&tool=browse) |
| US.CSFCybersecurity Framework 2.0NIST | 226 | 185 Requirements · 41 RequirementSetsFunktionen, Kategorien und Unterkategorien als verschachtelte Sets | [CC0 1.0](https://jascon.net/converted_examples/US.CSF/SOURCE-LICENSE.md) | [In der App öffnen](https://jascon.net/app/index.html#load=../converted_examples/US.CSF/csf-core-bundle/&tool=browse) |
| US.IFA-GoodReadOSCAL-Beispielsystem (SSP, Plan, Ergebnisse, POA&M)NIST, fiktive Inhalte | 16 | 6 Components · 3 Implementations · 2 Findings · 2 Requirements · 2 Risks · 1 AssessmentDie Lebenszyklustypen von Component bis Attestation, mit zwei Risks | [CC0 1.0](https://jascon.net/converted_examples/US.IFA-GoodRead/SOURCE-LICENSE.md) | [In der App öffnen](https://jascon.net/app/index.html#load=../converted_examples/US.IFA-GoodRead/ifa-core-bundle/&tool=assess) |
| US.SP800-53SP 800-53 Rev 5.2.0 mit den Baselines aus 800-53BNIST | 1.221 | 1.196 Requirements · 25 RequirementSetsParameter mit Geltung je Aussage; vier Baselines als Mitgliedschafts-Sets | [CC0 1.0](https://jascon.net/converted_examples/US.SP800-53/SOURCE-LICENSE.md) | [In der App öffnen](https://jascon.net/app/index.html#load=../converted_examples/US.SP800-53/sp800-53-core-bundle/&tool=browse) |

Das Beispiel-Bundle des Handbuchs enthält ein Objekt jedes Typs, darunter ein Risk, zwei Tailorings und zwei Checks: [das Beispiel-Bundle öffnen](https://jascon.net/app/index.html#load=../jascon/examples/&tool=browse). Es gibt außerdem einen [Reader als Einzeldatei](https://jascon.net/reader/index.html) ohne umgebenden Ordner; laden Sie ihn herunter und ziehen Sie einen Bundle-Ordner darauf.

## Den Referenzvalidator ausführen

Der Validator führt die 822 Konformitätsvektoren aus und prüft danach jedes Objekt der mitgelieferten Bundles erneut mit beiden Digests. Die letzte Zeile lautet `ALL GREEN` oder listet jeden Fehlschlag mit seiner Regel und seinem Grund auf.

Übergeben Sie einen oder mehrere Bundle-Ordner, um eigene Inhalte zu validieren. `--require-risk-basis` macht aus einer ausgewählten Anforderung ohne begründendes Risiko einen Fehlschlag.

Unter Windows erledigt der PowerShell-Zwilling dasselbe mit PowerShell 5.1, ohne dass etwas installiert werden muss. Er braucht Minuten, wo Python Sekunden braucht.

*Python, mit uv*

```sh
git clone https://github.com/christoph-puppe/JASCON.git
cd JASCON
uv run --no-project --with jsonschema python jascon/scripts/validate_core.py
```

*Python, mit pip*

```sh
pip install jsonschema
python jascon/scripts/validate_core.py
# Ihr eigenes Bundle:
python jascon/scripts/validate_core.py path/to/your-bundle
```

*Windows PowerShell 5.1, ohne Installation*

```sh
powershell -ExecutionPolicy Bypass -File jascon\scripts\validate_core.ps1
```

## Eine erste Anforderung schreiben

Wählen Sie ein Präfix unter einer Domain, die Sie kontrollieren, und behalten Sie es bei. Kennungen werden als Zeichenketten verglichen und nie abgerufen, deshalb muss unter der Adresse nichts ausgeliefert werden.

Teilen Sie den Text dort in Aussagen auf, wo sich die Verbindlichkeit, die verpflichtete Partei oder ein Parameter ändert. Deklarieren Sie jeden Parameter mit einem Typ und verweisen Sie im Fließtext mit `{param:name}` darauf.

Die Seite Durchsehen (Browse) der App hat dafür ein Formular unter „Write requirements and sets“. Es deklariert die Parameter, die es im Fließtext findet. Die Seite Übersicht (Home) exportiert den Arbeitsbestand als Bundle mit Manifest und beiden Digests je Objekt.

[Handbuch, Kapitel 4: Anforderungen schreiben](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch04-writing-requirements.md)

*req-backup-1.json — ein erfundenes Beispiel*

```json
{
  "id": "https://grc.your.example/req/BACKUP-1",
  "version": "2026-11",
  "label": "BACKUP-1",
  "lifecycle": "active",
  "statements": [
    { "id": "s1",
      "modality": "must",
      "obligated-parties": ["https://grc.your.example/party/operations"],
      "parameters": [
        { "name": "restore-interval", "type": "duration" }
      ],
      "prose": {
        "en": "A restore from backup is tested at least every {param:restore-interval}.",
        "de": "Eine Wiederherstellung aus dem Backup wird mindestens alle {param:restore-interval} getestet."
      } }
  ]
}
```

## Bringen Sie Ihr OSCAL mit und nehmen Sie es wieder mit

Die Seite Importieren (Import) der App liest einen OSCAL-Katalog oder ein OSCAL-Profil und meldet jede Regel, die sie angewandt hat. Regelsätze gibt es für Grundschutz++, SP 800-53 und CIS Benchmarks; ein Katalog anderer Form läuft durch die generischen Regeln, die das, wofür der Kern kein Feld hat, in einer Facette unter Ihrem Namespace bewahren und nichts verwerfen, ohne dass der Bericht eine Zeile dazu enthält. Für die Stapelverarbeitung enthält das Repository elf Konverter in Python, einen je gemessenem Korpus, auf Basis einer gemeinsamen Bibliothek.

In der Gegenrichtung schreibt `export_oscal.py` Kataloge in OSCAL 1.2.2. Die Exporte der mitgelieferten Bundles liegen daneben unter `converted_examples/*/oscal-export/`. Wofür OSCAL kein Konstrukt hat (Modalität, verpflichtete Parteien, überlappende Mitgliedschaft), reist in Props mit Namespace mit und kommt beim Import zurück.

[Die Seite Importieren (Import) öffnen](https://jascon.net/app/index.html#import)

## Risiken ergänzen und die Abdeckung berechnen

Laden Sie einen Katalog, wählen Sie mit einem Tailoring eine Baseline aus und schreiben Sie auf der Seite Risiko (Risk) die Risiken, die die Auswahl begründen. Die Ansicht Abdeckung (Coverage) listet jede ausgewählte Anforderung auf, die kein bewertetes Risiko nennt.

Zwei prototypische Risikokataloge helfen beim ersten Durchgang: 24 typische Risiken der Büro-IT und 23 einer Industrieanlage, auf Englisch und Deutsch, jeweils mit vorgeschlagenen Controls aus SP 800-53. Der Import kopiert einen Eintrag in ein eigenes Risk; die Entscheidung bleibt bei Ihnen.

[Die Risikokataloge und ihre Grenzen](https://github.com/christoph-puppe/JASCON/blob/main/risk-catalogs/README.md)

*einen Katalog in Ihr Bundle importieren*

```sh
python3 risk-catalogs/tools/risk_catalog.py import risk-catalogs/office-it \
    --bundle path/to/your-bundle \
    --org https://grc.your.example \
    --owner https://grc.your.example/party/ciso \
    --out path/to/risks
```

## Eine maschinelle Prüfung schreiben

Für eine technische Regel schreiben Sie auf der Seite Prüfungen (Checks) der App einen Check (Kern 2.0.0, Release-Kandidat): die Fakten, die ein Kollektor meldet, die Vergleiche, die entscheiden, und den Code des Kollektors in bash, sh, Python, PowerShell, Ansible oder als HTTP-Anfrage. Ein Sprachmodell kann Checks entwerfen, Regel für Regel oder für jede automatisierte Regel eines CIS-Imports, sobald Sie einen Schlüssel eingeben. Jeder Entwurf wird von den Kernregeln und einem Lint, der nur liest, beurteilt, und Sie entscheiden, was gespeichert wird. Die App führt keine Kollektoren aus.

[Die Seite Prüfungen (Checks) mit dem Beispiel öffnen](https://jascon.net/app/index.html#load=../jascon/examples/&tool=checks) [Wie ein Check entscheidet](https://jascon.net/de/checks.html)

## Die Empfehlungen eines Herstellers aufnehmen

Ein Empfehlungspaket ist eine Datei, die ein Hersteller veröffentlicht: Components mit Empfehlungen zu benannten Anforderungen (Kern 2.0.0, Release-Kandidat). Die Seite Übersicht (Home) der App zeigt, was ein Paket enthält, bevor etwas geschrieben wird, sagt, ob sein Herausgeber behauptet, attestiert oder belegt ist, und gibt nach dem Import eine Quittung aus. Auf der Seite Umsetzen (Implement) machen Sie das Produkt zum Mitglied Ihres Systems und übernehmen eine Empfehlung als Ihre eigene Kante. Dieselbe Datei ein zweites Mal schreibt nichts.

Das Beispielpaket ist fiktiv und mit einem öffentlichen Testschlüssel signiert. Noch hat kein Hersteller ein Paket veröffentlicht.

[Vorschau des Beispielpakets in der App](https://jascon.net/app/index.html#load=../jascon/example-packs/dbvendor-server-7-advice/) [Wie ein Paket funktioniert](https://jascon.net/de/model.html#advice)

### Für Hersteller: ein Paket schreiben

Der Paket-Builder ist eine einzelne HTML-Datei, die offline läuft. Sie beschreiben Ihr Produkt und jede Empfehlung in einem Formular; die Seite prüft das Paket mit denselben Regeln, die der Import beim Kunden ausführt, signiert die Ausgabe mit Ihrem Ed25519-Schlüssel oder bereitet die Bytes für openssl oder Ihren Signaturdienst vor und schreibt das ZIP. Ist der Katalog geladen, bietet sie die Klauseln und Parameter jeder Anforderung an und prüft jeden vorgeschlagenen Wert. Eine OSCAL-Komponentendefinition, die Sie bereits haben, wird als Entwurf importiert, mit einem Bericht darüber, was sich nicht zuordnen ließ.

[Den Paket-Builder öffnen](https://jascon.net/pack-builder/index.html) [Als einzelne Datei herunterladen](https://jascon.net/pack-builder/index.html)

## Mit einem Coding-Agenten arbeiten

Der Ordner `jascon/` ist ein Skill für Claude: das Handbuch als vierzehn nummerierte Anforderungen, das Kernschema, die Konformitätsvektoren, die Konverter und ein ausgearbeitetes Beispiel-Bundle. Ein Agent, der ihn hat, schreibt Objekte gegen das Schema und lässt den Validator über seine eigene Ausgabe laufen.

Die Arbeitsteilung ist dieselbe wie in der App: Ein Modell entwirft, die Kernregeln entscheiden, ein Mensch nimmt an.

*den Skill installieren*

```sh
# für Ihren Benutzer
cp -r jascon ~/.claude/skills/jascon
# oder für ein einzelnes Projekt
cp -r jascon .claude/skills/jascon
```

Lesepfade

## Erst Kapitel 2, dann je nach Rolle

Das Handbuch hat fünfzehn Kapitel und sieben Anhänge. Alle lesen Kapitel 2, das eine Stunde dauert. Danach trennen sich die Wege.

[Kapitel 3 bis 8, dann 14 Sie veröffentlichen ein Framework Identität und Namespaces, Aussagen, Sets und Baselines, Tailoring, Facetten, Mappings. Dann die Migrations-Playbooks, sobald es um einen echten Katalog geht.](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch03-identity-versions-lifecycle.md) [Kapitel 3, 12, 13, 11 Sie bauen ein Tool Identität für das mentale Modell, dann das Validator-Kapitel und sicheres Einlesen. Integrität, bevor irgendetwas mit einer Signatur in Berührung kommt.](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch12-building-a-validator.md) [Kapitel 9, 10, 11, 15 Sie betreiben, prüfen oder kaufen Systeme und Vererbung, Prüfung und Abweichungen, was eine Signatur beweist und was Sie aufgrund eines Konformitätsanspruchs verlangen dürfen.](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/ch09-systems-components-inheritance.md)

Referenz: [die Formen, Feld für Feld](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/appendix-a-shapes.md) · [das Kernschema](https://github.com/christoph-puppe/JASCON/blob/main/jascon/schemas/jascon-2.0.0.schema.json) · [Einwände und Antworten](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/appendix-f-objections.md) · [Glossar](https://github.com/christoph-puppe/JASCON/blob/main/jascon/references/appendix-g-glossary.md)
