인증 및 Mind Key

Synapse는 두 가지 인증 방법을 사용하며, 각각 다른 사용 사례에 최적화되어 있습니다. 신뢰할 수 있는 통합을 구축하려면 차이를 이해하는 것이 필수적입니다.

두 가지 인증 방법

Mind Key (에이전트용)

Mind Key는 테넌트 범위의 API 토큰입니다. 단일 마인드의 데이터 (메모리, 작업, 채팅, 스크립트 등)를 인증합니다. 다음에 사용하십시오:

• API를 호출하는 LLM 에이전트
• 백그라운드 자동화 스크립트
• MCP 서버 구성
• 모든 장기 통합

헤더 인증 (권장)

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

쿼리 파라미터 (URL 전용 도구용)

curl https://synapse.schaefer.zone/memory/recall?key=mk_yourMindKeyHere

Mind Key 생성

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

응답에 mind_key가 포함됩니다 — 즉시 저장하십시오, 한 번만 표시됩니다.

마인드 나열

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

마인드 삭제 (되돌릴 수 없음!)

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

JWT (사람용)

JWT는 특정 마인드가 아닌 사용자 계정을 인증합니다. 다음에 사용하십시오:

• 계정 가입 및 로그인
• 마인드 생성 / 나열 / 삭제
• 다른 사용자와 마인드 공유
• Web Push 구독 관리

가입

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

반환: { "jwt": "eyJ...", "user": {...} }

로그인

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

반환: { "jwt": "eyJ...", "user": {...} }

JWT 만료

JWT는 7일 후에 만료됩니다. JWT가 만료되면 /login을 다시 호출하여 새 것을 받으십시오. Mind Key는 만료되지 않으므로 기존 에이전트 통합은 계속 작동합니다.

보안 모범 사례

환경 변수 패턴

# .env (이 파일은 절대 커밋하지 마십시오)
SYNAPSE_MIND_KEY=mk_yourMindKeyHere
SYNAPSE_URL=https://synapse.schaefer.zone

// Node.js
const mindKey = process.env.SYNAPSE_MIND_KEY;
const url = process.env.SYNAPSE_URL;
await fetch(`${url}/memory/recall`, {
  headers: { Authorization: `Bearer ${mindKey}` },
});

MCP 서버 구성

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

다중 마인드 패턴

각 사용자는 여러 마인드를 가질 수 있습니다. 일반적인 패턴:

컨텍스트를 격리하기 위해 다른 LLM 세션에서 다른 Mind Key를 사용하십시오.

속도 제한

속도 제한 헤더 (X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After)는 해당되는 경우 응답에 포함됩니다.

다음 단계

• Mind Key vs JWT — 언제 무엇을 사용할지
• Memory API — Mind Key로 할 수 있는 것
• User API — JWT로 계정 관리