Incorporación
Esta guía explica cómo gestiona Askalot el despliegue multiinquilino y la autenticación, de modo que los datos de su organización permanezcan seguros y aislados.
Cómo unirse a Askalot
Sección titulada «Cómo unirse a Askalot»Las organizaciones pueden incorporarse a la plataforma de tres maneras:
Federación empresarial
Sección titulada «Federación empresarial»Para organizaciones que ya tienen proveedores de identidad.
Las organizaciones con sistemas de identidad consolidados (Google Workspace, Microsoft Azure AD, Okta) pueden federar la autenticación con Askalot. Los usuarios inician sesión con sus cuentas de la organización, y se les da de alta automáticamente en el primer inicio de sesión.
Incorporación gestionada
Sección titulada «Incorporación gestionada»Para organizaciones sin capacidad de federación de identidades.
Askalot crea una organización para su equipo. Los usuarios con el rol org_admin pueden invitar a nuevos miembros por correo electrónico. Los usuarios invitados se registran con cualquier método de autenticación admitido —correo electrónico y contraseña, o un proveedor público (Google o Microsoft)—; no están limitados a un proveedor de identidad de la organización.
Autoservicio (demostración)
Sección titulada «Autoservicio (demostración)»Para investigadores individuales y equipos pequeños.
El inquilino de desarrollo ofrece registro en autoservicio en la organización compartida ACME Corp para investigadores que quieran probar la plataforma sin compromiso por parte de su organización: es realmente gratuito, sin plazo de prueba, sin tarjeta de crédito y sin requisitos de elegibilidad, tanto para trabajos comerciales como no comerciales. La contrapartida es que se ofrece tal cual: sin garantía, sin SLA y sin compromiso de soporte. Cuando su trabajo necesite una parte identificada que responda contractualmente de los resultados, la disponibilidad y el soporte, eso es lo que ofrece Askalot Survey & Research Kft. mediante contrato; escriba a [email protected]. Regístrese con cualquier método de inicio de sesión admitido: el registro con contraseña requiere verificar el correo electrónico, mientras que iniciar sesión mediante un proveedor público de confianza (Google o Microsoft) da acceso inmediato sin verificación, porque Askalot confía en la confirmación de identidad del proveedor.
¿Solo quiere echar un vistazo primero? El enlace «Pruebe la demo interactiva» de la página de inicio inicia su sesión con una cuenta de demostración compartida en una organización sellada, precargada con cuestionarios de ejemplo de varios ámbitos, campañas, encuestas respondidas y conjuntos de datos analizados. Su registro de investigación no puede modificarse, así que puede explorar todas las etapas de la plataforma sin registrarse y sin alterar nada para el siguiente visitante; incluso puede probar un cuestionario de principio a fin en una vista previa y editar QML por sí mismo en un entorno de pruebas temporal que nunca guarda.
Una vez registrado en el entorno de pruebas, no necesita la cuenta compartida para volver: su propia cuenta también es miembro de la organización Askalot Demo. Ábrala desde el menú Cambiar de organización para leer todos los proyectos seleccionados, incluido Example Questionnaires, que contiene cuestionarios de ejemplo completos (todos los tipos de control, un bloque demográfico y una encuesta sobre el consumo de alimentos en el hogar) de los que aprender. Sigue sellada, así que allí puede leer y abrir vistas previas; su propio trabajo lo hace en su organización principal.
Arquitectura multiinquilino
Sección titulada «Arquitectura multiinquilino»Askalot usa una arquitectura multiinquilino totalmente aislada, en la que cada organización (inquilino) funciona en un entorno completamente separado. Este diseño ofrece:
- Aislamiento total de los datos: sus encuestas, participantes y respuestas se almacenan separados de los de otras organizaciones
- Recursos independientes: cada inquilino tiene recursos de cómputo dedicados, sin procesamiento compartido
- Dominios propios: acceda a su entorno mediante
<service>.<tenant>.askalot.io
Cómo funciona el aislamiento de inquilinos
Sección titulada «Cómo funciona el aislamiento de inquilinos»Cada inquilino se ejecuta en su propio entorno aislado, con:
- Límite de red separado: los inquilinos no pueden comunicarse directamente entre sí
- Almacenamiento dedicado: los volúmenes de datos se montan exclusivamente para cada inquilino
- Instancias de servicio independientes: cada inquilino ejecuta su propia copia de todos los servicios
Las URL de su inquilino
Sección titulada «Las URL de su inquilino»Una vez completada la incorporación, accederá a su entorno mediante estas URL:
| Servicio | Patrón de URL | Finalidad |
|---|---|---|
| Roundtable | roundtable.<tenant>.askalot.io |
Panel y gestión de usuarios |
| SirWay | sirway.<tenant>.askalot.io |
Ejecución de encuestas |
| Targetor | targetor.<tenant>.askalot.io |
Gestión de campañas |
| Armiger | armiger.<tenant>.askalot.io |
Editor de cuestionarios |
| Balansor | balansor.<tenant>.askalot.io |
Análisis estadístico |
| Portor | portor.<tenant>.askalot.io |
Pasarela de API y MCP |
Sustituya <tenant> por el nombre de inquilino asignado a su organización.
Autenticación
Sección titulada «Autenticación»Askalot usa un sistema de autenticación centralizado que ofrece inicio de sesión único (SSO) en todos los servicios de su inquilino.
Proveedor de identidad global
Sección titulada «Proveedor de identidad global»La autenticación la gestiona un proveedor de identidad OIDC (OpenID Connect) global que da servicio a todos los inquilinos. Este diseño ofrece:
- Inicio de sesión único: inicie sesión una vez y acceda a todos los servicios de Askalot
- Descubrimiento respetuoso con la privacidad: su pertenencia a un inquilino nunca se expone a otras organizaciones
- Varios métodos de autenticación: admite contraseña e inicio de sesión social (Google, Microsoft)
Cómo funciona la autenticación
Sección titulada «Cómo funciona la autenticación»Flujo paso a paso:
- Visite la página de inicio en
https://askalot.io - Introduzca su correo electrónico y su contraseña (o use el inicio de sesión social)
- Descubrimiento automático del inquilino: el sistema determina a qué inquilino o inquilinos pertenece
- Sesión establecida: se crea una cookie segura para todos los servicios de Askalot
- Redirección a su inquilino: se le lleva automáticamente a su panel
Métodos de inicio de sesión admitidos
Sección titulada «Métodos de inicio de sesión admitidos»| Método | Descripción |
|---|---|
| Correo electrónico + contraseña | Autenticación tradicional con nombre de usuario y contraseña |
| Inicie sesión con su cuenta de Google | |
| Microsoft | Inicie sesión con su cuenta de Microsoft/Azure AD |
Hay previstos otros proveedores de identidad (Okta, Apple, Facebook) para los despliegues empresariales.
Cuentas en más de un inquilino
Sección titulada «Cuentas en más de un inquilino»Si el mismo correo electrónico tiene una cuenta en más de un inquilino, al iniciar sesión se le pregunta cuál usar:
- Introduzca su correo electrónico y su contraseña
- Un cuadro de diálogo Seleccionar entorno muestra los inquilinos que tienen una cuenta para ese correo electrónico
- Elija a qué inquilino acceder
Para cambiar más adelante a otro inquilino, cierre sesión y elija el otro al iniciarla. Las cuentas son independientes: no se comparte nada entre inquilinos.
Conectar un asistente de IA es la excepción: la dirección del conector MCP ya nombra un inquilino, así que su inicio de sesión va a ese inquilino y no muestra el cuadro de diálogo Seleccionar entorno. Si su cuenta está en otro inquilino, conéctese con la dirección de ese inquilino.
Pertenecer a más de una organización
Sección titulada «Pertenecer a más de una organización»Dentro de un inquilino, su cuenta tiene una organización principal —aquella en la que se creó— y puede ser además miembro de otras organizaciones.
- Cada inicio de sesión empieza en su organización principal. No se elige organización al iniciar sesión. El menú Cambiar de organización de la barra de navegación enumera todas las organizaciones a las que pertenece, marca su organización principal como Principal y aquella en la que está trabajando como Actual, y le permite moverse entre ellas sin cerrar sesión.
- Un administrador le añade a una organización o le quita de ella. No hay forma de unirse a una organización ni de abandonarla por su cuenta. La única pertenencia automática es la de la organización Askalot Demo del entorno de pruebas gratuito, a la que se une toda cuenta de ese entorno al crearse, con los roles de diseñador, gestor y analista; es de solo lectura para todos. Tras una retirada, su sesión vuelve a su organización principal la próxima vez que se actualiza, y todo lo que tenía en la organización de la que se le retiró —sus roles en ella, su copropiedad de los proyectos de esa organización y los tokens de API y las conexiones de asistentes de IA limitados a ella— termina con la pertenencia. Su organización principal no puede retirarse.
- La pertenencia y los roles son independientes. Ser miembro le permite entrar en la organización; sus roles en esa organización deciden lo que puede hacer en ella. Un miembro sin rol allí puede abrir su perfil y los ajustes de su sesión, pero no puede ver ni trabajar con los proyectos, cuestionarios o datos de la organización hasta que un administrador le asigne un rol. Un rol que tenga en una organización nunca se traslada a otra.
- Los administradores ven cuándo estuvo activo por última vez. La página Gestión de usuarios muestra la fecha y hora de Última actividad de cada cuenta: la última vez que usó Askalot en un navegador, mediante un token de API o mediante un asistente de IA conectado, con una precisión de unos diez minutos. Una cuenta que no se ha usado indica Nunca. El trabajo que la plataforma hace en su nombre, como una simulación de IA que sigue ejecutándose después de que usted se marche, no cuenta, ni tampoco una pestaña del navegador que se deja abierta y a la que nadie vuelve.
- Los copropietarios de un proyecto deben ser miembros. Solo pueden añadirle como copropietario de un proyecto si es miembro de la organización a la que pertenece ese proyecto; consulte Compartir un cuestionario.
Un asistente de IA conectado mediante MCP funciona igual: su sesión empieza en su organización principal y puede pasar a cualquier organización que le ofrezca el menú de la barra de navegación. Consulte Su organización activa.
Seguridad de la sesión
Sección titulada «Seguridad de la sesión»- Sesiones basadas en JWT: autenticación sin estado mediante tokens firmados
- Cookies seguras: los atributos HttpOnly, Secure y SameSite evitan los ataques habituales
- Limitadas al dominio: las cookies se limitan a
.askalot.iopara el SSO entre servicios - Caducidad configurable: la duración de la sesión la fija la política de su organización
Correos de la cuenta
Sección titulada «Correos de la cuenta»Los correos de verificación de la dirección, de restablecimiento de contraseña y de confirmación de cambio de contraseña se envían con las mismas reglas de entrega que todo lo demás que envía Askalot. Dos de esas reglas pueden explicar un mensaje que nunca llega:
- Una dirección acepta como máximo cinco mensajes por hora de la misma parte de la plataforma, así que si solicita un restablecimiento repetidas veces en una misma hora, al final la solicitud se rechazará en lugar de ponerse en cola.
- Una dirección que ha producido antes un rebote permanente queda suprimida en toda la plataforma y no recibe nada, ni siquiera los correos de la cuenta, hasta que un operador levante la supresión. Si un enlace de verificación o de restablecimiento nunca llega y la dirección es correcta, pida a su operador que compruebe si hay una supresión.
- A una dirección de un dominio reservado para pruebas —
example.comy sus equivalentes, o cualquiera que termine en.test,.invalid,.localhost,.local— nunca se le envía nada. Esta es la explicación habitual cuando una cuenta de demostración o de ejemplo nunca recibe su correo de verificación.
Un mensaje no entregado nunca deshace el cambio de cuenta que lo produjo: un cambio de contraseña se aplica llegue o no su correo de confirmación, y un registro cuyo correo de verificación se rechaza crea igualmente la cuenta, que simplemente queda sin verificar hasta que le llegue un enlace de verificación. Consulte Límites de entrega y direcciones rebotadas.
Autorización de la API
Sección titulada «Autorización de la API»Para el acceso programático, Askalot ofrece dos vías de credenciales según cómo se conecte:
- Tokens de API: para la API REST y cualquier automatización no interactiva (scripts de CI, comunicación entre servidores, extracciones de datos al estilo de una hoja de cálculo).
- Inicio de sesión en el navegador con OAuth 2.1: para conectar un asistente de IA interactivo (Claude Code, Cursor) mediante MCP. Nunca pega un token; aprueba el acceso en el navegador una sola vez.
Generar tokens de API
Sección titulada «Generar tokens de API»- Inicie sesión en su panel de Roundtable
- Vaya a Configuración del perfil → Tokens de API
- Haga clic en Generar nuevo token
- Copie el token y guárdelo de forma segura (empieza por
aslat_y solo se muestra una vez)
Un token actúa en la organización en la que estaba trabajando cuando lo generó, con sus roles en ella. Si pertenece a varias organizaciones, cambie a aquella en la que debe trabajar la automatización antes de generar su token.
Usar los tokens de API
Sección titulada «Usar los tokens de API»Incluya su token en el encabezado X-Api-Token de sus llamadas REST:
X-Api-Token: aslat_your_api_tokenAuthorization: Bearer es una credencial distinta —una sesión OAuth interactiva—, y un token enviado ahí se rechaza en lugar de probarse como token de API.
Guarde los tokens en un gestor de secretos o en un archivo .env excluido de git, nunca en un archivo de inicio del shell que otros procesos puedan leer.
Consulte la documentación de la API REST y de la interfaz MCP para ver el uso detallado.
Conectar herramientas de IA mediante MCP
Sección titulada «Conectar herramientas de IA mediante MCP»La interfaz MCP (Model Context Protocol) de Askalot permite que los asistentes de IA interactúen directamente con la plataforma. El punto de conexión MCP usa OAuth 2.1, no un token pegado: solo configura la URL, y la primera llamada a una herramienta abre su navegador para que inicie sesión y apruebe el acceso.
Claude Code
Sección titulada «Claude Code»Añada el servidor a su .mcp.json (proyecto) o a ~/.claude.json (global), solo con la URL y sin token:
{ "mcpServers": { "askalot": { "type": "http", "url": "https://portor.<tenant>.askalot.io/mcp" } }}La primera vez que Claude Code llama a una herramienta de Askalot, abre su navegador para que inicie sesión y apruebe el acceso; a partir de ahí, los tokens se guardan y se renuevan automáticamente.
Añada la misma entrada, solo con la URL, a su configuración MCP en los ajustes de Cursor:
{ "mcpServers": { "askalot": { "type": "http", "url": "https://portor.<tenant>.askalot.io/mcp" } }}Cursor ejecuta el mismo inicio de sesión en el navegador la primera vez que se usa.
No interactivo (CI, n8n)
Sección titulada «No interactivo (CI, n8n)»Las automatizaciones de servidor que no pueden completar un inicio de sesión en el navegador deben usar la API REST con un token de API en lugar del punto de conexión MCP:
- URL base:
https://portor.<tenant>.askalot.io/api/v1 - Encabezado:
X-Api-Token: aslat_...(nuncaAuthorization: Bearer, que transporta un token de sesión OAuth)
Sustituya <tenant> por el nombre de inquilino de su organización.
Sus recursos iniciales
Sección titulada «Sus recursos iniciales»La primera vez que inicia sesión, Askalot prepara un espacio de trabajo personal para que pueda empezar a trabajar de inmediato:
- Proyecto predeterminado: un proyecto personal con su nombre (p. ej., «Alice’s Project»). Úselo para sus primeras encuestas o cámbiele el nombre para que corresponda a su investigación. Este proyecto no puede eliminarse. Como todo proyecto nuevo, empieza con un cuestionario inicial (véase más abajo).
- Estrategia de muestreo predeterminada: una estrategia lista para usar con factores demográficos estándar (distribuciones por género y grupo de edad). Úsela para generar grupos de encuestados representativos sin ninguna configuración. Esta estrategia es de solo lectura para garantizar una referencia común en toda su organización.
Estos recursos predeterminados se crean para cada usuario en las organizaciones no privadas. En las organizaciones privadas, los miembros comparten un panel de encuestados (encuestados, grupos y estrategias) y crean sus propios proyectos según los necesiten; consulte Uso compartido de datos según la organización.
Todo proyecto nuevo empieza con un cuestionario inicial. Siempre que se crea un proyecto —su proyecto predeterminado o cualquier proyecto que cree más adelante—, contiene un cuestionario corriente con un solo comentario que explica qué hacer con él. Cámbiele el nombre, conviértalo en su propia encuesta o elimínelo; un cuestionario inicial eliminado no vuelve. Los cuestionarios de ejemplo terminados no se copian en sus proyectos: si su entorno ofrece la organización Askalot Demo, su proyecto Example Questionnaires es el lugar para leerlos.
La página de inicio le muestra el camino. Después de iniciar sesión, la página de inicio de Roundtable muestra un camino para su proyecto: las etapas del flujo de investigación por orden, cuáles están hechas y el siguiente paso, con un enlace a la página donde se realiza. En una cuenta nueva, el camino empieza en su proyecto predeterminado. El cuestionario inicial sin modificar no cuenta como etapa terminada; un cuestionario propio que supera la validación, sí. Consulte la Guía del flujo de investigación.
Primeros pasos
Sección titulada «Primeros pasos»¿Todo listo para empezar a usar Askalot? Esto es lo que puede hacer a continuación:
-
Guía del flujo de investigación
Siga, etapa por etapa, el camino de su página de inicio
-
Inicio rápido
Cree su primera encuesta en minutos
-
Guía del usuario
Conozca todas las capacidades de la plataforma
-
Acceso a la API
Integre Askalot en sus aplicaciones
¿Necesita ayuda?
Sección titulada «¿Necesita ayuda?»Póngase en contacto con el administrador de Askalot de su organización o con el soporte:
- Correo electrónico: [email protected]
- Condiciones del servicio