설치 매뉴얼
개요
Note
이 매뉴얼은 2026년 10월 기준 화면으로 작성했습니다. 구글 클라우드 콘솔의 메뉴 이름과 화면은 바뀔 수 있습니다.
Google Cloud 앱은 Cloud Asset Inventory API와 Cloud Resource Manager API를 이용해 구글 클라우드의 자산·프로젝트·IAM 정책을 조회하는 확장 명령어를 제공합니다. 수집기 없이 쿼리로 조회하며, 서비스 계정 JSON 키로 인증합니다. 소나 4.0.2502.0 이상에서 동작합니다.
| 확장 명령어 | 조회 내용 |
|---|---|
| gcp-assets | 프로젝트·폴더·조직 아래의 자원 (VM, 버킷, 서비스 계정, 사용 설정된 API 등) |
| gcp-projects | 프로젝트 목록 |
| gcp-iam-policies | IAM 정책 (어느 자원에 누가 어떤 역할을 가졌는지) |
| gcp-check-permissions | 서비스 계정 권한 점검 |
설정 흐름
먼저 1. 기능별 필요 권한에서 조회할 범위와 필요한 역할을 정하세요. 조회 범위에 따라 역할을 부여하는 단계가 다릅니다. 아래 표에서 고른 범위의 칸이 필요인 단계만 순서대로 진행하세요. 작업 이름을 누르면 해당 설정 페이지로 이동합니다.
| 작업 | 작업 위치 | 프로젝트만 조회 | 조직·폴더 단위 조회 |
|---|---|---|---|
| 2. 프로젝트 생성, API 사용 설정 | 구글 클라우드 콘솔 | 필요 | 필요 |
| 3. 서비스 계정과 키 발급 | 구글 클라우드 콘솔 | 필요 | 필요 |
| 4-1. 프로젝트에 역할 부여 | 구글 클라우드 콘솔 | 필요 | - |
| 4-2. 조직·폴더에 역할 부여 | 구글 클라우드 콘솔 (조직 관리자) | - | 필요 |
| 5. 앱 설치, 접속 프로파일 추가 | 로그프레소 소나 | 필요 | 필요 |
| 6. 설치 후 검증 | 로그프레소 소나 | 필요 | 필요 |
설정을 마친 뒤 확장 명령어에서 조회할 프로젝트·폴더·조직을 지정하는 방법은 조회 범위 지정을 참고하세요. 오류가 나면 문제 해결을 참고하세요.
네트워크 요구 사항
소나에서 아래 주소로 HTTPS(443) 아웃바운드 통신이 허용되어야 합니다. 프록시를 거쳐야 하면 접속 프로파일에 HTTP 프록시를 입력합니다.
| 주소 | 사용하는 기능 |
|---|---|
oauth2.googleapis.com | 모든 기능 (토큰 발급) |
cloudasset.googleapis.com | gcp-assets, gcp-iam-policies |
cloudresourcemanager.googleapis.com | gcp-projects, gcp-check-permissions |
참고 자료
- Cloud Asset Inventory 문서
- Cloud Asset Inventory 지원 자산 유형
- Cloud Asset Inventory 검색식 문법 (gcp-assets)
- IAM 정책 검색 (gcp-iam-policies)
- Resource Manager 프로젝트 검색 (gcp-projects)
- 서비스 계정 키 만들기 및 관리