DK-Agora AI

문서

DK-Agora AI 기술 문서 및 가이드

빠른 시작

  1. 계정 만들기 - Google 또는 GitHub OAuth로 가입
  2. 첫 번째 메모 만들기 - 대시보드에서 "새 메모"를 클릭
  3. 암호화 비밀번호 설정 - 강력하고 고유한 비밀번호 선택
  4. 메모 저장 - 콘텐츠가 기기를 떠나기 전에 암호화됩니다

보안 모델

제로 지식 아키텍처

DK-Agora AI는 제로 지식 보안 모델을 사용합니다. 이는:

  • 모든 암호화/복호화가 브라우저에서 이루어집니다
  • 비밀번호가 절대 기기를 떠나지 않습니다
  • 암호화된 텍스트만 저장합니다
  • 전체 데이터베이스 접근 권한이 있어도 데이터를 읽을 수 없습니다

암호화 상세

AES-256-GCM

모든 암호화에 AES-256-GCM (갈루아/카운터 모드)을 사용합니다:

  • 키 파생: 100,000회 반복의 PBKDF2
  • IV: 암호화마다 무작위로 생성되는 12바이트 IV
  • 인증: GCM이 내장 인증을 제공
  • 솔트: 메모마다 고유한 16바이트 솔트

데이터 형식

{
  "salt": "base64-encoded-salt",
  "iv": "base64-encoded-iv",
  "ciphertext": "base64-encoded-encrypted-data",
  "version": 1
}

API 레퍼런스

DK-Agora AI는 프로그래밍 방식 접근을 위한 REST API를 제공합니다. 모든 API 요청에는 Bearer 토큰을 통한 인증이 필요합니다.

엔드포인트

GET /api/memos - 모든 메모 목록
POST /api/memos - 새 메모 만들기
GET /api/memos/:id - 특정 메모 가져오기
PATCH /api/memos/:id - 메모 업데이트
DELETE /api/memos/:id - 메모 삭제