{"title":"Autentisering & Mind Keys","slug":"authentication","category":"getting-started","summary":"Hur Synapse-autentisering fungerar: Mind Keys för agenter, JWT:er för människor, ?key= för URL-endast-verktyg.","audience":["human","llm"],"tags":["auth","mind-key","jwt","security"],"difficulty":"beginner","updated":"2026-06-27","word_count":443,"read_minutes":2,"llm_context":"Two auth methods: Mind Key (token-scoped, never expires) and JWT (user-scoped, 7-day expiry).\nMind Key: Authorization: Bearer mk_xxx OR ?key=mk_xxx (60 req/min limit on query)\nJWT: Authorization: Bearer eyJ... (no rate limit, used for /register, /login, /minds, /sharing)\nMind Key is shown only once at creation. Store it permanently.\nEach mind has exactly one Mind Key. Multiple minds = multiple keys.\n","lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Autentisering & Mind Keys\n\nSynapse använder två autentiseringsmetoder, var och en optimerad för olika\nanvändningsområden. Att förstå skillnaden är väsentligt för att bygga pålitliga\nintegrationer.\n\n## Två autentiseringsmetoder\n\n| Metod | Användningsområde | Hastighetsgräns | Utgång |\n|--------|----------|------------|--------|\n| **Mind Key** | LLM-agenter, automatiserade verktyg | Ingen (header) / 60 min (query) | Aldrig |\n| **JWT** | Mänskligt gränssnitt, kontoåtgärder | Ingen | 7 dagar |\n\n## Mind Key (för agenter)\n\nEn Mind Key är en klientomfattande API-token. Den autentiserar en enskild minds\ndata (minnen, uppgifter, chatt, skript etc.). Använd den för:\n\n- LLM-agenter som anropar API:et\n- Bakgrundsautomationsskript\n- MCP-serverkonfiguration\n- Alla långlivade integrationer\n\n### Header-autentisering (rekommenderas)\n\n```bash\ncurl -H \"Authorization: Bearer mk_yourMindKeyHere\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n### Queryparameter (för URL-endast-verktyg)\n\n```bash\ncurl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere\n```\n\n> [!WARNING]\n> Queryparametern `?key=` är begränsad till **60 begäranden per minut**.\n> Bearer-headern har ingen hastighetsgräns. Använd headern när er klient\n> stöder egna headers.\n\n### Skapa en Mind Key\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\": \"Work Mind\", \"description\": \"Project memories\"}'\n```\n\nSvaret inkluderar `mind_key` — **spara den omedelbart**, den visas endast en gång.\n\n### Lista era minds\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\n### Ta bort en mind (oåterkalleligt!)\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n## JWT (för människor)\n\nJWT:er autentiserar **användarkontot**, inte en specifik mind. Använd dem för:\n\n- Kontoregistrering och inloggning\n- Skapa / lista / ta bort minds\n- Dela minds med andra användare\n- Hantering av Web Push-prenumerationer\n\n### Registrera\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\"email\": \"you@example.com\", \"password\": \"secret\"}'\n```\n\nReturnerar: `{ \"jwt\": \"eyJ...\", \"user\": {...} }`\n\n### Logga in\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/login \\\n -H \"Content-Type: application/json\" \\\n -d '{\"email\": \"you@example.com\", \"password\": \"secret\"}'\n```\n\nReturnerar: `{ \"jwt\": \"eyJ...\", \"user\": {...} }`\n\n### JWT-utgång\n\nJWT:er löper ut efter **7 dagar**. När en JWT löper ut, anropa `/login` igen för\natt få en ny. Mind Key löper aldrig ut, så befintliga agentintegrationer\nfortsätter fungera.\n\n## Säkerhetsbästa praxis\n\n> [!CRITICAL]\n> - **Lägg aldrig Mind Keys i git.** Använd miljövariabler.\n> - **Logga aldrig Mind Keys.** Maskera dem i loggar (`mk_***...***xyz`).\n> - **Rotera nycklar** om ni misstänker läcka (ta bort mind, skapa en ny).\n> - **Använd en mind per projekt** för att begränsa skadeomfånget om en nyckel läcker.\n\n### Mönster med miljövariabel\n\n```bash\n# .env (NEVER commit this file)\nSYNAPSE_MIND_KEY=mk_yourMindKeyHere\nSYNAPSE_URL=https://synapse.schaefer.zone\n```\n\n```typescript\n// Node.js\nconst mindKey = process.env.SYNAPSE_MIND_KEY;\nconst url = process.env.SYNAPSE_URL;\nawait fetch(`${url}/memory/recall`, {\n headers: { Authorization: `Bearer ${mindKey}` },\n});\n```\n\n### MCP-serverkonfiguration\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_yourMindKeyHere\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\n## Flera-mind-mönster\n\nVarje användare kan ha flera minds. Vanliga mönster:\n\n| Mind-namn | Syfte |\n|-----------|---------|\n| `work` | Jobbrelaterade minnen |\n| `personal` | Personliga inställningar, familj |\n| `project-synapse` | Specifik projektkontext |\n| `learning-german` | Inlärningsframsteg |\n| `assistant-default` | Allmän reserv |\n\nAnvänd olika Mind Keys för olika LLM-sessioner för att hålla kontexter isolerade.\n\n## Hastighetsgränser\n\n| Autentiseringsmetod | Gräns | Omfattning |\n|-------------|-------|-------|\n| Mind Key (header) | Ingen | Per-mind |\n| Mind Key (?key=) | 60/min | Per-IP |\n| JWT (header) | Ingen | Per-användare |\n| Publika endpoints | Ingen | Global |\n\nHeaders för hastighetsgräns (`X-RateLimit-Limit`, `X-RateLimit-Remaining`,\n`Retry-After`) inkluderas i svar när tillämpligt.\n\n## Nästa steg\n\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) — när man ska använda vilken\n- [Memory API](/docs/api/memory) — vad ni kan göra med en Mind Key\n- [User API](/docs/api/user) — kontohantering med JWT:er\n","content_html":"

Autentisering & Mind Keys

\n

Synapse använder två autentiseringsmetoder, var och en optimerad för olika\nanvändningsområden. Att förstå skillnaden är väsentligt för att bygga pålitliga\nintegrationer.

\n

Två autentiseringsmetoder

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
MetodAnvändningsområdeHastighetsgränsUtgång
Mind KeyLLM-agenter, automatiserade verktygIngen (header) / 60 min (query)Aldrig
JWTMänskligt gränssnitt, kontoåtgärderIngen7 dagar
\n

Mind Key (för agenter)

\n

En Mind Key är en klientomfattande API-token. Den autentiserar en enskild minds\ndata (minnen, uppgifter, chatt, skript etc.). Använd den för:

\n\n

Header-autentisering (rekommenderas)

\n
curl -H "Authorization: Bearer mk_yourMindKeyHere" \\\n     https://synapse.schaefer.zone/memory/recall

Queryparameter (för URL-endast-verktyg)

\n
curl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere
Queryparametern `?key=` är begränsad till **60 begäranden per minut**.\nBearer-headern har ingen hastighetsgräns. Använd headern när er klient\nstöder egna headers.

Skapa en Mind Key

\n
curl -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer YOUR_JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{"name": "Work Mind", "description": "Project memories"}'

Svaret inkluderar mind_key — spara den omedelbart, den visas endast en gång.

\n

Lista era minds

\n
curl -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds

Ta bort en mind (oåterkalleligt!)

\n
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \\\n     https://synapse.schaefer.zone/minds/m_xyz789

JWT (för människor)

\n

JWT:er autentiserar användarkontot, inte en specifik mind. Använd dem för:

\n\n

Registrera

\n
curl -X POST https://synapse.schaefer.zone/register \\\n  -H "Content-Type: application/json" \\\n  -d '{"email": "you@example.com", "password": "secret"}'

Returnerar: { "jwt": "eyJ...", "user": {...} }

\n

Logga in

\n
curl -X POST https://synapse.schaefer.zone/login \\\n  -H "Content-Type: application/json" \\\n  -d '{"email": "you@example.com", "password": "secret"}'

Returnerar: { "jwt": "eyJ...", "user": {...} }

\n

JWT-utgång

\n

JWT:er löper ut efter 7 dagar. När en JWT löper ut, anropa /login igen för\natt få en ny. Mind Key löper aldrig ut, så befintliga agentintegrationer\nfortsätter fungera.

\n

Säkerhetsbästa praxis

\n

Mönster med miljövariabel

\n
# .env (NEVER commit this file)\nSYNAPSE_MIND_KEY=mk_yourMindKeyHere\nSYNAPSE_URL=https://synapse.schaefer.zone
// Node.js\nconst mindKey = process.env.SYNAPSE_MIND_KEY;\nconst url = process.env.SYNAPSE_URL;\nawait fetch(`${url}/memory/recall`, {\n  headers: { Authorization: `Bearer ${mindKey}` },\n});

MCP-serverkonfiguration

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_yourMindKeyHere",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

Flera-mind-mönster

\n

Varje användare kan ha flera minds. Vanliga mönster:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Mind-namnSyfte
workJobbrelaterade minnen
personalPersonliga inställningar, familj
project-synapseSpecifik projektkontext
learning-germanInlärningsframsteg
assistant-defaultAllmän reserv
\n

Använd olika Mind Keys för olika LLM-sessioner för att hålla kontexter isolerade.

\n

Hastighetsgränser

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AutentiseringsmetodGränsOmfattning
Mind Key (header)IngenPer-mind
Mind Key (?key=)60/minPer-IP
JWT (header)IngenPer-användare
Publika endpointsIngenGlobal
\n

Headers för hastighetsgräns (X-RateLimit-Limit, X-RateLimit-Remaining,\nRetry-After) inkluderas i svar när tillämpligt.

\n

Nästa steg

\n\n","urls":{"html":"/docs/getting-started/authentication","text":"/docs/getting-started/authentication?format=text","json":"/docs/getting-started/authentication?format=json","llm":"/docs/getting-started/authentication?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}