Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Pianifica ed esegui un audit

I controlli ti consentono di raccogliere le prove necessarie per valutare la tua organizzazioneGoogle Cloud in base ai framework supportati. Puoi pianificare un controllo da eseguire a intervalli regolari o eseguire un controllo on demand.

Un audit è un'operazione a lunga esecuzione che potrebbe richiedere alcune ore. La durata dipende dal numero di risorse nell'ambito dell'audit, ovvero l'organizzazione, il progetto o la cartella che hai registrato in precedenza.

Se pianifichi un audit, puoi creare una pianificazione per un framework e una risorsa specifici solo se non esiste già una pianificazione attiva o in pausa per la combinazione di framework e risorsa.

Prima di iniziare

Assicurati di disporre di uno dei seguenti ruoli IAM:
- Audit Manager Admin (roles/auditmanager.admin)
- Audit Manager Auditor (roles/auditmanager.auditor)
Assicurati che la tua organizzazione, il tuo progetto o la tua cartella siano stati registrati per l'audit.

Pianifica ed esegui un audit

Puoi creare una pianificazione per eseguire un controllo su base ricorrente o eseguire un controllo on demand.

Console

Nella console Google Cloud , vai alla pagina Esegui valutazione in Audit Manager.

Vai ad Audit Manager
Nella sezione Scegli risorsa e regione, segui questi passaggi:
1. Seleziona l'organizzazione, la cartella o il progetto da sottoporre ad audit.
2. Seleziona la località in cui deve essere elaborata la valutazione dell'audit. Per l'elenco delle località supportate, consulta Località di Audit Manager.
3. Fai clic su Avanti.
Nella sezione Scegli regolamento, seleziona il framework in base al quale vuoi controllare la risorsa e fai clic su Avanti. Per informazioni sui framework supportati, consulta Framework supportati.
(Facoltativo) Se viene visualizzata la sezione Configura parametri, completa quanto segue:
1. Fai clic su Modifica configurazione.
2. Nella finestra Configura parametri, aggiungi i parametri richiesti per i controlli cloud. Per ulteriori informazioni sui parametri, consulta il riferimento ai controlli cloud di Compliance Manager e i controlli cloud di Assured Workloads.
3. Fai clic su Salva.
(Facoltativo) Nella sezione Visualizza piano di valutazione, puoi scaricare un file ODS contenente informazioni sull'ambito di audit in base al framework selezionato. Per scaricare il file, fai clic sul link e poi su Avanti.
Nella sezione Scegli bucket di archiviazione, seleziona un bucket di archiviazione in cui salvare il report di controllo e le prove, quindi fai clic su Fine. Se il tuo bucket non è presente nell'elenco, chiedi all'amministratore di registrare la risorsa con il bucket di archiviazione.
(Facoltativo) Nella sezione Pianificazione, imposta una delle seguenti opzioni:
- La frequenza con cui ripetere il controllo (giornaliera, mensile, trimestrale o annuale).
- Il periodo di tempo da includere nel controllo. Se scegli Senza fine, il controllo continua a essere eseguito dalla data di inizio specificata fino a quando non lo interrompi manualmente.
Per avviare il controllo, fai clic su Esegui controllo o Esegui controllo pianificato.

Puoi visualizzare lo stato della verifica nella pagina Visualizza valutazioni.

gcloud

(Facoltativo) Genera una valutazione di controllo

Prima di eseguire un audit vero e proprio, puoi generare una valutazione (o un ambito) dell'audit che include una suddivisione dettagliata delle attività per l'audit in base al framework di conformità che hai scelto.

Il comando gcloud audit-manager audit-scopes generate genera un ambito di controllo.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organization, folder e project.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni in Audit Manager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.
OUTPUT_DIRECTORY: la directory in cui deve essere archiviato l'output. Ad esempio: reports.
OUTPUT_FILENAME: il nome del file di output. Non includere l'estensione del file nel nome file. Ad esempio:scopeReport.

Esegui questo comando:

Linux, macOS o 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

Esegui un controllo on demand

Il comando gcloud audit-manager audit-reports generate esegue un audit.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organization, folder e project.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni in Audit Manager.
BUCKET_URI: l'URI del bucket Cloud Storage. Ad esempio: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.

Esegui questo comando:

Linux, macOS o 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

Dovresti ricevere una risposta simile alla seguente:

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

REST

(Facoltativo) Genera una valutazione di controllo

Prima di eseguire un audit effettivo, puoi generare una valutazione (o un ambito) dell'audit che include un'analisi dettagliata delle attività per l'audit in base al framework di conformità scelto.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni in Audit Manager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:


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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{

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

La risposta contiene le seguenti informazioni:

Il campo scope_reports_contents è il formato byte dei contenuti, che deve essere convertito in formato ODF prima della revisione.

name: un identificatore di stringa univoco della risorsa applicabile.

Esegui un controllo on demand

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni in Audit Manager.
BUCKET_URI: l'URI del bucket Cloud Storage. Ad esempio: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:


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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

La risposta contiene le seguenti informazioni:

name: un identificatore di stringa univoco della richiesta di operazione di valutazione del controllo. Questo identificatore viene utilizzato per monitorare l'avanzamento del processo di valutazione dell'audit. Ad esempio: operation/098234.
done: un flag booleano impostato su false che indica che il processo è stato attivato. Questo valore viene impostato su true al termine della valutazione dell'audit.

Esegui un controllo pianificato

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
FRAMEWORK: l'ID del framework rispetto al quale eseguire l'audit. Ad esempio: builtin-cis-v8. Per trovare l'ID di un framework, consulta la pagina Visualizza valutazioni in Audit Manager.
BUCKET_URI: l'URI del bucket Cloud Storage. Ad esempio: gs://testbucketauditmanager.
AUDIT_REPORT_FORMAT: il formato del report di controllo di output. È supportato solo il formato ODF: AUDIT_REPORT_FORMAT_ODF.
DISPLAY_NAME: un nome per la pianificazione dell'audit. Ad esempio: NIST 800-53 Daily Audit.
SCHEDULE_START_TIME: il timestamp di attivazione della pianificazione di controllo. Ad esempio: 2026-02-25T10:00:00Z.
SCHEDULE_END_TIME: il timestamp di interruzione della pianificazione dell'audit. Ad esempio: 2027-02-25T10:00:00Z.
FREQUENCY: la frequenza delle esecuzioni dei controlli pianificati. Può essere uno dei seguenti valori: DAILY, WEEKLY, MONTHLY, QUARTERLY o ANNUALLY. Ad esempio: DAILY.
TIME_ZONE: il fuso orario per la pianificazione dell'audit in formato IANA. Questa variabile viene utilizzata per interpretare start_time e end_time. Se non specificato, il valore predefinito è UTC. Ad esempio: America/New_York.
SCHEDULE_STATE: lo stato della pianificazione di controllo. Può essere uno dei seguenti: SCHEDULE_STATE_ACTIVE, SCHEDULE_STATE_PAUSED o SCHEDULE_STATE_DELETED. Ad esempio: SCHEDULE_STATE_ACTIVE.
AUDIT_SCHEDULE_ID: un identificatore univoco per la pianificazione dell'audit.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "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"
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
}

Aggiorna i controlli pianificati

Puoi mettere in pausa, riprendere e interrompere i controlli ricorrenti. Se vuoi modificare la pianificazione, devi eliminare il controllo pianificato esistente e crearne uno nuovo.

Console

Nella console Google Cloud , vai alla pagina Gestione dei controlli in Audit Manager.

Vai ad Audit Manager
Nella scheda Pianificazioni, trova l'audit pianificato che vuoi aggiornare.
Esegui una delle seguenti operazioni:
- Per mettere in pausa una pianificazione di controllo, fai clic su Metti in pausa pianificazione.
- Per riavviare un controllo che hai messo in pausa, fai clic su Riprendi pianificazione.
- Per eliminare un controllo pianificato, fai clic su Interrompi pianificazione.

REST

Per mettere in pausa, riprendere o eliminare una pianificazione di controllo, invia una richiesta PATCH per aggiornare il state della pianificazione di controllo.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

RESOURCE_TYPE: il tipo di risorsa. I valori validi sono organizations, folders e projects.
RESOURCE_ID: l'ID risorsa dell'organizzazione, del progetto o della cartella. Ad esempio: 8767234.
LOCATION: la località dell'endpoint API Audit Manager. Per un elenco degli endpoint disponibili, consulta Località di Audit Manager. Ad esempio us-central1.
AUDIT_SCHEDULE_ID: l'ID della pianificazione di controllo da aggiornare. Ad esempio: my-schedule-id.
SCHEDULE_STATE: lo stato target della pianificazione di controllo. Imposta uno dei seguenti valori:
- SCHEDULE_STATE_PAUSED: per mettere in pausa una pianificazione attiva.
- SCHEDULE_STATE_ACTIVE: per riprendere una pianificazione in pausa.
- SCHEDULE_STATE_DELETED: per interrompere ed eliminare una pianificazione.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "state": "SCHEDULE_STATE"
}

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
}

Pianifica ed esegui un audit Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Pianifica ed esegui un audit

Console

gcloud

(Facoltativo) Genera una valutazione di controllo

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Esegui un controllo on demand

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

(Facoltativo) Genera una valutazione di controllo

curl

PowerShell

Esegui un controllo on demand

curl

PowerShell

Esegui un controllo pianificato

curl

PowerShell

Aggiorna i controlli pianificati

Console

REST

curl

PowerShell

Passaggi successivi

Pianifica ed esegui un audit