Lorixen.
DE

Stripe mit Tools verbinden: eingeschränkter Schlüssel statt sk_

Kurz gesagt: Wenn Sie Stripe mit einem weiteren Werkzeug verbinden, etwa einer Buchhaltungssoftware, einer Automatisierung oder einem KI-Assistenten, sollten Sie dafür keinen geheimen Schlüssel (sk_) herausgeben, sondern einen eingeschränkten Schlüssel (rk_) mit genau den Rechten, die dieses Werkzeug braucht. Laut Stripe-Dokumentation (abgerufen November 2026) hat ein geheimer Schlüssel uneingeschränkten Zugriff auf alle Stripe-Schnittstellen. Stripe empfiehlt, wo immer möglich eingeschränkte Schlüssel zu verwenden. Gelangt ein solcher Schlüssel in falsche Hände, kann der Angreifer nur das tun, was der Schlüssel erlaubt, und nicht etwa Auszahlungen auslösen.

Warum das für kleine Betriebe wichtig ist

Viele Betriebe nutzen Stripe nicht nur im Shop, sondern verbinden es mit weiteren Werkzeugen:

  • eine Buchhaltungssoftware, die Zahlungen und Gebühren abholt
  • eine Automatisierung, die bei neuen Zahlungen Rechnungen verschickt oder Kunden im CRM anlegt
  • ein Auswertungs-Dashboard für Umsätze
  • zunehmend auch KI-Assistenten, die Fragen zu Zahlungen beantworten sollen

Oft verlangt die Einrichtung „Ihren Stripe-API-Schlüssel“. Wer dann einfach den geheimen Schlüssel aus dem Dashboard kopiert, gibt dem Werkzeug die volle Kontrolle über das Stripe-Konto. Das ist mehr, als irgendein Auswertungstool je braucht.

Ein Beispiel zur Veranschaulichung: Eine Sprachschule in Wien verbindet Stripe mit einem Dashboard-Werkzeug, das monatliche Umsätze anzeigt. Bei der Einrichtung wird der geheime Schlüssel eingetragen. Das Werkzeug könnte damit nicht nur Zahlungen lesen, sondern auch Erstattungen auslösen oder Kundendaten ändern, obwohl es nur Zahlen anzeigen soll.

Die Schlüsselarten bei Stripe

Die Stripe-Dokumentation unterscheidet mehrere Arten:

Art Beginnt mit Darf öffentlich sein? Wofür
Veröffentlichbarer Schlüssel pk_ Ja Bezahlformulare im Browser und in Apps; keine sensiblen Vorgänge
Eingeschränkter Schlüssel rk_ Nein Server und Drittwerkzeuge mit genau festgelegten Rechten
Geheimer Schlüssel sk_ Nein Uneingeschränkter Zugriff auf alle Schnittstellen

Testschlüssel aus einer Sandbox tragen laut Dokumentation zusätzlich „test“ im Präfix, Liveschlüssel „live“. Geheimnisse für Webhooks sind laut Stripe getrennt von API-Schlüsseln und finden sich beim jeweiligen Webhook-Endpunkt.

Zum geheimen Schlüssel schreibt Stripe ausdrücklich, dass er für neue Anwendungsfälle nicht empfohlen wird, weil sich seine Rechte nicht einschränken lassen. Für bestehende Integrationen empfiehlt Stripe den Umstieg auf eingeschränkte Schlüssel.

Was ein eingeschränkter Schlüssel leistet

Laut Dokumentation wählen Sie bei einem eingeschränkten Schlüssel für jede Ressource eine von drei Stufen: Keine, Lesen oder Schreiben. Standard ist überall „Keine“. Stripe nennt als Beispiel einen Schlüssel, der nur Daten zu Zahlungsstreitigkeiten lesen darf. Wer ihn erbeutet, kann nur diese Daten lesen, aber keine Zahlungen erstellen, keine Zahlungsmethoden einsehen und keine Auszahlungen auslösen.

Stripe stellt die Unterschiede zum geheimen Schlüssel in einer Übersicht gegenüber. Die wichtigsten Punkte daraus:

  • Weitergabe an Dritte: Ein geheimer Schlüssel gibt dem Dritten die volle Kontrolle, ein eingeschränkter nur den nötigen Zugriff.
  • KI-Assistenten: Mit einem geheimen Schlüssel könnte ein Assistent Dinge tun, die Sie nicht wollen. Mit einem eingeschränkten legen Sie seine Rechte ausdrücklich fest. Stripe empfiehlt eingeschränkte Schlüssel besonders für KI-Agenten.
  • Prinzip der minimalen Rechte: Mit uneingeschränkten Schlüsseln nicht umsetzbar, mit eingeschränkten schon.

Schritt für Schritt: einen Schlüssel für ein Werkzeug anlegen

  1. Klären, was das Werkzeug tun soll. Ein Umsatz-Dashboard braucht Lesezugriff auf Zahlungen und Gebühren. Eine Automatisierung, die Rechnungen verschickt, braucht vielleicht Schreibzugriff auf Rechnungen, aber nicht auf Auszahlungen. Fragen Sie den Anbieter des Werkzeugs, welche Rechte er braucht.
  2. Im Dashboard anlegen. Laut Dokumentation erstellen Sie den Schlüssel im Bereich der API-Schlüssel über „Eingeschränkten Schlüssel erstellen“. Sie können mit voreingestellten Rechten beginnen oder bei null anfangen.
  3. Einen sprechenden Namen vergeben. Etwa „Umsatz-Dashboard, nur Lesen“. So wissen Sie später, wofür der Schlüssel gedacht ist.
  4. Rechte setzen. Für jede Ressource Keine, Lesen oder Schreiben wählen. Alles, was nicht gebraucht wird, bleibt auf Keine.
  5. Bestätigen und sicher speichern. Stripe verlangt laut Dokumentation eine Bestätigung mit zweitem Faktor. Den Schlüsselwert können Sie danach nicht erneut abrufen. Im Notizfeld halten Sie fest, wo er gespeichert ist.
  6. Zuerst in der Sandbox testen. Stripe empfiehlt, einen eingeschränkten Schlüssel zuerst in einer Sandbox anzulegen und zu prüfen, bevor man einen Liveschlüssel erstellt.

Laut Dokumentation sind eingeschränkte Schlüssel auf dem Server ein direkter Ersatz für geheime Schlüssel. Ihr Code nutzt sie auf dieselbe Weise.

Den alten geheimen Schlüssel ablösen

Hat ein Werkzeug bisher den geheimen Schlüssel, tauschen Sie ihn gegen einen eingeschränkten aus und prüfen, ob alles funktioniert. Danach empfiehlt Stripe, den alten Schlüssel zu rotieren oder ablaufen zu lassen. Laut Dokumentation lässt sich ein verzögertes Ablaufen von bis zu sieben Tagen einstellen, falls Sie einen Übergangszeitraum brauchen.

Zeigt ein Werkzeug nach der Umstellung Fehler, fehlt meist ein Recht. Ergänzen Sie gezielt das fehlende Recht, statt auf den geheimen Schlüssel zurückzugehen.

Wenn ein Schlüssel doch in falsche Hände gerät

Trotz aller Vorsicht kann ein Schlüssel versehentlich in einer Mail, einem geteilten Dokument oder einem öffentlichen Code-Verzeichnis landen. Dann zählt Geschwindigkeit. Sperren oder rotieren Sie den betroffenen Schlüssel sofort im Dashboard und hinterlegen Sie im zugehörigen Werkzeug einen neuen. Prüfen Sie anschließend in den Protokollen der Schnittstellenaufrufe, ob mit dem Schlüssel ungewöhnliche Anfragen gestellt wurden, etwa zu Zeiten, in denen das Werkzeug normalerweise nicht arbeitet.

Hier zeigt sich der Vorteil eingeschränkter Schlüssel besonders deutlich. War der Schlüssel nur zum Lesen von Umsätzen berechtigt, ist der mögliche Schaden begrenzt. Bei einem geheimen Schlüssel müssten Sie dagegen das gesamte Konto auf Veränderungen prüfen: Erstattungen, geänderte Auszahlungsdaten, neue Webhook-Endpunkte. Allein dieser Aufwand ist ein guter Grund, beim Verbinden neuer Werkzeuge von Anfang an sparsam mit Rechten umzugehen.

Gewohnheiten für mehr Sicherheit

  • Ein Schlüssel pro Werkzeug. Dann können Sie einen Schlüssel sperren, ohne alle anderen Verbindungen zu unterbrechen.
  • Liste führen. Welcher Schlüssel gehört zu welchem Werkzeug, wer hat ihn eingerichtet, wann wurde er zuletzt geprüft?
  • Nicht mehr genutzte Schlüssel löschen. Ein gekündigtes Werkzeug braucht keinen Zugang mehr.
  • Vorsichtig behandeln. Stripe betont, eingeschränkte Schlüssel mit derselben Sorgfalt zu behandeln wie geheime: nicht in Mails, nicht in Code-Ablagen, nicht in Tabellen.

Häufige Fragen

Was ist, wenn ein Werkzeug ausdrücklich den geheimen Schlüssel verlangt?

Fragen Sie beim Anbieter nach, ob ein eingeschränkter Schlüssel möglich ist und welche Rechte nötig sind. Laut Stripe unterstützen alle Stripe-Schnittstellen eingeschränkte Schlüssel.

Darf der veröffentlichbare Schlüssel auf der Website stehen?

Ja. Laut Stripe ist er dafür gedacht und kann keine sensiblen Vorgänge auslösen.

Kann ich Rechte später ändern?

Stripe beschreibt das Anpassen von Rechten und das Duplizieren bestehender Schlüssel als Vorlage. Prüfen Sie nach jeder Änderung, ob das Werkzeug weiter funktioniert.

Wenn Sie Ihr Stripe-Konto mit mehreren Werkzeugen verbunden haben und nicht mehr wissen, wer welchen Zugriff hat, räumen wir die Schlüssel gern mit Ihnen auf: Kontakt.

Quellen

WhatsAppTermin buchen