Claves de API

Las claves de API te permiten autenticar solicitudes programáticas a la API REST de Sift. Cada clave tiene alcance a tu organización.

De un vistazoCopy Anchor Link

Generar una claveCopy Anchor Link

1. Ve a Settings → Connections → Developer access (/app/settings/api-keys).
2. Elige nombre, perfil de permisos y caducidad. Crea la clave.
3. Copia la clave de inmediato: no se mostrará de nuevo.

Usar tu claveCopy Anchor Link

Envía la clave en el encabezado X-API-Key en cada solicitud:

GET https://api.getsift.ai/v0/action/list
X-API-Key: sk_live_your_key_here

AlcancesCopy Anchor Link

Developer access selecciona Reporting de forma predeterminada, con el alcance read. Elige Write para escrituras generales o Read and write para ambas. El permiso de escritura general no permite importar por Custom API.

Para Custom API, crea una clave Import en Settings → Connections → Developer → API keys. La pestaña Setup de la fuente enlaza allí con la fuente preseleccionada. Otorga ingest e ingest:read para fuentes seleccionadas. Permite validar, importar, corregir elementos, reintentar importaciones fallidas y leer recibos. No permite leer informes ni enviar respuestas.

Usa claves separadas para importación e informes. Las opciones de caducidad son 30 días, 90 días o sin caducidad. El valor predeterminado es 90 días.

Cuentas de servicioCopy Anchor Link

Una cuenta de servicio da a un script, una integración o una herramienta de IA su propia identidad en Sift. Úsala cuando una clave necesite más que los valores predeterminados de la organización, o cuando quieras saber qué herramienta hizo un cambio.

• Roles. Una cuenta de servicio tiene roles de tu organización, los mismos que das a las personas. Sus claves pueden hacer lo que esos roles permiten.
• Acceso. Las claves de Solo lectura solo pueden leer, permitan lo que permitan los roles. Las claves de Lectura y escritura también pueden hacer los cambios que permiten los roles.
• Claves. Cada cuenta puede tener varias claves, para rotarlas sin cortes. Una clave actúa como su cuenta, en la API REST y en MCP.
• Auditoría. Los cambios hechos con sus claves muestran el nombre de la cuenta de servicio en el registro de auditoría.
• Desactivar. Desactiva una cuenta para detener todas sus claves a la vez. Elimínala para quitarla junto con sus claves.

Los Super Admins gestionan las cuentas de servicio en Configuración → Conexiones → Acceso para desarrolladores → Cuentas de servicio. Empieza con Solo lectura (lo que ve un Manager, sin cambios), Administrador (el rol Super Admin, lectura y escritura) o Personalizado.

Una cuenta de servicio no puede actuar sobre los elementos propios de una persona, como su perfil, sus paneles o sus conexiones MCP. No puede crear cuentas de servicio ni claves.

Revocar una claveCopy Anchor Link

Puedes revocar cualquier clave en cualquier momento desde la misma página de configuración Developer access. Las solicitudes nuevas fallan después de la revocación. No asumas que revocar una clave cancela una solicitud que ya está en curso.

Buenas prácticasCopy Anchor Link

• Una clave por integración. No compartas una sola clave entre varios sistemas. Si una integración se ve comprometida, puedes revocar solo esa clave sin afectar las demás.
• Rota con regularidad. Genera una clave nueva, actualiza tu integración y luego revoca la anterior.
• Nunca confirmes claves en el control de versiones. Guárdalas en variables de entorno o en un gestor de secretos.

RelacionadoCopy Anchor Link