Obtén el estado de una auditoría

Puedes obtener el estado de una auditoría en curso que iniciaste con Audit Manager o Compliance Manager. Las auditorías pueden tardar mucho tiempo en completarse, y hacer un seguimiento de este estado te ayuda a seguir el progreso de la auditoría mientras se ejecuta.

Antes de comenzar

• Asegúrate de tener uno de los siguientes roles de IAM:

  • Administrador de Audit Manager (roles/auditmanager.admin)
  • Auditor del Gestor de auditorías (roles/auditmanager.auditor)
  • Visualizador del Administrador de cumplimiento (roles/cloudsecuritycompliance.viewer) (obligatorio si auditas un framework que creaste con el Administrador de cumplimiento)

• Identifica la auditoría para la que deseas obtener el estado.

Obtén el estado de una auditoría en curso

Console

1. En la consola de Google Cloud , ve a la página Ver auditorías.

   Ir a Ver auditorías

2. En la página Ver evaluaciones, puedes ver el estado actual de una auditoría en curso o consultar más información sobre una auditoría completada.

3. Para ver más información sobre la auditoría, haz clic en el vínculo de la columna Estado.

4. Para ver más información sobre la auditoría, haz clic en su nombre.

gcloud

El comando gcloud audit-manager operations describe describe una operación de auditoría.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• RESOURCE_TYPE: El tipo de recurso. Los valores válidos son organization, folder y project.
• RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
• LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones de Audit Manager. Por ejemplo: us-central1.
• AUDIT_OPERATION_ID: Es el ID único de la operación en curso que se incluyó en el cuerpo de la respuesta cuando ejecutaste la auditoría. Por ejemplo: 098234.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud audit-manager operations describe AUDIT_OPERATION_ID \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud audit-manager operations describe AUDIT_OPERATION_ID `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init, o gcloud auth login y gcloud config set project.

gcloud audit-manager operations describe AUDIT_OPERATION_ID ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

Una respuesta correcta incluye uno de los siguientes tipos de estado de ejecución:

Tipo de estado	Descripción
OPERATION_STATE_UNSPECIFIED	Es un estado no válido.
OPERATION_STATE_NOT_STARTED	Aún no comenzó el proceso de generación del informe de auditoría.
OPERATION_STATE_EVALUATION_IN_PROGRESS	Audit Manager está evaluando los recursos en función de los controles de cumplimiento.
OPERATION_STATE_EVALUATION_DONE	Audit Manager completó la evaluación de cumplimiento.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS	El administrador de auditorías está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE	Audit Manager completó la generación del informe de auditoría.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS	Audit Manager está subiendo el informe de auditoría y las evidencias al destino.
OPERATION_STATE_DONE	Se completó el proceso de generación del informe de auditoría.
OPERATION_STATE_FAILED	Se produjo un error en el proceso de generación del informe de auditoría.

Cada uno de los tipos de estado de ejecución puede proporcionar la siguiente información adicional, cuando corresponda:

Estado adicional	Descripción
failure_reason	Si la evaluación de auditoría falla, este campo proporciona el motivo de la falla.
evaluation_percent_complete	Si se inició la evaluación, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no se inicia, el campo comienza en 0. Cuando se completa el proceso, el campo se establece en 100.
report_generation_percent_complete	Si se inició la generación del informe, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no se inicia, el campo comienza en 0. Cuando se completa el proceso, el campo se establece en 100.
report_uploading_percent_complete	Si se inició la carga del informe, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no se inicia, el campo comienza en 0. Cuando se completa el proceso, el campo se establece en 100.

Una respuesta correcta de gcloud es similar a la siguiente:

done: true
name: projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID
response:
  '@type': type.googleapis.com/google.cloud.auditmanager.v1.AuditReport
  gcsUri: gs://testbucketauditmanager

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• RESOURCE_TYPE: El tipo de recurso. Los valores válidos son organizations, folders y projects.
• RESOURCE_ID: Es el ID del recurso de la organización, el proyecto o la carpeta. Por ejemplo: 8767234.
• LOCATION: Es la ubicación del extremo de API de Audit Manager. Para obtener una lista de los extremos disponibles, consulta Ubicaciones de Audit Manager. Por ejemplo: us-central1.
• AUDIT_OPERATION_ID: Es el ID único de la operación en curso que se incluyó en el cuerpo de la respuesta cuando ejecutaste la auditoría. Por ejemplo: 098234.

Método HTTP y URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

Una respuesta correcta incluye uno de los siguientes tipos de estado de ejecución:

Tipo de estado	Descripción
OPERATION_STATE_UNSPECIFIED	Es un estado no válido.
OPERATION_STATE_NOT_STARTED	Aún no comenzó el proceso de generación del informe de auditoría.
OPERATION_STATE_EVALUATION_IN_PROGRESS	Audit Manager está evaluando los recursos en función de los controles de cumplimiento.
OPERATION_STATE_EVALUATION_DONE	Audit Manager completó la evaluación de cumplimiento.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS	El administrador de auditorías está creando un informe de auditoría a partir de los datos evaluados.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE	Audit Manager completó la generación del informe de auditoría.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS	Audit Manager está subiendo el informe de auditoría y las evidencias al destino.
OPERATION_STATE_DONE	Se completó el proceso de generación del informe de auditoría.
OPERATION_STATE_FAILED	Se produjo un error en el proceso de generación del informe de auditoría.

Cada uno de los tipos de estado de ejecución puede proporcionar la siguiente información adicional, cuando corresponda:

Estado adicional	Descripción
failure_reason	Si la evaluación de auditoría falla, este campo proporciona el motivo de la falla.
evaluation_percent_complete	Si se inició la evaluación, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no se inicia, el campo comienza en 0. Cuando se completa el proceso, el campo se establece en 100.
report_generation_percent_complete	Si se inició la generación del informe, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no se inicia, el campo comienza en 0. Cuando se completa el proceso, el campo se establece en 100.
report_uploading_percent_complete	Si se inició la carga del informe, este campo proporciona el porcentaje del progreso. Cuando el proceso aún no se inicia, el campo comienza en 0. Cuando se completa el proceso, el campo se establece en 100.

Una respuesta de REST correcta es similar a la siguiente:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.auditmanager.v1.AuditReport",
    "gcsUri": "gs://testbucketauditmanager"
  }
}

Cuando se completa y sube un informe de auditoría, se devuelve un vínculo al informe.

¿Qué sigue?

• Consulta un informe de auditoría.