> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación

> Cómo funcionan las claves de la API de Croma Legal y el esquema bearer.

## Dónde obtener una clave

Las claves se crean y se revocan en el dashboard de Croma Legal en
[legal.usecroma.com](https://legal.usecroma.com), en **Desarrolladores**,
pestaña **Claves de API**. La clave completa se muestra una sola vez al
crearla, así que cópiala en un lugar seguro antes de salir de la página. Una
organización puede tener hasta **5** claves activas; revoca las que ya no uses.

<Card title="Crea una clave de API" icon="key" href="https://legal.usecroma.com/developers">
  Abre el dashboard de Croma Legal para generar y administrar las claves de tu
  organización.
</Card>

<Note>
  La gestión de claves la habilita Croma por usuario (todos los miembros de la
  organización ven la configuración de MCP, pero solo los usuarios habilitados
  ven la pestaña **Claves de API**). Si la necesitas, pídesela a tu contacto en
  Croma.
</Note>

## Esquema bearer

Envía la clave en el encabezado `Authorization` usando el esquema `Bearer`, en
cada solicitud:

```bash theme={"dark"}
Authorization: Bearer croma_live_xxxxxxxxxxxxxxxxxxxx
```

La misma clave autentica la API REST y el [servidor MCP](/es/legal/mcp-server):
el uso y los límites de tasa se comparten entre ambos.

## Solo claves con alcance de organización

Las claves se generan para una **organización**, no para un usuario
individual, y cada solicitud queda limitada a esa organización: la API nunca
acepta un id de organización del llamante. Una clave personal se rechaza con
`401`:

```json theme={"dark"}
{
  "error": {
    "type": "authentication_error",
    "code": "personal_api_key_not_allowed",
    "message": "Personal API keys are not allowed. Use an organization key."
  }
}
```

## Formato de la clave

Las claves se emiten con la marca `croma_<env>_…`: `croma_live_…` en
producción y `croma_test_…` en los demás entornos. Las claves de Legal solo
funcionan contra `api.legal.usecroma.com`; una clave de la plataforma de datos
públicos de Croma (`platform.usecroma.com`) se rechaza aquí, y viceversa.

<Warning>
  Una clave otorga acceso de lectura a todo el portafolio de tu organización,
  incluidos los números de identificación de los demandados y los datos que
  hayas importado. Guárdala como un secreto (variable de entorno o gestor de
  secretos), nunca la incluyas en el control de versiones y revócala desde el
  dashboard apenas sospeches que quedó expuesta. La revocación es inmediata.
</Warning>

## Autenticación fallida

Toda falla de autenticación devuelve `401` con un sobre
`authentication_error`. El campo `code` indica qué salió mal:

| Código                         | Qué significa                                                                                                                 | Cómo resolverlo                                                                                         |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `invalid_api_key`              | El encabezado `Authorization` falta o está mal formado, o la clave fue revocada, expiró o pertenece a otro producto de Croma. | Envía una clave de Legal válida como `Authorization: Bearer <clave>`, o crea una nueva en el dashboard. |
| `personal_api_key_not_allowed` | Se usó una clave personal donde solo se aceptan claves de organización.                                                       | Usa una clave de organización creada desde el dashboard de Croma Legal.                                 |

<Card title="Siguiente: Paginación y filtros" icon="list" href="/es/legal/pagination">
  Cómo paginan las listas, qué significa cada fecha y cómo sincronizar de forma incremental.
</Card>