Questa guida ti illustra la creazione e l'aggiornamento dei risultati utilizzando l'API Security Command Center.
Prima di iniziare
Prima di creare e aggiornare i risultati, devi completare le seguenti operazioni:
Per completare questa guida, devi disporre del ruolo IAM (Identity and Access Management) Editor risultati
di Security Command Center (securitycenter.findingsEditor
) a livello di organizzazione. Per ulteriori informazioni sui ruoli di Security Command Center, consulta Controllo dell'accesso.
Se vuoi creare risultati con indicatori di sicurezza, devi anche disporre di un ruolo IAM che includa le autorizzazioni per il tipo di indicatore che vuoi utilizzare:
- Scrittore contrassegni di sicurezza per asset (
securitycenter.assetSecurityMarksWriter
) - Scrittore contrassegni di sicurezza per risultati (
securitycenter.findingSecurityMarksWriter
)
Per saperne di più sui tag, vedi Utilizzare i tag di sicurezza di Security Command Center.
Creare un risultato
Crea un risultato attivo per un'origine.
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
Sostituisci quanto segue:
FINDING_NAME
: il nome del problema.PARENT_ID
: l'ID numerico dell'organizzazione principale.LOCATION
: la posizione di Security Command Center in cui creare un risultato; se la residenza dei dati è abilitata, utilizzaeu
,ksa
ous
; altrimenti, utilizza il valoreglobal
.SOURCE_ID
: l'ID numerico dell'origine del risultato.STATE
: lo stato del risultato; utilizzaACTIVE
se il risultato richiede attenzione oINACTIVE
se il risultato è stato risolto.CATEGORY
: il gruppo di tassonomie a cui appartiene il risultato, ad esempioAUDIT_LOGGING_DISABLED
.EVENT_TIME
: l'ora in cui si è verificato l'evento, formattata come timestamp RFC 822 o un altro formato di timestamp supportato da gcloud CLI.RESOURCE_NAME
: il nome completo della risorsa a cui si applica il risultato.
Vai
Java
Node.js
Python
Per informazioni sulla durata di archiviazione dei dati dei risultati in Security Command Center, leggi Conservazione dei risultati.
Aggiornamento dello stato di un risultato
Security Command Center fornisce anche un'API per aggiornare solo lo stato di un risultato. L'esempio seguente mostra come modificare lo stato di un risultato in inattivo.
gcloud
gcloud scc findings update \ PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_NAME \ --state=STATE
Sostituisci quanto segue:
PARENT
: il livello della gerarchia delle risorse in cui si trova il risultato; utilizzaorganizations
,folders
oprojects
.PARENT_ID
: l'ID numerico dell'organizzazione, della cartella o del progetto padre oppure l'ID alfanumerico del progetto padre.SOURCE_ID
: l'ID numerico dell'origine del risultato.LOCATION
: la posizione di Security Command Center in cui aggiornare un risultato; se la residenza dei dati è attivata, utilizzaeu
,ksa
ous
; altrimenti, utilizza il valoreglobal
.FINDING_NAME
: il risultato da aggiornare.STATE
: lo stato del risultato; utilizzaACTIVE
se il risultato richiede attenzione oINACTIVE
se il risultato è stato risolto.
Vai
Java
Node.js
Passaggi successivi
Scopri di più su come accedere a Security Command Center utilizzando le librerie client.