Resumen
Las API Keys permiten que sus aplicaciones, scripts y servicios de backend accedan de forma segura a las API de Astra sin necesidad de que un usuario inicie sesión a través de la interfaz web cada vez. Este artículo explica qué son las API Keys, cómo crearlas y utilizarlas, y cómo gestionar o revocar las claves existentes.
Instrucciones
¿Qué es una API Key?
Una API Key es una credencial secreta que comienza con sk_live_. Permite que su aplicación se autentique y realice solicitudes a las API de Astra de manera programática.
Las API Keys se utilizan habitualmente cuando necesita una conexión de sistema a sistema que se ejecute automáticamente sin interacción del usuario.
Casos de uso recomendados
Las API Keys son ideales cuando desea:
Sincronizar automáticamente leads calificados desde Astra a su CRM.
Crear paneles personalizados extrayendo datos de conversaciones y leads de Astra.
Activar flujos de trabajo empresariales cuando un agente de IA captura un nuevo lead.
Enviar datos de conversaciones a sistemas internos de análisis o informes.
Cuándo no utilizar API Keys
Las API Keys no se recomiendan para aplicaciones de cara al público donde cada usuario necesita otorgar acceso a su propia cuenta.
En estos casos, utilice la autenticación OAuth en su lugar.
Cómo crear una API Key
Para crear una nueva API Key:
Inicie sesión en su cuenta de Astra.
Vaya a Settings (Ajustes) > API Keys.
Haga clic en Create API Key (Crear API Key).
Introduzca un nombre descriptivo para la clave, como Production CRM Sync.
Haga clic en Create (Crear).
Importante: Guarde su API Key inmediatamente
Después de crear la clave, Astra muestra la API Key completa solo una vez.
Asegúrese de copiar y guardar la clave en una ubicación segura antes de cerrar la notificación o salir de la página.
Posteriormente, Astra solo mostrará un prefijo abreviado de la clave para fines de identificación. La clave completa no se puede volver a ver.
Cómo utilizar una API Key
Después de crear una API Key, añádala a su aplicación, script o integración.
Al realizar solicitudes a la API, incluya la clave en el encabezado de autorización de la solicitud, normalmente como un token de tipo Bearer.
Una vez configurada, su aplicación podrá acceder de forma segura a las API de Astra sin requerir que los usuarios inicien sesión a través de un navegador.
Gestionar API Keys existentes
La página API Keys muestra información sobre todas las claves activas.
Columna | Descripción |
Nombre | El nombre asignado a la API Key durante su creación |
Prefijo de clave | Los primeros caracteres de la API Key, utilizados para identificar la clave |
Creada | La fecha y hora en que se creó la clave |
Último uso | La última vez que se utilizó la clave; permanece en blanco si la clave nunca se ha usado |
Cómo revocar una API Key
Es posible que deba revocar una API Key si:
La clave fue expuesta o compartida involuntariamente
Una integración ya no es necesaria
Un miembro del equipo con acceso a la clave ha abandonado la organización
Está rotando las credenciales como parte de un proceso de seguridad
Para revocar una API Key:
Localice la clave en la lista de API Keys.
Haga clic en la opción Delete (Eliminar).
Confirme la acción.
¿Qué sucede después de la revocación?
La API Key queda invalidada inmediatamente.
Cualquier aplicación, script o integración que utilice esa clave ya no podrá acceder a las API de Astra hasta que se configure una nueva clave válida.
Mejores prácticas de seguridad al trabajar con API Keys
Siga estas recomendaciones para mantener sus API Keys seguras:
Nunca incluya API Keys en código frontend o del lado del cliente.
Almacene las API Keys en un gestor de secretos seguro o en variables de entorno.
Utilice API Keys separadas para entornos de prueba y de producción.
Rote las API Keys con regularidad.
Revoque las claves no utilizadas o desactualizadas.
Si una API Key se ve comprometida, revóquela inmediatamente y cree una nueva.
Did this answer your question?