Puoi utilizzare l'API Security Command Center e lo strumento a riga di comando gcloud CLI per gestire in modo programmatico i risultati di sicurezza. Scopri come creare risultati di sicurezza attivi per un'origine designata e aggiornare il loro stato (ad esempio, passando da ACTIVE a INACTIVE) man mano che i problemi vengono identificati e risolti.
Prima di iniziare
Prima di creare e aggiornare i risultati, devi completare i seguenti passaggi:
Per completare questa guida, devi disporre del ruolo IAM (Identity and Access Management) Security Center Findings Editor (securitycenter.findingsEditor) a livello di organizzazione. Per saperne di più sui ruoli di Security Command Center, consulta Controllo dell'accesso.
Se vuoi creare risultati con marcatori di sicurezza, devi anche avere un ruolo IAM che includa le autorizzazioni per il tipo di marcatore che vuoi utilizzare:
- Asset Security Marks Writer (
securitycenter.assetSecurityMarksWriter) - Finding Security Marks Writer (
securitycenter.findingSecurityMarksWriter)
Per ulteriori informazioni sui contrassegni, consulta Annota i risultati con i contrassegni di sicurezza.
Creazione di 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 risultato.PARENT_ID: l'ID numerico dell'organizzazione principale.LOCATION: la località di Security Command Center in cui creare un risultato; se la residenza dei dati è abilitata, utilizzaeu,saous; in caso contrario, utilizza il valoreglobal.SOURCE_ID: l'ID numerico dell'origine del risultato.STATE: lo stato del risultato; utilizzaACTIVEse il risultato richiede attenzione oINACTIVEse il risultato è stato risolto.CATEGORY: il gruppo di tassonomia 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, consulta 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,foldersoprojects.PARENT_ID: l'ID numerico dell'organizzazione, della cartella o del progetto principale o l'ID alfanumerico del progetto principale.SOURCE_ID: l'ID numerico dell'origine del risultato.LOCATION: la località di Security Command Center in cui aggiornare un risultato; se la residenza dei dati è abilitata, utilizzaeu,saous; in caso contrario, utilizza il valoreglobal.FINDING_NAME: il risultato da aggiornare.STATE: lo stato del risultato; utilizzaACTIVEse il risultato richiede attenzione oINACTIVEse il risultato è stato risolto.
Vai
Java
Node.js
Passaggi successivi
Scopri di più su come accedere a Security Command Center utilizzando le librerie client.