문서 보안(DRM) 연결

대상: 사내 문서 보안(DRM) 담당자 · 커넥터 운영자 선행 조건: 커넥터 v0.2.18 이상 설치 완료 (Connector 설치 가이드) · 서버 사양은 커넥터 서버 권장 사양 지금 연결할 수 있는 솔루션: 에이원정보 AIP 게이트웨이 (회사 안에 설치된 에이원정보 AIP·MIP 게이트웨이 서버). 게이트웨이 제품마다 연동 방식이 달라, 다른 회사의 게이트웨이는 아직 연결할 수 없습니다.

이 기능이 하는 일

사내 DRM 으로 암호화된 문서를 웍스AI 에 올리면, AI 가 그 문서를 읽을 수 있게 회사 안에서 풀어 줍니다.

웍스AI 에 문서 업로드
   → MCP Hub (지나가기만 함, 저장 안 함)
   → 회사 안의 커넥터
   → 공유 폴더에 잠깐 두고 DRM 게이트웨이가 풀어 줌
   → 풀린 문서를 웍스AI 로 돌려보냄
   → 커넥터가 공유 폴더의 파일을 바로 지움

• MCP Hub 에는 문서 내용과 파일 이름이 저장되지 않습니다. 사용 기록에는 시각 · 사용자 · 확장자 · 크기 · 결과만 남습니다.
• 풀린 문서를 웍스AI 가 얼마나 보관하는지는 웍스AI 의 업로드 문서 보관 정책을 따릅니다. 회사 보안 정책과 다르면 웍스AI 담당자와 먼저 맞춰 주세요.

먼저 알아 두실 것 — 회사 전체 권한으로 엽니다

에이원정보 AIP 게이트웨이는 게이트웨이에 등록된 하나의 계정으로 문서를 엽니다. 문서를 올린 사람에게 그 문서를 열 권한이 있는지는 따지지 않습니다.

그래서 열어도 되는 보안 등급을 회사가 정해야 합니다. 정하기 전에는 보호된 문서를 하나도 열지 않습니다.

• 에이원정보 AIP 게이트웨이는 문서의 보안 등급을 알려 주지 않아 "지정한 등급만 열기" 를 고를 수 없습니다. 지금은 "모두 열기" 만 고를 수 있고, 이때는 보안 담당자 승인을 확인받습니다.
• 사용자 본인의 권한으로만 여는 방식(Microsoft 365 에 직접 연결)은 Microsoft Purview(MIP) 직접 연결 가이드 를 봐 주세요 (커넥터 v0.2.19 이상).

1. 준비물

🔒 관리자 계정이나 다른 시스템과 같이 쓰는 계정은 넣지 마세요. 이 계정은 공유 폴더 한 곳에만 쓰기 권한이 있으면 됩니다.

네트워크 · 방화벽

커넥터는 밖에서 들어오는 연결을 받지 않습니다. 아래 나가는 길만 열어 주시면 됩니다.

• 커넥터 서버는 Linux(x86_64) 를 권장합니다. 공유 폴더는 Linux 서버에 SMB(CIFS)로 붙이면 되므로 게이트웨이가 Windows 서버여도 커넥터를 Windows 에 둘 필요는 없습니다. Windows 서버의 Docker Desktop 에서는 공유 폴더 연결을 아직 검증하지 않았습니다.
• 커넥터 서버, 파일 서버, 게이트웨이는 같은 사내망(1 Gbps 권장)에 두시길 권합니다 — 커넥터 서버 권장 사양

2. 커넥터 서버에 공유 폴더 붙이기

게이트웨이는 문서를 HTTP 로 받지 않고 공유 폴더에서 읽고, 풀린 결과도 공유 폴더에 씁니다. 그래서 커넥터는 게이트웨이가 보는 바로 그 폴더에 파일을 쓸 수 있어야 합니다. 이 단계가 커넥터 쪽 첫 준비입니다.

커넥터는 호스트에 이미 마운트된 폴더를 씁니다. 읽기·쓰기가 모두 되어야 합니다.

sudo mkdir -p /mnt/drm-share
sudo mount -t cifs //파일서버/drm /mnt/drm-share \
  -o rw,credentials=/etc/drm-share-credentials,uid=1000,gid=1000,iocharset=utf8

재부팅 뒤에도 유지되도록 /etc/fstab 에 넣어 두시길 권합니다.

확인:

touch /mnt/drm-share/_test && rm /mnt/drm-share/_test && echo OK

OK 가 나와야 합니다.

계정이 두 개 쓰일 수 있습니다. 위 마운트에 쓰는 계정(/etc/drm-share-credentials)은 커넥터 서버가 공유 폴더에 접속하는 계정이고, Studio 에 적는 "공유 폴더 계정" 은 게이트웨이가 같은 폴더에 접속하는 계정입니다. 같은 계정을 써도 되고 달라도 되지만, 둘 다 이 폴더에 읽기·쓰기 권한이 있어야 합니다.

3. 커넥터에 값 넣기

3-1. secrets 파일

실제 값은 커넥터 secrets 폴더에만 둡니다. MCP Hub 에는 변수 이름만 저장됩니다.

sudo tee /etc/mcp-connector/secrets/drm.env > /dev/null <<'EOF'
DRM_GW_HOST=게이트웨이서버이름
DRM_FS=파일서버이름
DRM_SHARE_USER=공유폴더계정
DRM_SHARE_PW=공유폴더비밀번호
EOF
sudo chmod 600 /etc/mcp-connector/secrets/drm.env

변수 이름은 Studio 에서 적으신 것과 같아야 합니다. 연결을 만들면 화면이 넣어야 할 이름 목록을 보여 드립니다. secrets 파일은 커넥터가 바로 다시 읽으므로 다시 시작할 필요가 없습니다.

3-2. 공유 폴더를 커넥터 안으로 넣고 다시 시작하기

커넥터 실행 명령에 한 줄을 더하고 커넥터를 다시 만듭니다. -v 는 실행 중인 컨테이너에 더할 수 없어 docker restart 로는 반영되지 않습니다 — 기존 컨테이너를 지우고(docker rm -f) 같은 이름·같은 저장소로 docker run 을 다시 해 주세요. 인증서가 그대로라 같은 커넥터로 다시 붙습니다.

docker run -d \
  ...
  -v /mnt/drm-share:/mnt/drm \
  ...

• 왼쪽 /mnt/drm-share 는 2단계에서 공유 폴더를 마운트한 경로입니다.
• 오른쪽 /mnt/drm 은 커넥터가 공유 폴더를 찾는 기본 경로입니다. 다른 경로를 쓰시려면 커넥터 secrets 파일에 DRM_SHARE_MOUNT=/mnt/다른경로 를 넣고 이 줄의 오른쪽도 같게 맞춰 주세요. 이 경로는 커넥터에서만 정합니다 — Studio 에는 적는 칸이 없습니다.
• 이 줄에는 :ro 를 붙이지 않습니다(커넥터가 써야 합니다).
• 커넥터는 이 경로가 실제로 연결된 공유 폴더일 때만 파일을 씁니다. 연결되지 않은 경로면 연결 확인이 "공유 폴더" 항목에서 멈춥니다. /tmp · /dev · /run 같은 시스템 폴더와 커넥터 자신의 폴더(/connector-state · /var/secrets)는 쓸 수 없습니다 — /mnt 아래를 권합니다.

게이트웨이가 회사 자체 인증서로 https 를 쓰는 경우 (사내 인증 기관이 발급한 인증서) 커넥터가 그 인증서를 믿도록 두 줄을 더해 주세요. 없으면 연결 확인이 "게이트웨이" 항목에서 멈춥니다.

docker run -d \
  ...
  -v /etc/pki/company-ca.pem:/etc/drm-ca.pem:ro \
  -e NODE_EXTRA_CA_CERTS=/etc/drm-ca.pem \
  ...

• 왼쪽 /etc/pki/company-ca.pem 은 회사 인증 기관 인증서(PEM)가 있는 경로입니다. 게이트웨이 담당자나 인프라 담당자에게 받아 주세요.
• 공인 인증서를 쓰는 게이트웨이라면 이 두 줄은 필요 없습니다.

문서 보안 기능은 커넥터에 기본으로 켜져 있어 따로 켤 것은 없습니다. 이 커넥터에서 문서 보안을 아예 막으려면 환경변수 MCP_DRM_ENABLED=off 를 넣고 다시 시작하시면 됩니다.

4. Studio 에서 연결 만들기

1. 문서 보안 → DRM 연결 만들기

2. 에이원정보 AIP 게이트웨이 선택

3. 연결 이름 · 커넥터 를 고르고 접속 정보를 넣습니다. 서버 이름과 계정·비밀번호 자리에는 ${변수이름} 을 적습니다.

   칸	예
   게이트웨이 주소	https://${DRM_GW_HOST}/RestAPI/api/
   시스템 ID	발급받은 값 그대로
   공유 폴더 경로	\\${DRM_FS}\drm
   공유 폴더 계정	${DRM_SHARE_USER}
   공유 폴더 비밀번호	${DRM_SHARE_PW}
   복호화 계정	게이트웨이 담당자가 알려 준 계정
   암호화 기본 레이블 ID	비워 두면 암호화하지 않습니다 (아래 「AI 가 만든 파일 암호화」)
   문서 소유자 도메인	example.com — 회사 테넌트에 등록된 도메인 (쉼표로 여러 개)

   게이트웨이 주소는 https 를 권합니다. http 도 연결되지만, 공유 폴더 계정과 비밀번호가 사내망에 암호화되지 않은 채 오갑니다.

   주소의 서버 이름도 변수로 적어야 합니다. 커넥터가 계정·비밀번호를 회사가 정한 서버로만 보내게 하기 위해서입니다.

4. 연결 주소와 키가 나옵니다. 키는 이때 한 번만 보입니다. 웍스AI 관리자 화면의 문서 보안 연결에 두 값을 넣어 주세요.

5. 연결 설정 탭 → 연결 확인 을 누릅니다. 네 항목이 모두 통과해야 합니다.

   항목	실패하면
   커넥터	커넥터가 꺼져 있거나 구버전입니다. MCP_DRM_ENABLED=off 를 넣어 두셨다면 지워 주세요
   설정 값	화면에 나온 변수 이름이 secrets 파일에 없습니다
   공유 폴더	2단계 마운트 또는 3-2 의 -v 줄을 확인해 주세요
   게이트웨이	커넥터에 연결한 폴더와 "공유 폴더 경로" 가 같은 폴더인지 먼저 확인해 주세요. 그다음 주소·443 포트·시스템 ID·공유 폴더 계정. 회사 자체 인증서를 쓰는 게이트웨이면 3-2 의 인증서 두 줄

   연결 확인은 커넥터가 공유 폴더에 시험 파일을 쓰고, 게이트웨이가 그 파일을 "공유 폴더 경로" 로 찾아 읽는지까지 봅니다.

6. 보안 등급 탭 에서 열어도 되는 범위를 정하고 저장합니다.

7. 화면 위의 켜기 를 누릅니다.

AI 가 만든 파일 암호화

웍스AI 가 AI 가 만든 파일(보고서·엑셀 등)을 사용자에게 내려줄 때, 회사 DRM 을 씌워서 내려보낼 수 있습니다.

• 연결 설정의 「암호화 기본 레이블 ID」에 씌울 보안 등급의 레이블 ID 를 그대로 적습니다. 레이블 ID 는 게이트웨이 담당자에게 받아 주세요. 비워 두면 암호화하지 않고 원래 파일을 내려보냅니다.
• 문서의 소유자는 파일을 내려받는 사용자로 정해집니다. 게이트웨이는 회사 테넌트에 등록된 도메인의 계정만 소유자로 받으므로, 「문서 소유자 도메인」에 그 도메인을 적어 주세요. 사용자 이메일이 그 도메인이 아니거나 칸이 비어 있으면 게이트웨이 기본 계정으로 암호화합니다.
• 레이블만 붙고 암호화되지 않은 파일은 레이블을 벗긴 뒤 회사 기본 등급으로 암호화합니다. 이미 암호화된 파일은 그대로 내려보냅니다.
• 사용자 지정 권한(Adhoc) 레이블은 쓸 수 없습니다. 권한이 미리 정해진 레이블을 골라 주세요.
• 커넥터 0.2.18 이상에서 동작합니다. 그 전 버전이면 레이블 ID 를 적어도 암호화하지 않고 원래 파일을 내려보냅니다.
• txt · csv 는 암호화하면 확장자가 ptxt 로 바뀝니다. 이 파일을 다시 웍스AI 에 올리면 평소처럼 풀립니다.

5. 운영

• 사용 기록 탭에서 누가 어떤 형식의 문서를 열었는지, 왜 못 열었는지 볼 수 있습니다.
• 키를 잃어버렸거나 새 나간 것 같으면 연결 설정 탭에서 새 키 발급. 이전 키는 즉시 쓸 수 없고, 웍스AI 에 새 키를 넣기 전까지 문서를 열 수 없습니다. 연결 주소는 바뀌지 않습니다.
• 잠시 멈추려면 화면 위의 끄기. 다시 켜면 설정 그대로 이어집니다.
• 공유 폴더에는 파일이 남지 않습니다. 커넥터가 처리 직후 지웁니다. 커넥터가 갑자기 꺼졌거나 게이트웨이가 늦게 결과를 쓴 경우에도, 커넥터가 mcp-hub 폴더에서 30분 지난 파일을 스스로 지웁니다. mcp-hub 폴더는 커넥터 전용이니 다른 파일을 두지 마세요.

열 수 없는 문서

한 번에 올릴 수 있는 문서는 100MB 까지입니다.