🔐 Kryptografische Block-Signaturen

• Regulatorische Compliance (qualifizierte elektronische Signatur)
• Rechtlicher Nachweis der Datenerstellung
• Erweiterte Audit-Trail und Rückverfolgbarkeit
• Nicht-Abstreitbarkeit von Transaktionen

❌ Ohne Partnersignatur — das Problem

Am 15. Januar liefert SupplyPro Komponenten. TechCorp erfasst selbst einen Block: "Lieferung erhalten: 500 Einheiten, Ref. ABC-789".

Drei Monate später schickt SupplyPro eine Rechnung für 800 Einheiten und behauptet, diese Menge geliefert zu haben. TechCorp zeigt Blöcke mit "500 Einheiten"... aber SupplyPro argumentiert, dass TechCorp diese Blöcke selbst erstellt hat. Nichts hinderte TechCorp daran, 500 statt 800 einzutragen, um die Rechnung zu reduzieren. Es steht Aussage gegen Aussage.

Das Problem: Wenn Sie die Daten im Namen Ihres Partners erfassen, beweist nichts, dass der Partner mit dem Eingetragenen einverstanden war.

✅ Mit Partnersignatur — die Lösung

SupplyPro generiert sein ECDSA-Schlüsselpaar mit @sowasit/signer und registriert es bei TechCorp. Von nun an erstellt und signiert SupplyPros eigenes System jeden Bestätigungsblock: "Lieferung bestätigt: 500 Einheiten, Ref. ABC-789". Optional kann TechCorp eine Version des Blocks erneut veröffentlichen, die es selbst signiert, um den Empfang zu bestätigen. Über einen Webhook wird der Zusteller benachrichtigt und die Lieferung ist abgesichert.

Drei Monate später schickt SupplyPro dennoch eine Rechnung für 800 Einheiten. TechCorp zeigt den von SupplyPro selbst signierten Block, der 500 gelieferte Einheiten bescheinigt. SupplyPros kryptografische Signatur ist da, verifizierbar und unwiderruflich — SupplyPro kann nicht behaupten, 800 geliefert zu haben.

Im Streitfall präsentiert TechCorp die von SupplyPro signierten Blöcke. Der Beweis ist kryptografisch unwiderlegbar und rechtlich durchsetzbar: SupplyPro hat die Zahl selbst zertifiziert.

npm install -g @sowasit/signer

npm install @sowasit/signer

signer add-key \
  --token YOUR_ENROLLMENT_TOKEN \
  --api-key YOUR_API_KEY \
  --passphrase your-secret-passphrase \
  --output ./keys \
  --client-name "Your Company Name" \
  --client-contact "admin@company.com"

1. Das generierte Zertifizierungsdokument drucken (sowasit.certification.txt)
2. Es signieren und stempeln (rechtliche Signatur Ihres Unternehmens)
3. Es als PDF scannen
4. Es über die API oder das Dashboard hochladen

signer create-block \
  --chain ch_abc123 \
  --key ./keys/sowasit.private.pem \
  --key-id f1a2b3c4d5e6f7g8 \
  --api-key sk_your_api_key \
  --content-file ./data.json \
  --passphrase your-secret-passphrase

signer sign \
  --key ./keys/sowasit.private.pem \
  --data ./content.json \
  --passphrase secret \
  --output ./signature.json

signer create-block \
  --chain ch_abc123 \
  --key ./keys/sowasit.private.pem \
  --key-id f1a2b3c4 \
  --api-key sk_xxx \
  --content '{"order": "ORD-001", "status": "shipped"}' \
  --passphrase secret

import { KeyManager } from '@sowasit/signer';

// Generate key pair
const keyPair = await KeyManager.generateKeyPair({
  passphrase: 'your-secret-passphrase'
});

// Save to disk
await KeyManager.saveKeyPair(keyPair, './keys', 'my-company');

console.log('Key ID:', keyPair.keyId);
console.log('Fingerprint:', keyPair.fingerprint);

import { KeyManager } from '@sowasit/signer';

const content = {
  transaction_id: 'TXN-001',
  amount: 1500.00,
  timestamp: Date.now()
};

const privateKey = await KeyManager.loadPrivateKey(
  './keys/my-company.private.pem',
  'your-passphrase'
);

const { signature, algorithm } = KeyManager.signContent(
  content,
  privateKey
);

console.log('Signature:', signature);

import { SoWasItClient } from '@sowasit/signer';
import fs from 'node:fs/promises';

const client = new SoWasItClient({
  apiKey: 'sk_your_api_key'
});

const content = {
  event: 'product_shipped',
  order_id: 'ORD-12345',
  timestamp: Date.now()
};

const privateKeyPem = await fs.readFile('./keys/my-company.private.pem', 'utf-8');

const response = await client.createSignedBlock(
  'ch_your_chain_id',
  content,
  privateKeyPem,
  'your_public_key_id',
  'your-passphrase'
);

console.log('Block created:', response.block);

🔒 Schutz privater Schlüssel

• Verwenden Sie immer eine Passphrase, um Ihren privaten Schlüssel zu verschlüsseln
• Committen Sie niemals private Schlüssel in Git
• Speichern Sie Schlüssel in einem Passwort-Manager oder HSM
• Private Schlüssel werden automatisch mit Berechtigungen 0600 gespeichert

🔄 Schlüsselrotation

• Generieren Sie regelmäßig neue Schlüssel (alle 6-12 Monate)
• Verwenden Sie den Ersetzungsmechanismus während der Rotation
• Widerrufen Sie alte Schlüssel nach der Migration

⚠️ Im Falle einer Kompromittierung

• Widerrufen Sie sofort den kompromittierten Schlüssel
• Generieren Sie ein neues Schlüsselpaar
• Benachrichtigen Sie bei Bedarf das SoWasIt-Team

curl -X POST https://api.sowasit.io/v1/keys/enrollment-tokens \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {
      "authorized_by": "admin@company.com"
    },
    "validity_days": 7
  }'

curl -X POST https://api.sowasit.io/v1/keys/register \
  -H "Content-Type: application/json" \
  -d '{
    "enrollment_token": "abc123...",
    "public_key": "-----BEGIN PUBLIC KEY-----\n...",
    "algorithm": "ECDSA-P-256",
    "client_info": {
      "name": "My Company SARL",
      "siret": "12345678901234",
      "contact": "admin@company.com"
    }
  }'

curl https://api.sowasit.io/v1/keys \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST https://api.sowasit.io/v1/keys/abc123/revoke \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Key compromised"
  }'

• Vollständige Dokumentation: sowasit.io/documentation
• NPM-Paket: @sowasit/signer
• Dashboard: sowasit.io/dashboard
• E-Mail: support@sowasit.io