Membisukan temuan individual

Dokumen ini menjelaskan cara menonaktifkan temuan satu per satu secara statis, mengaktifkannya kembali, atau menonaktifkan temuan secara massal di Security Command Center.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membisukan atau membunyikan kembali temuan, minta administrator untuk memberi Anda peran IAM berikut pada organisasi, folder, atau project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membisukan temuan satu per satu

Anda dapat membisukan temuan tertentu secara statis menggunakan konsolGoogle Cloud , gcloud CLI, atau Security Command Center API.

Membisukan temuan secara statis tidak memengaruhi apakah temuan tersebut aktif atau tidak. Jika temuan aktif disembunyikan, atribut state tetap tidak berubah: state="ACTIVE". Temuan disembunyikan, tetapi tetap aktif hingga kerentanan, kesalahan konfigurasi, atau ancaman yang mendasarinya diselesaikan. Selain itu, dengan menonaktifkan temuan secara statis, Anda menggantikan aturan penonaktifan dinamis yang berlaku untuk temuan tersebut.

Membisukan temuan kombinasi toksik akan menutup kasus kombinasi toksik yang sesuai.

Untuk menonaktifkan semua temuan mendatang yang cocok dengan kriteria yang Anda tentukan, lihat Mengelola aturan nonaktif.

Untuk kode contoh guna menonaktifkan temuan, lihat Menonaktifkan temuan.

Untuk membisukan temuan tertentu secara statis, klik tab untuk prosedur yang ingin Anda gunakan:

Konsol

  1. Di konsol Google Cloud , buka halaman Temuan Security Command Center.

    Buka Temuan

  2. Jika perlu, pilih Google Cloud project atau organisasi Anda.
  3. Jika Anda tidak melihat temuan yang perlu dibisukan di panel Findings query results, pilih kategori temuan di bagian Category pada panel Quick filters.
  4. Pilih temuan yang perlu Anda bisukan. Anda dapat memilih satu atau beberapa temuan.
  5. Di panel tindakan Hasil kueri temuan, klik Opsi nonaktif, lalu pilih Terapkan penggantian nonaktif.

    Atribut mute untuk temuan yang dipilih disetel ke MUTED, dan temuan dihapus dari panel Hasil kueri temuan. Atau, Anda dapat menonaktifkan temuan dari panel detailnya:

  6. Di panel Finding query results pada halaman Findings, di kolom Category, klik nama temuan individual. Panel detail temuan akan terbuka.

  7. Klik Ambil tindakan.

  8. Dari menu Ambil tindakan, pilih Terapkan penggantian nonaktif.

    Jika Anda memilih Nonaktifkan temuan seperti ini, halaman Buat aturan penonaktifan akan terbuka dan Anda dapat membuat aturan penonaktifan untuk temuan dengan jenis yang sama atau yang menyertakan atribut Indicator yang sama.

gcloud

  1. Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

  2. Untuk menyetel status nonaktif temuan ke MUTED, gunakan perintah set-mute di gcloud CLI:

    gcloud scc findings set-mute FINDING_ID \
      --PARENT=PARENT_ID \
      --location=LOCATION \
      --source=SOURCE_ID \
      --mute=MUTED

    Ganti kode berikut:

    • FINDING_ID: ID temuan yang ingin Anda nonaktifkan

      Untuk mengambil ID temuan, gunakan Security Command Center API untuk mencantumkan temuan. ID temuan adalah bagian terakhir dari atribut canonicalName, misalnya, projects/123456789012/sources/1234567890123456789/findings`/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: resource induk (project, folder, atau organization), peka huruf besar/kecil

    • PARENT_ID: ID organisasi induk, folder, atau project

    • LOCATION: lokasi Security Command Center tempat temuan dibisukan atau dibatalkan bisunya; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global

    • SOURCE_ID: ID sumber

      Untuk mengetahui petunjuk tentang cara mengambil ID sumber, lihat Mendapatkan ID sumber.

Go

import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv2"
	"cloud.google.com/go/securitycenter/apiv2/securitycenterpb"
)

// setMute mutes an individual finding.
// If a finding is already muted, muting it again has no effect.
// Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
func setMute(w io.Writer, findingPath string) error {
	// findingPath: The relative resource name of the finding. See:
	// https://cloud.google.com/apis/design/resource_names#relative_resource_name
	// Use any one of the following formats:
	//  - organizations/{organization_id}/sources/{source_id}/finding/{finding_id}
	//  - folders/{folder_id}/sources/{source_id}/finding/{finding_id}
	//  - projects/{project_id}/sources/{source_id}/finding/{finding_id}
	// findingPath := fmt.Sprintf("projects/%s/sources/%s/finding/%s", "your-google-cloud-project-id", "source", "finding-id")
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.SetMuteRequest{
		Name: findingPath,
		Mute: securitycenterpb.Finding_MUTED}

	finding, err := client.SetMute(ctx, req)
	if err != nil {
		return fmt.Errorf("failed to set the specified mute value: %w", err)
	}
	fmt.Fprintf(w, "Mute value for the finding: %s is %s", finding.Name, finding.Mute)
	return nil
}

Java


import com.google.cloud.securitycenter.v2.Finding;
import com.google.cloud.securitycenter.v2.Finding.Mute;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.SetMuteRequest;
import java.io.IOException;

public class SetMuteFinding {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the variables within {}
    // findingPath: The relative resource name of the finding. See:
    // https://cloud.google.com/apis/design/resource_names#relative_resource_name
    // Use any one of the following formats:
    //  - organizations/{org_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //
    String findingPath = "{path-to-the-finding}";

    setMute(findingPath);
  }

  // Mute an individual finding.
  // If a finding is already muted, muting it again has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
  public static Finding setMute(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      SetMuteRequest setMuteRequest =
          SetMuteRequest.newBuilder()
              // Relative path for the finding.
              .setName(findingPath)
              .setMute(Mute.MUTED)
              .build();

      Finding finding = client.setMute(setMuteRequest);
      System.out.println(
          "Mute value for the finding " + finding.getName() + " is: " + finding.getMute());
      return finding;
    }
  }
}

Python

def set_mute_finding(finding_path: str) -> None:
    """
      Mute an individual finding.
      If a finding is already muted, muting it again has no effect.
      Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
    Args:
        finding_path: The relative resource name of the finding. See:
        https://cloud.google.com/apis/design/resource_names#relative_resource_name
        Use any one of the following formats:
        - organizations/{organization_id}/sources/{source_id}/finding/{finding_id},
        - folders/{folder_id}/sources/{source_id}/finding/{finding_id},
        - projects/{project_id}/sources/{source_id}/finding/{finding_id}.
    """
    from google.cloud import securitycenter_v2

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.SetMuteRequest()
    request.name = finding_path
    request.mute = securitycenter_v2.Finding.Mute.MUTED

    finding = client.set_mute(request)
    print(f"Mute value for the finding: {finding.mute.name}")
    return finding

REST

Di Security Command Center API, gunakan metode findings.setMute untuk membisukan temuan. Isi permintaan adalah enum yang menunjukkan status senyap yang dihasilkan:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_ID:setMute

{
  "mute": "MUTED"
}

Ganti kode berikut:

  • PARENT: resource induk (organizations, folders, atau projects).
  • PARENT_ID: ID organisasi, folder, atau project induk.
  • LOCATION: lokasi Security Command Center tempat temuan dibisukan atau dibatalkan bisunya; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global
  • SOURCE_ID: ID numerik untuk sumber.

    Untuk mengetahui petunjuk tentang cara mengambil ID sumber, lihat Mendapatkan ID sumber.

  • FINDING_ID: ID temuan yang ingin Anda nonaktifkan.

    Untuk mengambil ID temuan, gunakan Security Command Center API untuk mencantumkan temuan. ID temuan adalah bagian terakhir dari atribut canonicalName, misalnya, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Setelah Anda membisukan temuan, atribut mute-nya akan ditetapkan ke MUTED.

Mengaktifkan temuan satu per satu

Anda dapat membatalkan pembisuan temuan individual secara statis menggunakan konsol Google Cloud , gcloud CLI, atau Security Command Center API.

Membatalkan bisu temuan berguna jika Anda perlu mencegah temuan disembunyikan oleh aturan penonaktifan yang terlalu luas, atau oleh aturan yang mungkin terlalu rumit untuk diubah guna mengecualikan temuan yang Anda anggap penting.

Temuan yang tidak dibisukan akan dibisukan kembali hanya jika temuan tersebut dibisukan secara manual. Aturan nonaktif yang dibuat dengan gcloud CLI atau Security Command Center API tidak akan memengaruhi temuan yang diaktifkan kembali oleh pengguna.

Untuk kode contoh guna membunyikan kembali temuan, lihat Membunyikan kembali temuan.

Konsol

Untuk mengaktifkan kembali notifikasi temuan individual menggunakan konsol Google Cloud , klik tab untuk tingkat layanan Anda:

  1. Di konsol Google Cloud , buka halaman Temuan Security Command Center.

    Buka Temuan

  2. Jika perlu, pilih Google Cloud project atau organisasi Anda. Halaman Temuan akan terbuka dengan kueri default yang ditampilkan di bagian Pratinjau kueri. Kueri default memfilter temuan yang disenyapkan, jadi Anda perlu mengedit kueri sebelum temuan yang disenyapkan muncul di panel Hasil kueri temuan.
  3. Di sebelah kanan bagian Pratinjau kueri, klik Edit kueri untuk membuka Editor kueri.
  4. Di kolom editor kueri, ganti pernyataan bisu yang ada dengan berikut ini:
    mute="MUTED"
  5. Klik Terapkan. Temuan di panel Findings query results diperbarui untuk hanya menyertakan temuan yang disenyapkan.
  6. Jika perlu, filter temuan yang dibisukan lainnya. Misalnya, di panel Quick filters di bagian Category, pilih nama temuan yang perlu Anda aktifkan suaranya untuk memfilter semua kategori temuan lainnya.
  7. Pilih temuan yang ingin Anda aktifkan suaranya. Anda dapat memilih satu atau beberapa temuan.
  8. Di panel tindakan Hasil kueri temuan, klik Opsi Sembunyikan, lalu pilih Terapkan penggantian batal sembunyikan. Atribut mute untuk temuan yang dipilih disetel ke UNMUTED, dan temuan dihapus dari panel Hasil kueri temuan. Atau, Anda dapat mengaktifkan kembali temuan dari panel detailnya:
  9. Di panel Finding query results pada halaman Findings, di kolom Category, klik nama temuan individual. Panel detail temuan akan terbuka.
  10. Klik Ambil tindakan.
  11. Dari menu Ambil tindakan, pilih Terapkan penggantian kebisuan.

gcloud

  1. Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

  2. Untuk menyetel status nonaktif temuan ke UNMUTED, gunakan perintah set-mute di gcloud CLI:

    gcloud scc findings set-mute FINDING_ID \
      --PARENT=PARENT_ID \
      --location=LOCATION \
      --source=SOURCE_ID \
      --mute=UNMUTED

    Ganti kode berikut:

    • FINDING_ID: ID temuan yang ingin Anda nonaktifkan

      Untuk mengambil ID temuan, gunakan Security Command Center API untuk mencantumkan temuan. ID temuan adalah bagian terakhir dari atribut canonicalName, misalnya, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: resource induk (project, folder, atau organization ), peka huruf besar/kecil

    • PARENT_ID: ID organisasi induk, folder, atau project

    • LOCATION: lokasi Security Command Center tempat temuan dibisukan atau dibatalkan bisunya; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global

    • SOURCE_ID: ID sumber

      Untuk mengetahui petunjuk tentang cara mengambil ID sumber, lihat Mendapatkan ID sumber.

Go


import (
	"context"
	"fmt"
	"io"

	securitycenter "cloud.google.com/go/securitycenter/apiv2"
	"cloud.google.com/go/securitycenter/apiv2/securitycenterpb"
)

// setUnmute unmutes an individual finding.
// Unmuting a finding that isn't muted has no effect.
// Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
func setUnmute(w io.Writer, findingPath string) error {
	// findingPath: The relative resource name of the finding. See:
	// https://cloud.google.com/apis/design/resource_names#relative_resource_name
	// Use any one of the following formats:
	//  - organizations/{organization_id}/sources/{source_id}/finding/{finding_id}
	//  - folders/{folder_id}/sources/{source_id}/finding/{finding_id}
	//  - projects/{project_id}/sources/{source_id}/finding/{finding_id}
	// findingPath := fmt.Sprintf("projects/%s/sources/%s/finding/%s", "your-google-cloud-project-id", "source", "finding-id")
	ctx := context.Background()
	client, err := securitycenter.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("securitycenter.NewClient: %w", err)
	}
	defer client.Close()

	req := &securitycenterpb.SetMuteRequest{
		Name: findingPath,
		Mute: securitycenterpb.Finding_UNMUTED}

	finding, err := client.SetMute(ctx, req)
	if err != nil {
		return fmt.Errorf("failed to set the specified mute value: %w", err)
	}
	fmt.Fprintf(w, "Mute value for the finding: %s is %s", finding.Name, finding.Mute)
	return nil
}

Java


import com.google.cloud.securitycenter.v2.Finding;
import com.google.cloud.securitycenter.v2.Finding.Mute;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.SetMuteRequest;
import java.io.IOException;

public class SetUnmuteFinding {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the variables within {}
    // findingPath: The relative resource name of the finding. See:
    // https://cloud.google.com/apis/design/resource_names#relative_resource_name
    // Use any one of the following formats:
    //  - organizations/{org_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - folders/{folder_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //  - projects/{project_id}/sources/{source_id}/locations/{location}/finding/{finding_id}
    //
    String findingPath = "{path-to-the-finding}";

    setUnmute(findingPath);
  }

  // Unmute an individual finding.
  // Unmuting a finding that isn't muted has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
  public static Finding setUnmute(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      SetMuteRequest setMuteRequest =
          SetMuteRequest.newBuilder()
              .setName(findingPath)
              .setMute(Mute.UNMUTED)
              .build();

      Finding finding = client.setMute(setMuteRequest);
      System.out.println(
          "Mute value for the finding " + finding.getName() + " is: " + finding.getMute());
      return finding;
    }
  }
}

Python

def set_unmute_finding(finding_path: str) -> None:
    """
      Unmute an individual finding.
      Unmuting a finding that isn't muted has no effect.
      Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE.
    Args:
        finding_path: The relative resource name of the finding. See:
        https://cloud.google.com/apis/design/resource_names#relative_resource_name
        Use any one of the following formats:
        - organizations/{organization_id}/sources/{source_id}/finding/{finding_id},
        - folders/{folder_id}/sources/{source_id}/finding/{finding_id},
        - projects/{project_id}/sources/{source_id}/finding/{finding_id}.
    """
    from google.cloud import securitycenter_v2

    client = securitycenter_v2.SecurityCenterClient()

    request = securitycenter_v2.SetMuteRequest()
    request.name = finding_path
    request.mute = securitycenter_v2.Finding.Mute.UNMUTED

    finding = client.set_mute(request)
    print(f"Mute value for the finding: {finding.mute.name}")
    return finding

REST

Di Security Command Center API, gunakan metode findings.setMute untuk membatalkan pembisuan temuan. Isi permintaan adalah enum yang menunjukkan status senyap yang dihasilkan:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_ID:setMute

{
  "mute": "UNMUTED"
}

Ganti kode berikut:

  • PARENT: resource induk (organizations, folders, atau projects)
  • PARENT_ID: ID organisasi induk, folder, atau project
  • LOCATION: lokasi Security Command Center tempat temuan dibisukan atau dibatalkan bisunya; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global
  • SOURCE_ID: ID numerik untuk sumber

    Untuk mengetahui petunjuk tentang cara mengambil ID sumber, lihat Mendapatkan ID sumber.

  • FINDING_ID: ID temuan yang ingin Anda nonaktifkan.

    Untuk mengambil ID temuan, gunakan Security Command Center API untuk mencantumkan temuan. ID temuan adalah bagian terakhir dari atribut canonicalName, misalnya, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

Temuan yang dipilih tidak lagi disembunyikan, dan atribut mute untuk temuan ditetapkan ke UNMUTED.

Menghapus penggantian status nonaktif dari temuan individual

Anda menerapkan penggantian status senyap saat Anda sengaja mengubah status senyap temuan untuk menyenyapkan atau membatalkan penyenyapan temuan secara statis. Misalnya, Anda mungkin ingin menerapkan penggantian status nonaktif untuk menyembunyikan temuan tingkat keparahan rendah yang tidak perlu dibuatkan aturan penonaktifan dinamis.

Anda dapat menghapus penggantian status senyap dari temuan individual menggunakan konsol Google Cloud , gcloud CLI, atau Security Command Center API.

Sebelum menghapus penggantian status bisu dari temuan, pahami hal-hal berikut:

  • Temuan memiliki penggantian status bisu jika dibisukan atau dibunyikan secara statis. Anda dapat menerapkan penggantian status senyap ke temuan apa pun secara manual atau otomatis dengan aturan senyap statis.
  • Penggantian status nonaktif berlaku untuk temuan tanpa batas waktu dan diprioritaskan daripada aturan nonaktif yang cocok.
  • Menghapus penggantian status nonaktif dari temuan akan mereset status nonaktif temuan sehingga dapat diproses oleh aturan nonaktif statis atau dinamis.
  • Menghapus penggantian status senyap dari temuan berbeda dengan membatalkan senyap temuan. Saat Anda mengaktifkan kembali temuan (menerapkan penggantian penonaktifan), aturan penonaktifan tidak dapat menonaktifkan temuan tersebut hingga Anda menghapus penggantian status penonaktifan secara manual.

Untuk menghapus penggantian pembisuan dari temuan tertentu, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Temuan Security Command Center.

    Buka Temuan

  2. Pilih project atau organisasi Anda. Google Cloud
  3. Di sebelah kanan bagian Pratinjau kueri, klik Edit kueri untuk membuka Editor kueri.
  4. Di kolom editor kueri, ganti pernyataan bisu yang ada dengan berikut ini:
    mute="MUTED" OR mute="UNMUTED"
  5. Klik Terapkan. Temuan di panel Findings query results diperbarui untuk menyertakan temuan yang diredam dan tidak diredam secara statis.
  6. Jika perlu, filter temuan lainnya. Misalnya, di panel Quick filters di bagian Category, pilih nama temuan yang perlu Anda reset untuk memfilter semua kategori temuan lainnya.
  7. Pilih temuan yang ingin Anda reset. Anda dapat memilih satu atau beberapa temuan.
  8. Di panel tindakan Hasil kueri temuan, klik Opsi Sembunyikan, lalu pilih Hapus penggantian penyembunyian. Atribut mute untuk temuan yang dipilih disetel ke UNDEFINED, dan temuan dihapus dari panel Hasil kueri temuan. Atau, Anda dapat mengaktifkan kembali temuan dari panel detailnya:
  9. Di panel Finding query results pada halaman Findings, di kolom Category, klik nama temuan individual. Panel detail temuan akan terbuka.
  10. Klik Ambil tindakan.
  11. Dari menu Ambil tindakan, pilih Hapus penggantian nonaktif.

gcloud

  1. Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

  2. Untuk menyetel status nonaktif temuan ke UNDEFINED, gunakan perintah set-mute di gcloud CLI:

    gcloud scc findings set-mute FINDING_ID \
      --PARENT=PARENT_ID \
      --location=LOCATION \
      --source=SOURCE_ID \
      --mute=UNDEFINED

    Ganti kode berikut:

    • FINDING_ID: ID temuan yang ingin Anda reset

      Untuk mengambil ID temuan, gunakan Security Command Center API untuk mencantumkan temuan. ID temuan adalah bagian terakhir dari atribut canonicalName, misalnya, projects/123456789012/sources/1234567890123456789/findings/5ee30aa342e799e4e1700826de053aa9.

    • PARENT: resource induk (project, folder, atau organization ), peka huruf besar/kecil

    • PARENT_ID: ID organisasi induk, folder, atau project

    • LOCATION: lokasi Security Command Center tempat temuan dibisukan atau dibatalkan bisunya; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global

    • SOURCE_ID: ID sumber

      Untuk mengetahui petunjuk tentang cara mengambil ID sumber, lihat Mendapatkan ID sumber.

REST

Di Security Command Center API, gunakan metode findings.setMute untuk mereset status senyap temuan. Isi permintaan adalah enum yang menunjukkan status senyap yang dihasilkan:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/sources/SOURCE_ID/locations/LOCATION/findings/FINDING_ID:setMute

{
  "mute": "UNDEFINED"
}

Ganti kode berikut:

  • PARENT: resource induk (organizations, folders, atau projects)
  • PARENT_ID: ID organisasi induk, folder, atau project
  • LOCATION: lokasi Security Command Center tempat temuan dibisukan atau dibatalkan bisunya; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global
  • SOURCE_ID: ID numerik untuk sumber

Java


import com.google.cloud.securitycenter.v2.Finding;
import com.google.cloud.securitycenter.v2.Finding.Mute;
import com.google.cloud.securitycenter.v2.SecurityCenterClient;
import com.google.cloud.securitycenter.v2.SetMuteRequest;
import java.io.IOException;

public class SetMuteUndefinedFinding {

  public static void main(String[] args) throws IOException {
    // TODO: Replace the variables within {}

    // findingPath: The relative resource name of the finding. See:
    // https://cloud.google.com/apis/design/resource_names#relative_resource_name
    // Use any one of the following formats:
    // - organizations/{organization_id}/sources/{source_id}/finding/{finding_id}
    // - folders/{folder_id}/sources/{source_id}/finding/{finding_id}
    // - projects/{project_id}/sources/{source_id}/finding/{finding_id}
    String findingPath = "{path-to-the-finding}";
    setMuteUndefined(findingPath);
  }

  // Reset mute state of an individual finding.
  // If a finding is already reset, resetting it again has no effect.
  // Various mute states are: MUTE_UNSPECIFIED/MUTE/UNMUTE/UNDEFINED.
  public static Finding setMuteUndefined(String findingPath) throws IOException {
    // Initialize client that will be used to send requests. This client only needs
    // to be created once, and can be reused for multiple requests.
    try (SecurityCenterClient client = SecurityCenterClient.create()) {

      SetMuteRequest setMuteRequest =
          SetMuteRequest.newBuilder()
              .setName(findingPath)
              .setMute(Mute.UNDEFINED)
              .build();

      Finding finding = client.setMute(setMuteRequest);
      System.out.println(
          "Mute value for the finding " + finding.getName() + " is: " + finding.getMute());
      return finding;
    }
  }
}

Menyembunyikan atau mereset beberapa temuan yang ada

Anda dapat melakukan operasi senyapkan massal berikut untuk beberapa temuan yang ada menggunakan perintah gcloud scc findings bulk-mute gcloud CLI, atau metode bulkMute dari Security Command Center API:

  • Menonaktifkan beberapa temuan yang ada. Menonaktifkan temuan yang ada secara massal akan menonaktifkannya secara statis dan menggantikan aturan penonaktifan dinamis yang berlaku untuk temuan tersebut. Jika Anda perlu membisukan temuan serupa di masa mendatang, buat aturan pembisuan.

  • Menghapus penggantian status nonaktif pada beberapa temuan yang ada. Dengan menghapus penggantian status senyap pada temuan, Anda mereset status senyap dari MUTED (disenyapkan secara statis) atau UNMUTED (tidak disenyapkan secara statis) ke UNDEFINED. Kemampuan ini dapat berguna jika Anda memigrasikan dari aturan bisu statis ke dinamis.

Tentukan kumpulan temuan yang perlu Anda nonaktifkan dengan menentukan filter temuan. Filter senyapkan massal tidak mendukung semua properti temuan. Untuk mengetahui daftar properti yang tidak didukung, lihat Properti temuan yang tidak didukung untuk aturan nonaktif.

Jika residensi data diaktifkan untuk Security Command Center, operasi membisukan massal dibatasi cakupannya ke lokasi Security Command Center tempat operasi tersebut dieksekusi.

Untuk kode contoh yang menonaktifkan temuan secara massal, lihat Menonaktifkan temuan secara massal.

Untuk membisukan atau mereset temuan secara massal, klik tab untuk prosedur yang ingin Anda gunakan:

Konsol

Di konsol Google Cloud , Anda hanya dapat menonaktifkan temuan secara massal dengan membuat aturan penonaktifan. Di konsol Google Cloud , pembuatan aturan penonaktifan akan menonaktifkan temuan yang ada dan yang akan datang.

gcloud

  1. Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

  2. Untuk membisukan atau mereset beberapa temuan secara massal, jalankan perintah gcloud scc findings bulk-mute:

    gcloud scc findings bulk-mute \
      --PARENT=PARENT_ID \
      --location=LOCATION \
      --filter="FILTER" \
      --mute-state=MUTE_STATE

    Ganti kode berikut:

    • PARENT: cakupan dalam hierarki resource tempat aturan penonaktifan diterapkan, organization, folder, atau project.
    • PARENT_ID: ID numerik organisasi, folder, atau project induk, atau ID alfanumerik project induk.
    • LOCATION: lokasi Security Command Center tempat temuan akan diredam atau dibunyikan; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global.
    • FILTER: ekspresi yang Anda tentukan untuk memfilter temuan.

      Misalnya, untuk membisukan semua temuan OPEN_FIREWALL dan PUBLIC_IP_ADDRESS yang ada dengan tingkat keparahan rendah di project internal-test, filter Anda dapat berupa "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.projectDisplayName=\"internal-test\"".

    • MUTE_STATE: nilai yang menunjukkan apakah temuan diredam secara statis atau tidak. Nilai yang valid adalah MUTED dan UNDEFINED. Nilai ditetapkan ke MUTED secara default. Tetapkan nilai ini ke UNDEFINED hanya jika Anda mereset status senyap beberapa temuan yang ada.

REST

Di Security Command Center API, gunakan metode findings.bulkMute untuk membisukan atau mereset status bisu beberapa temuan yang ada. Isi permintaan berisi ekspresi yang digunakan untuk memfilter temuan:

POST https://securitycenter.googleapis.com/v2/PARENT/PARENT_ID/locations/LOCATION/findings:bulkMute

{
  "filter": "FILTER",
  "muteState": "MUTE_STATE"
}

Ganti kode berikut:

  • PARENT: resource induk (organizations, folders, atau projects).
  • PARENT_ID: ID organisasi induk, folder, atau project.
  • LOCATION: lokasi Security Command Center tempat temuan akan diredam atau dibunyikan; jika retensi data diaktifkan, gunakan eu, sa, atau us; jika tidak, gunakan nilai global.
  • FILTER: ekspresi yang Anda tentukan untuk memfilter temuan.

    Misalnya, untuk membisukan semua temuan OPEN_FIREWALL dan PUBLIC_IP_ADDRESS yang ada dengan tingkat keparahan rendah di project internal-test, filter Anda dapat berupa "category=\"OPEN_FIREWALL\" OR category=\"PUBLIC_IP_ADDRESS\" AND severity=\"LOW\" AND resource.projectDisplayName=\"internal-test\"".

  • MUTE_STATE: nilai yang menunjukkan apakah temuan dibisukan atau tidak. Nilai yang valid adalah MUTED atau UNDEFINED. Nilai disetel ke MUTED secara default. Tetapkan nilai ini ke UNDEFINED hanya jika Anda mereset status senyap beberapa temuan yang ada.

Semua temuan yang ada di resource yang Anda pilih, dan yang cocok persis dengan filter, akan disembunyikan. Atribut mute untuk temuan ditetapkan ke MUTED.

Menonaktifkan temuan tidak mengubah statusnya. Jika temuan aktif dibisukan, temuan tersebut disembunyikan tetapi tetap aktif hingga kerentanan, kesalahan konfigurasi, atau ancaman yang mendasarinya diselesaikan.

Melihat temuan yang diabaikan di konsol Google Cloud

Anda dapat melihat temuan yang disembunyikan di konsol Google Cloud dengan mengedit kueri temuan untuk memilih temuan yang menyertakan nilai properti mute="MUTED".

Misalnya, kueri temuan berikut hanya menampilkan temuan aktif yang dibisukan:

state="ACTIVE"
AND mute="MUTED"

Untuk menampilkan semua temuan aktif, baik yang dibisukan maupun yang tidak dibisukan, hilangkan atribut mute dari kueri sepenuhnya:

state="ACTIVE"

Secara default, kueri temuan di konsol Google Cloud hanya menampilkan temuan yang tidak dibisukan.

Melihat temuan yang dinonaktifkan menurut jenis aturan penonaktifan

Bagian berikut menjelaskan cara membuat kueri temuan aktif menurut jenis aturan penonaktifan.

Untuk mengetahui informasi selengkapnya tentang mencantumkan temuan tertentu, lihat Memfilter temuan.

Temuan kueri yang dibisukan oleh aturan penonaktifan statis

Untuk menampilkan temuan aktif yang dinonaktifkan oleh aturan penonaktifan statis setelah waktu yang ditentukan, gunakan kueri berikut dan periksa atribut muteInitiator untuk menentukan apakah temuan dinonaktifkan oleh aturan penonaktifan statis.

state="ACTIVE" AND
muteInfo.staticMute.applyTime>=TIMESTAMP AND
muteInfo.staticMute.state="MUTED"

Ganti TIMESTAMP dengan string tanggal dan waktu yang menunjukkan awal periode waktu yang ingin Anda kueri. Untuk mengetahui informasi tentang format waktu, lihat gcloud topic datetimes.

Temuan kueri yang dinonaktifkan oleh aturan penonaktifan dinamis

Untuk menampilkan temuan aktif yang dinonaktifkan oleh aturan penonaktifan dinamis setelah waktu tertentu, gunakan kueri berikut:

state="ACTIVE" AND
muteUpdateTime>=TIMESTAMP AND
contains(muteInfo.dynamicMuteRecords, muteConfig="PARENT_ID/muteConfigs/CONFIG_ID")

Ganti kode berikut:

  • TIMESTAMP: string tanggal dan waktu yang menunjukkan awal jangka waktu yang ingin Anda kueri. Untuk mengetahui informasi tentang format waktu, lihat gcloud topic datetimes.
  • PARENT_ID: ID organisasi, folder, atau project induk, yang ditentukan dalam format organizations/123, folders/456, atau projects/789.
  • CONFIG_ID: nama aturan senyap. ID harus menggunakan karakter alfanumerik dan tanda hubung, serta terdiri dari 1 hingga 63 karakter.

Untuk mengetahui informasi selengkapnya tentang cara mengedit kueri temuan, lihat Membuat atau mengedit kueri temuan di dasbor.

Menghentikan notifikasi dan ekspor temuan yang dibisukan

Jika Anda mengaktifkan notifikasi temuan, temuan yang dibisukan baru atau yang diperbarui yang cocok dengan filter notifikasi Anda tetap diekspor ke Pub/Sub.

Untuk menghentikan ekspor dan notifikasi temuan yang disenyapkan, gunakan atribut mute untuk mengecualikan temuan yang disenyapkan dalam filter NotificationConfig. Misalnya, filter berikut hanya mengirim notifikasi untuk temuan aktif yang tidak dibisukan atau yang atribut bisunya belum ditetapkan:

FILTER="state=\"ACTIVE\" AND -mute=\"MUTED\""