CustomConfig

Menentukan properti dalam konfigurasi modul kustom untuk Security Health Analytics. Gunakan konfigurasi modul kustom untuk membuat detektor kustom yang menghasilkan temuan kustom untuk resource yang Anda tentukan.

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

object (Expr)

Opsional. Ekspresi Common Expression Language (CEL) yang akan dievaluasi untuk menghasilkan temuan. Jika ekspresi bernilai true terhadap resource, temuan akan dibuat.
customOutput

object (CustomOutputSpec)

Opsional. Properti output kustom.
resourceSelector

object (ResourceSelector)

Opsional. Jenis resource Inventaris Aset Cloud tempat modul kustom beroperasi. Untuk informasi tentang jenis resource, lihat Jenis aset yang didukung. Setiap modul kustom dapat menentukan hingga 5 jenis resource.
severity

enum (Severity)

Opsional. Tingkat keparahan yang akan ditetapkan ke temuan yang dihasilkan oleh modul.
description

string

Opsional. Teks yang menjelaskan kerentanan atau kesalahan konfigurasi yang terdeteksi oleh modul kustom. Penjelasan ini ditampilkan dengan setiap instance temuan untuk membantu penyelidik memahami masalah yang terdeteksi. Teks harus diapit dengan tanda petik.
recommendation

string

Opsional. Penjelasan tentang langkah-langkah yang direkomendasikan yang dapat dilakukan tim keamanan untuk menyelesaikan masalah yang terdeteksi. Penjelasan ini ditampilkan dengan setiap temuan yang dihasilkan oleh modul ini.

Expr

Merepresentasikan ekspresi tekstual dalam sintaksis Common Expression Language (CEL). CEL adalah bahasa ekspresi mirip C. Sintaksis dan semantik CEL didokumentasikan di https://github.com/google/cel-spec.

Contoh (Perbandingan):

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

Contoh (Kesetaraan):

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

Contoh (Logika):

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

Contoh (Manipulasi Data):

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

Variabel dan fungsi yang tepat yang dapat direferensikan dalam ekspresi ditentukan oleh layanan yang mengevaluasinya. Lihat dokumentasi layanan untuk informasi tambahan.

Representasi JSON 
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
Kolom
expression

string

Representasi tekstual ekspresi dalam sintaksis Common Expression Language.
title

string

Opsional. Judul untuk ekspresi, yaitu string singkat yang menjelaskan tujuannya. Ini dapat digunakan, misalnya, di UI yang memungkinkan untuk memasukkan ekspresi.
description

string

Opsional. Deskripsi ekspresi. Ini adalah teks yang lebih panjang yang menjelaskan ekspresi, misalnya saat diarahkan ke ekspresi tersebut di UI.
location

string

Opsional. String yang menunjukkan lokasi ekspresi untuk pelaporan error, misalnya nama file dan posisi dalam file.

CustomOutputSpec

Kumpulan pasangan nama-nilai opsional yang menentukan properti sumber kustom yang akan ditampilkan dengan setiap temuan yang dihasilkan oleh modul kustom. Properti sumber kustom yang ditentukan di sini akan disertakan dalam temuan.

Representasi JSON 
{
  "properties": [
    {
      object (Property)
    }
  ]
}
Kolom
properties[]

object (Property)

Opsional. Daftar properti output kustom yang akan ditambahkan ke temuan.

Properti

Setiap pasangan nama-nilai yang menentukan properti sumber kustom.

Representasi JSON 
{
  "name": string,
  "valueExpression": {
    object (Expr)
  }
}
Kolom
name

string

Opsional. Nama properti untuk output kustom.
valueExpression

object (Expr)

Opsional. Ekspresi CEL untuk output kustom. Properti resource dapat ditentukan untuk menampilkan nilai properti atau string teks yang diapit tanda kutip.

ResourceSelector

Referensi untuk memilih jenis resource.

Representasi JSON 
{
  "resourceTypes": [
    string
  ]
}
Kolom
resourceTypes[]

string

Opsional. Jenis resource tempat pendeteksi akan dijalankan.

Keparahan

Menentukan opsi nilai yang valid untuk tingkat keparahan temuan.

Enum
SEVERITY_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
CRITICAL Tingkat keparahan kritis.
HIGH Tingkat keparahan tinggi.
MEDIUM Tingkat keparahan sedang.
LOW Tingkat keparahan rendah.