← Blog
10 Min. Lesezeit
|
Veröffentlicht
|
Aktualisiert

Blockchain-API-Sicherheit: 6 praktische Tipps

Sechs Sicherheitspraktiken für Blockchain-APIs: Schlüsselerzeugung, Offline-Speicherung, lokales Signieren, Adressnutzung, API-Token und Webhook-Signaturen.

Kapitel
C
Chaingateway Team
Blockchain-Experten

Geprüft von Maurice Sobiera

Blockchain-API-Sicherheit umfasst die Praktiken, die Private Keys, API-Token und Webhook-Verkehr von Angreifern fernhalten, wenn Ihre Anwendung eine Blockchain über eine API nutzt. Das Risiko liegt in Ihrem Umgang mit Schlüsseln, in Ihren Zugangsdaten und in Ihrem Webhook-Endpunkt, nicht in der Blockchain selbst. Diese sechs Praktiken gelten für Chaingateway und für jede ähnliche API.

Wie sollten Sie Private Keys erzeugen?

Erzeugen Sie Private Keys mit einem kryptografisch sicheren Zufallszahlengenerator, und tun Sie das in einer Umgebung, die Sie kontrollieren. Das OWASP Cryptographic Storage Cheat Sheet sagt, dass Schlüssel aus einer kryptografisch sicheren Funktion stammen müssen und nicht aus gebräuchlichen Wörtern oder wahllosem Tastaturgetippe gebildet werden dürfen. Ein schwacher oder vorhersagbarer Schlüssel lässt sich erraten, und wer ihn errät, kann die Guthaben ausgeben.

Chaingateway kann über POST /api/v2/{blockchain}/addresses eine Adresse für Sie erzeugen. Der Leitfaden zur Wallet-Verwaltung beschreibt zwei Modi. Mit einem password wird der Private Key verschlüsselt auf unserer Seite gespeichert, und Sie nutzen das Passwort, um Transaktionen zu senden. Ohne Passwort enthält die Antwort den Private Key im Klartext, was für eine temporäre Adresse taugt, aber nicht für eine, die Sie behalten wollen. Wenn Sie die volle Kontrolle wollen, erzeugen Sie den Schlüssel auf Ihrem eigenen Rechner oder auf einer Hardware-Wallet und importieren ihn nur, wenn es nötig ist.

Wie sollten Sie Private Keys aufbewahren?

Halten Sie Schlüssel, die langfristig Guthaben sichern, offline, und lassen Sie auf Schlüsseln, die auf einem Server liegen, nur Arbeitsguthaben. Ein Schlüssel auf einem mit dem Internet verbundenen Rechner kann von allem gestohlen werden, was diesen Rechner kompromittiert. Hardware-Wallets und Offline-Backups beseitigen dieses Risiko, allerdings kann eine Hardware-Wallet verloren gehen, bewahren Sie also ein getestetes Wiederherstellungs-Backup auf.

Schreiben Sie Schlüssel oder Passwörter nie in Quellcode, Logs oder Tickets. Das OWASP Secrets Management Cheat Sheet stellt fest, dass viele Organisationen Secrets im Klartext in Quellcode und Konfigurationsdateien fest eintragen, und empfiehlt zentrale Speicherung mit Zugriffskontrolle und automatischer Rotation.

Sollten Sie Transaktionen auf Ihrem eigenen Rechner signieren?

Ja, wenn Sie können. Eine lokal signierte Transaktion legt den Private Key nie gegenüber Dritten offen, und die API muss nur noch das Ergebnis senden. Für TRON unterstützt Chaingateway diesen Ablauf: Die build-Endpunkte liefern eine unsignierte Transaktion zurück, Sie signieren sie mit dem TRON-Tooling aus dem TRON-Leitfaden zum Offline-Signieren, und POST /api/v2/tron/transactions/broadcast sendet die signierte Transaktion.

Bei den EVM-Netzwerken akzeptieren die Transaktions-Endpunkte entweder das password einer gespeicherten Adresse oder einen privatekey im Request-Body. Wenn Sie privatekey nutzen, reist der Schlüssel in der Anfrage mit, rufen Sie die API also nur über HTTPS auf und protokollieren Sie nie Request-Bodys. Unser Leitfaden zum Entschlüsseln von Keystores zeigt, wie Sie eine exportierte Keystore-Datei lokal öffnen.

Können Sie über die API erzeugte Adressen als Cold Wallet nutzen?

Nein. Eine Adresse, deren Schlüssel über einen Online-Dienst erzeugt oder gespeichert wurde, ist eine Hot Wallet, egal wie Sie sie nennen. Nutzen Sie API-Adressen als Einzahlungsadressen, verschieben Sie eingehende Guthaben auf eine Cold Wallet, die Sie offline erzeugt haben, und behandeln Sie die Einzahlungsadresse als kurzlebig.

Wenn Sie Einzahlungen einsammeln und für jeden Kunden oder jede Bestellung eine neue Adresse verwenden, begrenzen Sie, was ein Angreifer mit einem einzelnen geleakten Schlüssel gewinnt. Wenn Sie den ungesicherten Modus genutzt haben, wurde Ihnen der Private Key einmal zurückgegeben, bewahren Sie ihn also wie ein Passwort auf.

Wie schützen Sie Ihr API-Token?

Senden Sie das Token im Authorization-Header, und halten Sie es aus URLs, Frontend-Code und Repositories heraus. Chaingateway verwendet das Bearer-Schema Authorization: Bearer <token>, wie es RFC 6750 definiert. Dieses RFC verlangt TLS für jede Anfrage mit einem Bearer-Token, weil jeder, der das Token sieht, es nutzen kann.

Drei Gewohnheiten verringern den Schaden eines Lecks:

  • Speichern Sie das Token in einer Umgebungsvariable oder einem Secret Manager, nicht im Code.
  • Rotieren Sie es nach Zeitplan und nach jedem Verdacht auf Offenlegung, wie in unserem Leitfaden zur API-Key-Rotation beschrieben.
  • Beschränken Sie den Zugriff per IP-Adresse, falls Ihr Kontobereich das anbietet. Unser Beitrag zur IP-Whitelist-Funktion erklärt, wie das funktioniert.

Die OWASP API Security Top 10 führen fehlerhafte Authentifizierung, einschließlich schwacher Handhabung von Token, als eines der größten API-Risiken auf.

Wie prüfen Sie Webhooks der API?

Prüfen Sie bei jedem Webhook den X-Signature-Header, bevor Sie der Nutzlast vertrauen. Ohne diese Prüfung kann jeder, der Ihre Webhook-URL kennt, eine gefälschte Zahlungsbenachrichtigung senden. Chaingateway signiert Webhooks, wenn Sie in Ihren Profileinstellungen ein persönliches Secret festlegen. Die Signatur ist ein HMAC nach RFC 2104, gebildet aus der Transaktions-ID und Ihrem Secret.

Der Leitfaden zur Webhook-Sicherheit enthält Prüfcode in Python, Java, PHP und JavaScript. Vergleichen Sie Signaturen mit einer Funktion mit konstanter Laufzeit, und bestätigen Sie die Transaktion auf der Chain, bevor Sie eine Bestellung gutschreiben. Chaingateway wiederholt fehlgeschlagene Webhooks nicht automatisch. Fehlgeschlagene Benachrichtigungen werden unter /api/v2/{blockchain}/webhooks/notifications/failed aufgelistet, und Sie können jede über /webhooks/notifications/{id}/retry erneut senden. Prüfen Sie diese Liste also, wenn eine Zahlung zu fehlen scheint.

Brauchen Sie alle sechs?

Für alles, was echten Wert hält, ja. Die Praktiken decken unterschiedliche Fehlerstellen ab, und wer eine überspringt, lässt diese Stelle offen, egal was Sie anderswo tun.

FehlerstelleWas zu tun istWo Sie prüfen
SchlüsselerzeugungEinen kryptografisch sicheren Generator oder eine passwortgeschützte Adresse nutzenLeitfaden zur Wallet-Verwaltung
SchlüsselspeicherungLangfristige Guthaben offline halten, Secrets aus Code und Logs heraushaltenOWASP Secrets Management Cheat Sheet
SignierenLokal signieren, wo die API es unterstützt, sonst nur HTTPS verwendenPOST /api/v2/tron/transactions/broadcast
AdressnutzungAPI-Adressen für Einzahlungen nutzen und Guthaben auf eine Cold Wallet einsammelnIhr eigener Sweep-Job
API-ZugriffDas Bearer-Token in einem Secret Manager halten und rotierenLeitfaden zur API-Key-Rotation
BenachrichtigungenX-Signature prüfen und die Transaktion on-chain bestätigenLeitfaden zur Webhook-Sicherheit

Prüfen Sie die Tabelle, bevor Sie vom Testnet ins Mainnet wechseln. Mit dem Header X-Network: testnet können Sie den gesamten Ablauf einschließlich der Webhook-Prüfung ohne echte Guthaben durchspielen.

So entstehen diese Artikel

Möchten Sie das selbst umsetzen? API-Key erhalten — 7 Tage kostenlos testen, keine Karte nötig — oder werfen Sie einen Blick auf Blockchain-API für die vollständige Endpoint-Referenz.

C
Chaingateway Team
Blockchain-Experten

Das Chaingateway-Team hat es sich zur Aufgabe gemacht, die Blockchain-Integration für Entwickler weltweit zu vereinfachen.