Planifier et exécuter un audit

Les audits vous permettent de collecter les preuves dont vous avez besoin pour évaluer votre organisationGoogle Cloud par rapport aux frameworks compatibles. Vous pouvez planifier l'exécution d'un audit à intervalles réguliers ou exécuter un audit à la demande.

Un audit est une opération de longue durée qui peut prendre quelques heures. La durée dépend du nombre de ressources dans le champ d'application de l'audit, c'est-à-dire l'organisation, le projet ou le dossier que vous avez précédemment enregistré.

Si vous planifiez un audit, vous ne pouvez créer une planification pour un framework et une ressource spécifiques que s'il n'existe pas déjà de planification active ou en pause pour cette combinaison de framework et de ressource.

Avant de commencer

  • Assurez-vous de disposer de l'un des rôles IAM suivants :

    • Administrateur Audit Manager (roles/auditmanager.admin)
    • Auditeur Audit Manager (roles/auditmanager.auditor)
  • Assurez-vous que votre organisation, votre projet ou votre dossier ont été enregistrés pour l'audit.

Planifier et exécuter un audit

Vous pouvez créer une programmation pour exécuter un audit de manière récurrente ou à la demande.

Console

  1. Dans la console Google Cloud , accédez à la page Exécuter l'évaluation dans Audit Manager.

    Accéder à Audit Manager

  2. Dans la section Choisir une ressource et une région, procédez comme suit :

    1. Sélectionnez l'organisation, le dossier ou le projet à auditer.

    2. Sélectionnez l'emplacement où l'évaluation de l'audit doit être traitée. Pour obtenir la liste des emplacements acceptés, consultez Emplacements d'Audit Manager.

    3. Cliquez sur Suivant.

  3. Dans la section Choisir une réglementation, sélectionnez le framework par rapport auquel vous souhaitez auditer votre ressource, puis cliquez sur Suivant. Pour en savoir plus sur les frameworks compatibles, consultez Frameworks compatibles.

  4. Facultatif : Si la section Configurer les paramètres s'affiche, procédez comme suit :

    1. Cliquez sur Modifier la configuration.

    2. Dans la fenêtre Configurer les paramètres, ajoutez les paramètres requis pour les contrôles cloud. Pour en savoir plus sur les paramètres, consultez la documentation de référence sur les contrôles cloud de Compliance Manager et les contrôles cloud d'Assured Workloads.

    3. Cliquez sur Enregistrer.

  5. Facultatif : Dans la section Afficher le plan d'évaluation, vous pouvez télécharger un fichier ODS contenant des informations sur le champ d'application de l'audit en fonction du framework que vous avez sélectionné. Pour télécharger le fichier, cliquez sur le lien, puis sur Suivant.

  6. Dans la section Choisir un bucket de stockage, sélectionnez un bucket de stockage dans lequel le rapport d'audit et les preuves doivent être enregistrés, puis cliquez sur OK. Si votre bucket n'est pas listé, demandez à votre administrateur d'enregistrer votre ressource avec votre bucket de stockage.

  7. Facultatif : Dans la section Planification, définissez l'un des éléments suivants :

    • Fréquence de répétition de l'audit (quotidienne, mensuelle, trimestrielle ou annuelle)

    • Période à inclure dans l'audit. Si vous choisissez Sans fin, l'audit continue de s'exécuter à partir de la date de début que vous spécifiez, jusqu'à ce que vous l'arrêtiez manuellement.

  8. Pour lancer l'audit, cliquez sur Exécuter l'audit ou Exécuter l'audit planifié.

    Vous pouvez consulter l'état de l'audit sur la page Afficher les évaluations.

gcloud

Facultatif : générer une évaluation d'audit

Avant d'exécuter un audit réel, vous pouvez générer une évaluation d'audit (ou un champ d'application) qui inclut une répartition détaillée des tâches pour l'audit en fonction du framework de conformité que vous avez choisi.

La commande gcloud audit-manager audit-scopes generate génère un champ d'application d'audit.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource. Les valeurs valides sont organization, folder et project.
  • RESOURCE_ID : ID de ressource de l'organisation, du projet ou du dossier. Exemple : 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements d'Audit Manager. Par exemple : us-central1.
  • FRAMEWORK : ID du framework à auditer. Exemple : builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans Audit Manager.
  • AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie. Seul le format ODF est accepté : AUDIT_REPORT_FORMAT_ODF.
  • OUTPUT_DIRECTORY : répertoire dans lequel la sortie doit être stockée. Exemple : reports.
  • OUTPUT_FILENAME : nom du fichier de sortie. N'incluez pas l'extension de fichier dans le nom de fichier. Par exemple :scopeReport.

Exécutez la commande suivante :

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

Exécuter un audit à la demande

La commande gcloud audit-manager audit-reports generate exécute un audit.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource. Les valeurs valides sont organization, folder et project.
  • RESOURCE_ID : ID de ressource de l'organisation, du projet ou du dossier. Exemple : 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements d'Audit Manager. Par exemple : us-central1.
  • FRAMEWORK : ID du framework à auditer. Exemple : builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans Audit Manager.
  • BUCKET_URI : URI du bucket Cloud Storage. Exemple : gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie. Seul le format ODF est accepté : AUDIT_REPORT_FORMAT_ODF.

Exécutez la commande suivante :

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

Vous devriez obtenir un résultat semblable à celui-ci :

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

REST

Facultatif : générer une évaluation d'audit

Avant d'exécuter un audit réel, vous pouvez générer une évaluation d'audit (ou un champ d'application) qui inclut une répartition détaillée des tâches pour l'audit en fonction du framework de conformité que vous avez choisi.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource. Les valeurs valides sont organizations, folders et projects.
  • RESOURCE_ID : ID de ressource de l'organisation, du projet ou du dossier. Exemple : 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements Audit Manager. Par exemple : us-central1.
  • FRAMEWORK : ID du framework à auditer. Exemple : builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans Audit Manager.
  • AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie. Seul le format ODF est accepté : AUDIT_REPORT_FORMAT_ODF.

Méthode HTTP et URL :

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

Corps JSON de la requête :


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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

{

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

La réponse contient les informations suivantes :

    Le champ scope_reports_contents est le format d'octet du contenu, qui doit être converti au format ODF avant l'examen.

  • name : identifiant de chaîne unique de la ressource applicable.

Exécuter un audit à la demande

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource. Les valeurs valides sont organizations, folders et projects.
  • RESOURCE_ID : ID de ressource de l'organisation, du projet ou du dossier. Exemple : 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements d'Audit Manager. Par exemple : us-central1.
  • FRAMEWORK : ID du framework à auditer. Exemple : builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans Audit Manager.
  • BUCKET_URI : URI du bucket Cloud Storage. Exemple : gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie. Seul le format ODF est accepté : AUDIT_REPORT_FORMAT_ODF.

Méthode HTTP et URL :

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

Corps JSON de la requête :


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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

La réponse contient les informations suivantes :

  • name : identifiant de chaîne unique de la requête d'opération d'évaluation d'audit. Cet identifiant permet de suivre la progression du processus d'évaluation de l'audit. Exemple : operation/098234.
  • done : indicateur booléen défini sur false qui indique que le processus a été déclenché. Ce champ est défini sur true une fois l'évaluation d'audit terminée.

Exécuter un audit planifié

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource. Les valeurs valides sont organizations, folders et projects.
  • RESOURCE_ID : ID de ressource de l'organisation, du projet ou du dossier. Exemple : 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements d'Audit Manager. Par exemple : us-central1.
  • FRAMEWORK : ID du framework à auditer. Exemple : builtin-cis-v8. Pour trouver l'ID d'un framework, consultez la page Afficher les évaluations dans Audit Manager.
  • BUCKET_URI : URI du bucket Cloud Storage. Exemple : gs://testbucketauditmanager
  • AUDIT_REPORT_FORMAT : format du rapport d'audit de sortie. Seul le format ODF est accepté : AUDIT_REPORT_FORMAT_ODF.
  • DISPLAY_NAME : nom de la planification d'audit. Exemple : NIST 800-53 Daily Audit.
  • SCHEDULE_START_TIME : code temporel d'activation de la planification d'audit. Exemple : 2026-02-25T10:00:00Z.
  • SCHEDULE_END_TIME : code temporel de l'arrêt de la planification de l'audit. Exemple : 2027-02-25T10:00:00Z.
  • FREQUENCY : fréquence des exécutions d'audit planifiées. Il peut s'agir de DAILY, WEEKLY, MONTHLY, QUARTERLY ou ANNUALLY. Par exemple : DAILY.
  • TIME_ZONE : fuseau horaire de la planification d'audit au format IANA. Cette variable permet d'interpréter start_time et end_time. Si aucune valeur n'est spécifiée, la valeur par défaut est UTC. Exemple : America/New_York
  • SCHEDULE_STATE : état de la planification d'audit. Choix possible : SCHEDULE_STATE_ACTIVE, SCHEDULE_STATE_PAUSED ou SCHEDULE_STATE_DELETED. Exemple : SCHEDULE_STATE_ACTIVE.
  • AUDIT_SCHEDULE_ID : identifiant unique de la planification d'audit.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Mettre à jour les audits planifiés

Vous pouvez suspendre, reprendre et arrêter les audits récurrents. Si vous souhaitez modifier la planification, vous devez supprimer l'audit planifié existant, puis en créer un autre.

Console

  1. Dans la console Google Cloud , accédez à la page Gestion des audits dans Audit Manager.

    Accéder à Audit Manager

  2. Dans l'onglet Programmations, recherchez l'audit programmé que vous souhaitez modifier.

  3. Effectuez l'une des opérations suivantes :

    • Pour suspendre une planification d'audit, cliquez sur Suspendre la planification.

    • Pour redémarrer un audit que vous avez mis en pause, cliquez sur Reprendre la programmation.

    • Pour supprimer un audit planifié, cliquez sur Arrêter la planification.

REST

Pour suspendre, reprendre ou supprimer une planification d'audit, envoyez une requête PATCH pour mettre à jour le champ state de la planification d'audit.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource. Les valeurs valides sont organizations, folders et projects.
  • RESOURCE_ID : ID de ressource de l'organisation, du projet ou du dossier. Exemple : 8767234.
  • LOCATION : emplacement du point de terminaison de l'API Audit Manager. Pour obtenir la liste des points de terminaison disponibles, consultez Emplacements d'Audit Manager. Par exemple : us-central1.
  • AUDIT_SCHEDULE_ID : ID de la planification d'audit à mettre à jour. Exemple : my-schedule-id.
  • SCHEDULE_STATE : état cible de la planification d'audit. Définissez cette option sur l'une des valeurs suivantes :
    • SCHEDULE_STATE_PAUSED : pour suspendre une programmation active.
    • SCHEDULE_STATE_ACTIVE : pour reprendre une programmation mise en pause.
    • SCHEDULE_STATE_DELETED : pour arrêter et supprimer une programmation.

Méthode HTTP et URL :

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

Corps JSON de la requête :

{
  "state": "SCHEDULE_STATE"
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Étapes suivantes