Gli asset sono le risorse Google Cloud di un'organizzazione, ad esempio istanze Compute Engine o bucket Cloud Storage.
Questa guida mostra come utilizzare le librerie client di Security Command Center per accedere ai record ritirati gestiti da Security Command Center per le risorse di un progetto o di un'organizzazione.
Security Command Center conserva i record solo per un sottoinsieme di asset nell'Cloud Asset Inventory. Per l'elenco più completo delle risorse nel tuo ambiente, utilizza Cloud Asset Inventory per elencarle.
Per ulteriori informazioni, consulta le seguenti risorse:
- Servizio di elenco degli asset di Cloud Asset Inventory
- Tipi di asset supportati in Security Command Center
Livelli di concessione per i ruoli IAM
I ruoli IAM per Security Command Center possono essere concessi a livello di organizzazione, cartella o progetto. La possibilità di visualizzare, modificare, creare o aggiornare risultati, asset e origini di sicurezza dipende dal livello per cui ti è stato concesso l'accesso. Per scoprire di più sui ruoli di Security Command Center, consulta Controllo degli accessi.
Prima di iniziare
Prima di configurare una sorgente, devi completare i seguenti passaggi:
Dimensioni pagina
Tutte le API di elenco di Security Command Center sono paginate. Ogni risposta restituisce una pagina di risultati e un token per restituire la pagina successiva. Le dimensioni della pagina sono configurabili. Il valore predefinito di pageSize è 10, ma può essere impostato su un valore minimo di 1 e un valore massimo di 1000.
Tipi di risorse
L'attributo resourceType
in Security Command Center utilizza una convenzione di denominazione diversa da quella di Cloud Asset Inventory. Per un elenco dei formati dei tipi di risorsa, consulta Tipi di asset supportati in Security Command Center.
Elenco di tutti gli asset
Questi esempi mostrano come elencare tutti gli asset:
gcloud
Per elencare tutti gli asset in un progetto, una cartella o un'organizzazione, esegui il seguente comando:
gcloud scc assets list PARENT_ID
Sostituisci PARENT_ID
con uno dei seguenti valori:
- Un ID organizzazione nel seguente formato:
ORGANIZATION_ID
(solo l'ID numerico) - Un ID cartella nel seguente formato:
folders/FOLDER_ID
- Un ID progetto nel seguente formato:
projects/PROJECT_ID
Per altri esempi, esegui:
gcloud scc assets list --help
Per esempi nella documentazione, consulta gcloud scc assets list.
Python
Java
Vai
Node.js
L'output per ogni risorsa è un oggetto JSON simile al seguente:
asset:
createTime: '2020-10-05T17:55:14.823Z'
iamPolicy:
policyBlob: '{"bindings":[{"role":"roles/owner","members":["serviceAccount:SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com","user:USER_EMAIL@gmail.com"]}]}'
name: organizations/ORGANIZATION_ID/assets/ASSET_ID
resourceProperties:
createTime: '2020-10-05T17:36:17.915Z'
lifecycleState: ACTIVE
name: PROJECT_ID
parent: '{"id":"ORGANIZATION_ID","type":"organization"}'
projectId: PROJECT_ID
projectNumber: 'PROJECT_NUMBER'
securityCenterProperties:
resourceDisplayName: PROJECT_ID
resourceName: //cloudresourcemanager.googleapis.com/projects/PROJECT_NUMBER
resourceOwners:
- serviceAccount:SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com
- user:USER_EMAIL@gmail.com
resourceParent: //cloudresourcemanager.googleapis.com/organizations/ORGANIZATION_ID
resourceParentDisplayName: ORGANIZATION_NAME
resourceProject: //cloudresourcemanager.googleapis.com/projects/PROJECT_NUMBER
resourceProjectDisplayName: PROJECT_ID
resourceType: google.cloud.resourcemanager.Project
securityMarks:
name: organizations/ORGANIZATION_ID/assets/ASSET_ID/securityMarks
updateTime: '2020-10-05T17:55:14.823Z'
Filtra asset
Un progetto, una cartella o un'organizzazione possono avere molti asset. L'esempio precedente non utilizza filtri, pertanto vengono restituiti tutti gli asset. Security Command Center ti consente di utilizzare i filtri per asset per ottenere informazioni su asset specifici. I filtri sono simili alle clausole "where" nelle istruzioni SQL, tranne per il fatto che, anziché alle colonne, si applicano agli oggetti retitrati dall'API.
L'output di esempio nell'esempio precedente mostra alcuni campi e sottocampi e le relative proprietà che possono essere utilizzati nei filtri degli asset. Security Command Center supporta array e oggetti JSON completi come potenziali tipi di proprietà. Puoi filtrare in base a:
- Elementi array
- Oggetti JSON completi con corrispondenza parziale della stringa all'interno dell'oggetto
- Subcampi dell'oggetto JSON
I campi secondari devono essere numeri, stringhe o valori booleani e le espressioni di filtro devono utilizzare i seguenti operatori di confronto:
- Stringhe:
- Parità di genere
=
- Corrispondenza parziale delle stringhe
:
- Parità di genere
- Numeri:
- Diseguaglianze
<
,>
,<=
,>=
- Uguaglianza
=
- Diseguaglianze
- Operatori booleani:
- Uguaglianza
=
- Uguaglianza
Gli esempi riportati di seguito filtrano gli asset:
gcloud
Utilizza il seguente comando per filtrare gli asset:
gcloud scc assets list PARENT_ID --filter="FILTER"
Sostituisci quanto segue:
FILTER
con il filtro che devi utilizzare. Ad esempio, il seguente filtro restituisce solo le risorse del progetto:--filter="security_center_properties.resource_type=\"google.cloud.resourcemanager.Project\""
PARENT_ID
con uno dei seguenti valori:- Un ID organizzazione nel seguente formato:
ORGANIZATION_ID
(solo l'ID numerico) - Un ID cartella nel seguente formato:
folders/FOLDER_ID
- Un ID progetto nel seguente formato:
projects/PROJECT_ID
- Un ID organizzazione nel seguente formato:
Per altri esempi, esegui:
gcloud scc assets list --help
Per esempi nella documentazione, consulta gcloud scc assets list.
Python
Java
Vai
Node.js
Elenco in un determinato momento
Gli esempi precedenti mostrano come elencare un set corrente di asset. Security Command Center ti consente anche di visualizzare uno snapshot storico degli asset. Gli esempi riportati di seguito restituiscono lo stato di tutti gli asset in un determinato momento. Security Command Center supporta risoluzioni di tempo in millisecondi.
gcloud
Utilizza il seguente comando per elencare gli asset a partire da un determinato momento:
gcloud scc assets list PARENT_ID --read-time="READ_TIME"
Sostituisci quanto segue:
READ_TIME
con l'ora in cui elencare le risorse. Utilizza il formato seguente:YYYY-MM-DDThh:mm:ss.ffffffZ
. Ad esempio:--read-time="2022-12-21T07:00:06.861Z"
PARENT_ID
con uno dei seguenti valori:- Un ID organizzazione nel seguente formato:
ORGANIZATION_ID
(solo l'ID numerico) - Un ID progetto nel seguente formato:
projects/PROJECT_ID
- Un ID cartella nel seguente formato:
folders/FOLDER_ID
- Un ID organizzazione nel seguente formato:
Per altri esempi, esegui:
gcloud scc assets list --help
Per esempi nella documentazione, consulta gcloud scc assets list.
Python
Java
Vai
Node.js
Elenco delle risorse con modifiche dello stato
Security Command Center ti consente di confrontare un asset in due momenti per identificare se è stato aggiunto, rimosso o era presente durante il periodo di tempo specificato. I
seguenti esempi confrontano i progetti esistenti in READ_TIME
con un punto di
tempo precedente specificato da COMPARE_DURATION
. COMPARE_DURATION
viene fornito in
secondi.
Quando è impostato COMPARE_DURATION
, l'attributo stateChange
nei risultati
dell'asset elenco viene aggiornato con uno dei seguenti valori:
ADDED
: la risorsa non era presente all'inizio dicompareDuration
, ma era presente areadTime
.REMOVED
: la risorsa era presente all'inizio dicompareDuration
, ma non inreadTime
.ACTIVE
: l'asset era presente sia all'inizio che alla fine del periodo di tempo definito dacompareDuration
ereadTime
.
gcloud
Utilizza il seguente comando per confrontare lo stato delle risorse in due punti nel tempo:
gcloud scc assets list PARENT_ID \ --filter="FILTER" \ --read-time=READ_TIME \ --compare-duration=COMPARE_DURATION
Sostituisci quanto segue:
COMPARE_DURATION
con un numero di secondi che definisce un punto nel tempo precedente a quello specificato nel flag--read-time
. Ad esempio:--compare-duration=84600s
FILTER
con il filtro che devi utilizzare. Ad esempio, il seguente filtro restituisce solo le risorse del progetto:--filter="security_center_properties.resource_type=\"google.cloud.resourcemanager.Project\""
PARENT_ID
con uno dei seguenti valori:- Un ID organizzazione nel seguente formato:
ORGANIZATION_ID
(solo l'ID numerico) - Un ID progetto nel seguente formato:
projects/PROJECT_ID
- Un ID cartella nel seguente formato:
folders/FOLDER_ID
- Un ID organizzazione nel seguente formato:
READ_TIME
con l'ora in cui elencare le risorse. Utilizza il seguente formato:YYYY-MM-DDThh:mm:ss.ffffffZ
. Ad esempio: Per altri esempi, esegui:--read-time="2022-12-21T07:00:06.861Z"
gcloud scc assets list --help
Per esempi nella documentazione, consulta gcloud scc assets list.
Python
Java
Vai
Node.js
Esempi di filtro
Di seguito sono riportati altri filtri di asset utili. Puoi utilizzare AND
e OR
nei
filtri per combinare i parametri ed espandere o perfezionare i risultati.
Trovare una risorsa del progetto con un proprietario specifico
"security_center_properties.resource_type = \"google.cloud.resourcemanager.Project\" AND security_center_properties.resource_owners : \"$USER\""
$USER
ha in genere il formato user:someone@domain.com
. Il confronto per user
utilizza l'operatore sottostringa :
e non è necessaria una corrispondenza esatta.
Regole firewall con porte HTTP aperte
"security_center_properties.resource_type = \"google.compute.Firewall\" AND resource_properties.name =\"default-allow-http\""
Risorse appartenenti a progetti specifici
"security_center_properties.resource_parent = \"$PROJECT_1_NAME\" OR security_center_properties.resource_parent = \"$PROJECT_2_NAME\""
$PROJECT_1_NAME
e $PROJECT_2_NAME
sono identificatori delle risorse nel formato
//cloudresourcemanager.googleapis.com/projects/$PROJECT_ID
, dove
$PROJECT_ID
è il numero del progetto. Un esempio completo potrebbe essere: //cloudresourcemanager.googleapis.com/projects/100090906
Trovare le immagini Compute Engine i cui nomi contengono una stringa specifica
Questo filtro restituisce le immagini Compute Engine che contengono la sottostringa "Debia":
"security_center_properties.resource_type = \"google.compute.Image\" AND resource_properties.name : \"Debia\""
Risorse le cui proprietà contengono coppie chiave-valore
Questo filtro restituisce i bucket Cloud Storage in cui bucketPolicyOnly
è disabilitato. Il valore di resourceProperties.iamConfiguration
è codificato come stringa. Utilizza il carattere \
per inserire caratteri di escape nelle stringhe, incluso l'operatore :
tra il nome e il valore della chiave.
"resourceProperties.iamConfiguration:"\"bucketPolicyOnly\"\:{\"enabled\"\:false""
Trovare gli asset del progetto creati prima o in un momento specifico
Questi filtri di esempio corrispondono agli asset creati prima del 18 luglio 2019 alle 20:26:21 GMT. Con il filtro create_time
, puoi esprimere l'ora utilizzando i seguenti formati e tipi:
Tempo Unix (in millisecondi) come valore letterale intero
"create_time <= 1563481581000"
RFC 3339 come valore letterale di stringa
"create_time <= \"2019-07-18T20:26:21+00:00\""
Esclusione di asset dai risultati
Per escludere una risorsa dai risultati, utilizza la negazione inserendo un carattere -
davanti a un parametro. L'operazione è simile all'utilizzo dell'operatore NOT in un
istruzione SQL.
Questo filtro restituisce tutte le risorse del progetto tranne Debia
:
"security_center_properties.resource_type = \"google.cloud.resourcemanager.Project\" AND -resource_properties.projectId = \"Debia\""
Passaggi successivi
Scopri di più su come accedere a Security Command Center utilizzando una libreria client.