설치 매뉴얼
개요
Caution
이 매뉴얼은 구글 워크스페이스 앱 1.9.2610.0 이상을 기준으로 작성되었습니다. 앱 설치 전에 최신 버전을 사용하는지 확인하고, 이전 버전을 사용 중이라면 최신 버전으로 업그레이드하세요.
Note
이 매뉴얼은 2026년 10월 기준 화면으로 작성했습니다. 구글 워크스페이스 관리 콘솔과 구글 클라우드 콘솔의 메뉴 이름과 화면은 바뀔 수 있습니다.
구글 워크스페이스 앱은 구글 워크스페이스의 감사 로그(관리자 활동, 로그인, 드라이브, Meet, Chat, OAuth 토큰)와 알림 센터 알림을 수집하고, 도메인·사용자·그룹·드라이브 연결 앱 조회와 구글 스프레드시트 읽기·쓰기 확장 명령어를 제공합니다.
설정 흐름
먼저 1. 기능별 필요 권한에서 사용할 수집기와 확장 명령어를 정하고, 필요한 권한만 준비하세요. 인증 방식은 3. 인증 방식 선택을 참고해 고릅니다.
인증 방식에 따라 진행할 단계가 다릅니다. 아래 표에서 고른 방식의 칸이 필요인 단계만 순서대로 진행하세요. 작업 이름을 누르면 해당 설정 페이지로 이동합니다.
| 작업 | 작업 위치 | 서비스 계정 방식 | 사용자 계정 OAuth 방식 |
|---|---|---|---|
| 2. 연동 전용 계정과 관리자 역할 준비 | 관리 콘솔 | 필요 | 필요 (드라이브 앱·스프레드시트 명령어만 쓰면 불필요) |
| 2. 프로젝트 생성, API 사용 설정 | 구글 클라우드 콘솔 | 필요 | 필요 |
| 3-1. 서비스 계정과 키 발급 | 구글 클라우드 콘솔 | 필요 | - |
| 3-1. 도메인 전체 위임 등록 | 관리 콘솔 | 필요 | - |
| 3-2. OAuth 동의 화면, 클라이언트 구성 | 구글 클라우드 콘솔 | - | 필요 |
| 3-2. 리프레시 토큰 발급 | OAuth 2.0 Playground | - | 필요 |
| 4. 앱 설치, 접속 프로파일, 수집기 설정 | 로그프레소 소나 | 필요 | 필요 |
네트워크 요구 사항
소나에서 사용할 기능에 해당하는 주소로 HTTPS(443) 아웃바운드 통신이 허용되어야 합니다.
| 주소 | 사용하는 기능 |
|---|---|
oauth2.googleapis.com | 모든 기능 (토큰 발급) |
admin.googleapis.com | Admin Activity·Login·Drive·Meet·Chat 수집기, *-logs 확장 명령어, google-workspace-domains·users·groups |
alertcenter.googleapis.com | 알림 센터 수집기, google-workspace-alerts |
www.googleapis.com | Drive Activity 수집기, google-workspace-drive-logs·drive-apps·drive-app |
sheets.googleapis.com | google-workspace-sheets-values·sheets-write-values |