Aller au contenu
Base de connaissances

Prise en main

Ce guide explique comment Askalot gère le déploiement multi-instance et l’authentification, afin que les données de votre organisation restent sécurisées et isolées.

Les organisations peuvent rejoindre la plateforme de trois façons :

Pour les organisations disposant déjà d’un fournisseur d’identité.

Les organisations dotées d’un système d’identité établi (Google Workspace, Microsoft Azure AD, Okta) peuvent fédérer leur authentification avec Askalot. Les utilisateurs se connectent avec leur compte professionnel existant, et leur compte est provisionné automatiquement lors de la première connexion.

Pour les organisations sans capacité de fédération d’identité.

Askalot crée une organisation pour votre équipe. Les utilisateurs dotés du rôle org_admin peuvent inviter de nouveaux membres par e-mail. Les utilisateurs invités s’inscrivent avec n’importe quelle méthode d’authentification prise en charge — adresse e-mail et mot de passe, ou un fournisseur public (Google ou Microsoft) : ils ne sont pas limités au fournisseur d’identité d’une organisation.

Pour les chercheurs individuels et les petites équipes.

L’instance de développement permet de s’inscrire en libre-service dans l’organisation partagée ACME Corp, pour les chercheurs qui veulent essayer la plateforme sans engagement de leur organisation. C’est réellement gratuit, sans limite de durée d’essai, sans carte bancaire et sans condition d’éligibilité, pour un usage commercial comme non commercial. La contrepartie est que le service est fourni en l’état : sans garantie, sans SLA et sans engagement d’assistance. Lorsque votre travail exige un interlocuteur nommé, contractuellement responsable des résultats, de la disponibilité et de l’assistance, c’est ce qu’Askalot Survey & Research Kft. propose sous contrat — écrivez à [email protected]. Inscrivez-vous avec n’importe quelle méthode de connexion prise en charge : l’inscription par mot de passe exige une vérification de l’adresse e-mail, tandis que la connexion via un fournisseur public de confiance (Google ou Microsoft) donne un accès immédiat sans vérification, car Askalot se fie à la confirmation d’identité du fournisseur.

Vous voulez d’abord jeter un coup d’œil ? Le lien Essayer la démo interactive de la page d’accueil du site vous connecte à un compte de démonstration partagé, dans une organisation scellée préchargée avec des questionnaires d’exemple dans plusieurs domaines, des campagnes, des enquêtes remplies et des jeux de données analysés. Son dossier de recherche ne peut pas être modifié : vous pouvez donc explorer chaque étape de la plateforme sans vous inscrire et sans rien perturber pour le visiteur suivant — y compris essayer un questionnaire de bout en bout dans un aperçu, et modifier vous-même du QML dans un bac à sable temporaire qui n’enregistre jamais rien.

Une fois inscrit sur le bac à sable, vous n’avez plus besoin du compte partagé pour y revenir : votre propre compte est également membre de l’organisation Askalot Demo. Ouvrez-la depuis le menu Changer d’organisation pour lire chacun des projets soigneusement choisis, dont Example Questionnaires, qui regroupe des questionnaires d’exemple complets (tous les types de contrôles, un bloc de données démographiques et une enquête sur la consommation alimentaire des ménages) dont vous pouvez vous inspirer. Elle reste scellée : vous y lisez et prévisualisez, et vous faites votre propre travail dans votre organisation d’origine.

Askalot repose sur une architecture multi-instance entièrement isolée, dans laquelle chaque organisation (instance) fonctionne dans un environnement totalement séparé. Cette conception apporte :

  • Une isolation complète des données : vos enquêtes, vos participants et leurs réponses sont stockés séparément de ceux des autres organisations
  • Des ressources indépendantes : chaque instance dispose de ressources de calcul dédiées, sans traitement partagé
  • Des domaines personnalisés : accédez à votre environnement via <service>.<tenant>.askalot.io

Chaque instance s’exécute dans son propre environnement isolé, avec :

  • Une frontière réseau distincte : les instances ne peuvent pas communiquer directement entre eux
  • Un stockage dédié : les volumes de données sont montés exclusivement pour chaque instance
  • Des services indépendants : chaque instance exécute sa propre copie de l’ensemble des services

Une fois votre organisation en place, vous accédez à votre environnement par ces URL :

Service Modèle d’URL Rôle
Roundtable roundtable.<tenant>.askalot.io Tableau de bord et gestion des utilisateurs
SirWay sirway.<tenant>.askalot.io Conduite des enquêtes
Targetor targetor.<tenant>.askalot.io Gestion des campagnes
Armiger armiger.<tenant>.askalot.io Éditeur de questionnaires
Balansor balansor.<tenant>.askalot.io Analyse statistique
Portor portor.<tenant>.askalot.io Passerelle API et MCP

Remplacez <tenant> par le nom d’instance attribué à votre organisation.

Askalot utilise un système d’authentification centralisé qui offre l’authentification unique (SSO) pour tous les services de votre instance.

L’authentification est assurée par un fournisseur d’identité OIDC (OpenID Connect) global qui dessert toutes les instances. Cette conception apporte :

  • L’authentification unique : connectez-vous une fois et accédez à tous les services d’Askalot
  • Une découverte respectueuse de la vie privée : votre appartenance à une instance n’est jamais révélée aux autres organisations
  • Plusieurs méthodes d’authentification : prise en charge du mot de passe et de la connexion via un réseau social (Google, Microsoft)
NavigateurOIDC global(askalot.io)Services devotre instance 1. Accès à askalot.io2. Saisie des identifiants3. Vérification auprès de l'instance 4. Utilisateur confirmé5. Cookie de session et redirection6. Accès aux services (déjà connecté)

Le déroulé étape par étape :

  1. Rendez-vous sur la page d’accueil à l’adresse https://askalot.io
  2. Saisissez votre adresse e-mail et votre mot de passe (ou utilisez une connexion via un réseau social)
  3. Découverte automatique de l’instance — le système identifie la ou les instances auxquelles vous appartenez
  4. Session établie — un cookie sécurisé est défini pour tous les services d’Askalot
  5. Redirection vers votre instance — vous êtes automatiquement dirigé vers votre tableau de bord
Méthode Description
E-mail + mot de passe Authentification classique par identifiant et mot de passe
Google Connexion avec votre compte Google
Microsoft Connexion avec votre compte Microsoft/Azure AD

D’autres fournisseurs d’identité (Okta, Apple, Facebook) sont prévus pour les déploiements en entreprise.

Si la même adresse e-mail possède un compte dans plusieurs instances, la connexion vous demande laquelle utiliser :

  1. Saisissez votre adresse e-mail et votre mot de passe
  2. Une boîte de dialogue Choisir l’environnement liste les instances qui détiennent un compte pour cette adresse
  3. Choisissez l’instance à laquelle accéder

Pour passer ensuite à une autre instance, déconnectez-vous et choisissez l’autre lors de la connexion. Les comptes sont distincts : rien n’est partagé entre les instances.

La connexion d’un assistant IA fait exception : l’adresse du connecteur MCP désigne déjà une instance, si bien que sa connexion se fait auprès de cette instance et n’affiche aucune boîte de dialogue Choisir l’environnement. Si votre compte se trouve sur une autre instance, connectez-vous avec l’adresse de cette instance.

Au sein d’une instance, votre compte a une organisation d’origine — celle dans laquelle il a été créé —, et vous pouvez aussi être membre d’autres organisations.

  • Chaque connexion commence dans votre organisation d’origine. Aucun choix d’organisation n’est proposé à la connexion. Le menu Changer d’organisation de la barre de navigation liste toutes les organisations dont vous êtes membre, marque votre organisation d’origine comme Principale et celle dans laquelle vous travaillez comme Actuelle, et vous permet de passer de l’une à l’autre sans vous déconnecter.
  • C’est un administrateur qui vous ajoute à une organisation ou vous en retire. Vous ne pouvez ni rejoindre ni quitter une organisation par vous-même. La seule appartenance automatique est celle de l’organisation Askalot Demo sur le bac à sable gratuit, que chaque compte y rejoint à sa création avec les rôles Concepteur, Gestionnaire et Analyste ; elle est en lecture seule pour tout le monde. Après un retrait, votre session revient à votre organisation d’origine lors de son prochain rafraîchissement, et tout ce que vous déteniez dans l’organisation dont vous avez été retiré — vos rôles, votre copropriété de ses projets, ainsi que les jetons API et les connexions d’assistants IA qui lui sont rattachés — prend fin avec l’appartenance. Votre organisation d’origine ne peut pas vous être retirée.
  • Appartenance et rôles sont distincts. Être membre vous permet de basculer dans l’organisation ; ce sont vos rôles dans cette organisation qui déterminent ce que vous pouvez y faire. Un membre sans rôle peut ouvrir son profil et les paramètres de sa session, mais ne peut ni voir ni traiter les projets, questionnaires ou données de l’organisation tant qu’un administrateur ne lui a pas attribué de rôle. Un rôle détenu dans une organisation n’est jamais reporté dans une autre.
  • Les administrateurs voient quand vous avez été actif pour la dernière fois. La page Gestion des utilisateurs affiche pour chaque compte la date et l’heure de Dernière activité : la dernière fois que vous avez utilisé Askalot dans un navigateur, par un jeton API ou par un assistant IA connecté, à une dizaine de minutes près. Un compte jamais utilisé indique Jamais. Le travail que la plateforme effectue en votre nom, comme une simulation IA qui se poursuit après votre départ, n’est pas pris en compte, pas plus qu’un onglet de navigateur resté ouvert auquel personne ne revient.
  • Les copropriétaires d’un projet doivent être membres. Vous ne pouvez être ajouté comme copropriétaire d’un projet que si vous êtes membre de l’organisation à laquelle ce projet appartient — consultez Partager un questionnaire.

Un assistant IA connecté via MCP fonctionne de la même manière : sa session commence dans votre organisation d’origine et peut être déplacée vers toute organisation que vous propose le menu de la barre de navigation. Consultez Votre organisation active.

  • Sessions fondées sur JWT : authentification sans état reposant sur des jetons signés
  • Cookies sécurisés : les attributs HttpOnly, Secure et SameSite préviennent les attaques courantes
  • Portée limitée au domaine : les cookies sont rattachés à .askalot.io pour l’authentification unique entre les services
  • Expiration configurable : la durée des sessions est fixée par la politique de votre organisation

Les e-mails de vérification d’adresse, de réinitialisation du mot de passe et de confirmation de changement de mot de passe sont envoyés selon les mêmes règles de distribution que tous les autres envois d’Askalot. Deux de ces règles peuvent expliquer qu’un message n’arrive jamais :

  • Une adresse accepte au plus cinq messages par heure provenant d’une même partie de la plateforme : des demandes de réinitialisation répétées dans l’heure finiront donc par être refusées plutôt que mises en file d’attente.
  • Une adresse ayant déjà fait l’objet d’un rebond définitif est bloquée sur toute la plateforme et ne reçoit plus rien tant qu’un opérateur n’a pas levé le blocage — y compris les e-mails liés au compte. Si un lien de vérification ou de réinitialisation n’arrive jamais alors que l’adresse est correcte, demandez à votre opérateur de vérifier si elle est bloquée.
  • Une adresse sur un domaine réservé aux tests — example.com et ses semblables, ou tout domaine se terminant par .test, .invalid, .localhost, .local — ne reçoit jamais aucun envoi. C’est l’explication habituelle lorsqu’un compte de démonstration ou d’exemple ne reçoit jamais son e-mail de vérification.

Un message non distribué n’annule jamais la modification du compte qui l’a déclenché : un changement de mot de passe est appliqué, que son e-mail de confirmation arrive ou non, et une inscription dont l’e-mail de vérification est refusé crée tout de même le compte — il reste simplement non vérifié jusqu’à ce qu’un lien de vérification vous parvienne. Consultez Limites d’envoi et adresses en rebond.

Pour l’accès par programmation, Askalot propose deux types d’identifiants selon votre mode de connexion :

  • Les jetons API — pour l’API REST et toute automatisation non interactive (scripts de CI, échanges de serveur à serveur, extractions de données vers un tableur).
  • La connexion OAuth 2.1 dans le navigateur — pour connecter un assistant IA interactif (Claude Code, Cursor) via MCP. Vous ne collez jamais de jeton : vous approuvez l’accès une fois dans le navigateur.
  1. Connectez-vous à votre tableau de bord Roundtable
  2. Rendez-vous dans Paramètres du profil → Jetons API
  3. Cliquez sur Générer un nouveau jeton
  4. Copiez le jeton et conservez-le en lieu sûr (il commence par aslat_ et n’est affiché qu’une seule fois)

Un jeton agit dans l’organisation dans laquelle vous travailliez au moment de sa génération, avec les rôles que vous y détenez. Si vous appartenez à plusieurs organisations, basculez dans celle où l’automatisation doit travailler avant de générer son jeton.

Incluez votre jeton dans l’en-tête X-Api-Token de vos appels REST :

X-Api-Token: aslat_your_api_token

Authorization: Bearer correspond à d’autres identifiants — une session OAuth interactive —, et un jeton envoyé dans cet en-tête est refusé au lieu d’être essayé comme jeton API.

Conservez vos jetons dans un gestionnaire de secrets ou dans un fichier .env ignoré par git — jamais dans un fichier de démarrage du shell que d’autres processus peuvent lire.

Consultez la documentation de l’API REST et de l’interface MCP pour une utilisation détaillée.

L’interface MCP (Model Context Protocol) d’Askalot permet aux assistants IA d’interagir directement avec la plateforme. Le point de terminaison MCP utilise OAuth 2.1, et non un jeton collé : vous ne configurez que l’URL, et le premier appel d’outil ouvre votre navigateur pour vous connecter et approuver l’accès.

Ajoutez le serveur à votre fichier .mcp.json (projet) ou ~/.claude.json (global) — l’URL seule, sans jeton :

{
"mcpServers": {
"askalot": {
"type": "http",
"url": "https://portor.<tenant>.askalot.io/mcp"
}
}
}

La première fois que Claude Code appelle un outil Askalot, il ouvre votre navigateur pour que vous vous connectiez et approuviez l’accès ; les jetons sont ensuite stockés et renouvelés automatiquement.

Ajoutez la même entrée, limitée à l’URL, à votre configuration MCP dans les paramètres de Cursor :

{
"mcpServers": {
"askalot": {
"type": "http",
"url": "https://portor.<tenant>.askalot.io/mcp"
}
}
}

Cursor procède à la même connexion dans le navigateur lors de la première utilisation.

Les automatisations côté serveur qui ne peuvent pas effectuer une connexion dans le navigateur doivent piloter l’API REST avec un jeton API au lieu du point de terminaison MCP :

  • URL de base : https://portor.<tenant>.askalot.io/api/v1
  • En-tête : X-Api-Token: aslat_... (jamais Authorization: Bearer, qui transporte un jeton de session OAuth)

Remplacez <tenant> par le nom d’instance de votre organisation.

Lors de votre première connexion, Askalot prépare un espace de travail personnel pour que vous puissiez commencer à travailler immédiatement :

  • Projet par défaut — Un projet personnel à votre nom (par exemple « Alice’s Project »). Utilisez-le pour vos premières enquêtes ou renommez-le en fonction de votre recherche. Ce projet ne peut pas être supprimé. Comme tout nouveau projet, il commence avec un questionnaire de départ (voir ci-dessous).
  • Stratégie d’échantillonnage par défaut — Une stratégie prête à l’emploi avec des facteurs démographiques standard (répartitions par genre et par tranche d’âge). Utilisez-la pour générer des viviers de répondants représentatifs sans aucune configuration. Cette stratégie est en lecture seule afin de garantir une base de référence cohérente dans toute votre organisation.

Ces ressources par défaut sont créées pour chaque utilisateur des organisations non privées. Dans les organisations privées, les membres partagent un même panel de répondants (répondants, viviers et stratégies) et créent leurs propres projets selon leurs besoins ; consultez Partage des données au sein d’une organisation.

Chaque nouveau projet commence avec un questionnaire de départ. Chaque fois qu’un projet est créé — votre projet par défaut ou tout projet que vous créez ensuite —, il contient un questionnaire ordinaire composé d’un seul commentaire qui explique quoi en faire. Renommez-le, transformez-le en votre propre enquête ou supprimez-le ; un questionnaire de départ supprimé ne revient pas. Les questionnaires d’exemple aboutis ne sont pas copiés dans vos projets : lorsque votre environnement propose l’organisation Askalot Demo, c’est son projet Example Questionnaires qu’il faut consulter.

La page d’accueil vous montre le chemin. Une fois connecté, la page d’accueil de Roundtable affiche un parcours pour votre projet : les étapes du parcours de recherche dans l’ordre, celles qui sont terminées, et l’étape suivante avec un lien vers la page où elle se réalise. Sur un nouveau compte, le parcours s’ouvre sur votre projet par défaut. Le questionnaire de départ laissé intact ne compte pas comme une étape terminée ; un questionnaire qui vous est propre et qui passe la validation, si. Consultez le Guide du parcours de recherche.

Envie de vous lancer ? Voici la marche à suivre :

Contactez l’administrateur Askalot de votre organisation ou adressez-vous à l’assistance :