---
type: explanation
title: Überblick
summary: Was ein Site-Key ist, wie du einen erstellst und die Einstellungen, die ihn steuern, von Name und Status bis zur Secret-Rotation und Löschung.
---

Ein Site-Key ist die Anmeldedatei, die dein Widget mit Caputchin verbindet. Du erstellst einen in einem [Team](/docs/troops/overview), und jeder Key ist ein Wertepaar plus seine eigenen Einstellungen, Statistik und Historie.

## Ein Key oder mehrere?

Die meisten Seiten brauchen nur einen. Erstell einen separaten Key, wenn du eine Fläche eigenständig messen oder justieren willst:

- **Einen pro Umgebung** (Staging und Produktion), damit Test-Traffic deine echte Statistik nicht trübt.
- **Einen pro Formular oder Produkt**, wenn du für jedes eigenständige Statistik oder andere [Sicherheit](/docs/site-keys/security)-Einstellungen willst.

Keys im selben Team teilen sich standardmäßig einen Satz Spiel-Anpassung (ein Key kann ihn in seinen eigenen Einstellungen überschreiben), also geht es beim Aufteilen meist darum, Einstellungen und Statistik zu isolieren. Im Zweifel fang mit einem an und teil später auf.

## Einen Key erstellen

1. Öffne dein Team und geh zu **Site-Keys**.
2. Klick **Site-Key erstellen**, gib ihm einen Namen und klick **Erstellen**. Mehr als einen Namen verlangt er nicht.

Das liefert die zwei Werte zurück, die du überall sonst verwendest:

| Wert | Sieht aus wie | Wohin er gehört |
|---|---|---|
| Public Key | `cpt_pub_...` | Das `sitekey`-Attribut des Widgets, in deiner Seite. Sicher im Browser. |
| Secret | `cpt_sec_...` | Dein Server, im `/siteverify`-Aufruf. Liefer es nie an den Browser. |

Das **Secret wird einmal gezeigt**, bei der Erstellung, also kopier es dann. Der **Public Key** ist danach immer auf der **Integration**-Seite des Keys sichtbar, die auch fertig einzufügende Embed-Snippets zeigt.

## Name

Der Name eines Keys ist ein Label für deinen eigenen Gebrauch, auf der **Einstellungen**-Seite des Keys unter **Identifikation**. Er erscheint nicht im Widget und beeinflusst die Verifizierung nicht, also benenn ihn um, wann immer du willst.

## Status: aktivieren und deaktivieren

Jeder Key hat einen **Aktiviert**-Schalter auf seiner **Einstellungen**-Seite. Ein **deaktivierter** Key lehnt jeden `/siteverify`-Aufruf ab, sodass die Verifizierung sofort stoppt, ohne etwas zu löschen. Deaktivier einen Key, wenn du von einem geleakten Deployment weg rotierst, und aktivier ihn wieder, wenn du bereit bist.

## Das Secret rotieren

Rotier das Secret von der **Einstellungen**-Seite, wann immer du glaubst, es könnte geleakt sein. Die Rotation ist sofort: Das neue Secret funktioniert auf der Stelle und das alte verifiziert sofort nicht mehr, ohne Überlappungsfenster. Der **Public Key bleibt unverändert**, also braucht nur dein Backend den neuen Wert. Roll ihn zügig aus, damit laufende Verifizierungen weiter gelingen.

## Einen Key löschen

Löschen ist endgültig. Auf der **Einstellungen**-Seite entfernt **Site-Key löschen** den Key und seine Verifizierungskonfiguration, und die Verifizierung stoppt sofort. Du tippst den Namen des Keys (oder seinen Public Key) zur Bestätigung, und es kann nicht rückgängig gemacht werden. Willst du einen Key nur pausieren, deaktivier ihn stattdessen.

## Einstellungen mit eigener Seite

- [Sicherheit](/docs/site-keys/security): CORS-Origins, erforderliche Header, Proof-of-Work-Schwierigkeit, Bot-Blockierung und das Rate-Limit.
- [Statistik und Sessions](/docs/site-keys/statistics): der Verifizierungs-Funnel und das Log pro Session.
- [Audit-Logs](/docs/audit-logs/site-key-log): eine Aufzeichnung der Änderungen am Key.

## Siehe auch

- [Das Widget zu deiner Seite hinzufügen](/docs/getting-started/add-the-widget)
- [Auf deinem Backend verifizieren](/docs/integration-guides/verify-on-your-backend)