감사 예약 및 실행

감사를 통해 지원되는 프레임워크에 따라Google Cloud 조직을 평가하는 데 필요한 증거를 수집할 수 있습니다. 정기적으로 실행되도록 감사를 예약하거나 주문형 감사를 실행할 수 있습니다.

감사는 몇 시간이 걸릴 수 있는 장기 실행 작업입니다. 소요 시간은 감사 범위 내 리소스 수, 즉 이전에 등록한 조직, 프로젝트 또는 폴더 수에 따라 달라집니다.

감사를 예약하는 경우 프레임워크 및 리소스 조합에 대한 활성 또는 일시중지된 일정이 아직 없는 경우에만 특정 프레임워크 및 리소스에 대한 일정을 만들 수 있습니다.

시작하기 전에

  • 다음 IAM 역할 중 하나가 있는지 확인합니다.

    • 감사 관리자 관리 (roles/auditmanager.admin)
    • 감사 관리자 감사관 (roles/auditmanager.auditor)
  • 조직, 프로젝트 또는 폴더가 감사를 위해 등록되었는지 확인합니다.

감사 예약 및 실행

일정을 만들어 감사를 반복적으로 실행하거나 주문형 감사를 실행할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Audit Manager의 평가 실행 페이지로 이동합니다.

    감사 관리자로 이동

  2. 리소스 및 리전 선택 섹션에서 다음을 수행합니다.

    1. 감사해야 하는 조직, 폴더 또는 프로젝트를 선택합니다.

    2. 감사 평가를 처리해야 하는 위치를 선택합니다. 지원되는 위치 목록은 감사 관리자 위치를 참조하세요.

    3. 다음을 클릭합니다.

  3. 규정 선택 섹션에서 리소스를 감사할 프레임워크를 선택하고 다음을 클릭합니다. 지원되는 프레임워크에 대한 자세한 내용은 지원되는 프레임워크를 참조하세요.

  4. 선택사항: 매개변수 구성 섹션이 표시되면 다음을 완료합니다.

    1. 구성 수정을 클릭합니다.

    2. 매개변수 구성 창에서 클라우드 제어에 필요한 매개변수를 추가합니다. 매개변수에 대한 자세한 내용은 규정 준수 관리자 클라우드 제어 참조 및 Assured Workloads 클라우드 제어를 참조하세요.

    3. 저장을 클릭합니다.

  5. 선택사항: 평가 계획 보기 섹션에서 선택한 프레임워크에 따라 감사 범위에 대한 정보가 포함된 ODS 파일을 다운로드할 수 있습니다. 파일을 다운로드하려면 링크를 클릭하고 다음을 클릭합니다.

  6. 스토리지 버킷 선택 섹션에서 감사 보고서와 증거를 저장해야 하는 스토리지 버킷을 선택하고 완료를 클릭합니다. 버킷이 목록에 없으면 관리자에게 스토리지 버킷에 리소스를 등록하도록 요청하세요.

  7. 선택사항: 일정 섹션에서 다음 중 하나를 설정합니다.

    • 감사를 반복할 빈도 (매일, 매월, 분기별 또는 매년)입니다.

    • 감사에 포함할 기간입니다. 종료되지 않음을 선택하면 수동으로 중지할 때까지 지정한 시작일부터 감사가 계속 실행됩니다.

  8. 감사를 시작하려면 감사 실행 또는 예약된 감사 실행을 클릭합니다.

    평가 보기 페이지에서 감사 상태를 확인할 수 있습니다.

gcloud

선택사항: 감사 평가 생성

실제 감사를 실행하기 전에 선택한 규정 준수 프레임워크를 기반으로 감사에 대한 자세한 태스크 분류가 포함된 감사 평가(또는 범위)를 생성할 수 있습니다.

gcloud audit-manager audit-scopes generate 명령어는 감사 범위를 생성합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organization, folder, project입니다.
  • RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
  • LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
  • FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 감사 관리자의 평가 보기 페이지를 참조하세요.
  • AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF
  • OUTPUT_DIRECTORY: 출력이 저장되어야 하는 디렉터리입니다. 예를 들면 reports입니다.
  • OUTPUT_FILENAME: 출력 파일의 이름입니다. 파일 이름에 파일 확장자를 포함하지 마세요. 예를 들면 scopeReport입니다.

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud audit-manager audit-scopes generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --output-directory=OUTPUT_DIRECTORY \
    --output-file-name=OUTPUT_FILENAME

Windows(PowerShell)

gcloud audit-manager audit-scopes generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --output-directory=OUTPUT_DIRECTORY `
    --output-file-name=OUTPUT_FILENAME

Windows(cmd.exe)

gcloud audit-manager audit-scopes generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --output-directory=OUTPUT_DIRECTORY ^
    --output-file-name=OUTPUT_FILENAME

주문형 감사 실행

gcloud audit-manager audit-reports generate 명령어는 감사를 실행합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organization, folder, project입니다.
  • RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
  • LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
  • FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 감사 관리자의 평가 보기 페이지를 참조하세요.
  • BUCKET_URI: Cloud Storage 버킷의 URI입니다. 예를 들면 gs://testbucketauditmanager입니다.
  • AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud audit-manager audit-reports generate \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION \
    --compliance-framework=FRAMEWORK \
    --report-format=AUDIT_REPORT_FORMAT \
    --gcs-uri=BUCKET_URI

Windows(PowerShell)

gcloud audit-manager audit-reports generate `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION `
    --compliance-framework=FRAMEWORK `
    --report-format=AUDIT_REPORT_FORMAT `
    --gcs-uri=BUCKET_URI

Windows(cmd.exe)

gcloud audit-manager audit-reports generate ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION ^
    --compliance-framework=FRAMEWORK ^
    --report-format=AUDIT_REPORT_FORMAT ^
    --gcs-uri=BUCKET_URI

다음과 비슷한 응답이 표시됩니다.

done: false
name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24

REST

선택사항: 감사 평가 생성

실제 감사를 실행하기 전에 선택한 규정 준수 프레임워크를 기반으로 감사에 대한 자세한 태스크 분류가 포함된 감사 평가(또는 범위)를 생성할 수 있습니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
  • RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
  • LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
  • FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 감사 관리자의 평가 보기 페이지를 참조하세요.
  • AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF

HTTP 메서드 및 URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate

JSON 요청 본문:


{
  "compliance_framework" : "FRAMEWORK"
  "report_format" : "AUDIT_REPORT_FORMAT"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{

  "scope_report_contents" : "980u43nrf090834uhbkfehf......"
  "name" : "folders/8767234/locations/us-west"
}

응답에는 다음 정보가 포함됩니다.

    scope_reports_contents 필드는 콘텐츠의 바이트 형식이며 검토 전에 ODF 형식으로 변환해야 합니다.

  • name: 해당 리소스의 고유한 문자열 식별자입니다.

주문형 감사 실행

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
  • RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
  • LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
  • FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 감사 관리자의 평가 보기 페이지를 참조하세요.
  • BUCKET_URI: Cloud Storage 버킷의 URI입니다. 예를 들면 gs://testbucketauditmanager입니다.
  • AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF

HTTP 메서드 및 URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate

JSON 요청 본문:


{
  "destination" : {
    "gcs_uri" : "BUCKET_URI"
  },
  "compliance_framework" : "FRAMEWORK"
  "report_format" : "AUDIT_REPORT_FORMAT"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "organizations/834/projects/10398413/locations/987234/operations/098234",
  "done": false
}

응답에는 다음 정보가 포함됩니다.

  • name: 감사 평가 작업 요청의 고유 문자열 식별자입니다. 이 식별자는 감사 평가 프로세스의 진행 상황을 추적하는 데 사용됩니다. 예를 들면 operation/098234입니다.
  • done: false로 설정되는 불리언 플래그로서 프로세스가 트리거되었음을 의미합니다. 감사 평가가 완료되면 true로 설정됩니다.

예약된 감사 실행

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
  • RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
  • LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
  • FRAMEWORK: 감사의 기준이 되는 프레임워크의 ID입니다. 예를 들면 builtin-cis-v8입니다. 프레임워크 ID를 찾으려면 감사 관리자의 평가 보기 페이지를 참조하세요.
  • BUCKET_URI: Cloud Storage 버킷의 URI입니다. 예를 들면 gs://testbucketauditmanager입니다.
  • AUDIT_REPORT_FORMAT: 출력 감사 보고서의 형식입니다. ODF 형식만 지원됩니다. AUDIT_REPORT_FORMAT_ODF
  • DISPLAY_NAME: 감사 일정의 이름입니다. 예를 들면 NIST 800-53 Daily Audit입니다.
  • SCHEDULE_START_TIME: 감사 일정이 활성화되는 타임스탬프입니다. 예를 들면 2026-02-25T10:00:00Z입니다.
  • SCHEDULE_END_TIME: 감사 일정이 중지되는 타임스탬프입니다. 예를 들면 2027-02-25T10:00:00Z입니다.
  • FREQUENCY: 예약된 감사 실행 빈도입니다. DAILY, WEEKLY, MONTHLY, QUARTERLY, ANNUALLY 중 하나일 수 있습니다. 예를 들면 DAILY입니다.
  • TIME_ZONE: IANA 형식의 감사 일정 시간대입니다. 이 변수는 start_time 및 end_time를 해석하는 데 사용됩니다. 지정하지 않으면 기본값은 UTC입니다. 예를 들면 America/New_York입니다.
  • SCHEDULE_STATE: 감사 일정의 상태입니다. SCHEDULE_STATE_ACTIVE, SCHEDULE_STATE_PAUSED, SCHEDULE_STATE_DELETED 중 하나일 수 있습니다. 예를 들면 SCHEDULE_STATE_ACTIVE입니다.
  • AUDIT_SCHEDULE_ID: 감사 일정의 고유 식별자입니다.

HTTP 메서드 및 URL:

POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID

JSON 요청 본문:

{
  "display_name": "DISPLAY_NAME",
  "gcs_uri": "BUCKET_URI",
  "compliance_framework": "FRAMEWORK",
  "report_format": "AUDIT_REPORT_FORMAT",
  "schedule_config": {
    "start_time": "SCHEDULE_START_TIME",
    "end_time": "SCHEDULE_END_TIME",
    "frequency": "FREQUENCY",
    "time_zone": "TIME_ZONE"
  },
  "state": "SCHEDULE_STATE"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_ACTIVE",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-02-25T13:27:00Z"
}

예약된 감사 업데이트

반복 감사를 일시중지, 재개, 중지할 수 있습니다. 일정을 변경하려면 기존 예약된 감사를 삭제한 후 새 예약된 감사를 만들어야 합니다.

콘솔

  1. Google Cloud 콘솔에서 Audit Manager의 감사 관리 페이지로 이동합니다.

    감사 관리자로 이동

  2. 예약 탭에서 업데이트할 예약된 감사를 찾습니다.

  3. 다음 중 하나를 수행합니다.

    • 감사 일정을 일시중지하려면 일정 일시중지를 클릭합니다.

    • 일시중지한 감사를 다시 시작하려면 일정 재개를 클릭합니다.

    • 예약된 감사를 삭제하려면 일정 중지를 클릭합니다.

REST

감사 일정을 일시중지, 재개 또는 삭제하려면 PATCH 요청을 전송하여 감사 일정의 state를 업데이트합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • RESOURCE_TYPE: 리소스 유형입니다. 유효한 값은 organizations, folders, projects입니다.
  • RESOURCE_ID: 조직, 프로젝트 또는 폴더의 리소스 ID입니다. 예를 들면 8767234입니다.
  • LOCATION: Audit Manager API 엔드포인트의 위치입니다. 사용 가능한 엔드포인트 목록은 감사 관리자 위치를 참조하세요. 예를 들면 us-central1입니다.
  • AUDIT_SCHEDULE_ID: 업데이트할 감사 일정의 ID입니다. 예를 들면 my-schedule-id입니다.
  • SCHEDULE_STATE: 감사 일정의 타겟 상태입니다. 다음 중 하나로 설정합니다.
    • SCHEDULE_STATE_PAUSED: 활성 일정을 일시중지합니다.
    • SCHEDULE_STATE_ACTIVE: 일시중지된 일정을 재개합니다.
    • SCHEDULE_STATE_DELETED: 일정을 중지하고 삭제합니다.

HTTP 메서드 및 URL:

PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state

JSON 요청 본문:

{
  "state": "SCHEDULE_STATE"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"

PowerShell

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
  "display_name": "My first audit schedule",
  "gcs_uri": "gs://my-bucket",
  "compliance_framework": "NIST_800_53",
  "report_format": "AUDIT_REPORT_FORMAT_ODF",
  "schedule_config": {
    "start_time": "2026-02-25T10:00:00Z",
    "end_time": "2027-02-25T10:00:00Z",
    "frequency": "DAILY",
    "time_zone": "America/New_York"
  },
  "state": "SCHEDULE_STATE_PAUSED",
  "create_time": "2026-02-25T13:27:00Z",
  "update_time": "2026-09-11T18:15:00Z"
}

다음 단계