Mengintegrasikan Amazon Macie dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan Amazon Macie dengan Google Security Operations (Google SecOps).

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama parameter	Jenis	Nilai default	Wajib	Deskripsi
Nama Instance	String	T/A	Tidak	Nama Instance yang ingin Anda konfigurasi integrasinya.
Deskripsi	String	T/A	Tidak	Deskripsi Instance.
AWS Access Key ID	String	T/A	Ya	ID Kunci Akses AWS yang akan digunakan dalam integrasi.
AWS Secret Key	Sandi	T/A	Ya	Kunci Rahasia AWS yang akan digunakan dalam integrasi.
AWS Default Region	String	T/A	Ya	Region default AWS yang akan digunakan dalam integrasi, misalnya us-west-1.
Menjalankan dari Jarak Jauh	Kotak centang	Tidak dicentang	Tidak	Centang kotak untuk menjalankan integrasi yang dikonfigurasi dari jarak jauh. Setelah dipilih, opsi akan muncul untuk memilih pengguna jarak jauh (agen).

Untuk mendapatkan petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Anda dapat melakukan perubahan pada tahap selanjutnya, jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan yang tertunda dari meja kerja Anda dan Menjalankan tindakan manual dalam kasus Anda.

Ping

Menguji konektivitas.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip

Nama hasil skrip	Opsi nilai	Contoh
is_success	Benar atau Salah	is_success:False

Repositori kasus

Jenis hasil	Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika berhasil: "Successfully connected to the Amazon Macie service with the provided connection parameters!" Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis, seperti kredensial salah atau konektivitas terputus dilaporkan: "Failed to connect to the Amazon Macie service! Error is {0}".format(exception.stacktrace)	Genera

Membuat Daftar Temuan

Mencantumkan temuan Amazon Macie berdasarkan parameter input tindakan yang ditentukan.

Parameter

Nama parameter	Jenis	Nilai default	Wajib	Deskripsi
Jenis Temuan	String	T/A	Tidak	Jenis temuan yang akan ditelusuri, misalnya SensitiveData:S3Object/Credentials atau SensitiveData:S3Object/Multiple. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma. Jika tidak ada yang ditentukan, tindakan akan menampilkan semua jenis temuan.
Keparahan	String	4	Tidak	Tingkat keseriusan temuan yang akan ditelusuri - Tinggi, Sedang, atau Rendah. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma. Jika tidak ada yang ditentukan, tindakan akan menampilkan semua temuan, terlepas dari tingkat keparahannya.
Sertakan Temuan yang Diarsipkan?	Kotak centang	Tidak dicentang	Tidak	Tentukan apakah akan menyertakan temuan yang diarsipkan dalam hasil atau tidak.
Jangka Waktu	Bilangan bulat	4	Tidak	Tentukan jangka waktu dalam jam untuk mengambil temuan.
Batas kumpulan data	Bilangan bulat	20	Tidak	Tentukan jumlah kumpulan data yang dapat ditampilkan oleh tindakan.
Urutkan menurut	String	T/A	Tidak	Tentukan parameter untuk mengurutkan data. Contoh: updatedAt
Tata urutan	DDL	ASC	Tidak	Tata urutan.

Kasus penggunaan

Mencantumkan temuan Amazon Macie untuk melihat temuan yang tersedia.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip

Nama hasil skrip	Opsi nilai	Contoh
is_success	Benar atau Salah	is_success:False

Hasil JSON

{
  "ResponseMetadata":{
    "HTTPHeaders":{
      "connection":"keep-alive",
      "content-length":"2741",
      "content-type":"application/json",
      "date":"Thu, 22 Oct 2020 11:08:58 GMT",
      "x-amz-apigw-id":"ID",
      "x-amzn-remapped-content-length":"2741",
      "x-amzn-remapped-date":"Thu, 22 Oct ""2020 11:08:57 ""GMT",
      "x-amzn-remapped-x-amzn-requestid":"eaea00d2-11f8-40d8-adce-f6c9f17e9815",
      "x-amzn-requestid":"4102349a-a5da-4bfc-ad78-40f48885985f"
    },
    "HTTPStatusCode":200,
    "RequestId":"4102349a-a5da-4bfc-ad78-40f48885985f",
    "RetryAttempts":0
  },
  "findings":[
    {
      "accountId":"ACCOUNT_ID",
      "archived":false,
      "category":"CLASSIFICATION",
      "classificationDetails":{
        "detailedResultsLocation":"s3://[export-config-not-set]/AWSLogs/ACCOUNT_ID/Macie/us-east-1/",
        "jobArn":"arn:aws:macie2:us-east-1",
        "jobId":"088009521d393eda440a24f3c7ad8fbd",
        "result":{
          "additionalOccurrences":false,
          "customDataIdentifiers":{
            "detections":[
            ],
            "totalCount":0
          },
          "mimeType":"application/zip",
          "sensitiveData":[
            {
              "category":"PERSONAL_INFORMATION",
              "detections":[
                {
                  "count":80,
                  "type":"PHONE_NUMBER"
                },
                {
                  "count":5,
                  "type":"ADDRESS"
                },
                {
                  "count":207,
                  "type":"NAME"
                }
              ],
              "totalCount":292
            },
            {
              "category":"CREDENTIALS",
              "detections":[
                {
                  "count":5,
                  "type":"AWS_CREDENTIALS"
                }
              ],
              "totalCount":5
            }
          ],
          "sizeClassified":44213802,
          "status":{
            "code":"PARTIAL",
            "reason":"ARCHIVE_CONTAINS_UNPROCESSED_FILES"
          }
        }
      },
      "count":1,
      "createdAt":datetime.datetime(2020,
      10,
      22,
      3,
      12,
      9,
      364000,
      "tzinfo=tzutc())",
      "description":"The object contains more than one type of ""sensitive information.",
      "id":"FINDING_ID",
      "partition":"aws",
      "region":"us-east-1",
      "resourcesAffected":{
        "s3Bucket":{
          "arn":"arn:aws:s3:::testexample",
          "createdAt":datetime.datetime(2020,
          9,
          14,
          10,
          31,
          56,
          "tzinfo=tzutc())",
          "defaultServerSideEncryption":{
            "encryptionType":"NONE"
          },
          "name":"testexample",
          "owner":{
            "displayName":"lab_aws",
            "id":"OWNER_ID"
          },
          "publicAccess":{
            "effectivePermission":"PUBLIC",
            "permissionConfiguration":{
              "accountLevelPermissions":{
                "blockPublicAccess":{
                  "blockPublicAcls":false,
                  "blockPublicPolicy":false,
                  "ignorePublicAcls":false,
                  "restrictPublicBuckets":false
                }
              },
              "bucketLevelPermissions":{
                "accessControlList":{
                  "allowsPublicReadAccess":false,
                  "allowsPublicWriteAccess":false
                },
                "blockPublicAccess":{
                  "blockPublicAcls":false,
                  "blockPublicPolicy":false,
                  "ignorePublicAcls":false,
                  "restrictPublicBuckets":false
                },
                "bucketPolicy":{
                  "allowsPublicReadAccess":true,
                  "allowsPublicWriteAccess":false
                }
              }
            }
          },
          "tags":[
          ]
        },
        "s3Object":{
          "bucketArn":"arn:aws:s3:::testsiemplify",
          "eTag":"8dfbe2ba101b3ca0a62f8fde823503b4-5",
          "extension":"zip",
          "key":"awscliv2.zip",
          "lastModified":datetime.datetime(2020,
          9,
          28,
          18,
          47,
          30,
          "tzinfo=tzutc())",
          "path":"testexample/awscliv2.zip",
          "publicAccess":false,
          "serverSideEncryption":{
            "encryptionType":"NONE"
          },
          "size":33775890,
          "storageClass":"STANDARD",
          "tags":[
          ],
          "versionId":""
        }
      },
      "sample":false,
      "schemaVersion":"1.0",
      "severity":{
        "description":"High",
        "score":3
      },
      "title":"The S3 object contains multiple types of sensitive ""information.",
      "type":"SensitiveData:S3Object/Multiple",
      "updatedAt":datetime.datetime(2020,
      10,
      22,
      3,
      12,
      9,
      364000,
      "tzinfo=tzutc())"
    }
  ]
}

Repositori kasus

Jenis hasil	Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika berhasil: "Temuan Amazon Macie ditemukan" Jika is_success=False, misalnya tidak ada temuan yang ditemukan: "No findings were returned." Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis, seperti kredensial salah atau konektivitas terputus dilaporkan: "Failed to connect to the Amazon Macie service! Error is {0}".format(exception.stacktrace)	Umum
Tabel	Nama Tabel: Amazon Macie Findings Kolom Tabel: ID Temuan - "id" Kategori Judul Keparahan Jenis Is Archived - archived Dibuat Pada Diperbarui Pada	Umum

Mendapatkan Temuan

Mendapatkan temuan Amazon Macie berdasarkan ID Temuan yang ditentukan.

Parameter

Nama parameter	Jenis	Nilai default	Wajib	Deskripsi
ID temuan	String	T/A	Ya	ID temuan untuk mendapatkan detailnya. Parameter dapat menggunakan beberapa nilai sebagai string yang dipisahkan koma.

Kasus Penggunaan

Mendapatkan detail Temuan saat menganalisis pemberitahuan. Temuan dalam kasus ini tidak akan "datar" seperti yang akan berasal dari konektor, dan menemukan data mungkin lebih mudah diproses.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip

Nama hasil skrip	Opsi nilai	Contoh
is_success	Benar atau Salah	is_success:False

Hasil JSON

{
    "Policy": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AddPerm",
                "Effect": "Allow",
                "Principal": "*",
                "Action": "s3:GetObject",
                "Resource": "arn:aws:s3:::testexample/*"
            }
        ]
    }

Repositori kasus

Jenis hasil	Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika berhasil: "Temuan Amazon Macie ditemukan" Jika is_success=False, misalnya tidak ada temuan yang ditemukan: "No findings were returned." Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis, seperti kredensial salah atau konektivitas terputus dilaporkan: "Failed to connect to the Amazon Macie service! Error is {0}".format(exception.stacktrace)	Umum
Tabel	Nama Tabel: Amazon Macie Findings Kolom Tabel: ID Temuan - "id" Kategori Judul Keparahan Jenis Is Archived - archived Dibuat Pada Diperbarui Pada	Umum

Membuat ID Data Kustom

Membuat ID Data Kustom Amazon Macie.

Parameter

Nama parameter	Jenis	Nilai default	Wajib	Deskripsi
Nama ID Data Kustom	String	T/A	Ya	Nama ID data kustom baru Amazon Macie.
Deskripsi ID Data Kustom	String	T/A	Tidak	Deskripsi ID data kustom baru Amazon Macie.
Ekspresi Reguler ID Data Kustom	String	T/A	Ya	Ekspresi reguler ID data kustom baru Amazon Macie. Contoh: I[a@]mAB[a@]dRequest
Kata Kunci ID Data Kustom	String	T/A	Tidak	Kata kunci ID data kustom baru Amazon Macie.
Kata yang Diabaikan Pengenal Data Kustom	String	T/A	Tidak	Kata-kata yang diabaikan ID data kustom baru Amazon Macie.
Jarak Pencocokan Maksimum ID Data Kustom	Bilangan bulat	50	Tidak	Jarak kecocokan maksimum ID data kustom baru Amazon Macie.

Kasus penggunaan

Buat ID data kustom Amazon Macie berdasarkan data yang diamati, sehingga ID data kustom baru nantinya dapat digunakan dalam tugas klasifikasi.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip

Nama hasil skrip	Opsi nilai	Contoh
is_success	Benar atau Salah	is_success:False

Hasil JSON

{
  "ResponseMetadata":{
    "HTTPHeaders":{
      "connection":"keep-alive",
      "content-length":"65",
      "content-type":"application/json",
      "date":"Mon, 26 Oct 2020 05:15:07 GMT",
      "x-amz-apigw-id":"ID",
      "x-amzn-remapped-content-length":"65",
      "x-amzn-remapped-date":"Mon, 26 Oct ""2020 05:15:07 ""GMT",
      "x-amzn-remapped-x-amzn-requestid":"61217a30-189e-4573-9f76-257b7065a04d",
      "x-amzn-requestid":"509e1c12-ab86-459e-9d6d-790a359686b2"
    },
    "HTTPStatusCode":200,
    "RequestId":"509e1c12-ab86-459e-9d6d-790a359686b2",
    "RetryAttempts":0
  },
  "customDataIdentifierId":"ff43487b-5643-4de1-b651-9ecbeb3021ed"
}

Repositori kasus

Jenis hasil	Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika berhasil: "New Amazon Macie custom data identifier created: {0}".format(new identifier_id from response) Jika is_success=False, misalnya tidak ada temuan yang ditemukan: "Failed to create Amazon Macie Identifier. Error is: {0}".format(error from response) Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis, seperti kredensial salah atau konektivitas terputus dilaporkan: "Failed to connect to the Amazon Macie service! Error is {0}".format(exception.stacktrace)	Umum

Menghapus ID Data Kustom

Menghapus Amazon Macie Custom Data Identifier.

Parameter

Nama parameter	Jenis	Nilai default	Wajib	Deskripsi
ID ID Data Kustom	String	T/A	Tidak	ID ID data kustom Amazon Macie yang akan dihapus.

Kasus Penggunaan

Menghapus Amazon Macie Custom Data Identifier.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip

Nama hasil skrip	Opsi nilai	Contoh
is_success	Benar atau Salah	is_success:False

Repositori kasus

Jenis hasil	Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika berhasil: "Amazon Macie custom data identifier {0} deleted".format(custom data identifier id) Jika is_success=False, misalnya tidak ada temuan yang ditemukan: "Failed to delete Amazon Macie Identifier {0}. Error is: {1}".format(custom data identifier id, error from response) Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis, seperti kredensial salah atau konektivitas terputus dilaporkan: "Failed to connect to the Amazon Macie service! Error is {0}".format(exception.stacktrace)	Umum

Mengaktifkan Macie

Aktifkan layanan Amazon Macie.

Parameter

T/A

Kasus penggunaan

Aktifkan Amazon Macie setelah periode layanan selesai.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip

Nama hasil skrip	Opsi nilai	Contoh
is_success	Benar atau Salah	is_success:False

Repositori kasus

Jenis hasil	Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika berhasil: "Successfully enabled Amazon Macie service" Jika is_success=False: "Failed to enable Amazon Macie service. Error is: {0}".format(error from response) Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis, seperti kredensial salah atau konektivitas terputus dilaporkan:"Failed to connect to the Amazon Macie service! Error is {0}".format(exception.stacktrace)	Umum

Menonaktifkan Macie

Nonaktifkan layanan Amazon Macie.

Kasus Penggunaan

Menonaktifkan Amazon Macie untuk periode layanan - untuk melakukan beberapa perubahan di bucket AWS dan tidak menyebabkan banyak positif palsu.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil tindakan

Hasil skrip

Nama hasil skrip	Opsi nilai	Contoh
is_success	Benar atau Salah	is_success:False

Repositori kasus

Jenis hasil	Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika berhasil: "Successfully disabled Amazon Macie service" Jika is_success=False: "Failed to disable Amazon Macie service. Error is: {0}".format(error from response) Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis, seperti kredensial salah atau konektivitas terputus dilaporkan: "Failed to connect to the Amazon Macie service! Error is {0}".format(exception.stacktrace)	Umum

Konektor

Untuk mempelajari lebih lanjut cara mengonfigurasi konektor di Google SecOps, lihat Menyerap data (konektor).

Catatan: Untuk mencegah kehilangan data, konektor menggunakan Perataan Peristiwa. Jika pemberitahuan mentah berisi daftar entitas (seperti beberapa alamat email, nama host, atau alamat IP), konektor akan otomatis meratakannya menjadi peristiwa yang terpisah dan unik.

Misalnya, satu pemberitahuan mentah yang berisi tiga alamat email berbeda diserap sebagai tiga peristiwa terpisah, yang masing-masing berisi satu alamat email yang berbeda.

Proses ini memastikan bahwa setiap entity diindeks dengan benar sebagai aset unik, sehingga dapat sepenuhnya ditelusuri dan ditindaklanjuti dalam playbook.

Amazon Macie - Findings Connector

Menyerap temuan Amazon Macie.

Parameter konektor

Gunakan parameter berikut untuk mengonfigurasi konektor:

Nama parameter	Jenis	Nilai default	Wajib	Deskripsi
Nama Kolom Produk	String	T/A	Ya	Nama kolom tempat nama produk disimpan. Nama produk terutama memengaruhi pemetaan. Untuk menyederhanakan dan meningkatkan proses pemetaan untuk konektor, nilai default di-resolve ke nilai pengganti yang direferensikan dari kode. Setiap input yang tidak valid untuk parameter ini akan di-resolve ke nilai penggantian secara default. Nilai defaultnya adalah Product Name.
Nama Kolom Peristiwa	String	T/A	Ya	Nama kolom yang menentukan nama peristiwa (subjenis).
Nama Kolom Lingkungan	String	T/A	Tidak	Nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ada, konektor akan menggunakan nilai default.
Environment Regex Pattern	String	T/A	Tidak	Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom Environment Field Name. Parameter ini memungkinkan Anda memanipulasi kolom lingkungan menggunakan logika ekspresi reguler. Gunakan nilai default .* untuk mengambil nilai Environment Field Name mentah yang diperlukan. Jika pola ekspresi reguler null atau kosong, atau nilai lingkungan null, hasil lingkungan akhir adalah lingkungan default.
Waktu Tunggu Skrip (Detik)	Bilangan bulat	180	Ya	Batas waktu tunggu, dalam detik, untuk proses Python yang menjalankan skrip saat ini.
AWS Access Key ID	String	T/A	Benar	ID Kunci Akses AWS yang akan digunakan dalam integrasi.
AWS Secret Key	Sandi	T/A	Benar	Kunci Rahasia AWS yang akan digunakan dalam integrasi.
AWS Default Region	String	T/A	Benar	Region default AWS yang akan digunakan dalam integrasi, misalnya us-west-2.
Menemukan tingkat keparahan yang akan diserap	String	T/A	Tidak	Tingkat keparahan temuan yang akan diserap - High, Medium, atau Low. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma. Jika tidak ada yang ditentukan, konektor akan menyerap semua temuan, terlepas dari tingkat keparahannya.
Temuan maksimum yang akan diambil	Bilangan bulat	50	Tidak	Jumlah temuan yang akan diproses per satu iterasi konektor.
Ambil Jam Maksimum ke Belakang	Bilangan bulat	1	Tidak	Jumlah jam sebelum waktu saat ini untuk mengambil pemberitahuan. Parameter ini dapat berlaku untuk iterasi konektor awal setelah Anda mengaktifkan konektor untuk pertama kalinya, atau nilai pengganti untuk stempel waktu konektor yang sudah tidak berlaku.
Use whitelist as a blacklist	Kotak centang	Tidak dicentang	Ya	Jika dipilih, konektor akan menggunakan daftar dinamis sebagai daftar yang tidak diizinkan.
Alamat Server Proxy	String	T/A	Tidak	Alamat server proxy yang akan digunakan.
Nama Pengguna Proxy	String	T/A	Tidak	Nama pengguna proxy untuk melakukan autentikasi.
Sandi Proxy	Sandi	T/A	Tidak	Sandi proxy untuk melakukan autentikasi.

Aturan Konektor

Daftar yang tidak diizinkan dinonaktifkan secara default.

Konektor mendukung daftar dinamis yang hanya menyerap temuan dari jenis tertentu.

Konektor mendukung proxy.

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.