AWS S3

Versi integrasi: 4.0

Kasus Penggunaan

  1. Mengelola bucket
  2. Mendownload file dari bucket
  3. Mengupload file ke bucket

Mengonfigurasi Integrasi AWS S3 di Google Security Operations

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

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan 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.
ID Kunci Akses AWS String T/A Ya ID Kunci Akses AWS yang akan digunakan dalam integrasi.
Kunci Rahasia AWS Sandi T/A Ya Kunci Rahasia AWS yang akan digunakan dalam integrasi.
Region Default AWS String T/A Ya Region default AWS yang akan digunakan dalam integrasi, misalnya us-west-2.
Menjalankan dari Jarak Jauh Kotak centang Tidak dicentang Tidak Centang kolom untuk menjalankan integrasi yang dikonfigurasi dari jarak jauh. Setelah dicentang, opsi akan muncul untuk memilih pengguna jarak jauh (agen).

Tindakan

Ping

Deskripsi

Uji konektivitas ke AWS S3 dengan parameter yang diberikan di halaman konfigurasi integrasi di tab Google Security Operations Marketplace.

Kasus penggunaan

Uji Konektivitas.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika berhasil:

"Berhasil terhubung ke server AWS S3 dengan parameter koneksi yang diberikan!"

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika tidak berhasil:

"Gagal terhubung ke server AWS S3! Error adalah {0}".format(exception.stacktrace)

 Umum

Mencantumkan Bucket

Deskripsi

Mengambil daftar bucket dari AWS S3.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "Buckets": [
        {
            "CreationDate": %Y-%m-%dT%H:%M:%S,
            "Name": "testsiemplify"
        }
    ],
    "Owner": {
        "DisplayName": "lab_aws",
        "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
    },
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

If status code == 200 (is_success = true) "Successfully listed available buckets in AWS S3".

Jika kode status lainnya (is_success=false): "Tindakan tidak dapat mencantumkan bucket yang tersedia di AWS S3.

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau lainnya: "Error saat menjalankan tindakan "List Buckets". Alasan: {0}''.format(error.Stacktrace)

 Umum

Mendapatkan Kebijakan Bucket

Deskripsi

Mengambil informasi tentang kebijakan bucket dari AWS S3.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Nama Bucket String T/A Ya Tentukan nama bucket yang akan digunakan untuk mengambil informasi kebijakan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "Policy": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "AddPerm",
                "Effect": "Allow",
                "Principal": "*",
                "Action": "s3:GetObject",
                "Resource": "arn:aws:s3:::testsiemplify/*"
            }
        ]
    }
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status == 200 (is_success = true) "Berhasil mengambil informasi tentang kebijakan bucket "{0}" di AWS S3".format(bucket_name)

Jika kode status lainnya (is_success=false): "Tindakan tidak dapat menampilkan informasi tentang kebijakan bucket '{0}' di AWS S3".format(bucket_name)

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau lainnya: "Error saat menjalankan tindakan "Get Bucket Policy". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menetapkan Kebijakan Bucket

Deskripsi

Tetapkan kebijakan di bucket dari AWS S3.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Nama Bucket String T/A Ya Tentukan nama bucket yang kebijakannya ingin Anda perbarui.
Objek JSON Kebijakan String T/A Ya Tentukan objek JSON kebijakan yang ingin Anda tetapkan untuk bucket. Contohnya dapat ditemukan di sini: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
bucket_policy = {
    'Version': '2012-10-17',
    'Statement': [{
        'Sid': 'AddPerm',
        'Effect': 'Allow',
        'Principal': '*',
        'Action': ['s3:GetObject'],
        'Resource': f'arn:aws:s3:::{bucket_name}/*'
    }]
}
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status == 204 (is_success = true) "Successfully updated policy of the "{0}" bucket in AWS S3".format(bucket_name)

Jika kode status lainnya (is_success=false): "Tindakan tidak dapat memperbarui kebijakan bucket '{0}' di AWS S3".format(bucket_name)

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Setel Kebijakan Bucket". Alasan: {0}''.format(error.Stacktrace)

Mencantumkan Objek Bucket

Deskripsi

Memungkinkan pengguna menonaktifkan akun pengguna. Isi permintaan berisi pengguna yang akan dinonaktifkan. Properti yang diaktifkan akun harus disetel ke false.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Nama Bucket String T/A Ya Tentukan nama bucket tempat mengambil objek.
Jumlah Maksimum Objek yang Akan Ditampilkan Bilangan bulat T/A Tidak Tentukan jumlah objek yang akan ditampilkan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
"Contents": [
        {
            "Key": "text.txt",
            "LastModified": %Y-%m-%dT%H:%M:%S,
            "ETag": "d41d8cd98f00b204e9800998ecf8427e",
            "Size": 0,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "lab_aws",
                "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
            }
        },
        {
            "Key": "text_1.txt",
            "LastModified": %Y-%m-%dT%H:%M:%S,
            "ETag": "d41d8cd98f00b204e9800998ecf8427e",
            "Size": 0,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "lab_aws",
                "ID": "935dc3fed0e1d2c5b12242cf9927370824f2438681a2d3c0523f254dbde41aba"
            }
        }
    ]
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status == 200 (is_success = true) "Berhasil menampilkan objek bucket "{0}" di AWS S3".format(bucket_name)

Jika kode status lainnya (is_success=false): "Tindakan tidak dapat menampilkan objek bucket '{0}' di AWS S3".format(bucket_name)

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "List Bucket Objects". Alasan: {0}''.format(error.Stacktrace)

 Umum
Tabel Repositori Kasus

Nama Tabel: Objek Bucket '{0}'

Kolom:

  • Kunci (dipetakan sebagai Kunci)
  • Terakhir Diubah (dipetakan sebagai LastModified)
  • Ukuran (Byte) (dipetakan sebagai Ukuran)
  • Pemilik (dipetakan sebagai Owner/DisplayName)
  • Kelas Penyimpanan (dipetakan sebagai Kelas Penyimpanan)
 Umum

Download File Dari Bucket

Deskripsi

Download file dari bucket di AWS S3.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Jalur File Bucket String s3://{bucket_name}/{file_name} Ya Tentukan jalur ke file dalam bucket. Contoh: s3://siemplify/syslog/log.txt
Jalur Download String T/A Ya Tentukan jalur tempat file akan didownload.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
"bucket_file_path": "s3://testsiemplify/test/123.txt"
"download_path": "/usr/bin/share/download.txt"
}

Repositori Kasus

Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status == 200 (is_success = true) "Berhasil mendownload '{0}' dari AWS S3".format(bucket_file_path)

Jika kode status lainnya (is_success=false): "Tindakan tidak dapat mendownload '{0}' dari AWS S3. Alasan: file dengan jalur download tersebut sudah ada."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, error SDK, lainnya: "Error saat menjalankan tindakan "Download File From Bucket". Alasan: {0}''.format(error.Stacktrace)

 Umum

Mengupload File Ke Bucket

Deskripsi

Mengupload file ke bucket di AWS S3.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Jalur File String T/A Ya Tentukan jalur ke file yang perlu diupload.
Jalur Upload Bucket String s3://{bucket_name}/{file_name} Ya Tentukan jalur dalam bucket tempat jalur harus diupload. Contoh: s3://siemplify/syslog/log.txt

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
"bucket_upload_path": "s3://testsiemplify/test/123.txt"
"file_path": "/usr/bin/share/download.txt"
}
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status == 200 (is_success = true) "Berhasil mengupload '{0}' ke bucket AWS S3 {1}".format(file_path, bucket name aka first string after s3://)

Jika file tidak ada (is_success = false) "Tindakan tidak dapat mengupload '{0}' ke AWS S3. Alasan: file dengan jalur upload tersebut tidak ada."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, error SDK, lainnya: "Error saat menjalankan tindakan "Upload File Ke Bucket". Alasan: {0}''.format(error.Stacktrace)

 Umum

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