---
type: explanation
title: Visión general
summary: Qué es una clave de sitio, cómo crear una, y los ajustes que la gobiernan, del nombre y el estado a la rotación del secreto y la eliminación.
---

Una clave de sitio es la credencial que conecta tu widget con Caputchin. Creas una dentro de un [equipo](/docs/troops/overview), y cada clave es un par de valores más sus propios ajustes, estadística e historial.

## ¿Una clave o varias?

La mayoría de sitios necesita solo una. Crea una clave aparte cuando quieras medir o afinar una superficie por su cuenta:

- **Una por entorno** (staging y producción) para que el tráfico de prueba no enturbie tu estadística real.
- **Una por formulario o producto** cuando quieras estadística independiente, o ajustes de [seguridad](/docs/site-keys/security) distintos, para cada uno.

Las claves del mismo equipo comparten un conjunto de personalización de juego por defecto (una clave puede sobrescribirlo en sus propios ajustes), así que dividir suele ser cuestión de aislar ajustes y estadística. Ante la duda, empieza con una y divide más tarde.

## Crea una clave

1. Abre tu equipo y ve a **Claves de sitio**.
2. Haz clic en **Create site-clave**, dale un nombre, y haz clic en **Create**. Lo único que pide es un nombre.

Eso devuelve los dos valores que usarás en todo lo demás:

| Valor | Tiene esta pinta | Dónde va |
|---|---|---|
| Clave pública | `cpt_pub_...` | El atributo `sitekey` del widget, en tu página. Seguro en el navegador. |
| Secreto | `cpt_sec_...` | Tu servidor, en la llamada `/siteverify`. Nunca lo envíes al navegador. |

El **secreto se muestra una vez**, al crearla, así que cópialo entonces. La **clave pública** siempre queda visible después en la página de **Integración** de la clave, que también muestra fragmentos de incrustación listos para pegar.

## Nombre

El nombre de una clave es una etiqueta para tu propio uso, en la página de **Settings** de la clave bajo **Identification**. No aparece en el widget y no afecta a la verificación, así que renómbrala cuando quieras.

## Estado: activar y desactivar

Cada clave tiene un interruptor **Enabled** en su página de **Settings**. Una clave **desactivada** rechaza toda llamada `/siteverify`, así que la verificación se detiene de inmediato sin eliminar nada. Desactiva una clave cuando estés rotando para alejarte de un despliegue filtrado, y vuelve a activarla cuando estés listo.

## Rota el secreto

Rota el secreto desde la página de **Settings** cuando creas que puede haberse filtrado. La rotación es inmediata: el secreto nuevo funciona al instante y el viejo deja de verificar de inmediato, sin ventana de solapamiento. La **clave pública no cambia**, así que solo tu backend necesita el valor nuevo. Despliégalo pronto para que las verificaciones en curso sigan teniendo éxito.

## Elimina una clave

Eliminar es permanente. En la página de **Settings**, **Delete site-clave** quita la clave y su configuración de verificación, y la verificación se detiene de inmediato. Escribes el nombre de la clave (o su clave pública) para confirmar, y no se puede deshacer. Si solo quieres pausar una clave, desactívala en su lugar.

## Ajustes con su propia página

- [Seguridad](/docs/site-keys/security): origins CORS, headers obligatorios, dificultad del proof-of-work, bloqueo de bots y el rate limit.
- [Estadística y sesiones](/docs/site-keys/statistics): el embudo de verificación y el registro por sesión.
- [Audit logs](/docs/audit-logs/site-key-log): un registro de los cambios hechos a la clave.

## Véase también

- [Añade el widget a tu sitio](/docs/getting-started/add-the-widget)
- [Verifica en tu backend](/docs/integration-guides/verify-on-your-backend)