# API-Keys verwalten

> URL: https://foura.ai/de/docs/dashboard/api-keys
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

Auf der Seite API Keys kannst du die Schlüssel erstellen, einsehen und verwalten, mit denen deine Anwendungen die FourA API aufrufen.

## Deine Schlüssel einsehen

Die Seite zeigt jeden Schlüssel, auf den du Zugriff hast: deine persönlichen Schlüssel und alle Schlüssel von Organisationen, denen du angehörst. Die Mitgliedschaft gewährt den Zugriff, daher sieht auch ein einfaches Mitglied die Schlüssel der Organisation.

| Spalte | Beschreibung |
|--------|---------------|
| Name | Anzeigename und, falls angegeben, die Beschreibung |
| Owner | `Personal` oder der Name der Organisation |
| Key Prefix | Die ersten Zeichen des Schlüssels, gefolgt von einer Maskierung (`pk_live_a1b2••••••••`), mit einer Reveal-Schaltfläche oder einem Schloss-Symbol bei älteren Schlüsseln |
| Status | Active oder Inactive |
| Created | Wann der Schlüssel erstellt wurde |
| Last Used | Wann der Schlüssel zuletzt einen Request gesendet hat |

Suche nach Name oder Beschreibung, filtere nach Active oder Inactive und sortiere nach Name, Owner, Status, Created oder Last Used. Die Sortierreihenfolge wechselt zwischen absteigend, aufsteigend und aus.

### Der Owner-Filter

Wenn du mindestens einer Organisation angehörst, erscheint neben dem Suchfeld ein **Owner**-Dropdown: **Everything**, **Personal** oder ein Eintrag pro Organisation. Es filtert die Liste nach Schlüsseln dieses Owners. Dieselbe Auswahl auf Overview, Metrics, Activity und Proxy übernimmt diese Einstellung, damit alle fünf Seiten stets denselben Traffic anzeigen.

## Schlüssel erstellen

Klicke über der Liste auf **Create Key** (**Create API key** auf der leeren Seite vor deinem ersten Schlüssel) und fülle folgende Felder aus:

| Feld | Erforderlich | Beschreibung |
|-------|----------|-------------|
| Name | Ja | Eine aussagekräftige Bezeichnung, zum Beispiel "production-scraper" oder "staging-test" |
| Description | Nein | Notizen zum Verwendungszweck dieses Schlüssels |
| Owner | Ja, falls du in einer Organisation bist | Personal oder jede Organisation, der du angehörst. Die Auswahl erscheint nur, wenn du mindestens einer angehörst. |

Jedes Mitglied einer Organisation kann Schlüssel für diese erstellen, unabhängig von der Rolle. Das ist der Zweck dieser Einstellung: Die Nutzung eines Organisationsschlüssels wird dem Owner der Organisation in Rechnung gestellt. So benötigt ein Entwickler keinen persönlichen Schlüssel, der fälschlicherweise ihm statt dem Unternehmen berechnet wird.

Der vollständige Schlüssel wird direkt nach der Erstellung einmalig in einem Dialog zum Kopieren angezeigt. Du kannst ihn später über **Reveal** erneut abrufen. Schlüssel verwenden das Präfix `pk_live_` und sehen wie `pk_live_a1b2c3d4e5f6...` aus. Du erhältst eine E-Mail, die die Erstellung des Schlüssels bestätigt.

Dein Plan bestimmt, wie viele aktive Schlüssel du besitzen kannst: deine persönlichen Schlüssel plus die Schlüssel von Organisationen, die du besitzt. Ein für eine Organisation erstellter Schlüssel wird auf den Plan des Owners angerechnet. Bei Erreichen des Limits wird die Erstellung mit einem Hinweis auf das Limit deines Plans verweigert. Deaktiviere oder lösche daher ungenutzte Schlüssel oder führe ein Upgrade durch.

## Schlüssel aufdecken

Klicke auf das Augensymbol neben dem maskierten Präfix eines Schlüssels, um dessen vollständiges Secret wieder anzuzeigen. Das Dashboard fordert dich zur Bestätigung auf und öffnet dann einen Dialog mit dem unverschleierten Schlüssel, einem Kopier-Button und einem kurzen Countdown. Nach Ablauf des Countdowns wird das Secret wieder von der Seite entfernt.

Jedes Aufdecken wird im Audit-Log erfasst, da dabei aktive Zugangsdaten offengelegt werden.

Jeder, mit dem der Key geteilt wird, kann ihn aufdecken: sein persönlicher Besitzer oder jedes Mitglied der Organisation, der er gehört.

### Legacy-Keys

Keys, die vor Einführung der Reveal-Funktion erstellt wurden, zeigen ein Schloss-Symbol statt des Auges und können nicht aufgedeckt werden. Da nur ihr Hash gespeichert wurde, ist das originale Secret unwiderruflich verloren. Um einen Legacy-Key umzustellen, öffne das Aktionsmenü und wähle **Regenerate**. Das neue Secret kann ab dann jederzeit aufgedeckt werden.

## Was die einzelnen Rollen dürfen

Bei einem persönlichen Key kannst du alles tun. Bei einem Organisations-Key gelten drei Stufen:

| Aktion | Member | Admin | Owner |
|--------|--------|-------|-------|
| Den Key verwenden und aufdecken | Ja | Ja | Ja |
| Umbenennen, Beschreibung bearbeiten | Ja | Ja | Ja |
| Aktivieren oder deaktivieren | Nein | Ja | Ja |
| Secret neu generieren | Nein | Ja | Ja |
| Löschen | Nein | Ja | Ja |
| Aus der Organisation verschieben | Nein | Nein | Ja |

Deaktivieren und Bearbeiten bleiben in der Zeile sichtbar, sind aber ausgegraut mit einem Hinweis zum Grund. Regenerate, Transfer und Delete erscheinen gar nicht erst im Menü, wenn deine Rolle sie nicht ausführen darf. Die API verweigert dieselben Aktionen, sodass eine Integration die Oberfläche nicht umgehen kann.

Die Aufteilung richtet sich nach den Auswirkungen für alle, die den Key teilen. Das Umbenennen ist harmlos. Das Neugenerieren oder Deaktivieren stoppt sofort die Integrationen aller Kollegen. Das Verschieben eines Keys entzieht ihn dem Unternehmen und rechnet seine Nutzung über den Plan des neuen Besitzers ab, daher darf dies nur der Owner.

## Einen Key bearbeiten

Klicke auf **Edit**, um Name und Beschreibung zu aktualisieren. Die Eigentümerschaft wird in diesem Dialog nicht geändert: Nutze dafür **Transfer**.

**View Metrics** im Aktionsmenü öffnet die Overview, gefiltert nach diesem Key.

## Aktivieren und Deaktivieren

Verwende **Disable** oder **Enable** in der jeweiligen Zeile. Das Deaktivieren eines Keys blockiert jeden API-Request, der ihn nutzt, und du kannst ihn jederzeit wieder aktivieren. Die Änderung wird innerhalb einer Minute wirksam.

## Einen Key neu generieren

Wenn du vermutest, dass ein Key kompromittiert wurde, öffne das Aktionsmenü und wähle **Regenerate**. Dadurch wird ein neues Secret für dieselbe Key-ID erstellt. Das alte Secret funktioniert innerhalb einer Minute nicht mehr. Name, Besitzer und alle anderen Einstellungen bleiben unverändert.

Das neue Secret bleibt auch nach dem Schließen des Dialogs aufdeckbar. Du musst es also nicht sofort beim ersten Mal kopieren.

## Einen Key übertragen

**Transfer** im Aktionsmenü verschiebt einen Key zwischen persönlichem und Organisationsbesitz, ohne das Secret neu zu generieren. Die Key-ID, die Metriken und der Aktivitätsverlauf bleiben erhalten. Nur der Besitzer ändert sich und damit auch, wem die Nutzung in Rechnung gestellt wird.

| Vorgang | Wer es tun darf |
|---------|-----------------|
| Persönlichen Key in eine Organisation übertragen | Jeder, der dieser Organisation angehört |
| Organisations-Key zu sich selbst übertragen | Der Owner der Organisation |
| Zwischen zwei Organisationen übertragen | Der Owner der Organisation, die der Key verlässt |

Ein Key, der in eine Organisation verschoben wird, wird deren Standard-Team "Everyone" hinzugefügt, wodurch er für die Mitglieder sichtbar wird. Ein Key, der herausverschoben wird, verlässt jedes Team, in dem er war.

## Einen Key löschen

Öffne das Aktionsmenü und wähle **Löschen**. Das Löschen eines bereits verwendeten Keys deaktiviert ihn: Der Key authentifiziert nicht mehr und bleibt als **Inaktiv** in der Liste, damit der Verlauf von Aktivität und Metriken seinen Namen behält. Noch nie verwendete Keys werden direkt entfernt.

Du erhältst eine E-Mail, wenn ein Key gelöscht wird.

## Organisations-Keys und Abrechnung

Die Nutzung eines Keys im Besitz einer Organisation wird auf den Tarif des **Organisationsinhabers** angerechnet, unabhängig davon, wer den Request gesendet hat. Die Seite [Nutzung & Limits](https://foura.ai/docs/dashboard/quota) des Inhabers zählt diese Keys zusammen mit den persönlichen und trennt beide Bereiche auf.

## Verwandte Themen

- [Authentifizierung](https://foura.ai/docs/getting-started/authentication): Wie API-Keys mit der API funktionieren
- [Organisationen](https://foura.ai/docs/dashboard/teams-and-orgs): Rollen, Mitglieder und geteilter Zugriff
- [Nutzung & Limits](https://foura.ai/docs/dashboard/quota): Welche Keys auf deinen Tarif angerechnet werden
- [Dashboard-Übersicht](https://foura.ai/docs/dashboard/overview): Alle Dashboard-Bereiche
