Fehlercodes
Beide Bauformen melden Fehler mit einem Code. Die L4Re-Bauform verwendet Zahlen, die Windows-Bauform Namen; die beiden Listen sind nicht deckungsgleich. Diese Seite nennt jeden Code mit dem Anlass, bei dem der Dienst ihn heute sendet, und mit der Reaktion, die auf der anfragenden Seite sinnvoll ist.
L4Re-Bauform
Der Code steht in den ersten 4 Byte der Nutzdaten einer Fehlerantwort; siehe Binärprotokoll der L4Re-Bauform.
| Wert | Konstante | Anlass | Reaktion |
|---|---|---|---|
| 1 | WVDS_ERR_INVALID_HEADER | Kopf, Länge, Stufe oder ein Längenfeld der Nutzdaten ungültig; HKDF-Ausgabe über 1024 Byte oder leeres IKM | Anfrage korrigieren |
| 2 | WVDS_ERR_INVALID_REQ_TYPE | unbekannter, reservierter oder nicht eingebauter Anfragetyp | Typ prüfen, Bauoptionen des Dienstes prüfen |
| 3 | WVDS_ERR_INVALID_KEY_ID | key_id ungleich 0 bei WVDS_REQ_DERIVE_KEY | key_id auf 0 setzen |
| 4 | WVDS_ERR_KEY_NOT_FOUND | WVDS_REQ_EXPORT_KEY für eine unbekannte Kennung oder für einen Schlüssel ohne öffentlichen Teil | Kennung prüfen; nach einem Neustart neu erzeugen |
| 5 | WVDS_ERR_ENCRYPTION_FAILED | AES- oder ChaCha20-Verschlüsselung gescheitert, auch bei unbekannter Kennung oder wiederholter Nonce; ML-KEM-Kapselung gescheitert | Kennung und Nonce prüfen |
| 6 | WVDS_ERR_DECRYPTION_FAILED | Entschlüsselung gescheitert, auch bei falschem Tag oder unbekannter Kennung; ML-KEM-Entkapselung gescheitert | Daten als nicht vertrauenswürdig behandeln |
| 7 | WVDS_ERR_SIGNATURE_FAILED | Signieren gescheitert, auch bei unbekannter Kennung | Kennung prüfen |
| 8 | WVDS_ERR_VERIFICATION_FAILED | Prüfung nicht durchführbar, etwa wegen unbrauchbarem öffentlichem Schlüssel | Daten als nicht geprüft behandeln |
| 9 | WVDS_ERR_INVALID_SIGNATURE | derzeit nicht gesendet; eine ungültige Signatur meldet 0x11 als Ergebnis 0 | – |
| 10 | WVDS_ERR_ALLOCATION_FAILED | kein Platz für die Antwort im geteilten Speicher | später wiederholen |
| 65535 | WVDS_ERR_INTERNAL | Schlüsselerzeugung, Ableitung oder Senden gescheitert, auch bei voller Schlüsselablage | Protokoll des Dienstes prüfen |
Der Code ist ein 32-Bit-Feld; die Werte selbst passen in 16 Bit.
Windows-Bauform
Der Name steht im Feld error.code der Antwort; siehe
JSON-Protokoll der Windows-Bauform.
| Name | Anlass |
|---|---|
INVALID_REQUEST | Zeile ist kein gültiges JSON, unbekannte operation, fehlendes Feld oder ungültiges Base64 |
INVALID_KEY | öffentlicher Schlüssel nicht als Base64 lesbar |
INVALID_NONCE | Nonce bei aes_decrypt nicht genau 12 Byte |
INVALID_TAG | Tag bei aes_decrypt nicht genau 16 Byte |
KEY_NOT_FOUND | unbekannte Kennung bei aes_encrypt und aes_decrypt; export_public_key für eine unbekannte Kennung oder einen AES-Schlüssel |
DECRYPTION_FAILED | Tag passt nicht; die Daten sind verändert oder der Schlüssel ist falsch |
SIGNATURE_INVALID | Signaturprüfung nicht durchführbar; eine ungültige Signatur meldet valid: false ohne Fehler |
UNSUPPORTED_ALGORITHM | unbekanntes Verfahren oder unbekannte Stufe |
RATE_LIMIT_EXCEEDED | mehr als 60 000 Anfragen in 60 Sekunden |
INTERNAL_ERROR | alle übrigen Fehler, auch unbekannte Kennung bei ml_dsa_sign und ml_kem_decapsulate, wiederholte Nonce und volle Schlüsselablage |
Die Namen NONCE_REUSED, TIMEOUT und SUCCESS sind definiert, werden aber derzeit nicht gesendet.
Verwandte Themen
de/wiki/pqcrypt/svc/reference/error-codes.txt · Zuletzt geändert: von Wolfgang van der Stille