Puedes usar la API de Security Command Center y la herramienta de línea de comandos de gcloud CLI para
administrar los hallazgos de seguridad de manera programática. Aprende a
crear hallazgos de seguridad activos para una fuente designada y actualizar su estado
(como la transición de ACTIVE a INACTIVE) a medida que se identifican y
resuelven los problemas.
Antes de comenzar
Antes de crear y actualizar los resultados, debes completar lo siguiente:
Para completar esta guía, debes tener el rol de Identity and Access Management (IAM) de editor de hallazgos del centro de seguridad (securitycenter.findingsEditor) a nivel de la organización. Para obtener más información sobre
los roles de Security Command Center, consulta
Control de acceso.
Si deseas crear resultados con marcas de seguridad, también debes tener una función de IAM que incluya permisos para el tipo de marca que deseas usar:
- Escritor de marcas de seguridad de activos (
securitycenter.assetSecurityMarksWriter) - Escritor de marcas de seguridad de resultados (
securitycenter.findingSecurityMarksWriter)
Para obtener más información sobre las marcas, consulta Anota los hallazgos con marcas de seguridad.
Crea un resultado
Crea un resultado activo para una fuente.
gcloud
gcloud scc findings create FINDING_NAME \ --organization=PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --state=STATE \ --category=CATEGORY \ --event-time=EVENT_TIME \ --resource-name=RESOURCE_NAME
Reemplaza lo siguiente:
FINDING_NAME: Es el nombre del hallazgo.PARENT_ID: Es el ID numérico de la organización superior.LOCATION: La ubicación de Security Command Center en la que se creará un hallazgo. Si la residencia de datos está habilitada, usaeu,saous. De lo contrario, usa el valorglobal.SOURCE_ID: Es el ID numérico de la fuente del hallazgo.STATE: Es el estado del hallazgo. UsaACTIVEsi el hallazgo requiere atención oINACTIVEsi ya se abordó.CATEGORY: Es el grupo de taxonomía al que pertenece el hallazgo, por ejemplo,AUDIT_LOGGING_DISABLED.EVENT_TIME: Es la hora en que se produjo el evento, con el formato de una marca de tiempo RFC 822 u otro formato de marca de tiempo que admita gcloud CLI.RESOURCE_NAME: Es el nombre completo del recurso al que se aplica el hallazgo.
Go
Java
Node.js
Python
Para obtener información sobre durante cuánto tiempo se almacenan los datos de resultados en Security Command Center, lee Retención de resultados.
Actualiza el estado de un resultado
Security Command Center también proporciona una API para actualizar solo el estado de un resultado. En el siguiente ejemplo, se muestra cómo cambiar el estado de un hallazgo a inactivo.
gcloud
gcloud scc findings update \ PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_NAME \ --state=STATE
Reemplaza lo siguiente:
PARENT: Es el nivel de la jerarquía de recursos en el que se encuentra el hallazgo. Usaorganizations,foldersoprojects.PARENT_ID: Es el ID numérico de la organización, la carpeta o el proyecto superior, o el ID alfanumérico del proyecto superior.SOURCE_ID: Es el ID numérico de la fuente del hallazgo.LOCATION: la ubicación de Security Command Center en la que se actualizará un hallazgo. Si la residencia de datos está habilitada, usaeu,saous. De lo contrario, usa el valorglobal.FINDING_NAME: Es el hallazgo que se actualizará.STATE: Es el estado del hallazgo. UsaACTIVEsi el hallazgo requiere atención oINACTIVEsi ya se abordó.
Go
Java
Node.js
¿Qué sigue?
Obtén más información para acceder a Security Command Center con bibliotecas cliente.