L'API Security Command Center ti consente di gestire in modo programmatico i contrassegni di sicurezza su asset e risultati. I contrassegni di sicurezza sono annotazioni personalizzabili che ti aiutano ad aggiungere il contesto aziendale alle tue risorse cloud per semplificare la valutazione, il filtro e la generazione di report.
Puoi aggiungere o aggiornare i contrassegni di sicurezza solo sugli asset supportati da Security Command Center. Per un elenco degli asset supportati, consulta Tipi di asset supportati in Security Command Center.
Prima di iniziare
Prima di poter utilizzare i contrassegni di sicurezza, devi configurare un account di servizio e l'SDK.
Per aggiungere o modificare i contrassegni di sicurezza, devi disporre di un ruolo Identity and Access Management che includa le autorizzazioni per il tipo di contrassegno che vuoi utilizzare:
- Contrassegni degli asset: Asset Security Marks Writer,
securitycenter.assetSecurityMarksWriter - Finding marks: Finding Security Marks Writer,
securitycenter.findingSecurityMarksWriter
Per saperne di più sui ruoli IAM in Security Command Center, consulta Controllo dell'accesso. Per scoprire come utilizzare i contrassegni di sicurezza in modo efficace, consulta Annota i risultati con i contrassegni di sicurezza e Annota gli asset con i contrassegni di sicurezza.
Aggiunta o aggiornamento dei contrassegni di sicurezza sugli asset
Quando utilizzi l'API Security Command Center, l'aggiunta e l'aggiornamento dei contrassegni di sicurezza sono la stessa operazione. L'esempio mostra come aggiungere i contrassegni di sicurezza per le coppie chiave-valore (key_a, value_a) e (key_b, value_b).
Il seguente codice utilizza le maschere di campo per garantire che vengano aggiornati solo questi valori. Se non vengono fornite maschere di campo, tutti i contrassegni di sicurezza vengono cancellati prima di aggiungere le chiavi e i valori specificati.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --security-marks=SECURITY_MARKS \ --update-mask=UPDATE_MASK
Sostituisci quanto segue:
ASSET_ID: l'asset da aggiornare.PARENT: il livello della gerarchia delle risorse in cui si trova l'asset; utilizzaorganization,folderoproject.PARENT_ID: l'ID numerico dell'organizzazione, della cartella o del progetto principale o l'ID alfanumerico del progetto principale.LOCATION: la località di Security Command Center in cui aggiornare un contrassegno di sicurezza su un asset; se la residenza dei dati è abilitata, utilizzaeu,saous; in caso contrario, utilizza il valoreglobal.SECURITY_MARKS: coppie chiave-valore separate da virgole che rappresentano i contrassegni di sicurezza e i relativi valori, ad esempiokey_a=value_a,key_b=value_b.UPDATE_MASK: elenco separato da virgole dei campi contrassegno di sicurezza da aggiornare per l'asset, ad esempiomarks.key_a,marks.key_b.
Vai
Python
Leggi Gestisci le policy per informazioni sui contrassegni degli asset dedicati per i rilevatori di Security Health Analytics.
Eliminazione dei contrassegni di sicurezza sugli asset
L'eliminazione di marcatori di sicurezza specifici viene eseguita in modo simile all'aggiunta o all'aggiornamento, chiamando in modo specifico l'aggiornamento con una maschera di campo, ma senza alcun valore corrispondente. Nell'esempio, i contrassegni di sicurezza con le chiavi key_a e key_b vengono eliminati.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --update-mask=UPDATE_MASK
ASSET_ID: l'asset da aggiornare.PARENT: il livello della gerarchia delle risorse in cui si trova l'asset; utilizzaorganization,folderoproject.PARENT_ID: l'ID numerico dell'organizzazione, della cartella o del progetto principale o l'ID alfanumerico del progetto principale.LOCATION: la località di Security Command Center in cui eliminare un contrassegno di sicurezza da un asset; se la residenza dei dati è abilitata, utilizzaeu,saous; in caso contrario, utilizza il valoreglobal.UPDATE_MASK: elenco separato da virgole dei campi contrassegno di sicurezza da eliminare dalla risorsa, ad esempiomarks.key_a,marks.key_b.
Node.js
Python
Aggiunta ed eliminazione di marcatori di sicurezza nella stessa richiesta
La tecnica per aggiungere e aggiornare i contrassegni di sicurezza e per eliminarli può essere combinata nella stessa richiesta. Nell'esempio, key_a viene aggiornato e
key_b viene eliminato.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --update-mask=UPDATE_MASK
ASSET_ID: l'asset da aggiornare.PARENT: il livello della gerarchia delle risorse in cui si trova l'asset; utilizzaorganization,folderoproject.PARENT_ID: l'ID numerico dell'organizzazione, della cartella o del progetto principale o l'ID alfanumerico del progetto principale.LOCATION: la località di Security Command Center in cui aggiornare ed eliminare i contrassegni di sicurezza per un asset; se la residenza dei dati è abilitata, utilizzaeu,saous; in caso contrario, utilizza il valoreglobal.SECURITY_MARKS: coppie chiave-valore separate da virgole che rappresentano i contrassegni di sicurezza che vuoi aggiornare, ad esempiokey_a=value_a; ometti i contrassegni di sicurezza che vuoi eliminareUPDATE_MASK: elenco separato da virgole dei campi contrassegno di sicurezza da aggiornare o eliminare, ad esempiomarks.key_a,marks.key_b.
Node.js
Python
Aggiunta di contrassegni di sicurezza ai risultati
L'aggiunta, l'aggiornamento e l'eliminazione dei contrassegni di sicurezza sui risultati seguono lo stesso processo dell'aggiornamento dei contrassegni di sicurezza sugli asset. L'unica modifica è il nome della risorsa utilizzata nella chiamata API. Anziché una risorsa asset, fornisci un nome risorsa risultato.
Ad esempio, per aggiornare i contrassegni di sicurezza di un risultato, utilizza il seguente codice:
gcloud
gcloud scc findings update-marks FINDING_NAME \ --PARENT=PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --security-marks=SECURITY_MARKS \ --update-mask=UPDATE_MASK
Sostituisci quanto segue:
FINDING_NAME: il risultato da aggiornare.PARENT: il livello della gerarchia delle risorse in cui si trova il risultato; utilizzaorganization,folderoproject.PARENT_ID: l'ID numerico dell'organizzazione, della cartella o del progetto principale o l'ID alfanumerico del progetto principale.LOCATION: la località di Security Command Center in cui aggiornare un contrassegno di sicurezza su un risultato; se la residenza dei dati è abilitata, utilizzaeu,saous; in caso contrario, utilizza il valoreglobal.SOURCE_ID: l'ID origine.SECURITY_MARKS: coppie chiave-valore separate da virgole che rappresentano i contrassegni di sicurezza e i relativi valori, ad esempiokey_a=value_a,key_b=value_b.UPDATE_MASK: elenco separato da virgole dei campi contrassegno di sicurezza da aggiornare per l'asset, ad esempiomarks.key_a,marks.key_b.
Java
Node.js
Python
I contrassegni di sicurezza vengono elaborati durante le scansioni in batch, che vengono eseguite due volte al giorno per Security Command Center Premium ed Enterprise e una volta ogni due giorni per Security Command Center Standard, e non in tempo reale. Potrebbe verificarsi un ritardo di 12-24 ore prima che i contrassegni di sicurezza vengano elaborati e vengano applicate le norme relative all'applicazione delle norme che risolvono o riaprono i risultati.
Elenco degli asset con filtri contrassegno di sicurezza
Dopo aver impostato i contrassegni di sicurezza su un asset, questi possono essere utilizzati nell'argomento filter della chiamata API ListAssets. Ad esempio, per eseguire una query su tutti gli asset in cui key_a = value_a, utilizza il seguente codice:
gcloud
# ORGANIZATION=12344321 FILTER="security_marks.marks.key_a = \"value_a\"" gcloud scc assets list $ORGANIZATION \ --filter="$FILTER"
Vai
Java
Node.js
Python
Elenco dei risultati con filtri contrassegno di sicurezza
Dopo aver impostato i contrassegni di sicurezza su un risultato, questi possono essere utilizzati nell'argomento filter della chiamata API ListFindings. Ad esempio, per eseguire una query su tutti gli asset in cui key_a != value_a, utilizza il seguente codice:
gcloud
gcloud scc findings list PARENT/PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --filter=FILTER
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.LOCATION: la località di Security Command Center in cui elencare i risultati; se la residenza dei dati è abilitata, utilizzaeu,saous; altrimenti, utilizza il valoreglobal.SOURCE_ID: l'ID origine.FILTER: il filtro da applicare ai risultati; ad esempio, per escludere i risultati con il contrassegno di sicurezzakey_a=value_a, utilizza"NOT security_marks.marks.key_a=\"value_a\""
Vai
Java
Node.js
Python
Passaggi successivi
- Scopri di più su come elencare i risultati ed elencare gli asset.