문제 해결
오류 메시지별 조치
1.9.2610.0부터 권한이 부족하면 확장 명령어 결과와 수집기 상태에 필요한 조치가 함께 표시됩니다.
| 메시지 | 원인 | 조치 |
|---|---|---|
register OAuth scopes in domain-wide delegation: ... | 도메인 전체 위임에 범위 미등록 | 표시된 범위를 도메인 전체 위임에 추가 |
OAuth user credential must include scopes: ... | 리프레시 토큰에 범위 없음 | 표시된 범위를 포함해 리프레시 토큰 다시 발급 |
account has no admin privilege for this API | 위임된 계정·동의한 계정에 관리자 권한 없음 | 관리자 역할에 필요한 권한 추가 |
share the spreadsheet with the account | 스프레드시트가 계정에 공유되지 않음 | 위임된 계정·동의한 계정에 스프레드시트 공유 |
enable the API in the Google Cloud project | 구글 클라우드에서 API 미사용 | 해당 API 사용 설정 |
alert center requires service account key ... | OAuth 방식으로 알림 센터 사용 | 알림 센터 수집기는 서비스 계정 방식 프로파일로 지정 |
delegated user is required for service account key | 서비스 계정 방식인데 위임된 계정 없음 | 접속 프로파일에 위임된 계정 입력 |
group not found: ... | group 옵션의 그룹을 찾을 수 없음 | 그룹 이메일이 아닌 그룹 이름 입력 |
업그레이드 후 수집기가 멈췄을 때
실행 중인 상태로 1.9.2610.0 이상으로 업그레이드하면 수집기가 오류로 멈출 수 있습니다. 구글 워크스페이스 수집기를 비활성화했다가 다시 활성화하세요. 수집기는 마지막 수집 시점부터 이어서 수집하므로 로그가 누락되지 않습니다.
권한을 바꿨는데 반영되지 않을 때
관리 콘솔에서 범위나 권한을 바꾼 뒤에는 접속 프로파일을 한 번 저장하세요. 앱은 받은 토큰을 최대 1시간 동안 다시 쓰므로, 저장하지 않으면 바뀐 설정이 바로 적용되지 않을 수 있습니다.
OAuth 범위를 줄이려면
사용자 계정 OAuth 방식에서 범위를 바꿔 다시 동의해도, 이전에 발급한 리프레시 토큰은 무효가 되지 않고 예전 범위를 그대로 유지합니다. 범위를 줄이려면 기존 동의를 먼저 철회하세요.
- 연동 전용 계정으로 Google 계정 > 보안 > 타사 앱 및 서비스에 들어가, OAuth 동의 화면에 등록한 앱(예: Logpresso Sonar)의 액세스 권한을 삭제합니다. 이 앱으로 발급한 리프레시 토큰이 모두 무효가 됩니다.
- 3-2. 사용자 계정 OAuth 방식의 단계 3을 줄인 범위로 다시 진행하고, 응답의
scope에 필요한 범위만 있는지 확인합니다. - 접속 프로파일의 서비스 키를 새 리프레시 토큰으로 바꾸고 저장합니다.
Caution
1을 진행하면 기존 리프레시 토큰을 쓰는 접속 프로파일은 바로 인증에 실패합니다. 2와 3을 이어서 진행하세요.