Drive 보안, 감사 및 안전한 삭제 규칙

Drive 자동화는 파일을 이동하고 공유하고 삭제할 수 있기 때문에 강력합니다. 이러한 능력에는 명확한 안전 규칙이 필요합니다. TrekMail의 Drive API는 범위가 제한된 토큰, 복구 가능한 휴지통, 명시적인 영구 삭제 권한, MCP 안전 게이트 및 감사 로깅을 결합하여 에이전트가 보이지 않는 파일 관리자가 되지 않고 작업할 수 있게 합니다.

범위가 좁은 토큰 사용

워크플로마다 토큰을 하나씩 만드세요. 보고용 토큰은 읽기, 업로드 토큰은 쓰기, 전달 토큰은 공유만 할 수 있어야 합니다. 정리 토큰에는 영구 삭제 권한을 부여할 수 있지만 별도로 만들고 명확하게 이름을 지정하며 드물게 사용해야 합니다.

항상 실행되는 단일 에이전트에 모든 Drive 범위를 부여하지 마세요. 문제가 발생할 경우 범위가 좁은 토큰은 영향 범위를 제한하고 감사 검토를 더 쉽게 만듭니다.

먼저 휴지통으로 이동하고 나중에 영구 삭제

일반 삭제는 파일과 폴더를 휴지통으로 이동합니다. 휴지통에서는 복구할 수 있습니다. 영구 삭제는 되돌릴 수 없습니다.

다음 기본 규칙을 사용하세요.

에이전트는 승인된 워크플로의 일부로 파일을 휴지통으로 이동할 수 있습니다. 사용자가 영구 삭제를 명시적으로 요청했거나 검토된 유지 관리 작업이 실행 중인 경우에만 파일을 영구 삭제할 수 있습니다.

로컬에서 호스팅되는 MCP 서버에서는 관리자가 영구 삭제 도구에 TREKMAIL_ALLOW_DESTRUCTIVE=true를 요구할 수 있습니다. 해당 영구 삭제 범위도 항상 필요합니다.

공개 링크 검토

공개 공유 링크는 외부 전달을 위해 설계되었습니다. URL을 가진 사람은 링크가 만료되거나 다운로드 한도에 도달하거나 취소될 때까지 파일을 다운로드할 수 있습니다.

더 안전한 기본 설정:

• 만료 날짜를 설정하세요.
• 다운로드 한도를 설정하세요.
• 프로젝트가 끝나면 링크를 취소하세요.
• 정책에서 허용하지 않는 한 지정된 수신자만 접근해야 하는 파일에는 공개 링크를 만들지 마세요.

데이터를 변경하는 모든 워크플로 감사

데이터를 변경하는 Drive API 및 MCP 작업은 사용한 토큰과 함께 기록됩니다. AI 에이전트 및 API → 감사 로그에서 다음 질문에 답할 수 있습니다.

• 어떤 토큰이 이 폴더를 만들었나요?
• 어떤 에이전트가 파일을 업로드했나요?
• 공개 링크는 언제 생성되거나 취소되었나요?
• 영구 삭제 작업이 수행되었나요?

나중에 토큰을 취소하더라도 이전 감사 항목은 검토에 계속 유용합니다.

사서함 제한

에이전트에 한 사서함의 Drive만 필요한 경우 토큰을 해당 사서함으로 제한하세요. API는 제한 밖의 리소스를 공개하지 않습니다. 이는 단일 사서함 워크플로에 포함된 도우미에게 특히 중요합니다.

결제 안전

Drive 추가 기능의 결제 변경은 API 또는 MCP 쓰기 도구를 통해 제공되지 않습니다. 에이전트는 추가 기능 상태와 가격을 읽을 수 있지만 구매, 용량 변경 및 취소 작업은 대시보드에서만 수행됩니다. 따라서 파일 자동화 토큰이 결제 자동화 토큰으로 바뀌는 일을 막을 수 있습니다.

사고 대응 체크리스트

에이전트가 예상하지 못한 작업을 수행한 경우:

1. 토큰을 취소합니다.
2. 해당 토큰으로 필터링한 감사 로그를 검토합니다.
3. 가능한 경우 휴지통에서 파일을 복원합니다.
4. 의도하지 않은 공유 링크를 취소합니다.
5. 워크플로를 수정한 후에만 범위가 더 좁은 대체 토큰을 만듭니다.