Első lépések
Ez az útmutató bemutatja, hogyan kezeli az Askalot a többbérlős telepítést és a hitelesítést úgy, hogy szervezete adatai biztonságban és elkülönítve maradjanak.
Hogyan csatlakozhat az Askalothoz?
Szekció neve “Hogyan csatlakozhat az Askalothoz?”A szervezetek háromféle módon csatlakozhatnak a platformhoz:
Vállalati föderáció
Szekció neve “Vállalati föderáció”Meglévő identitásszolgáltatóval rendelkező szervezeteknek.
A kiépített identitásrendszerrel (Google Workspace, Microsoft Azure AD, Okta) rendelkező szervezetek föderálhatják a hitelesítést az Askalottal. A felhasználók meglévő szervezeti fiókjukkal jelentkeznek be, és az első bejelentkezéskor a fiókjuk automatikusan létrejön.
Kezelt bevezetés
Szekció neve “Kezelt bevezetés”Identitásföderációra nem képes szervezeteknek.
Az Askalot létrehoz egy szervezetet az Ön csapata számára. Az org_admin szerepkörű felhasználók e-mailben hívhatnak meg új tagokat. A meghívott felhasználók bármely támogatott hitelesítési módszerrel regisztrálhatnak – e-mail-címmel és jelszóval, vagy nyilvános szolgáltatóval (Google vagy Microsoft) –, nem csak szervezeti identitásszolgáltatóval.
Önkiszolgáló (demó)
Szekció neve “Önkiszolgáló (demó)”Egyéni kutatóknak és kis csapatoknak.
A fejlesztői bérlőn önkiszolgáló regisztrációval csatlakozhatnak a közös ACME Corp szervezethez azok a kutatók, akik szervezeti elköteleződés nélkül szeretnék kipróbálni a platformot – ez valóban ingyenes: nincs próbaidő, nem kell bankkártya, és nincs jogosultsági feltétel: üzleti és nem üzleti célú munkára egyaránt használható. Cserébe a szolgáltatás „ahogy van” alapon érhető el: garancia, SLA és támogatási kötelezettségvállalás nélkül. Ha a munkájához olyan nevesített szerződő félre van szüksége, aki szerződésben felel az eredményekért, a rendelkezésre állásért és a támogatásért, ezt az Askalot Survey & Research Kft. szerződés keretében kínálja – írjon az [email protected] címre. Bármely támogatott bejelentkezési módszerrel regisztrálhat: a jelszavas regisztrációhoz e-mail-cím-megerősítés szükséges, míg egy megbízható nyilvános szolgáltatón (Google vagy Microsoft) keresztüli bejelentkezés megerősítés nélkül, azonnal hozzáférést ad, mivel az Askalot megbízik a szolgáltató személyazonosság-megerősítésében.
Előbb csak körülnézne? A nyitóoldal „Próbálja ki az élő demót” hivatkozása egy közös demófiókkal jelentkezteti be egy lezárt szervezetbe, amelyben több területet felölelő példakérdőívek, kampányok, befejezett kitöltések és elemzett adatkészletek várják. A kutatási nyilvántartása nem módosítható, így regisztráció nélkül, a következő látogató zavarása nélkül fedezheti fel a platform minden szakaszát – beleértve egy kérdőív elejétől végéig tartó kipróbálását előnézetben, valamint a QML gyakorlati szerkesztését egy ideiglenes homokozóban, amely semmit sem ment.
Ha regisztrált a próbakörnyezetben, a visszatéréshez már nincs szüksége a közös fiókra: az Ön saját fiókja is tagja az Askalot Demo szervezetnek. Nyissa meg a Szervezet váltása menüből, és olvassa el az összes összeállított projektet, köztük az Example Questionnaires projektet, amely teljes mintakérdőíveket tartalmaz (minden vezérlőtípust, egy demográfiai blokkot és egy háztartási élelmiszer-fogyasztási kérdőívet), hogy tanulhasson belőlük. A szervezet lezárt marad, így ott olvasni és előnézetet készíteni tud, a saját munkáját pedig az otthoni szervezetében végzi.
Többbérlős architektúra
Szekció neve “Többbérlős architektúra”Az Askalot teljesen elkülönített többbérlős architektúrát használ, amelyben minden szervezet (bérlő) teljesen különálló környezetben működik. Ez a kialakítás a következőket biztosítja:
- Teljes adatelkülönítés: az Ön kérdőívei, résztvevői és válaszai a többi szervezettől elkülönítve tárolódnak
- Független erőforrások: minden bérlő dedikált számítási erőforrásokkal rendelkezik, közös feldolgozás nélkül
- Egyedi domainek: környezetét a
<service>.<tenant>.askalot.iocímen éri el
Hogyan működik a bérlői elkülönítés?
Szekció neve “Hogyan működik a bérlői elkülönítés?”Minden bérlő saját, elkülönített környezetben fut, amelyben:
- Külön hálózati határ van: a bérlők nem kommunikálhatnak közvetlenül egymással
- Dedikált tárhely van: az adatkötetek kizárólag az adott bérlőhöz vannak csatolva
- Független szolgáltatáspéldányok futnak: minden bérlő az összes szolgáltatás saját példányát futtatja
Az Ön bérlői URL-címei
Szekció neve “Az Ön bérlői URL-címei”A bevezetés után környezetét a következő URL-címeken éri el:
| Szolgáltatás | URL-minta | Rendeltetés |
|---|---|---|
| Roundtable | roundtable.<tenant>.askalot.io |
Irányítópult és felhasználókezelés |
| SirWay | sirway.<tenant>.askalot.io |
Kérdőív-kitöltés |
| Targetor | targetor.<tenant>.askalot.io |
Kampánykezelés |
| Armiger | armiger.<tenant>.askalot.io |
Kérdőívszerkesztő |
| Balansor | balansor.<tenant>.askalot.io |
Statisztikai elemzés |
| Portor | portor.<tenant>.askalot.io |
API-átjáró és MCP |
A <tenant> helyére a szervezetéhez rendelt bérlőnevet írja.
Hitelesítés
Szekció neve “Hitelesítés”Az Askalot központosított hitelesítési rendszert használ, amely egyszeri bejelentkezést (SSO) biztosít a bérlőjén belüli összes szolgáltatáshoz.
Globális identitásszolgáltató
Szekció neve “Globális identitásszolgáltató”A hitelesítést egy minden bérlőt kiszolgáló globális OIDC (OpenID Connect) identitásszolgáltató végzi. Ez a kialakítás a következőket biztosítja:
- Egyszeri bejelentkezés: egyszer jelentkezik be, és az Askalot összes szolgáltatását eléri
- Adatvédelmet tiszteletben tartó felderítés: a bérlői tagsága soha nem válik láthatóvá más szervezetek számára
- Többféle hitelesítési módszer: jelszavas és közösségi bejelentkezés (Google, Microsoft) támogatása
Hogyan működik a hitelesítés?
Szekció neve “Hogyan működik a hitelesítés?”A folyamat lépésről lépésre:
- Nyissa meg a nyitóoldalt a
https://askalot.iocímen - Adja meg e-mail-címét és jelszavát (vagy használjon közösségi bejelentkezést)
- Automatikus bérlőfelderítés – a rendszer megkeresi, mely bérlő(k)höz tartozik
- Létrejön a munkamenet – a rendszer biztonságos sütit állít be az összes Askalot-szolgáltatáshoz
- Átirányítás a bérlőjéhez – a rendszer automatikusan az irányítópultjára viszi
Támogatott bejelentkezési módszerek
Szekció neve “Támogatott bejelentkezési módszerek”| Módszer | Leírás |
|---|---|
| E-mail + jelszó | Hagyományos felhasználónév/jelszó alapú hitelesítés |
| Bejelentkezés Google-fiókkal | |
| Microsoft | Bejelentkezés Microsoft-/Azure AD-fiókkal |
További identitásszolgáltatók (Okta, Apple, Facebook) támogatása vállalati telepítésekhez a fejlesztési tervben szerepel.
Fiókok több bérlőben
Szekció neve “Fiókok több bérlőben”Ha ugyanazzal az e-mail-címmel több bérlőben is van fiók, a bejelentkezéskor a rendszer megkérdezi, melyiket használja:
- Adja meg e-mail-címét és jelszavát
- A Környezet kiválasztása párbeszédablak felsorolja azokat a bérlőket, amelyekben ehhez az e-mail-címhez fiók tartozik
- Válassza ki, melyik bérlőt kívánja elérni
Később úgy válthat másik bérlőre, hogy kijelentkezik, majd bejelentkezéskor a másikat választja. A fiókok különállók: a bérlők között semmi sem közös.
Kivétel az MI-asszisztens csatlakoztatása: az MCP-összekötő címe már egy adott bérlőt nevez meg, így Ön ebbe a bérlőbe jelentkezik be, és nem jelenik meg a Környezet kiválasztása párbeszédablak. Ha a fiókja egy másik bérlőn van, annak a bérlőnek a címével csatlakozzon.
Tagság több szervezetben
Szekció neve “Tagság több szervezetben”Egy bérlőn belül a fiókjának egy otthoni szervezete van – az, amelyben létrejött –, de további szervezeteknek is tagja lehet.
- Minden bejelentkezés az otthoni szervezetében indul. Bejelentkezéskor nem lehet szervezetet választani. A navigációs sáv Szervezet váltása menüje felsorolja az összes szervezetet, amelynek tagja, az otthoni szervezetét Elsődleges, azt pedig, amelyben éppen dolgozik, Jelenlegi jelöléssel látja el, és kijelentkezés nélkül vált közöttük.
- Szervezethez adminisztrátor adja hozzá, és adminisztrátor távolítja el onnan. Önállóan nem léphet be egy szervezetbe, és nem is léphet ki belőle. Az egyetlen automatikus tagság az ingyenes próbakörnyezet Askalot Demo szervezete: ehhez minden ottani fiók a létrehozásakor csatlakozik tervező, menedzser és elemző szerepkörrel; mindenki számára írásvédett. Eltávolítás után a munkamenete a következő frissítéskor visszatér az otthoni szervezetébe, és mindaz, ami az eltávolított szervezetben az Öné volt – az ottani szerepkörei, a projektjeiben fennálló társtulajdonosi jogai, valamint az arra a szervezetre szóló API-tokenjei és MI-asszisztens-kapcsolatai –, a tagsággal együtt megszűnik. Az otthoni szervezetéből nem lehet eltávolítani.
- A tagság és a szerepkörök különállók. A tagság lehetővé teszi, hogy átváltson a szervezetbe; hogy ott mit tehet, azt az abban a szervezetben betöltött szerepkörei döntik el. Az a tag, akinek ott nincs szerepköre, megnyithatja a profilját és a munkamenet-beállításait, de nem láthatja a szervezet projektjeit, kérdőíveit és adatait, és nem is dolgozhat rajtuk, amíg egy adminisztrátor szerepkört nem ad neki. Az egyik szervezetben betöltött szerepkör soha nem száll át egy másikba.
- Az adminisztrátorok látják, mikor volt utoljára aktív. A Felhasználókezelés oldal minden fióknál megmutatja az Utoljára aktív dátumot és időpontot: azt, amikor utoljára használta az Askalotot böngészőben, API-tokennel vagy csatlakoztatott MI-asszisztensen keresztül, körülbelül tíz perc pontossággal. A még nem használt fióknál a Soha felirat áll. Az Ön nevében a platform által végzett munka – például egy MI-szimuláció, amely a távozása után is fut – nem számít, és az sem, ha egy böngészőlap nyitva marad, de senki sem tér vissza hozzá.
- A projekt társtulajdonosainak tagnak kell lenniük. Csak akkor adhatják hozzá egy projekt társtulajdonosaként, ha tagja annak a szervezetnek, amelyhez a projekt tartozik – lásd: Kérdőív megosztása.
Az MCP-n keresztül csatlakoztatott MI-asszisztens ugyanígy működik: a munkamenete az otthoni szervezetében indul, és bármelyik olyan szervezetbe áthelyezhető, amelyet a navigációs sáv menüje felkínál Önnek. Lásd: Az Ön aktív szervezete.
A munkamenet biztonsága
Szekció neve “A munkamenet biztonsága”- JWT-alapú munkamenetek: állapotmentes hitelesítés aláírt tokenekkel
- Biztonságos sütik: a HttpOnly, Secure és SameSite jelzők megakadályozzák a gyakori támadásokat
- Domainhez kötött hatókör: a sütik hatóköre a
.askalot.io, ami lehetővé teszi az egyszeri bejelentkezést a szolgáltatások között - Beállítható lejárat: a munkamenet időtartamát a szervezete szabályzata határozza meg
Fiókkal kapcsolatos e-mailek
Szekció neve “Fiókkal kapcsolatos e-mailek”Az e-mail-cím megerősítésére, a jelszó visszaállítására és a jelszómódosítás megerősítésére szolgáló üzenetekre ugyanazok a kézbesítési szabályok vonatkoznak, mint minden más levélre, amelyet az Askalot küld. E szabályok közül kettő is megmagyarázhatja, ha egy üzenet nem érkezik meg:
- Egy cím óránként legfeljebb öt üzenetet fogad a platform ugyanazon részéből, így ha egy órán belül ismételten kér jelszó-visszaállítást, a kérést egy idő után a rendszer elutasítja, nem pedig sorba állítja.
- Az a cím, amely korábban véglegesen visszapattant, a teljes platformon le van tiltva, és semmit sem kap – a fiókkal kapcsolatos leveleket sem –, amíg egy üzemeltető fel nem oldja a letiltást. Ha egy megerősítő vagy visszaállító link nem érkezik meg, pedig a cím helyes, kérje meg az üzemeltetőjét, hogy ellenőrizze, nincs-e letiltva.
- A tesztelésre fenntartott domainek címeire –
example.comés társai, illetve bármi, ami.test,.invalid,.localhostvagy.localvégződésű – a rendszer egyáltalán nem küld levelet. Általában ez a magyarázat, ha egy bemutató- vagy mintafiók soha nem kapja meg a megerősítő levelét.
Egy kézbesítetlen üzenet soha nem vonja vissza azt a fiókmódosítást, amely kiváltotta: a jelszómódosítás akkor is érvénybe lép, ha a megerősítő e-mail nem érkezik meg, és az a regisztráció, amelynek megerősítő e-mailjét elutasították, ugyanúgy létrehozza a fiókot – az csupán megerősítetlen marad, amíg egy megerősítő link el nem jut Önhöz. Lásd: Kézbesítési korlátok és visszapattant címek.
API-jogosultságok
Szekció neve “API-jogosultságok”Programozott hozzáféréshez az Askalot a csatlakozás módjától függően kétféle hitelesítési utat kínál:
- API-tokenek – a REST API-hoz és bármilyen nem interaktív automatizáláshoz (CI-szkriptek, szerverek közötti kommunikáció, táblázatkezelőből indított adatlekérések).
- OAuth 2.1 böngészős bejelentkezés – interaktív MI-asszisztens (Claude Code, Cursor) MCP-n keresztüli csatlakoztatásához. Soha nem kell tokent beillesztenie; a hozzáférést egyszer, a böngészőben hagyja jóvá.
API-tokenek létrehozása
Szekció neve “API-tokenek létrehozása”- Jelentkezzen be a Roundtable irányítópultjára
- Lépjen a Profilbeállítások → API-tokenek oldalra
- Kattintson az Új token létrehozása gombra
- Másolja ki, és tárolja biztonságosan a tokent (
aslat_előtaggal kezdődik, és csak egyszer jelenik meg)
A token abban a szervezetben működik, amelyben a létrehozásakor dolgozott, az ottani szerepköreivel. Ha több szervezetnek is tagja, a token létrehozása előtt váltson arra a szervezetre, amelyben az automatizálásnak dolgoznia kell.
Az API-tokenek használata
Szekció neve “Az API-tokenek használata”A tokent a REST-hívások X-Api-Token fejlécében adja meg:
X-Api-Token: aslat_your_api_tokenAz Authorization: Bearer másfajta hitelesítő adat – egy interaktív OAuth-munkamenet –,
és az ott küldött tokent a rendszer elutasítja, nem próbálja meg API-tokenként felhasználni.
A tokeneket titokkezelőben vagy a gitből kizárt .env fájlban tárolja – soha ne olyan shell-indítófájlban, amelyet más folyamatok is olvashatnak.
A részletes használatot a REST API és az MCP-felület dokumentációja ismerteti.
MI-eszközök csatlakoztatása MCP-n keresztül
Szekció neve “MI-eszközök csatlakoztatása MCP-n keresztül”Az Askalot MCP (Model Context Protocol) felülete lehetővé teszi, hogy az MI-asszisztensek közvetlenül a platformmal dolgozzanak. Az MCP-végpont OAuth 2.1-et használ, nem beillesztett tokent: csak az URL-t kell megadnia, az első eszközhívás pedig megnyitja a böngészőt a bejelentkezéshez és a hozzáférés jóváhagyásához.
Claude Code
Szekció neve “Claude Code”Vegye fel a szervert a .mcp.json (projektszintű) vagy a ~/.claude.json (globális) fájlba – csak az URL-t, token nélkül:
{ "mcpServers": { "askalot": { "type": "http", "url": "https://portor.<tenant>.askalot.io/mcp" } }}Amikor a Claude Code először hív meg egy Askalot-eszközt, megnyitja a böngészőt a bejelentkezéshez és a hozzáférés jóváhagyásához; a tokeneket ezután a Claude Code tárolja és automatikusan frissíti.
Cursor
Szekció neve “Cursor”Vegye fel ugyanezt, csak URL-t tartalmazó bejegyzést a Cursor beállításai között az MCP-konfigurációba:
{ "mcpServers": { "askalot": { "type": "http", "url": "https://portor.<tenant>.askalot.io/mcp" } }}A Cursor az első használatkor ugyanígy böngészős bejelentkezést indít.
Nem interaktív használat (CI, n8n)
Szekció neve “Nem interaktív használat (CI, n8n)”Azok a szerveroldali automatizálások, amelyek nem tudnak böngészős bejelentkezést végrehajtani, az MCP-végpont helyett API-tokennel a REST API-t használják:
- Alap-URL:
https://portor.<tenant>.askalot.io/api/v1 - Fejléc:
X-Api-Token: aslat_...(soha neAuthorization: Bearer, amely OAuth-munkamenet-tokent hordoz)
A <tenant> helyére a szervezete bérlőnevét írja.
Az Ön kezdő erőforrásai
Szekció neve “Az Ön kezdő erőforrásai”Az első bejelentkezéskor az Askalot személyes munkaterületet hoz létre Önnek, hogy azonnal munkához láthasson:
- Alapértelmezett projekt – az Ön nevét viselő személyes projekt (pl. „Alice projektje”). Használja az első kérdőíveihez, vagy nevezze át a kutatásának megfelelően. Ez a projekt nem törölhető. Mint minden új projekt, egy kezdő kérdőívvel indul (lásd alább).
- Alapértelmezett mintavételi stratégia – azonnal használható stratégia szokásos demográfiai tényezőkkel (nem és korcsoport szerinti megoszlás). Ezzel minden beállítás nélkül generálhat reprezentatív válaszadói köröket. Ez a stratégia írásvédett, hogy a szervezeten belül egységes kiindulópontot biztosítson.
Ezek az alapértelmezések a nem privát szervezetekben minden felhasználónak létrejönnek. A privát szervezetekben a tagok egyetlen közös válaszadói panelt (válaszadók, válaszadói körök és stratégiák) használnak, a projektjeiket pedig szükség szerint maguk hozzák létre; lásd: Szervezetalapú adatmegosztás.
Minden új projekt kezdő kérdőívvel indul. Valahányszor egy projekt létrejön – legyen az az alapértelmezett projektje vagy bármely később létrehozott projekt –, egy közönséges kérdőívet tartalmaz egyetlen megjegyzéssel, amely elmagyarázza, mit kezdjen vele. Nevezze át, alakítsa saját kérdőívvé, vagy törölje; a törölt kezdő kérdőív nem tér vissza. A kész példakérdőívek nem másolódnak az Ön projektjeibe: ahol a környezete kínálja az Askalot Demo szervezetet, annak Example Questionnaires projektjében olvashatja el őket.
A kezdőlap megmutatja az utat. Bejelentkezés után a Roundtable kezdőlapja egy útvonalat mutat a projektjéhez: sorra veszi a kutatási folyamat szakaszait, jelzi, melyik van kész, a következő lépéshez pedig hivatkozást ad arra az oldalra, ahol elvégezhető. Új fióknál az útvonal az alapértelmezett projekten indul. Az érintetlen kezdő kérdőív nem számít kész szakasznak; egy saját, a validáción átmenő kérdőív viszont igen. Lásd a kutatási folyamat útmutatóját.
Hogyan tovább?
Szekció neve “Hogyan tovább?”Készen áll az Askalot használatára? A következő lépések:
-
A kutatási folyamat útmutatója
Kövesse a kezdőlapján látható útvonalat szakaszról szakaszra
-
Gyors kezdés
Készítse el első kérdőívét percek alatt
-
Felhasználói útmutató
Ismerje meg a platform összes képességét
-
API-hozzáférés
Építse be az Askalotot alkalmazásaiba
Segítségre van szüksége?
Szekció neve “Segítségre van szüksége?”Forduljon szervezete Askalot-adminisztrátorához, vagy vegye fel a kapcsolatot az ügyfélszolgálattal: