연구실·기관

기관 관리자가 답할 수 있는 질문

답은 관리자 명령과 (개발 중인) 관리자 화면, 감사 기록에 있습니다. 결과를 볼 수 있는 사람은 누구나 공유 화면에서 그 결과의 출처와 재현 명령을 봅니다.

누가 어떤 데이터로 작업했는지: 작업공간마다 쓴 데이터가 기록되고, 이 기록은 줄지 않습니다. 권한을 거둬도 남습니다. 명령: ws show ws-0012
이 결과가 어떤 데이터에서 나왔는지: 결과마다 쓴 데이터와 거쳐 온 결과가 남고, 결과 출처 그림으로 이어집니다. 명령: release show r-0137
지금 이 결과를 누가 볼 수 있고, 언제 왜 바뀌었는지: 볼 수 있는 사람과 그 조건, 바뀐 이력(원본 권한 변경, 관리자가 넓힌 것과 그 사유)이 남습니다. 명령: release show r-0137
이 결과를 어떻게 다시 만드는지: 재현 명령과 그 순간의 작업 폴더, 작업 환경, 데이터 버전이 저장되어 있습니다. 다시 실행해 확인하는 기능은 계획되어 있습니다.
누가 결과를 열어 보고 내려받았는지: 결과 열람과 내려받기, 편집기에서 내려받은 파일이 감사 기록에 남습니다. 명령: synapse audit --target r-0137
연구실 단위 화면 (책임연구자용)준비 중: 지금은 이 답이 관리자 명령과 (개발 중인) 관리자 화면에 있습니다. 연구실 책임자가 자기 연구실만 보는 화면은 계획되어 있습니다.

기관이 정하는 것

데이터와 역할, 계정, 작업공간, 인터넷, SSH, 결과는 기관이 정하고, 기록은 기관이 봅니다. 모두 관리자 화면이나 명령으로 합니다.

역할은 데이터 레이크의 폴더 트리에서 체크합니다. 체크하면 실행할 명령이 쌓이고, 적용을 누르면 실행됩니다. 상위 폴더에서 받은 역할은 회색으로 보입니다.

데이터 레이크 개발 중인 화면

images
ct_20241,248개
mr_brain
tables
patients4개
labs4개

/images/mr_brain의 역할

(주지 않음) ct_research
(주지 않음) ehr_basic
(주지 않음) ehr_full
(상위 폴더에서 받음) imaging_all 상위 폴더에서 받음: /images
(줌) mr_research 더할 예정
(주지 않음) pathology

적용할 명령 1개

$ lake grant /images/mr_brain mr_research

적용

역할을 체크하면 명령이 쌓이고, 적용을 누르면 실행됩니다. 상위 폴더에서 받은 역할은 회색이고 여기서 뺄 수 없습니다. 예시이며, 개발 중인 화면을 옮겨 그렸습니다.

데이터와 역할: 폴더와 테이블에 역할을 주면 그 아래 전체에 적용되고, 파일 하나에 따로 더할 수도 있습니다. 「거부」 규칙은 없습니다. 숨길 데이터는 따로 폴더를 두거나, 비식별 테이블 같은 파생 테이블을 만들어 따로 권한을 줍니다. 명령: lake grant /images/mr_brain mr_research
계정: 만들기, 역할 주기, 임시 비밀번호(72시간), 사용 중지. 사용 중지하면 그 계정의 작업공간이 정지되고, 결과를 볼 수 있는 사람 수에서 빠집니다. 명령: synapse user disable kim
작업공간과 자원: 모든 작업공간 현황과 저장 공간 사용량을 봅니다. 작업공간마다 GPU 메모리 상한을 정합니다. 한 사람이 가질 수 있는 작업공간 수는 설치 설정입니다(기본: 보관하지 않은 것 10개, 켜 둔 것 2개). 명령: synapse storage
인터넷 규칙: 작업공간마다 템플릿(Claude만, 패키지 저장소, 인터넷, 완전 개방)과 추가 규칙을 정합니다. 바로 적용되고, 최근 접속(허용·막힘)을 작업공간마다 볼 수 있습니다. 기관 템플릿을 더할 수 있습니다. 명령: ws net set ws-0012 --template claude-only
SSH: 사람마다 허용합니다. 허용하는 화면에도 적혀 있듯, SSH를 허용하면 그 사람은 자기 작업공간의 파일을 대량으로 내려받을 수 있습니다(scp, sftp). 명령: synapse user set kim --ssh
결과: 집계 통계처럼 넓게 나눠도 되는 결과는 사유를 적고 볼 수 있는 사람을 넓히거나 되돌립니다. 권한 요청에는 역할을 주거나, 결과를 넓히거나, 사유를 적어 거절합니다. 명령: release access ls
감사 기록: 지울 수 없게 설계된 기록입니다(추가만 됩니다). 로그인, 화면·API·작업공간에서 실행한 명령(거절된 것 포함), 작업공간과 결과 열기, 내려받기, 편집기의 파일 전송, 권한 변경이 남습니다. 명령: synapse audit
기관 표시: 기관 이름과 로고. 기관 색은 로고 칸에만 쓰고, 상태를 나타내는 색과 섞지 않습니다. 명령: synapse brand set --logo logo.svg

설치 방식

기관 서버에 설치하거나, 기관 하나만을 위한 인스턴스(SaaS, 준비 중)로 운영합니다. 두 방식은 같은 소프트웨어이고, 기관끼리 설치를 함께 쓰지 않습니다.

기관 서버에 설치NVIDIA DGX Spark (GB10, arm64, GPU 1개) 지금 동작함
기관 서버에 설치x86 서버 준비 중
기관 전용 인스턴스 (SaaS)기관 하나만을 위해 Praesidion에서 운영 준비 중

아직 출시 전입니다. 지금은 첫 설치를 준비하고 있습니다.

저장 공간, 인터넷 규칙 템플릿, 사내망 범위, 한 사람의 상한, 기관 이름처럼 기관마다 다른 것은 설정으로 정합니다.

필요한 것

서버: 리눅스 서버 한 대(systemd). 지금 시험한 장비는 NVIDIA DGX Spark입니다.
작업 환경: Docker와 NVIDIA Container Toolkit
저장 공간: OpenZFS 풀 하나. 원본, 내보낸 결과, 작업 폴더가 모두 여기에 있습니다. 운영에는 실제 디스크를 씁니다.
주소: 포털 주소 하나와, 작업공간마다 주소를 주는 와일드카드 DNS 이름
HTTPS: 기관이 준비한 인증서. 인터넷에 공개하려면 필요하고, OTP 앱을 등록할 때도 필요합니다.
연구자: 최신 브라우저(Chrome 111, Firefox 113, Safari 16.4 이상)와 Claude 구독(Pro, Max, Team, Enterprise), 그리고 토큰을 받을 자기 컴퓨터의 Claude Code. SSH를 허용받은 사람은 OpenSSH 8.1 이상.

기관이 만든 계정으로 로그인합니다. 로그인에 OTP 앱 코드를 요구할 수 있고, 인터넷에 공개하면 모든 계정에 요구합니다.

계정과 비밀번호: 관리자가 계정을 만들고 임시 비밀번호(72시간)를 줍니다. 연구자는 첫 로그인 때 비밀번호를 바꿉니다.
OTP 앱 2단계 인증: 비밀번호가 맞을 때만 코드를 묻고, 시도 횟수를 제한하고, 한 번 쓴 코드는 다시 받지 않습니다. OTP 앱을 등록한 계정은 SSH 키나 API 토큰을 만들 때 10분 안에 넣은 코드가 한 번 더 필요합니다. 휴대폰을 잃으면 관리자가 초기화합니다.
세션: 최대 12시간이고, 60분 동안 쓰지 않으면 끝납니다.
인터넷 공개: 서버 포트를 열지 않고 Cloudflare 터널로 받습니다. 공개하면 모든 계정에 OTP 앱 코드를 요구하고, HTTPS가 필요하고, API 토큰은 기본으로 인터넷 쪽에서 받지 않습니다. 이 설정은 만들어 두었지만, 아직 실제 설치에서 켜 본 적은 없습니다.
SSH: 관리자가 사람마다 허용합니다. 비밀번호 없이 등록한 키로만, 키 주인의 켜져 있는 작업공간에만 들어갑니다. 연구자에게 열기 전에 Windows와 macOS에서 모든 접속 명령을 확인하는 일이 남아 있습니다.
통합 로그인 (SSO)준비 중: 누구인지 확인하는 곳을 한 곳에 두어, 기관 계정 연동을 나중에 붙일 수 있게 했습니다.

연구자에게 필요한 것

브라우저와 Claude 구독, 그리고 토큰을 받을 자기 컴퓨터의 Claude Code입니다.

Claude 구독은 Pro, Max, Team, Enterprise 가운데 하나여야 합니다. 무료 계정으로는 토큰을 받을 수 없습니다(2026년 10월 Anthropic 문서 기준). Claude 연결 안내서

지금은 연구자마다 개인 Claude 계정을 연결합니다. 그래서 대화를 모델 학습에 쓰는지 같은 데이터 처리 조건은 각자의 계정 설정을 따르고, 기관이 정할 수 없습니다. 연구자에게 이 설정을 확인하도록 안내하세요.

연구자는 자기 컴퓨터의 터미널에서 토큰을 받아(claude setup-token) 내 계정 화면에 한 번 붙여 넣습니다. 토큰은 암호화해 저장합니다. 작업공간에는 작업 폴더 밖의 읽기 전용 파일로 들어가고, Claude를 시작할 때 Claude 프로세스에 넘겨집니다. 이 파일은 작업공간 안에서 연구자 권한으로 읽을 수 있습니다.

기관 Claude 계정과 LLM 게이트웨이준비 중: 쓰는 사람이 늘면, 기관 계정의 키를 작업공간 밖에 두고 모든 호출을 기록하는 중계 서버(LLM 게이트웨이)로 바꿀 계획입니다.

더 읽을 것

설치와 운영 안내는 첫 설치를 마친 뒤에 공개합니다. 그 전에 작동 방식과 보안 개요에서, 시스템이 무엇을 하고 무엇을 하지 않는지 확인하세요.