{"title":"प्रमाणीकरण और Mind Keys","slug":"authentication","category":"getting-started","summary":"Synapse प्रमाणीकरण कैसे काम करता है: एजेंट्स के लिए Mind Keys, मानवों के लिए JWTs, URL-केवल टूल्स के लिए ?key=।","audience":["human","llm"],"tags":["auth","mind-key","jwt","security"],"difficulty":"beginner","updated":"2026-06-27","word_count":537,"read_minutes":3,"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":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# प्रमाणीकरण और Mind Keys\n\nSynapse दो प्रमाणीकरण विधियों का उपयोग करता है, प्रत्येक अलग उपयोग के मामले के लिए अनुकूलित। विश्वसनीय इंटीग्रेशन बनाने के लिए अंतर को समझना आवश्यक है।\n\n## दो प्रमाणीकरण विधियाँ\n\n| विधि | उपयोग का मामला | रेट लिमिट | समाप्ति |\n|--------|----------|------------|--------|\n| **Mind Key** | LLM एजेंट्स, स्वचालित टूल्स | कोई नहीं (हेडर) / 60 मिनट (क्वेरी) | कभी नहीं |\n| **JWT** | मानव-सामने UI, खाता ऑप्स | कोई नहीं | 7 दिन |\n\n## Mind Key (एजेंट्स के लिए)\n\nMind Key एक टैनेंट-स्कोप्ड API टोकन है। यह एकल mind के डेटा (मेमोरीज़, कार्य, चैट, स्क्रिप्ट्स, आदि) को प्रमाणित करता है। इसका उपयोग करें:\n\n- API कॉल करने वाले LLM एजेंट्स\n- बैकग्राउंड ऑटोमेशन स्क्रिप्ट्स\n- MCP server कॉन्फ़िगरेशन\n- कोई भी दीर्घ-जीवित इंटीग्रेशन\n\n### हेडर प्रमाणीकरण (अनुशंसित)\n\n```bash\ncurl -H \"Authorization: Bearer mk_yourMindKeyHere\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\n### क्वेरी पैरामीटर (URL-केवल टूल्स के लिए)\n\n```bash\ncurl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere\n```\n\n> [!WARNING]\n> `?key=` क्वेरी पैरामीटर **60 requests per minute** तक सीमित है।\n> Bearer हेडर की कोई रेट लिमिट नहीं है। जब भी आपका क्लाइंट कस्टम हेडर का समर्थन करता है हेडर का उपयोग करें।\n\n### 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\nप्रतिक्रिया में `mind_key` शामिल है — **इसे तुरंत सहेजें**, यह केवल एक बार दिखाई जाती है।\n\n### अपने minds की सूची बनाना\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds\n```\n\n### Mind हटाना (अपरिवर्तनीय!)\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_JWT\" \\\n https://synapse.schaefer.zone/minds/m_xyz789\n```\n\n## JWT (मानवों के लिए)\n\nJWT विशिष्ट mind नहीं, बल्कि **उपयोगकर्ता खाते** को प्रमाणित करते हैं। इनका उपयोग करें:\n\n- खाता पंजीकरण और लॉगिन\n- Minds बनाने / सूचीबद्ध करने / हटाने\n- अन्य उपयोगकर्ताओं के साथ minds साझा करने\n- Web Push सब्सक्रिप्शन प्रबंधन\n\n### पंजीकरण\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\nलौटाता है: `{ \"jwt\": \"eyJ...\", \"user\": {...} }`\n\n### लॉगिन\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\nलौटाता है: `{ \"jwt\": \"eyJ...\", \"user\": {...} }`\n\n### JWT समाप्ति\n\nJWT **7 दिनों** के बाद समाप्त होते हैं। JWT समाप्त होने पर, नया प्राप्त करने के लिए बस `/login` फिर से कॉल करें। Mind Key कभी समाप्त नहीं होती, इसलिए मौजूदा एजेंट इंटीग्रेशन काम करते रहते हैं।\n\n## सुरक्षा सर्वोत्तम प्रथाएँ\n\n> [!CRITICAL]\n> - **Mind Keys कभी git में कमिट न करें।** पर्यावरण वेरिएबल्स का उपयोग करें।\n> - **Mind Keys कभी लॉग न करें।** लॉग में उन्हें मास्क करें (`mk_***...***xyz`)।\n> - **लीक के संदेह होने पर keys रोटेट करें** (mind हटाएँ, नया बनाएँ)।\n> - **प्रति परियोजना एक mind का उपयोग करें** ताकि लीक होने पर प्रभाव सीमित रहे।\n\n### पर्यावरण वेरिएबल पैटर्न\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 server config\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## मल्टी-Mind पैटर्न\n\nप्रत्येक उपयोगकर्ता के पास कई minds हो सकते हैं। सामान्य पैटर्न:\n\n| Mind नाम | उद्देश्य |\n|-----------|---------|\n| `work` | कार्य-संबंधी मेमोरीज़ |\n| `personal` | व्यक्तिगत प्राथमिकताएँ, परिवार |\n| `project-synapse` | विशिष्ट परियोजना संदर्भ |\n| `learning-german` | सीखने की प्रगति |\n| `assistant-default` | सामान्य-उद्देश्य fallback |\n\nसंदर्भ अलग रखने के लिए विभिन्न LLM सत्रों के लिए विभिन्न Mind Keys का उपयोग करें।\n\n## रेट लिमिट\n\n| प्रमाणीकरण विधि | सीमा | दायरा |\n|-------------|-------|-------|\n| Mind Key (हेडर) | कोई नहीं | प्रति-mind |\n| Mind Key (?key=) | 60/min | प्रति-IP |\n| JWT (हेडर) | कोई नहीं | प्रति-उपयोगकर्ता |\n| सार्वजनिक एंडपॉइंट्स | कोई नहीं | वैश्विक |\n\nरेट लिमिट हेडर (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`) जब लागू हो तब प्रतिक्रियाओं में शामिल होते हैं।\n\n## अगले कदम\n\n- [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt) — कब क्या उपयोग करें\n- [Memory API](/docs/api/memory) — Mind Key से आप क्या कर सकते हैं\n- [User API](/docs/api/user) — JWTs के साथ खाता प्रबंधन\n","content_html":"

प्रमाणीकरण और Mind Keys

\n

Synapse दो प्रमाणीकरण विधियों का उपयोग करता है, प्रत्येक अलग उपयोग के मामले के लिए अनुकूलित। विश्वसनीय इंटीग्रेशन बनाने के लिए अंतर को समझना आवश्यक है।

\n

दो प्रमाणीकरण विधियाँ

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
विधिउपयोग का मामलारेट लिमिटसमाप्ति
Mind KeyLLM एजेंट्स, स्वचालित टूल्सकोई नहीं (हेडर) / 60 मिनट (क्वेरी)कभी नहीं
JWTमानव-सामने UI, खाता ऑप्सकोई नहीं7 दिन
\n

Mind Key (एजेंट्स के लिए)

\n

Mind Key एक टैनेंट-स्कोप्ड API टोकन है। यह एकल mind के डेटा (मेमोरीज़, कार्य, चैट, स्क्रिप्ट्स, आदि) को प्रमाणित करता है। इसका उपयोग करें:

\n\n

हेडर प्रमाणीकरण (अनुशंसित)

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

क्वेरी पैरामीटर (URL-केवल टूल्स के लिए)

\n
curl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere
`?key=` क्वेरी पैरामीटर **60 requests per minute** तक सीमित है।\nBearer हेडर की कोई रेट लिमिट नहीं है। जब भी आपका क्लाइंट कस्टम हेडर का समर्थन करता है हेडर का उपयोग करें।

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"}'

प्रतिक्रिया में mind_key शामिल है — इसे तुरंत सहेजें, यह केवल एक बार दिखाई जाती है।

\n

अपने minds की सूची बनाना

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

Mind हटाना (अपरिवर्तनीय!)

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

JWT (मानवों के लिए)

\n

JWT विशिष्ट mind नहीं, बल्कि उपयोगकर्ता खाते को प्रमाणित करते हैं। इनका उपयोग करें:

\n\n

पंजीकरण

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

लौटाता है: { "jwt": "eyJ...", "user": {...} }

\n

लॉगिन

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

लौटाता है: { "jwt": "eyJ...", "user": {...} }

\n

JWT समाप्ति

\n

JWT 7 दिनों के बाद समाप्त होते हैं। JWT समाप्त होने पर, नया प्राप्त करने के लिए बस /login फिर से कॉल करें। Mind Key कभी समाप्त नहीं होती, इसलिए मौजूदा एजेंट इंटीग्रेशन काम करते रहते हैं।

\n

सुरक्षा सर्वोत्तम प्रथाएँ

\n

पर्यावरण वेरिएबल पैटर्न

\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 server config

\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}

मल्टी-Mind पैटर्न

\n

प्रत्येक उपयोगकर्ता के पास कई minds हो सकते हैं। सामान्य पैटर्न:

\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 नामउद्देश्य
workकार्य-संबंधी मेमोरीज़
personalव्यक्तिगत प्राथमिकताएँ, परिवार
project-synapseविशिष्ट परियोजना संदर्भ
learning-germanसीखने की प्रगति
assistant-defaultसामान्य-उद्देश्य fallback
\n

संदर्भ अलग रखने के लिए विभिन्न LLM सत्रों के लिए विभिन्न Mind Keys का उपयोग करें।

\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\n
प्रमाणीकरण विधिसीमादायरा
Mind Key (हेडर)कोई नहींप्रति-mind
Mind Key (?key=)60/minप्रति-IP
JWT (हेडर)कोई नहींप्रति-उपयोगकर्ता
सार्वजनिक एंडपॉइंट्सकोई नहींवैश्विक
\n

रेट लिमिट हेडर (X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After) जब लागू हो तब प्रतिक्रियाओं में शामिल होते हैं।

\n

अगले कदम

\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"]}