API-Schlüssel
Ein API-Schlüssel ist ein geheimer Code, der belegt, dass ein anderes System Ihre Daten lesen darf. Er funktioniert wie ein Passwort, nur wird er von einem Programm statt von einer Person übermittelt – und bleibt gültig, bis Sie ihn widerrufen.
Gut zu wissen: Der Gatherino-Editor und das Konto sind auf Englisch oder Tschechisch verfügbar. Die Formulare, die Ihre Teilnehmenden ausfüllen, können in 18 Sprachen angezeigt werden, einschließlich Deutsch.
Der Schlüssel wird in den Einstellungen erstellt und genau einmal angezeigt. Speichern Sie ihn sofort in einer Umgebungsvariable oder einem Secret-Manager auf Ihrem Server. Später können Sie ihn nicht mehr auslesen, da er in einer Form gespeichert wird, aus der sich der ursprüngliche Wert nicht ableiten lässt.
Der häufigste Fehler ist, den Schlüssel in den JavaScript-Code der Seite einzubauen. Der Quelltext im Browser ist öffentlich: Jeder kann den Schlüssel kopieren und jede Antwort aus allen Ihren Formularen herunterladen. API-Aufrufe gehören daher auf einen Server, der den Schlüssel verwahrt und nur das zurückgibt, was öffentlich sein soll.
Wenn ein Schlüssel offengelegt wurde, prüfen Sie nicht erst, ob ihn jemand verwendet hat. Widerrufen Sie ihn und stellen Sie einen neuen aus. Der Widerruf wirkt sofort, und der alte Schlüssel funktioniert danach nicht mehr.
In der Praxis
- Der Schlüssel gehört in eine serverseitige Umgebungsvariable, nicht in ein Repository und nicht ins Frontend.
- Verwenden Sie für jede Integration einen eigenen Schlüssel, damit Sie nur diesen einen widerrufen können.
- Erneuern Sie den Schlüssel, wenn eine Person, die ihn kannte, das Unternehmen verlässt.
FAQ
Wo erstelle ich einen API-Schlüssel?
Unter Einstellungen → API-Schlüssel. Er wird nur einmal angezeigt.
Wie wird der Schlüssel übermittelt?
Im Header Authorization: Bearer <key> oder im Header x-api-key.
Was passiert, wenn ich einen Schlüssel widerrufe?
Er funktioniert sofort nicht mehr, und Integrationen, die ihn verwenden, erhalten einen 401-Fehler.
Verwandte Inhalte
Gatherino kostenlos testen
Kostenloser Tarif: 3 Formulare und 100 Antworten pro Monat. Keine Kreditkarte nötig, Daten werden in der EU gehostet.
Kostenlos starten →