Naru

toolset과 승인·감사

toolset 하나가 MCP 주소 하나예요. 어떤 도구를, 누구에게, 어떤 승인으로 내놓을지 정하고, 모든 호출을 감사 기록에 남겨요.

toolset

/mcp/<toolset> 하나가 가상 MCP 서버 하나예요. 갈피의 MCP 연결 하나, Mothership 커넥터 하나가 toolset 하나에 대응해요.

관리 → Toolset. toolset마다 MCP 주소와 도구 수.관리 → Toolset. toolset마다 MCP 주소와 도구 수.
관리 → Toolset. toolset마다 MCP 주소와 도구 수.
항목 뜻
include 도구 선택 패턴(erp_api_*, !groupware_*)
maxRisk 내놓을 최대 위험도(low, medium(기본), high)
approval 고위험 호출의 승인: elicitation(사람에게 MCP로 물어요), client(클라이언트의 승인을 믿어요. Mothership이면 Runtime 승인 claim이 있어야 해요), none
masking 출력 마스킹. 주민등록번호는 늘 기본이고, phone, card, email과 사용자 정의 정규식을 더해요
access 역할, 그룹, 사용자, 서비스
allowNonProduction prod toolset이 Mothership 비운영 환경(미리보기 등)의 호출을 받을지(기본 거절)
toolsets.yaml
slug: corp-read
env: prod
name: 사내 조회
include: ["*", "!groupware_*"]
maxRisk: low
approval: client
access: { services: [mothership-acme] }
관리 → Toolset → 사내 업무.관리 → Toolset → 사내 업무.
관리 → Toolset → 사내 업무.

들어오는 쪽

누구 어떻게
사람(MCP 클라이언트) 나루 OAuth 2.1 인가 서버. toolset마다 protected resource metadata, DCR, PKCE S256, resource indicator. access 1시간, refresh 30일(회전)
사람(스크립트) 개인 토큰 naru_pat_…
서비스 서비스 토큰 naru_svc_…. 서명된 사용자 assertion이 함께 오면 그 사람으로 바뀌어요(Mothership, 갈피 짝짓기)
개발 개발 토큰 naru_dev_…. 개발용 MCP(/dev/mcp)만

토큰은 관리 → 사람과 토큰 → 토큰에서 발급하고, 값은 그때 한 번만 보여요.

감사 기록

모든 도구 호출, 로그인, 개인 계정 연결·해제, 설정·배포·토큰 발급이 남아요.

  • 도구 호출은 실행 전에 started로 먼저 남기고 끝나면 결과로 바꿔요. 기록할 수 없으면 실행하지 않아요.
  • 입력은 기본 해시로 남겨요. function이 audit: { input: 'full' }이면 마스킹한 뒤 원문을 남겨요.
  • 보관은 NARU_AUDIT_RETENTION_DAYS(기본 730일)예요.
  • SIEM 내보내기는 커서로 앞으로 읽어요: naru-admin audit --after 0 --jsonl > audit.jsonl. 끝에 표준 오류로 다음 커서(--after N)를 남겨요.
관리 → 감사 기록.관리 → 감사 기록.
관리 → 감사 기록.

비밀값을 지키는 법

  • 나루가 다룬 비밀값(시스템·개인 비밀값, plugin이 받은 쿠키와 토큰)을 기억해 두고, 밖으로 나가는 곳(도구 결과와 오류, 감사 기록의 자유 텍스트, 서버 로그, 관리 API 오류)에서 «redacted»로 바꿔요.
  • plugin이 바꾼 요청(쿼리의 API 키, 인증 헤더, 서명)은 function에 돌아가지 않아요.
Esc