Tu app, tus permisos. Kirky adentro.
Kirky nunca inicia sesión en tus sistemas. Tu backend dice quién es el usuario, el navegador del propio usuario lee tus datos y cada respuesta se verifica contra su fuente antes de que alguien la vea.
Tres lugares, y lo que viaja entre ellos
Tu login, tus llaves, tus endpoints
- Firmador de tokens (ES256)
- Endpoints de lectura y escritura
Tu app, con el widget en un Shadow DOM
- Las pantallas de tu app
- widget de kirky
Sesiones, documentos, el modelo · Estados Unidos
- Revisión de sesión
- Tus documentos, indexados
- El modelo, con tus reglas
- 1¿Quién es este usuario?El widget le pide un token a tu backend, detrás de tu propio login.
- 2Token firmado · 5 minTu servidor firma el id y los roles del usuario con una llave que nunca sale de ahí.
- 3Token + preguntaKirky verifica la firma y el origen, y abre una sesión corta.
- 4Lee este endpointPara una pregunta de datos, Kirky indica la llamada; nunca la hace.
- 5GET /orders, como el usuarioEl navegador llama a tu API con la sesión del propio usuario.
- 6Respuesta + fuentesCada cita verificada contra su pasaje, o “no sé”.
- 1¿Quién es este usuario?El navegador del usuarioTu backendEl widget le pide un token a tu backend, detrás de tu propio login.
- 2Token firmado · 5 minTu backendEl navegador del usuarioTu servidor firma el id y los roles del usuario con una llave que nunca sale de ahí.
- 3Token + preguntaEl navegador del usuarioKirkyKirky verifica la firma y el origen, y abre una sesión corta.
- 4Lee este endpointKirkyEl navegador del usuarioPara una pregunta de datos, Kirky indica la llamada; nunca la hace.
- 5GET /orders, como el usuarioEl navegador del usuarioTu backendEl navegador llama a tu API con la sesión del propio usuario.
- 6Respuesta + fuentesKirkyEl navegador del usuarioCada cita verificada contra su pasaje, o “no sé”.
Los números siguen una pregunta de principio a fin.
Qué pasa entre la pregunta y la respuesta
- 01
Se carga el widget
Una etiqueta script. Se monta en un Shadow DOM, así que tus estilos y los de Kirky nunca se tocan, y sabe en qué pantalla está el usuario.
- 02
Tu backend responde por el usuario
Firma un token con el id, los roles y el idioma del usuario. Vive cinco minutos como máximo, y Kirky no confía en nada más sobre quién es el usuario.
- 03
Kirky revisa el rol
Los roles vienen del token. Un rol que Kirky no ha visto empieza sin permisos hasta que un administrador se los da.
- 04
Encuentra las fuentes
Documentos que el rol puede leer, la guía de la pantalla actual o uno de tus endpoints de lectura — como máximo tres lecturas por pregunta.
- 05
Los datos se leen en el navegador
El navegador del usuario llama a tu API con la sesión del usuario. Tus llaves de API nunca llegan a Kirky, y solo regresan los campos que permitiste.
- 06
La respuesta se verifica
Cada cita se compara palabra por palabra con su pasaje. Lo que no se puede respaldar se quita; si no queda nada, la respuesta es “no sé”.
Mira cómo la revisión de rol detiene una pregunta
Pregunta por el plazo de devolución y luego por una comisión. Mismo usuario, mismo chat; la segunda nunca llega al modelo.
Lo que Kirky hace y lo que no
- Dice cuando no sabeEn Conocimiento y Datos, cada afirmación necesita una fuente. Sin fuente, no hay afirmación.
- Los roles empiezan vacíosUn rol nuevo no ve nada hasta que se lo das. Kirky nunca amplía lo que tu app permite.
- Nunca borraLas acciones crean o actualizan, después de una vista previa y una confirmación. Borrar no está en la lista.
- No se sale del temaLas preguntas fuera de lo que activaste reciben un no amable, y en las respuestas no salen enlaces ni imágenes.
- Conoce sus límitesComo máximo tres lecturas por pregunta, 500 filas para razonar, 60 segundos por respuesta — y luego le dice al usuario cómo acotar la pregunta.
- Avisa, nunca bloqueaCentinela avisa antes de que se guarde un valor inusual. El usuario siempre decide.
Caché, y lo que nunca sale de tu lado
- Respuestas de Ayuda y Conocimiento, hasta por 7 días.
- Separadas por rol e idioma, así que nadie ve una respuesta escrita para otro rol.
- Se descartan en cuanto cambia un documento que esa respuesta podía leer.
- Respuestas con tus datos en vivo.
- Acciones y sus vistas previas.
- Nada personal de un solo usuario.
- Tus llaves de API y credenciales de base de datos.
- La llave privada que firma los tokens de usuario.
- Los campos de una respuesta que no le permitiste usar a Kirky.
¿Necesitan acceso a nuestro código, base de datos o llaves de API?
No. Agregas un script y tu backend firma un token de vida corta. Las preguntas de datos corren en el navegador del usuario contra tus endpoints; el acceso directo a la base de datos es opcional, en Scale, mediante un conector de solo lectura que tú alojas.
¿Dónde vive la llave privada?
Contigo. El portal genera el par de llaves en el navegador de tu administrador; la llave privada se descarga una vez y nunca llega a nuestros servidores. Solo guardamos la llave pública, y puedes rotarla con dos llaves activas.
¿El widget va a chocar con nuestro CSS?
No. Se monta en un Shadow DOM, así que tus estilos no se filtran hacia él y los suyos no se filtran hacia tu app.
¿Podemos probar sin afectar producción?
Sí. Cada organización tiene un entorno Test gratuito con sus propias llaves y datos, y el SDK tiene un modo simulado con respuestas fijas para tu CI.