---
title: "Kanonisierung (JCS): Definition | KYA-Glossar"
url: https://knowyouragent.ch/wissen/glossar/kanonisierung
lang: de-CH
updated: 2026-10-12
license: © Innopulse Consulting GmbH
---

# Kanonisierung (JCS)

Kanonisierung bringt Daten in eine eindeutige, festgelegte Darstellung, damit Hashwerte und Signaturen unabhängig von Formatierung immer gleich ausfallen; für JSON beschreibt RFC 8785 das JSON Canonicalization Scheme (JCS).

Dasselbe JSON-Objekt lässt sich auf viele Arten schreiben: mit anderer Reihenfolge der Felder, mit Leerzeichen, mit verschiedenen Zahlendarstellungen. Für Menschen ist das gleich, für einen Hashwert nicht. Kanonisierung legt eine einzige Darstellung fest, etwa sortierte Felder und keine überflüssigen Leerzeichen. RFC 8785 beschreibt das für JSON, die Signaturbasis nach RFC 9421 erfüllt dieselbe Aufgabe für HTTP-Anfragen.

Für Nachweise ist Kanonisierung die Voraussetzung, dass ein Hash, etwa in einem Manifest oder einer [Beleg-Kette](https://knowyouragent.ch/wissen/glossar/beleg-kette), bei jeder [Prüfstelle](https://knowyouragent.ch/wissen/glossar/pruefstelle) gleich nachgerechnet werden kann.

## Beispiel

Eine Beleg-Kette speichert für jeden Eintrag den Hash über die kanonische Form des Vorgängers. Formatiert ein System die Einträge später um, bleibt die kanonische Form gleich, und die Kette lässt sich weiterhin prüfen. Ändert jemand einen Betrag, ändert sich der Hash, und die Kette bricht.

## Abgrenzung

Kanonisierung ändert keine Inhalte, sondern nur die Darstellung. Eine Signatur schützt die kanonische Form; eine Signaturbasis nach RFC 9421 ist die kanonische Form einer HTTP-Anfrage.

## In der Praxis

- Hashen und signieren Sie JSON immer in kanonischer Form, nie in der zufälligen Ausgabe einer Bibliothek.
- Dokumentieren Sie, welches Verfahren der Kanonisierung Sie verwenden.
- Testen Sie mit Daten in verschiedener Formatierung, ob der Hash gleich bleibt.

## Bezug zu KYA

KYA berechnet Hashwerte in Nachweispaketen, Beleg-Ketten und den reportDigest des Prüfscheins über kanonische Formen. Deshalb ergibt dieselbe Eingabe überall denselben Wert.

Zugehöriger Prüfschritt: [Kryptografische Integrität](https://knowyouragent.ch/methode/pruefschritte) (`cryptographic_integrity`). Sind Signaturen, Disclosures, Hash-Ketten und Manifest unverändert?

[Jetzt prüfen: passendes Beispiel öffnen](https://knowyouragent.ch/pruefen?beispiel=manipuliert)

## Häufige Fragen

### Was ist Kanonisierung?

Das Überführen von Daten in eine eindeutige Darstellung, damit Hashwerte und Signaturen unabhängig von Formatierung gleich ausfallen.

### Was ist JCS?

Das JSON Canonicalization Scheme nach RFC 8785. Es legt fest, wie JSON eindeutig geschrieben wird, etwa mit sortierten Feldern und festen Zahlendarstellungen.

### Warum braucht es Kanonisierung bei Nachweisen?

Weil ein Hash sonst bei jeder Umformatierung anders ausfällt. Nur mit einer kanonischen Form kann jede Prüfstelle denselben Wert nachrechnen.

### Ist die Signaturbasis nach RFC 9421 auch eine Kanonisierung?

Ja, im Kern. Sie legt fest, welche Teile einer HTTP-Anfrage in welcher Form signiert werden.

### Wo nutzt KYA Kanonisierung?

Bei Manifesten von Nachweispaketen, bei Beleg-Ketten und beim reportDigest des Prüfscheins, der sich dadurch reproduzierbar nachrechnen lässt.

### Welche Fehler treten bei der Kanonisierung häufig auf?

Unterschiedliche Darstellungen von Zahlen, Unicode-Zeichen in verschiedenen Formen und Bibliotheken, die Felder nicht sortieren. Tests mit absichtlich unterschiedlich formatierten Daten decken solche Fehler früh auf.

## Quellen

- [RFC 8785: JSON Canonicalization Scheme (JCS)](https://www.rfc-editor.org/rfc/rfc8785)
- [RFC 9421: HTTP Message Signatures](https://www.rfc-editor.org/rfc/rfc9421)

## Verwandte Begriffe

- [Nachweispaket](https://knowyouragent.ch/wissen/glossar/nachweispaket)
- [Beleg-Kette](https://knowyouragent.ch/wissen/glossar/beleg-kette)
- [HTTP Message Signatures (RFC 9421)](https://knowyouragent.ch/wissen/glossar/http-message-signatures)
- [X.509-Zertifikat](https://knowyouragent.ch/wissen/glossar/x509-zertifikat)

---
Quelle: https://knowyouragent.ch/wissen/glossar/kanonisierung · KYA – Know Your Agent