CustomConfig

Definisce le proprietà in una configurazione del modulo personalizzato per Security Health Analytics. Utilizza la configurazione del modulo personalizzato per creare rilevatori personalizzati che generano risultati personalizzati per le risorse specificate.

Rappresentazione JSON 
{
  "predicate": {
    object (Expr)
  },
  "customOutput": {
    object (CustomOutputSpec)
  },
  "resourceSelector": {
    object (ResourceSelector)
  },
  "severity": enum (Severity),
  "description": string,
  "recommendation": string
}
Campi
predicate

object (Expr)

Facoltativo. L'espressione Common Expression Language (CEL) da valutare per produrre risultati. Quando l'espressione ha come risultato true per una risorsa, viene generato un risultato.
customOutput

object (CustomOutputSpec)

Facoltativo. Proprietà di output personalizzate.
resourceSelector

object (ResourceSelector)

Facoltativo. I tipi di risorse di Cloud Asset Inventory su cui opera il modulo personalizzato. Per informazioni sui tipi di risorse, consulta Tipi di asset supportati. Ogni modulo personalizzato può specificare fino a 5 tipi di risorse.
severity

enum (Severity)

Facoltativo. La gravità da assegnare ai risultati generati dal modulo.
description

string

Facoltativo. Testo che descrive la vulnerabilità o l'errore di configurazione rilevato dal modulo personalizzato. Questa spiegazione viene restituita con ogni istanza del rilevamento per aiutare gli investigatori a comprendere il problema rilevato. Il testo deve essere racchiuso tra virgolette.
recommendation

string

Facoltativo. Una spiegazione della procedura consigliata che i team di sicurezza possono seguire per risolvere il problema rilevato. Questa spiegazione viene restituita con ogni risultato generato da questo modulo.

Expr

Rappresenta un'espressione di testo nella sintassi Common Expression Language (CEL). CEL è un linguaggio di espressioni simile a C. La sintassi e la semantica di CEL sono documentate all'indirizzo https://github.com/google/cel-spec.

Esempio (confronto):

title: "Summary size limit"
description: "Determines if a summary is less than 100 chars"
expression: "document.summary.size() < 100"

Esempio (uguaglianza):

title: "Requestor is owner"
description: "Determines if requestor is the document owner"
expression: "document.owner == request.auth.claims.email"

Esempio (logica):

title: "Public documents"
description: "Determine whether the document should be publicly visible"
expression: "document.type != 'private' && document.type != 'internal'"

Esempio (manipolazione dei dati):

title: "Notification string"
description: "Create a notification string with a timestamp."
expression: "'New message received at ' + string(document.create_time)"

Le variabili e le funzioni esatte a cui può essere fatto riferimento all'interno di un'espressione sono determinate dal servizio che la valuta. Per ulteriori informazioni, consulta la documentazione del servizio.

Rappresentazione JSON 
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
Campi
expression

string

Rappresentazione testuale di un'espressione nella sintassi di Common Expression Language.
title

string

Facoltativo. Titolo dell'espressione, ovvero una breve stringa che ne descrive lo scopo. Può essere utilizzato, ad esempio, nelle UI che consentono di inserire l'espressione.
description

string

Facoltativo. Descrizione dell'espressione. Si tratta di un testo più lungo che descrive l'espressione, ad esempio quando si passa il mouse sopra l'espressione in un'interfaccia utente.
location

string

Facoltativo. Stringa che indica la posizione dell'espressione per la segnalazione degli errori, ad esempio un nome file e una posizione nel file.

CustomOutputSpec

Un insieme di coppie nome-valore facoltative che definiscono le proprietà di origine personalizzate da restituire con ogni risultato generato dal modulo personalizzato. Le proprietà sorgente personalizzate definite qui sono incluse nel risultato.

Rappresentazione JSON 
{
  "properties": [
    {
      object (Property)
    }
  ]
}
Campi
properties[]

object (Property)

Facoltativo. Un elenco di proprietà di output personalizzate da aggiungere al risultato.

Proprietà

Una singola coppia nome-valore che definisce una proprietà di origine personalizzata.

Rappresentazione JSON 
{
  "name": string,
  "valueExpression": {
    object (Expr)
  }
}
Campi
name

string

Facoltativo. Nome della proprietà per l'output personalizzato.
valueExpression

object (Expr)

Facoltativo. L'espressione CEL per l'output personalizzato. È possibile specificare una proprietà della risorsa per restituire il valore della proprietà o una stringa di testo racchiusa tra virgolette.

ResourceSelector

Risorsa per la selezione del tipo di risorsa.

Rappresentazione JSON 
{
  "resourceTypes": [
    string
  ]
}
Campi
resourceTypes[]

string

Facoltativo. I tipi di risorse su cui eseguire il rilevatore.

Gravità

Definisce le opzioni di valore valide per la gravità di un risultato.

Enum
SEVERITY_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
CRITICAL Gravità critica.
HIGH Gravità elevata.
MEDIUM Gravità media.
LOW Gravità bassa.