1. 기능별 필요 권한
사용할 수집기와 확장 명령어를 표에서 찾아 지원 인증 방식 열을 보고 사용할 인증 방식을 정하세요. 그다음 같은 행의 값을 정리해 두면 이후 설정 단계에서 그대로 등록합니다.
- 관리자 권한: 2. 구글 워크스페이스 준비에서 관리자 역할에 추가
- 구글 클라우드 API: 2. 구글 워크스페이스 준비에서 사용 설정
- OAuth 범위: 3-1. 서비스 계정 방식은 도메인 전체 위임에, 3-2. 사용자 계정 OAuth 방식은 리프레시 토큰 발급 시 등록
사용하지 않을 기능의 권한은 준비하지 않아도 됩니다. 권한이 빠진 기능만 실패하고, 오류 메시지에 필요한 조치가 표시됩니다.
Note
알림 센터를 제외한 수집기 5종과
*-logs 확장 명령어는 모두 admin.reports.audit.readonly 범위와 보고서 관리자 권한을 사용합니다. 감사 로그만 수집한다면 이 범위와 권한만 준비하면 됩니다. 단, Drive Activity 수집기와 drive-logs는 앱 이름 조회용 drive.apps.readonly 범위와 Google Drive API가 추가로 필요합니다.
관리자 권한은 관리 콘솔 관리자 역할의 관리자 권한 섹션 기준입니다.
수집기
| 수집기 (수집 모델) | 지원 인증 방식 | 관리자 권한 | 구글 클라우드 API | OAuth 범위 |
|---|---|---|---|---|
| Google Workspace Alert Center | 서비스 계정만 | 아래 알림 종류별 관리자 권한 표 참고 | Google Workspace Alert Center API | https://www.googleapis.com/auth/apps.alerts |
| Google Workspace Admin Activity | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| Google Workspace Login | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| Google Drive Activity | 서비스 계정, OAuth | 보고서 | Admin SDK API, Google Drive API | https://www.googleapis.com/auth/admin.reports.audit.readonly, https://www.googleapis.com/auth/drive.apps.readonly |
| Google Meet Activity | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| Google Chat Activity | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
확장 명령어
확장 명령어 이름은 공통 접두어 google-workspace-를 생략했습니다. 예를 들어 users는 google-workspace-users 명령어입니다.
| 확장 명령어 | 지원 인증 방식 | 관리자 권한 | 구글 클라우드 API | OAuth 범위 |
|---|---|---|---|---|
| alerts | 서비스 계정만 | 아래 알림 종류별 관리자 권한 표 참고 | Google Workspace Alert Center API | https://www.googleapis.com/auth/apps.alerts |
| admin-logs | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| login-logs | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| drive-logs | 서비스 계정, OAuth | 보고서 | Admin SDK API, Google Drive API | https://www.googleapis.com/auth/admin.reports.audit.readonly, https://www.googleapis.com/auth/drive.apps.readonly |
| meet-logs | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| chat-logs | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| oauth-logs | 서비스 계정, OAuth | 보고서 | Admin SDK API | https://www.googleapis.com/auth/admin.reports.audit.readonly |
| domains | 서비스 계정, OAuth | 도메인 관리 | Admin SDK API | https://www.googleapis.com/auth/admin.directory.domain.readonly |
| users | 서비스 계정, OAuth | 도메인 관리, 사용자 > 읽기 | Admin SDK API | https://www.googleapis.com/auth/admin.directory.domain.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly |
users (group 옵션) | 서비스 계정, OAuth | 도메인 관리, 사용자 > 읽기, 그룹스 > 읽기 | Admin SDK API | https://www.googleapis.com/auth/admin.directory.domain.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly |
| groups | 서비스 계정, OAuth | 도메인 관리, 그룹스 > 읽기 | Admin SDK API | https://www.googleapis.com/auth/admin.directory.domain.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly |
| drive-apps | 서비스 계정, OAuth | 없음 | Google Drive API | https://www.googleapis.com/auth/drive.apps.readonly |
| drive-app | 서비스 계정, OAuth | 없음 | Google Drive API | https://www.googleapis.com/auth/drive.apps.readonly |
| sheets-values | 서비스 계정, OAuth | 없음 (대상 시트를 보기 권한으로 공유) | Google Sheets API | https://www.googleapis.com/auth/spreadsheets.readonly |
| sheets-write-values | 서비스 계정, OAuth | 없음 (대상 시트를 편집 권한으로 공유) | Google Sheets API | https://www.googleapis.com/auth/spreadsheets |
알림 종류별 관리자 권한
알림 센터 수집기와 google-workspace-alerts 확장 명령어는 수집할 알림 종류에 따라 필요한 관리자 권한이 다릅니다.
| 수집할 알림 | 관리자 권한 |
|---|---|
| 시스템 알림 (예: 사용자에게 관리자 권한 부여) | 서비스 > 알림 센터 > 전체 권한 > 보기 액세스 |
| 활동 규칙 알림 (관리 콘솔 규칙에서 만든 규칙의 알림) | 서비스 > 알림 센터 > 전체 권한 > 보기 액세스, 서비스 > 보안 센터 > 활동 규칙 > 보기, 서비스 > 보안 센터 > 감사 및 조사 > 보기 > 규칙 |