Zum Inhalt springen
Wissensdatenbank

Onboarding

Dieser Leitfaden erklärt, wie Askalot Mandantentrennung und Authentifizierung umsetzt, damit die Daten Ihrer Organisation sicher und getrennt bleiben.

Organisationen können der Plattform auf drei Wegen beitreten:

Für Organisationen mit eigenem Identitätsanbieter.

Organisationen mit etablierten Identitätssystemen (Google Workspace, Microsoft Azure AD, Okta) können ihre Anmeldung per Identitätsföderation an Askalot anbinden. Die Benutzer melden sich mit ihren bestehenden Organisationskonten an und werden bei der ersten Anmeldung automatisch angelegt.

Für Organisationen ohne Möglichkeit zur Identitätsföderation.

Askalot richtet für Ihr Team eine Organisation ein. Benutzer mit der Rolle org_admin können neue Mitglieder per E-Mail einladen. Eingeladene registrieren sich mit einer beliebigen unterstützten Anmeldemethode – E-Mail und Passwort oder ein öffentlicher Anbieter (Google oder Microsoft) – und sind nicht auf einen Identitätsanbieter der Organisation beschränkt.

Für einzelne Forschende und kleine Teams.

Der Entwicklungsmandant bietet Forschenden, die die Plattform ohne organisatorische Verpflichtung ausprobieren möchten, eine Selbstregistrierung in der gemeinsamen Organisation ACME Corp. Sie ist wirklich kostenlos – ohne ablaufende Testphase, ohne Kreditkarte und ohne Eignungsprüfung, für kommerzielle wie nichtkommerzielle Arbeit gleichermaßen. Der Preis dafür: Sie wird so bereitgestellt, wie sie ist – ohne Gewährleistung, ohne SLA und ohne Supportzusage. Braucht Ihre Arbeit einen benannten Vertragspartner, der für Ergebnisse, Verfügbarkeit und Support vertraglich einsteht, übernimmt das die Askalot Survey & Research Kft. im Rahmen eines Vertrags – wenden Sie sich an [email protected]. Registrieren Sie sich mit einer beliebigen unterstützten Anmeldemethode: Eine Registrierung mit Passwort erfordert eine Bestätigung der E-Mail-Adresse, während die Anmeldung über einen vertrauenswürdigen öffentlichen Anbieter (Google oder Microsoft) sofortigen Zugang ohne Bestätigung gewährt, da Askalot der Identitätsprüfung des Anbieters vertraut.

Sie möchten sich erst einmal umsehen? Der Link „Live-Demo ausprobieren“ auf der Startseite meldet Sie bei einem gemeinsamen Demokonto in einer versiegelten Organisation an, die bereits Beispielfragebögen aus mehreren Fachgebieten, Kampagnen, ausgefüllte Umfragen und analysierte Datensätze enthält. Deren Forschungsbestand lässt sich nicht ändern. So können Sie jede Phase der Plattform erkunden, ohne sich zu registrieren und ohne etwas für die nächste Besucherin oder den nächsten Besucher zu verändern. Sie können sogar einen Fragebogen in einer Vorschau vollständig durchspielen und QML in einer temporären Sandbox, die nie speichert, selbst bearbeiten.

Sobald Sie sich in der Sandbox registriert haben, brauchen Sie das gemeinsame Konto nicht mehr, um dorthin zurückzukehren: Auch Ihr eigenes Konto ist Mitglied der Organisation Askalot Demo. Öffnen Sie sie über das Menü Organisation wechseln, um jedes kuratierte Projekt zu lesen, darunter Example Questionnaires mit vollständigen Beispielfragebögen (jeder Item-Typ, ein Demografieblock und eine Umfrage zum Lebensmittelverbrauch im Haushalt) zum Lernen. Die Organisation bleibt versiegelt: Dort lesen Sie und sehen sich Vorschauen an, Ihre eigene Arbeit erledigen Sie in Ihrer Heimatorganisation.

Askalot nutzt eine vollständig getrennte mandantenfähige Architektur, in der jede Organisation (jeder Mandant) in einer komplett separaten Umgebung arbeitet. Dieses Design bietet:

  • Vollständige Datentrennung: Ihre Umfragen, Befragten und Antworten werden getrennt von anderen Organisationen gespeichert
  • Unabhängige Ressourcen: Jeder Mandant hat eigene Rechenressourcen ohne gemeinsame Verarbeitung
  • Eigene Domains: Sie erreichen Ihre Umgebung über <service>.<tenant>.askalot.io

Jeder Mandant läuft in seiner eigenen, abgeschotteten Umgebung mit:

  • Eigener Netzwerkgrenze: Mandanten können nicht direkt miteinander kommunizieren
  • Eigenem Speicher: Speicher-Volumes sind ausschließlich dem jeweiligen Mandanten zugeordnet
  • Unabhängigen Dienstinstanzen: Jeder Mandant betreibt seine eigene Kopie aller Dienste

Nach dem Onboarding erreichen Sie Ihre Umgebung über diese URLs:

Dienst URL-Muster Zweck
Roundtable roundtable.<tenant>.askalot.io Dashboard und Benutzerverwaltung
SirWay sirway.<tenant>.askalot.io Durchführung von Umfragen
Targetor targetor.<tenant>.askalot.io Kampagnenverwaltung
Armiger armiger.<tenant>.askalot.io Fragebogeneditor
Balansor balansor.<tenant>.askalot.io Statistische Analyse
Portor portor.<tenant>.askalot.io API-Gateway & MCP

Ersetzen Sie <tenant> durch den Mandantennamen, der Ihrer Organisation zugewiesen wurde.

Askalot nutzt ein zentrales Authentifizierungssystem, das Single Sign-on (SSO) über alle Dienste Ihres Mandanten hinweg bietet.

Die Authentifizierung übernimmt ein globaler OIDC-Identitätsanbieter (OpenID Connect), der alle Mandanten bedient. Dieses Design bietet:

  • Single Sign-on: Einmal anmelden und alle Askalot-Dienste nutzen
  • Datenschutzfreundliche Zuordnung: Ihre Mandantenzugehörigkeit wird anderen Organisationen nie offengelegt
  • Mehrere Anmeldemethoden: Unterstützung für Passwort und Social Login (Google, Microsoft)
BrowserGlobaler OIDC(askalot.io)Dienste IhresMandanten 1. askalot.io aufrufen2. Zugangsdaten eingeben3. Beim Mandanten prüfen 4. Benutzer bestätigt5. Sitzungscookie setzen & weiterleiten6. Dienste nutzen (bereits angemeldet)

Der Ablauf Schritt für Schritt:

  1. Rufen Sie die Startseite auf unter https://askalot.io
  2. Geben Sie E-Mail-Adresse und Passwort ein (oder nutzen Sie Social Login)
  3. Automatische Mandantenzuordnung – das System ermittelt, zu welchem Mandanten bzw. welchen Mandanten Sie gehören
  4. Sitzung hergestellt – ein sicheres Cookie wird für alle Askalot-Dienste gesetzt
  5. Weiterleitung zu Ihrem Mandanten – Sie gelangen automatisch zu Ihrem Dashboard
Methode Beschreibung
E-Mail + Passwort Klassische Anmeldung mit Benutzername und Passwort
Google Anmeldung mit Ihrem Google-Konto
Microsoft Anmeldung mit Ihrem Microsoft-/Azure-AD-Konto

Weitere Identitätsanbieter (Okta, Apple, Facebook) sind für Unternehmensbereitstellungen geplant.

Hat dieselbe E-Mail-Adresse in mehr als einem Mandanten ein Konto, fragt die Anmeldung, welches verwendet werden soll:

  1. Geben Sie E-Mail-Adresse und Passwort ein
  2. Der Dialog Umgebung auswählen listet die Mandanten auf, in denen für diese E-Mail-Adresse ein Konto besteht
  3. Wählen Sie den Mandanten, auf den Sie zugreifen möchten

Um später zu einem anderen Mandanten zu wechseln, melden Sie sich ab und wählen bei der Anmeldung den anderen. Die Konten sind getrennt: Zwischen Mandanten wird nichts geteilt.

Die Ausnahme ist das Verbinden eines KI-Assistenten: Die Adresse des MCP-Connectors nennt bereits einen Mandanten, daher führt seine Anmeldung zu diesem Mandanten und zeigt den Dialog Umgebung auswählen nicht. Liegt Ihr Konto bei einem anderen Mandanten, verbinden Sie sich mit dessen Adresse.

Innerhalb eines Mandanten hat Ihr Konto genau eine Heimatorganisation – die, in der es angelegt wurde –, und Sie können zusätzlich Mitglied weiterer Organisationen sein.

  • Jede Anmeldung beginnt in Ihrer Heimatorganisation. Bei der Anmeldung gibt es keine Organisationsauswahl. Das Menü Organisation wechseln in der Navigationsleiste listet jede Organisation auf, der Sie angehören, kennzeichnet Ihre Heimatorganisation mit Primär und die, in der Sie gerade arbeiten, mit Aktuell, und wechselt zwischen ihnen, ohne dass Sie sich abmelden müssen.
  • Eine Administratorin oder ein Administrator fügt Sie einer Organisation hinzu oder entfernt Sie daraus. Selbst können Sie einer Organisation weder beitreten noch sie verlassen. Die einzige automatische Mitgliedschaft ist die Organisation Askalot Demo in der kostenlosen Sandbox, der jedes Konto dort beim Anlegen mit den Rollen designer, manager und analyst beitritt; sie ist für alle schreibgeschützt. Nach einer Entfernung kehrt Ihre Sitzung bei der nächsten Aktualisierung zu Ihrer Heimatorganisation zurück, und alles, was Sie in der entfernten Organisation hatten – Ihre Rollen dort, Ihre Mitinhaberschaft an ihren Projekten sowie die darauf beschränkten API-Tokens und KI-Assistenten-Verbindungen –, endet mit der Mitgliedschaft. Ihre Heimatorganisation kann Ihnen nicht entzogen werden.
  • Mitgliedschaft und Rollen sind getrennt. Als Mitglied können Sie in die Organisation wechseln; Ihre Rollen in dieser Organisation entscheiden, was Sie dort tun können. Ein Mitglied ohne Rolle dort kann sein Profil und seine Sitzungseinstellungen öffnen, aber die Projekte, Fragebögen und Daten der Organisation weder sehen noch bearbeiten, bis eine Administratorin oder ein Administrator eine Rolle vergibt. Eine Rolle, die Sie in einer Organisation haben, gilt nie automatisch in einer anderen.
  • Administratoren sehen, wann Sie zuletzt aktiv waren. Die Seite Benutzerverwaltung zeigt für jedes Konto Datum und Uhrzeit unter Zuletzt gesehen: wann Sie Askalot zuletzt im Browser, über ein API-Token oder über einen verbundenen KI-Assistenten genutzt haben, auf etwa zehn Minuten genau. Ein nie genutztes Konto zeigt Nie. Arbeit, die die Plattform in Ihrem Auftrag erledigt – etwa eine KI-Simulation, die weiterläuft, nachdem Sie gegangen sind –, zählt nicht, ebenso wenig ein offen gelassener Browser-Tab, zu dem niemand zurückkehrt.
  • Mitinhaber eines Projekts müssen Mitglieder sein. Als Mitinhaber eines Projekts können Sie nur hinzugefügt werden, wenn Sie Mitglied der Organisation sind, zu der das Projekt gehört – siehe Einen Fragebogen teilen.

Ein über MCP verbundener KI-Assistent funktioniert genauso: Seine Sitzung beginnt in Ihrer Heimatorganisation und kann in jede Organisation wechseln, die Ihnen das Menü in der Navigationsleiste anbietet. Siehe Ihre aktive Organisation.

  • JWT-basierte Sitzungen: Zustandslose Authentifizierung mit signierten Tokens
  • Sichere Cookies: Die Flags HttpOnly, Secure und SameSite verhindern gängige Angriffe
  • Domaingebunden: Cookies gelten für .askalot.io, damit SSO über alle Dienste funktioniert
  • Konfigurierbare Gültigkeit: Die Sitzungsdauer legt die Richtlinie Ihrer Organisation fest

E-Mails zur Bestätigung der Adresse, zum Zurücksetzen des Passworts und zur Bestätigung einer Passwortänderung unterliegen denselben Versandregeln wie alle anderen E-Mails von Askalot. Zwei dieser Regeln können erklären, warum eine Nachricht nie ankommt:

  • Eine Adresse nimmt pro Stunde höchstens fünf Nachrichten vom selben Teil der Plattform an. Wer innerhalb einer Stunde wiederholt ein Zurücksetzen anfordert, wird daher irgendwann abgewiesen, statt in eine Warteschlange zu kommen.
  • Eine Adresse, die zuvor einen Hard Bounce verursacht hat, wird plattformweit gesperrt und erhält nichts mehr, bis ein Operator die Sperre aufhebt – auch keine Konto-E-Mails. Kommt ein Bestätigungs- oder Zurücksetzungslink nie an, obwohl die Adresse stimmt, bitten Sie Ihren Operator, nach einer Sperre zu sehen.
  • An eine Adresse auf einer für Tests reservierten Domain – example.com und verwandte Domains oder alles, was auf .test, .invalid, .localhost, .local endet – wird überhaupt nie gesendet. Das ist die übliche Erklärung, wenn ein Demo- oder Beispielkonto nie seine Bestätigungs-E-Mail erhält.

Eine nicht zugestellte Nachricht macht die Kontoänderung, die sie ausgelöst hat, nie rückgängig: Eine Passwortänderung wird angewendet, ob ihre Bestätigungs-E-Mail ankommt oder nicht, und eine Registrierung, deren Bestätigungs-E-Mail abgewiesen wird, legt das Konto trotzdem an – es bleibt nur unbestätigt, bis ein Bestätigungslink Sie erreicht. Siehe Versandgrenzen und unzustellbare Adressen.

Für den programmatischen Zugriff bietet Askalot je nach Verbindungsart zwei Wege:

  • API-Tokens – für die REST-API und jede nicht interaktive Automatisierung (CI-Skripte, Server-zu-Server, Datenabrufe, wie sie etwa eine Tabellenkalkulation ausführt).
  • OAuth-2.1-Anmeldung im Browser – zum Verbinden eines interaktiven KI-Assistenten (Claude Code, Cursor) über MCP. Sie fügen nie ein Token ein, sondern genehmigen den Zugriff einmal im Browser.
  1. Melden Sie sich bei Ihrem Roundtable-Dashboard an
  2. Öffnen Sie Profileinstellungen → API-Tokens
  3. Klicken Sie auf Neues Token erzeugen
  4. Kopieren Sie das Token und bewahren Sie es sicher auf (es beginnt mit aslat_ und wird nur einmal angezeigt)

Ein Token gilt für die Organisation, in der Sie es erzeugt haben, und arbeitet mit Ihren dortigen Rollen. Gehören Sie mehreren Organisationen an, wechseln Sie vor dem Erzeugen in die Organisation, in der die Automatisierung arbeiten soll.

Geben Sie Ihr Token im Header X-Api-Token Ihrer REST-Aufrufe mit:

X-Api-Token: aslat_your_api_token

Authorization: Bearer steht für andere Zugangsdaten – eine interaktive OAuth-Sitzung –, und ein dort gesendetes Token wird abgelehnt und nicht etwa als API-Token ausprobiert.

Bewahren Sie Tokens in einem Secrets-Manager oder einer von Git ignorierten .env-Datei auf – nie in einer Shell-Startdatei, die andere Prozesse lesen können.

Ausführliche Informationen zur Nutzung finden Sie in der Dokumentation zur REST-API und zur MCP-Schnittstelle.

Über die MCP-Schnittstelle (Model Context Protocol) von Askalot können KI-Assistenten direkt mit der Plattform arbeiten. Der MCP-Endpunkt nutzt OAuth 2.1 statt eines eingefügten Tokens: Sie konfigurieren nur die URL, und der erste Tool-Aufruf öffnet Ihren Browser zur Anmeldung und Genehmigung des Zugriffs.

Tragen Sie den Server in Ihre .mcp.json (Projekt) oder ~/.claude.json (global) ein – nur die URL, kein Token:

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

Wenn Claude Code zum ersten Mal ein Askalot-Tool aufruft, öffnet es Ihren Browser zur Anmeldung und Genehmigung des Zugriffs; die Tokens werden danach gespeichert und automatisch erneuert.

Tragen Sie denselben Eintrag mit nur der URL in Ihre MCP-Konfiguration in den Cursor-Einstellungen ein:

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

Cursor führt bei der ersten Nutzung dieselbe Anmeldung im Browser durch.

Server-Automatisierungen, die keine Anmeldung im Browser durchlaufen können, sollten statt des MCP-Endpunkts die REST-API mit einem API-Token ansprechen:

  • Basis-URL: https://portor.<tenant>.askalot.io/api/v1
  • Header: X-Api-Token: aslat_... (nie Authorization: Bearer, das ein OAuth-Sitzungstoken trägt)

Ersetzen Sie <tenant> durch den Mandantennamen Ihrer Organisation.

Bei Ihrer ersten Anmeldung richtet Askalot einen persönlichen Arbeitsbereich ein, damit Sie sofort loslegen können:

  • Standardprojekt – Ein persönliches Projekt, das nach Ihnen benannt ist (z. B. „Alice’s Project“). Nutzen Sie es für Ihre ersten Umfragen oder benennen Sie es passend zu Ihrer Forschung um. Dieses Projekt kann nicht gelöscht werden. Wie jedes neue Projekt beginnt es mit einem Start-Fragebogen (siehe unten).
  • Standard-Stichprobenstrategie – Eine sofort nutzbare Strategie mit üblichen demografischen Faktoren (Verteilungen nach Geschlecht und Altersgruppe). Damit erzeugen Sie ohne jede Konfiguration repräsentative Befragtenpools. Diese Strategie ist schreibgeschützt, damit in Ihrer Organisation eine einheitliche Ausgangsbasis gilt.

Diese Standardressourcen werden in nicht privaten Organisationen für jeden Benutzer angelegt. In privaten Organisationen teilen sich die Mitglieder ein gemeinsames Befragtenpanel (Befragte, Pools und Strategien) und legen ihre Projekte nach Bedarf selbst an; siehe Datenfreigabe in Organisationen.

Jedes neue Projekt beginnt mit einem Start-Fragebogen. Wann immer ein Projekt angelegt wird – Ihr Standardprojekt oder jedes Projekt, das Sie später anlegen –, enthält es einen gewöhnlichen Fragebogen mit einem einzigen Kommentar, der erklärt, was Sie damit tun können. Benennen Sie ihn um, bearbeiten Sie ihn zu Ihrer eigenen Umfrage oder löschen Sie ihn; ein gelöschter Start-Fragebogen kommt nicht zurück. Fertige Beispielfragebögen werden nicht in Ihre Projekte kopiert: Wo Ihre Umgebung die Organisation Askalot Demo anbietet, lesen Sie sie im dortigen Projekt Example Questionnaires.

Die Startseite weist Ihnen den Weg. Nach der Anmeldung zeigt die Startseite von Roundtable einen Weg für Ihr Projekt: die Phasen des Forschungsablaufs der Reihe nach, welche erledigt sind, und den nächsten Schritt mit einem Link zu der Seite, auf der er erledigt wird. Bei einem neuen Konto beginnt der Weg mit Ihrem Standardprojekt. Der unveränderte Start-Fragebogen zählt nicht als erledigte Phase; ein eigener Fragebogen, der die Validierung besteht, schon. Siehe Leitfaden zum Forschungsablauf.

Bereit, mit Askalot zu arbeiten? So geht es weiter:

Wenden Sie sich an die Person, die Askalot in Ihrer Organisation administriert, oder an den Support: