Google Workspace

다운로드 224
업데이트 2026. 11. 12.

설치 매뉴얼

개요

Caution
이 매뉴얼은 구글 워크스페이스 앱 1.9.2610.0 이상을 기준으로 작성되었습니다. 앱 설치 전에 최신 버전을 사용하는지 확인하고, 이전 버전을 사용 중이라면 최신 버전으로 업그레이드하세요. Gmail 로그 수집과 google-workspace-gmail-logs 확장 명령어는 1.10.2611.0 이상에서 사용할 수 있습니다.
Note
이 매뉴얼은 2026년 10월 기준 화면으로 작성했습니다. 구글 워크스페이스 관리 콘솔과 구글 클라우드 콘솔의 메뉴 이름과 화면은 바뀔 수 있습니다.

구글 워크스페이스 앱은 구글 워크스페이스의 감사 로그(관리자 활동, 로그인, 드라이브, Gmail, Meet, Chat, OAuth 토큰)와 알림 센터 알림을 수집하고, 도메인·사용자·그룹·드라이브 연결 앱 조회와 구글 스프레드시트 읽기·쓰기 확장 명령어를 제공합니다.

설정 흐름

먼저 1. 기능별 필요 권한에서 사용할 수집기와 확장 명령어를 정하고, 필요한 권한만 준비하세요. 인증 방식은 3. 인증 방식 선택을 참고해 고릅니다.

인증 방식에 따라 진행할 단계가 다릅니다. 아래 표에서 고른 방식의 칸이 필요인 단계만 순서대로 진행하세요. 작업 이름을 누르면 해당 설정 페이지로 이동합니다.

작업작업 위치서비스 계정 방식사용자 계정 OAuth 방식
2. 연동 전용 계정과 관리자 역할 준비관리 콘솔필요필요 (드라이브 앱·스프레드시트 명령어만 쓰면 불필요)
2. 프로젝트 생성, API 사용 설정구글 클라우드 콘솔필요필요
3-1. 서비스 계정과 키 발급구글 클라우드 콘솔필요-
3-1. 도메인 전체 위임 등록관리 콘솔필요-
3-2. OAuth 동의 화면, 클라이언트 구성구글 클라우드 콘솔-필요
3-2. 리프레시 토큰 발급OAuth 2.0 Playground-필요
4. 앱 설치, 접속 프로파일, 수집기 설정로그프레소 소나필요필요

Gmail 로그 제약 사항

Gmail 로그는 구글이 제공하는 범위에 따라 다음 제약이 있습니다.

  • 구글 워크스페이스 에디션에 따라 Gmail 로그가 제공되지 않을 수 있습니다.
  • 구글은 Gmail 로그를 180일 동안 보관하므로, 수집기의 모니터링 대상 일수는 최대 180일입니다.
  • google-workspace-gmail-logs 확장 명령어는 from 또는 duration 옵션이 필수이고, 최근 180일 이내를 한 번에 최대 30일까지 조회합니다.
  • 보낸 사람 주소, 첨부 파일 이름, 클릭한 링크의 URL은 제공되지 않습니다.
  • 수신자는 받는사람, 참조, 숨은참조를 구분하지 않습니다.
  • 반송은 메일 이벤트 유형 UNKNOWN과 처리 유형 BOUNCED로, 전달은 원본 메일의 FIRST_REPLIED로 기록됩니다.
  • 읽음 표시, 메일 다운로드, 스팸 신고 시의 발신자 차단은 기록되지 않습니다.
  • 배송 단계 이벤트(UNKNOWN)가 전체의 절반가량입니다.

네트워크 요구 사항

소나에서 사용할 기능에 해당하는 주소로 HTTPS(443) 아웃바운드 통신이 허용되어야 합니다.

주소사용하는 기능
oauth2.googleapis.com모든 기능 (토큰 발급)
admin.googleapis.comAdmin Activity·Login·Drive·Gmail·Meet·Chat 수집기, *-logs 확장 명령어, google-workspace-domains·users·groups
alertcenter.googleapis.com알림 센터 수집기, google-workspace-alerts
www.googleapis.comDrive Activity 수집기, google-workspace-drive-logs·drive-apps·drive-app
sheets.googleapis.comgoogle-workspace-sheets-values·sheets-write-values