Mengintegrasikan Amazon EC2 dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan AWS Elastic Compute Cloud (Amazon EC2) dengan Google Security Operations.

Kasus penggunaan

  1. Mengamankan instance Amazon Elastic Compute Cloud (Amazon EC2)

    1. Membuat grup keamanan untuk membatasi akses internet masuk dan keluar ke Amazon EC2.
    2. Mengalokasikan alamat IP Elastis baru
    3. Mengaitkan alamat IP Elastis baru

  2. Pengelolaan resource - menggunakan tag kustom instance untuk melacak dan mengidentifikasi resource AWS.

Sebelum memulai

Sebelum mengonfigurasi integrasi AWS Elastic Compute Cloud (EC2) di Google SecOps, pastikan lingkungan jaringan dan kredensial AWS Anda memenuhi semua prasyarat operasional.

Untuk menyiapkan lingkungan Anda untuk integrasi, pastikan Anda menyelesaikan hal berikut:

  1. Verifikasi visibilitas jaringan antara Google SecOps dan endpoint layanan regional AWS EC2.

  2. Dapatkan kredensial API terprogram AWS (ID Kunci Akses dan Kunci Akses Rahasia) dengan izin IAM yang sesuai.

  3. Konfigurasikan dan uji instance integrasi dalam Google SecOps.

Persyaratan jaringan

Google SecOps berkomunikasi langsung dengan layanan AWS EC2 menggunakan REST API HTTPS dan AWS Python SDK (boto3).

Pastikan lingkungan jaringan Anda memenuhi aturan konektivitas berikut:

  • Akses HTTPS keluar: Aktifkan komunikasi HTTPS keluar dari instance Google SecOps atau Agen Jarak Jauh Anda ke endpoint regional AWS EC2 (ec2.<region>.amazonaws.com) melalui port 443/TCP.

    Untuk mengetahui informasi selengkapnya, lihat Endpoint Layanan AWS dalam dokumentasi AWS.

  • Konfigurasi proxy: Jika organisasi Anda merutekan traffic keluar melalui proxy HTTP/HTTPS, konfigurasikan variabel proxy lingkungan standar (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) di server Google SecOps atau host Agen Jarak Jauh.

Autentikasi dan kredensial

Integrasi AWS EC2 memerlukan kredensial API terprogram untuk mengautentikasi permintaan menggunakan AWS Signature Version 4.

Pastikan lingkungan AWS Anda memenuhi persyaratan autentikasi berikut:

  • Kredensial terprogram: Dapatkan ID Kunci Akses AWS dan Kunci Rahasia AWS yang valid yang terkait dengan pengguna atau peran AWS IAM.

    Untuk mengetahui informasi tentang cara membuat identitas IAM dan membuat kredensial, lihat Mengelola kunci akses untuk pengguna IAM dan Identitas IAM dalam dokumentasi AWS.

  • Hak istimewa terendah: Batasi izin hanya untuk tindakan dan resource komputasi yang diperlukan untuk alur kerja otomatis Anda, dan rotasikan kredensial secara berkala.

    Untuk mengetahui detail tentang rekomendasi keamanan, lihat Praktik terbaik keamanan di IAM dalam dokumentasi AWS.

Mengonfigurasi izin tindakan

Berikan izin khusus yang diperlukan untuk tindakan yang dijalankan oleh playbook Google SecOps Anda kepada identitas AWS IAM yang melakukan autentikasi.

Lihat izin minimal untuk tindakan AWS Elastic Compute Cloud (EC2) dalam tabel berikut:

Nama Tindakan Izin IAM AWS yang Diperlukan (ActionName:Permission) Izin Prasyarat Deskripsi/Cakupan Resource
Mengizinkan Egress Grup Keamanan ec2:AuthorizeSecurityGroupEgress ec2:DescribeRegions Menambahkan aturan keluar ke grup keamanan EC2. Resource: ARN grup keamanan target.
Mengizinkan Ingress Grup Keamanan ec2:AuthorizeSecurityGroupIngress ec2:DescribeRegions Menambahkan aturan masuk ke grup keamanan EC2. Resource: ARN grup keamanan target.
Membuat Tag ec2:CreateTags ec2:DescribeRegions Menambahkan atau menimpa tag pada resource EC2. Resource: ARN resource EC2 target.
Mencantumkan Instance ec2:DescribeInstances ec2:DescribeRegions Mengambil status dan metadata untuk instance EC2. Resource: *.
Mencantumkan Grup Keamanan ec2:DescribeSecurityGroups — Mengambil konfigurasi dan aturan grup keamanan. Resource: *.
Ping ec2:DescribeRegions — Memvalidasi konektivitas integrasi. Resource: *.
Mencabut Egress Grup Keamanan ec2:RevokeSecurityGroupEgress ec2:DescribeRegions Menghapus aturan keluar dari grup keamanan EC2. Resource: ARN grup keamanan target.
Mencabut Ingress Grup Keamanan ec2:RevokeSecurityGroupIngress ec2:DescribeRegions Menghapus aturan masuk dari grup keamanan EC2. Resource: ARN grup keamanan target.
Memulai Instance ec2:StartInstances — Memulai instance EC2 yang dihentikan. Resource: ARN instance EC2 target.
Stop Instance ec2:StopInstances — Menghentikan instance EC2 yang sedang berjalan. Resource: ARN instance EC2 target.
Mengambil Snapshot ec2:CreateSnapshots ec2:DescribeRegions Membuat snapshot EBS point-in-time untuk volume instance. Resource: ARN instance dan volume.
Menghentikan Instance ec2:TerminateInstances — Menonaktifkan dan menghentikan instance EC2. Resource: ARN instance EC2 target.

Referensi cepat (ActionName:Permission)

Gunakan referensi cepat berikut untuk meninjau izin yang diperlukan untuk setiap tindakan:

Ping: ec2:DescribeRegions
Authorize Security Group Egress: ec2:AuthorizeSecurityGroupEgress, ec2:DescribeRegions
Authorize Security Group Ingress: ec2:AuthorizeSecurityGroupIngress, ec2:DescribeRegions
Create Tags: ec2:CreateTags, ec2:DescribeRegions
List Instances: ec2:DescribeInstances, ec2:DescribeRegions
List Security Groups: ec2:DescribeSecurityGroups
Revoke Security Group Egress: ec2:RevokeSecurityGroupEgress, ec2:DescribeRegions
Revoke Security Group Ingress: ec2:RevokeSecurityGroupIngress, ec2:DescribeRegions
Start Instance: ec2:StartInstances
Stop Instance: ec2:StopInstances
Take Snapshot: ec2:CreateSnapshots, ec2:DescribeRegions
Terminate Instance: ec2:TerminateInstances

Contoh kebijakan IAM (hak istimewa terendah)

Contoh kebijakan berikut menunjukkan izin yang diperlukan untuk menjalankan semua tindakan AWS EC2 di Google SecOps.

Untuk mengetahui petunjuk tentang cara membuat dan melampirkan kebijakan IAM, lihat Membuat kebijakan IAM dalam dokumentasi AWS.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "SecOpsEC2Discovery",
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeRegions",
        "ec2:DescribeInstances",
        "ec2:DescribeSecurityGroups"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SecOpsEC2InstanceRemediation",
      "Effect": "Allow",
      "Action": [
        "ec2:StartInstances",
        "ec2:StopInstances",
        "ec2:TerminateInstances",
        "ec2:CreateTags",
        "ec2:CreateSnapshots"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SecOpsEC2SecurityGroupManagement",
      "Effect": "Allow",
      "Action": [
        "ec2:AuthorizeSecurityGroupIngress",
        "ec2:RevokeSecurityGroupIngress",
        "ec2:AuthorizeSecurityGroupEgress",
        "ec2:RevokeSecurityGroupEgress"
      ],
      "Resource": "arn:aws:ec2:*:*:security-group/*"
    }
  ]
}

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
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-2.

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.

Mengizinkan Egress Grup Keamanan

Menambahkan aturan egress yang ditentukan ke grup keamanan untuk digunakan dengan VPC. Aturan keluar mengizinkan instance mengirim traffic ke rentang alamat CIDR IPv4 atau IPv6 yang ditentukan. Perubahan aturan diterapkan ke instance yang terpengaruh secepat mungkin. Namun, mungkin akan terjadi sedikit keterlambatan.

Untuk mengetahui informasi selengkapnya tentang batas grup keamanan VPC, lihat Batas Amazon VPC.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Grup Keamanan String T/A Ya

Satu atau beberapa ID grup keamanan. Dipisahkan dengan koma.

Note for dev: every ID in a separate request
Protokol IP DDL semua Tidak

Nama protokol IP. Gunakan 'all' untuk menentukan semua protokol. Menentukan 'all' akan mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.

Nilai yang mungkin: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code
Dari Port Bilangan bulat Tidak Awal rentang port untuk protokol TCP dan UDP, atau nomor jenis ICMP.
Ke Port Bilangan bulat Tidak Akhir rentang port untuk protokol TCP dan UDP mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.
Rentang IP - CidrIP String T/A Tidak Rentang CIDR IPv4. Untuk menentukan satu alamat IPv4, gunakan panjang awalan /32.
IPv6 Ranges - CidrIP String T/A Tidak Rentang CIDR IPv6. Untuk menentukan satu alamat IPv6, gunakan panjang awalan /128.

Dijalankan Pada

Tindakan ini tidak berjalan 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 menambahkan aturan egress yang ditentukan ke setidaknya satu (atau semua) grup keamanan: (is_success = true): "Successfully added the specified egress rule to the following security groups: {group_ids}"

jika gagal menambahkan aturan egress yang ditentukan karena error aturan izin (port tidak valid,dll.): (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Alasan: Set Izin IP tidak valid. Untuk mengetahui detail selengkapnya, periksa log."

jika gagal menambahkan aturan egress yang ditentukan karena ID grup keamanan tidak valid: (is_success = false): "Failed to add the specified egress rule to the following security groups: {group_ids}. Alasan: ID Grup Keamanan yang diberikan tidak valid. Untuk mengetahui detail selengkapnya, periksa log.``

Jika gagal menambahkan aturan traffic keluar yang ditentukan ke semua grup: is_success=false

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Authorize Security Group Egress". Reason: {0}''.format(error.Stacktrace)

 Umum

Mengizinkan Ingress Grup Keamanan

Menambahkan aturan ingress yang ditentukan ke grup keamanan. Aturan masuk mengizinkan instance menerima traffic dari rentang alamat CIDR IPv4 atau IPv6 yang ditentukan. Perubahan aturan diterapkan ke instance yang terpengaruh secepat mungkin. Namun, mungkin akan terjadi sedikit keterlambatan.

Untuk mengetahui informasi selengkapnya tentang batas grup keamanan VPC, lihat Batas Amazon VPC.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Grup Keamanan String T/A Ya

Satu atau beberapa ID grup keamanan. Dipisahkan dengan koma.

Note for dev: every ID in a separate request
Protokol IP DDL semua Tidak

Nama protokol IP. Gunakan 'all' untuk menentukan semua protokol. Menentukan 'all' akan mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.

Nilai yang mungkin: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code
Dari Port Bilangan bulat Tidak Awal rentang port untuk protokol TCP dan UDP, atau nomor jenis ICMP.
Ke Port Bilangan bulat Tidak Akhir rentang port untuk protokol TCP dan UDP mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.
Rentang IP - CidrIP String T/A Tidak Alamat IPv4 dalam format CIDR. Untuk menentukan satu alamat IPv4, gunakan panjang awalan /32.
IPv6 Ranges - CidrIP String T/A Tidak Rentang CIDR IPv6. Untuk menentukan satu alamat IPv6, gunakan panjang awalan /128.

Dijalankan Pada

Tindakan ini tidak berjalan 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:

if successfully added the specified ingress rules to at least one security groups: (if all were successfully updated - is_success = true): "Successfully added the specified ingress rule to the following security groups: {group_ids}"

jika gagal menambahkan aturan ingress yang ditentukan karena error aturan izin (port tidak valid,dll.): (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Alasan: Set Izin IP tidak valid. Untuk mengetahui detail selengkapnya, periksa log."

jika gagal menambahkan aturan ingress yang ditentukan karena ID grup keamanan tidak valid: (is_success =false): "Failed to add the specified ingress rule to the following security groups: {group_ids}. Alasan: ID Grup Keamanan yang diberikan tidak valid. Untuk mengetahui detail selengkapnya, periksa log.``

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Authorize Security Group Ingress". Reason: {0}''.format(error.Stacktrace)

 Umum

Membuat Tag

Tag adalah label yang Anda tetapkan ke resource AWS. Setiap tag terdiri dari kunci dan nilai opsional. Anda dapat menggunakan tag untuk menelusuri dan memfilter resource atau melacak biaya AWS. Hanya menambahkan atau menimpa tag yang ditentukan untuk resource Amazon EC2 yang ditentukan. Saat Anda menentukan kunci tag yang ada, nilainya akan ditimpa dengan nilai baru. Setiap resource dapat memiliki maksimum 50 tag. Kunci tag harus unik per resource.

Untuk mengetahui informasi selengkapnya tentang tag, lihat Memberi Tag pada Resource Anda di Panduan Pengguna Amazon Elastic Compute Cloud.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID resource String T/A Ya Satu atau beberapa ID resource. Dipisahkan dengan koma.
Tag String T/A Ya

Kombinasi nilai kunci tag yang akan ditetapkan ke resource. Misalnya, untuk menambahkan tag dengan kunci Owner dan nilai TeamA ke semua resource yang ditentukan, tentukan Owner:TeamA. Anda dapat menentukan beberapa kombinasi nilai kunci dengan memisahkannya menggunakan koma.

Anda dapat menambahkan atau menimpa tag yang ditentukan. Kunci tag harus unik per resource.

Dijalankan Pada

Tindakan ini tidak berjalan 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: "Successfully added {tags_list} tags to the following resources: "resource_ids"

Untuk ID resource yang tidak valid (is_success = false): "Failed to add {tag_list} tags to the following resources: {resource_ids}. Alasan: ID resource tidak valid

Jika resource memiliki lebih dari 50 tag (is_success = false): "Failed to add {tag_list} tags to the following resources: {resource_ids}. Alasan: resource dapat memiliki maksimal 50 tag.

Jika kunci tag tidak unik: (is_success = false): "Failed to add {tag_list} tags to the following resources: {resource_ids}. Alasan: Kunci tag harus unik per resource.

Jika tag yang diberikan dalam format yang tidak valid (artinya hanya kunci atau hanya nilai tanpa struktur lengkap kunci:nilai) (is_success = false): "Failed to add {invalid_tags} tags to the following resources: {ids}. Alasan: Format tidak valid. Tag harus menyertakan kunci dan nilai.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Create Tags". Reason: {0}''.format(error.Stacktrace)

 Umum

Mencantumkan Instance

Menjelaskan instance yang ditentukan atau semua instance.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Instance String T/A Tidak Satu atau beberapa ID instance. Tentukan ID instance, output hanya menyertakan informasi untuk instance yang ditentukan. Parameter ini tidak dapat digunakan dengan parameter 'Hasil Maksimal'. 'ID Instance' memiliki prioritas lebih tinggi daripada parameter 'Hasil Maksimum'.
Filter Tag String T/A Tidak Kombinasi kunci/nilai tag yang ditetapkan ke resource. Misalnya, untuk menemukan semua resource yang memiliki tag dengan kunci Owner dan nilai TeamA, tentukan Owner:TeamA. Filter tag yang dipisahkan koma. Contoh: Name:Name1,Owner:TeamA. Instance yang ditampilkan akan disesuaikan dengan semua filter.
Hasil Maksimal Bilangan bulat 50 Tidak Tentukan jumlah instance yang akan ditampilkan. Default-nya adalah 50. Jumlah maksimum adalah 1000. Parameter 'Instance IDs' tidak dapat digunakan dengan parameter 'Max Results'. 'ID Instance' memiliki prioritas lebih tinggi daripada parameter 'Hasil Maksimum'.

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
"EC2_Instances": [
    {
   "AmiLaunchIndex":0,
   "ImageId":"ami-047a51fa27710816e",
   "InstanceId":"i-044c08c5bfe1a7f98",
   "InstanceType":"t2.micro",
   "KeyName":"\"Key\": \"Test\", \"Value\":\"Test\"",
   "LaunchTime":"2021-1-30",
   "Monitoring":{
      "State":"disabled"
   },
   "Placement":{
      "AvailabilityZone":"us-east-1d",
      "GroupName":"",
      "Tenancy":"default"
   },
   "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
   "PrivateIpAddress":"192.0.2.220",
   "ProductCodes":[

   ],
   "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
   "PublicIpAddress":"192.0.2.218",
   "State":{
      "Code":16,
      "Name":"running"
   },
   "StateTransitionReason":"",
   "SubnetId":"subnet-1b1fda3a",
   "VpcId":"vpc-ID",
   "Architecture":"x86_64",
   "BlockDeviceMappings":[
      {
         "DeviceName":"/dev/xvda",
         "Ebs":{
            "AttachTime":"2021-1-30",
            "DeleteOnTermination":true,
            "Status":"attached",
            "VolumeId":"vol-00f70681a43e5d86e"
         }
      }
   ],
   "ClientToken":"",
   "EbsOptimized":false,
   "EnaSupport":true,
   "Hypervisor":"xen",
   "NetworkInterfaces":[
      {
         "Association":{
            "IpOwnerId":"amazon",
            "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
            "PublicIp":"192.0.2.218"
         },
         "Attachment":{
            "AttachTime":"",
            "AttachmentId":"eni-attach-06bc5e5901ce99ef2",
            "DeleteOnTermination":true,
            "DeviceIndex":0,
            "Status":"attached",
            "NetworkCardIndex":0
         },
         "Description":"",
         "Groups":[
            {
               "GroupName":"launch-wizard-2",
               "GroupId":"sg-001700ccddac4189a"
            }
         ],
         "Ipv6Addresses":[

         ],
         "MacAddress":"12:34:56:ab:cd:ef",
         "NetworkInterfaceId":"eni-020fa83efd417e32d",
         "OwnerId":"ID",
         "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
         "PrivateIpAddress":"192.0.2.220",
         "PrivateIpAddresses":[
            {
               "Association":{
                  "IpOwnerId":"amazon",
                  "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
                  "PublicIp":"192.0.2.218"
               },
               "Primary":true,
               "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
               "PrivateIpAddress":"192.0.2.220"
            }
         ],
         "SourceDestCheck":true,
         "Status":"in-use",
         "SubnetId":"subnet-1b1fda3a",
         "VpcId":"vpc-ID",
         "InterfaceType":"interface"
      }
   ],
   "RootDeviceName":"/dev/xvda",
   "RootDeviceType":"ebs",
   "SecurityGroups":[
      {
         "GroupName":"launch-wizard-2",
         "GroupId":"sg-001700ccddac4189a"
      }
   ],
   "SourceDestCheck":true,
   "Tags":[
      {
         "Key":"Owner",
         "Value":"Example"
      },
      {
         "Key":"Name",
         "Value":"Example test"
      }
   ],
   "VirtualizationType":"hvm",
   "CpuOptions":{
      "CoreCount":1,
      "ThreadsPerCore":1
   },
   "CapacityReservationSpecification":{
      "CapacityReservationPreference":"open"
   },
   "HibernationOptions":{
      "Configured":false
   },
   "MetadataOptions":{
      "State":"applied",
      "HttpTokens":"optional",
      "HttpPutResponseHopLimit":1,
      "HttpEndpoint":"enabled"
   },
   "EnclaveOptions":{
      "Enabled":false
   }
}
 ]
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika instance berhasil dicantumkan(is_success = true): "Successfully described Amazon EC2 instances."
  • Jika tidak ada nilai yang tersedia(is_success = false): "No instances were found in Amazon EC2"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, ID instance tidak valid, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "List Instances". Reason: {0}''.format(error.Stacktrace)

 Umum
Tabel Repositori Kasus

Nama Tabel: Instance Amazon EC2

Kolom Tabel:

ID

Negara bagian/Provinsi

Jenis

Zona Ketersediaan

DNS IPv4 Publik

Alamat IPv4 publik

Pemantauan

Nama grup keamanan

Nama kunci

Waktu peluncuran

Mencantumkan Grup Keamanan

Menjelaskan grup keamanan yang ditentukan atau semua grup keamanan Anda. Grup keamanan digunakan dengan instance di platform EC2-Classic atau di VPC tertentu.

Untuk mengetahui informasi selengkapnya, lihat Grup Keamanan Amazon EC2.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Nama Grup Keamanan String T/A Salah Satu atau beberapa Nama grup keamanan [khusus EC2-Classic dan VPC default]. Dipisahkan dengan koma.Jika Anda menentukan Nama grup keamanan, output hanya akan menyertakan informasi untuk nama yang ditentukan.
ID Grup Keamanan String T/A Salah Satu atau beberapa ID grup keamanan. Dipisahkan dengan koma.Jika Anda menentukan ID grup keamanan, output hanya akan menyertakan informasi untuk ID yang ditentukan. Diperlukan untuk grup keamanan di VPC non-default.
Filter Tag String T/A Salah

Kombinasi nilai kunci dari tag yang ditetapkan ke grup keamanan. Misalnya, untuk menemukan semua grup dengan tag yang menyertakan kunci Owner dan nilai TeamA, masukkan Owner:TeamA. Anda dapat menggunakan filter tag yang dipisahkan koma, seperti Name:Name1,Owner:TeamA. Grup yang ditampilkan harus cocok dengan semua filter.
Hasil Maksimal Bilangan bulat 50 Salah Jumlah grup keamanan yang akan ditampilkan. Nilai defaultnya adalah 50. Nilai maksimumnya adalah 1000. Catatan: Parameter 'Security Group IDs' dan 'Security Group Names' tidak dapat digunakan dengan parameter 'Max Results'.

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
"EC2_Security_Groups": [
{
   "Description":"launch-wizard-2 created 2021-01-30T19:37:11.523+02:00",
   "GroupName":"launch-wizard-2",
   "IpPermissions":[
      {
         "FromPort":22,
         "IpProtocol":"tcp",
         "IpRanges":[
            {
               "CidrIp":"192.0.2.0/0"
            }
         ],
         "Ipv6Ranges":[

         ],
         "PrefixListIds":[

         ],
         "ToPort":22,
         "UserIdGroupPairs":[

         ]
      }
   ],
   "OwnerId":"582302349248",
   "GroupId":"sg-001700ccddac4189a",
   "IpPermissionsEgress":[
      {
         "IpProtocol":"-1",
         "IpRanges":[
            {
               "CidrIp":"192.0.2.0/0"
            }
         ],
         "Ipv6Ranges":[

         ],
         "PrefixListIds":[

         ],
         "UserIdGroupPairs":[

         ]
      }
   ],
   "Tags":[
      {
         "Key":"Team",
         "Value":"A-Team"
      },
      {
         "Key":"Owner",
         "Value":"Example"
      }
   ],
   "VpcId":"vpc-ID"
}
]
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika grup berhasil dicantumkan(is_success = true): "Successfully described Amazon EC2 security groups."
  • Jika tidak ada nilai yang tersedia(is_success = false): "No security groups were found in Amazon EC2"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, ID/Nama grup tidak valid, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "List Security Groups". Reason: {0}''.format(error.Stacktrace)

 Umum
Tabel Repositori Kasus

Nama Tabel: Instance Amazon EC2

Kolom Tabel:

ID grup keamanan

Nama grup keamanan

ID VPC

Deskripsi

ID Pemilik

Ping

Uji konektivitas ke AWS EC2.

Parameter

T/A

Dijalankan Pada

Tindakan ini tidak berjalan 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: "Successfully connected to the Amazon EC2 with the provided connection parameters!"

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika tidak berhasil: "Failed to connect to the Amazon EC2 server! Error is {0}".format(exception.stacktrace)

 Umum

Mencabut Egress Grup Keamanan

Menghapus aturan egress (aturan outbound) yang ditentukan dari grup keamanan untuk EC2-VPC. Tindakan ini tidak berlaku untuk grup keamanan yang digunakan di EC2-Classic. Untuk menghapus aturan, nilai yang Anda tentukan (misalnya, port) harus sama persis dengan nilai aturan yang ada. Perubahan aturan diterapkan ke instance dalam grup keamanan secepat mungkin. Namun, mungkin akan terjadi sedikit penundaan.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Grup Keamanan String T/A Ya

Satu atau beberapa ID grup keamanan. Dipisahkan dengan koma.

Note for dev: every ID in a separate request
Protokol IP DDL semua Tidak

Nama protokol IP. Gunakan 'all' untuk menentukan semua protokol. Menentukan 'all' akan mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.

Nilai yang mungkin: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code
Dari Port Bilangan bulat Tidak Awal rentang port untuk protokol TCP dan UDP, atau nomor jenis ICMP.
Ke Port Bilangan bulat Tidak Akhir rentang port untuk protokol TCP dan UDP mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.
Rentang IP - CidrIP String T/A Tidak Alamat IPv4 dalam format CIDR. Untuk menentukan satu alamat IPv4, gunakan panjang awalan /32.
IPv6 Ranges - CidrIP String T/A Tidak Rentang CIDR IPv6. Untuk menentukan satu alamat IPv6, gunakan panjang awalan /128.

Dijalankan Pada

Tindakan ini tidak berjalan 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 mencabut aturan egress yang ditentukan dari setidaknya satu (atau semua) grup keamanan: (is_success = true): "Successfully revoked the specified egress rule from the following security groups: {group_ids}"

jika gagal mencabut aturan egress yang ditentukan karena error aturan izin (port tidak valid seperti 205,dll.): (is_success =false): "Failed to revoke the specified egress rule from the following security groups: {group_ids}. Alasan: Set Izin IP tidak valid. Untuk mengetahui detail selengkapnya, periksa log."

if failed to revoke the specified egress rules because of invalid security group id: (is_success =false): "Failed to revoke the specified egress rule from the following security groups: {group_ids}. Alasan: ID Grup Keamanan yang diberikan tidak valid. Untuk mengetahui detail selengkapnya, periksa log.``

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Revoke Security Group Egress". Reason: {0}''.format(error.Stacktrace)

 Gener

Mencabut Akses Masuk Grup Keamanan

Menghapus aturan ingress (aturan masuk) yang ditentukan dari grup keamanan. Untuk menghapus aturan, nilai yang Anda tentukan (misalnya, port) harus sama persis dengan nilai aturan yang ada. Perubahan aturan diterapkan ke instance dalam grup keamanan secepat mungkin. Namun, mungkin akan terjadi sedikit keterlambatan.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Grup Keamanan String T/A Ya

Satu atau beberapa ID grup keamanan. Dipisahkan dengan koma.

Note for dev: every ID in a separate request
Protokol IP DDL semua Tidak

Nama protokol IP. Gunakan 'all' untuk menentukan semua protokol. Menentukan 'all' akan mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.

Nilai yang mungkin: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code
Dari Port Bilangan bulat Tidak Awal rentang port untuk protokol TCP dan UDP, atau nomor jenis ICMP.
Ke Port Bilangan bulat Tidak Akhir rentang port untuk protokol TCP dan UDP mengizinkan traffic di semua port, terlepas dari rentang port yang Anda tentukan.
Rentang IP - CidrIP String T/A Tidak Alamat IPv4 dalam format CIDR. Untuk menentukan satu alamat IPv4, gunakan panjang awalan /32.
IPv6 Ranges - CidrIP String T/A Tidak Rentang CIDR IPv6. Untuk menentukan satu alamat IPv6, gunakan panjang awalan /128.

Dijalankan Pada

Tindakan ini tidak berjalan 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:

if successfully revoked the specified ingress rules to at least one (or all) security groups: (is_success = true): "Successfully revoked the specified ingress rule from the following security groups: {group_ids}"

if failed to revoke the specified ingress rules because of permissions rule error (invalid port as 205,etc): (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Alasan: Set Izin IP tidak valid. Untuk mengetahui detail selengkapnya, periksa log."

if failed to revoke the specified ingress rules because of invalid security group id: (is_success =false): "Failed to revoke the specified ingress rule from the following security groups: {group_ids}. Alasan: ID Grup Keamanan yang diberikan tidak valid. Untuk mengetahui detail selengkapnya, periksa log.``

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Revoke Security Group Ingress". Reason: {0}''.format(error.Stacktrace)

 Umum

Memulai Instance

Memulai instance yang didukung Amazon Elastic Block Store (Amazon EBS) yang sebelumnya telah Anda hentikan. Mungkin diperlukan waktu beberapa menit hingga instance memasuki status berjalan. Perhatikan bahwa Anda tidak dapat memulai instance yang didukung penyimpanan instance. Untuk mengetahui informasi selengkapnya tentang instance yang didukung penyimpanan instance, lihat Penyimpanan untuk perangkat root.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Instance String T/A Ya Satu atau beberapa ID instance. Dipisahkan koma

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
[
  {
      "CurrentState": "pending",
        "InstanceId": "string",
        "PreviousState":"stopped"
    }
]
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika status saat ini dari semua/beberapa instance berbeda dari: pending, running: ( Is_success = false): Can not start the following instances from their current state: <failed_instance ids>
  • Jika status saat ini tertunda → tindakan masih dalam proses: Melanjutkan….instance yang diminta masih tertunda
  • Jika status saat ini adalah berjalan:(is_success=true: Cetak: Instance berikut berhasil dimulai : <running_instance ids>
  • Jika salah satu instance tidak valid (is_success =false): Instance berikut tidak valid: <not valid ids>. Coba lagi.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Start Instance". Reason: {0}''.format(error.Stacktrace)

 Umum

Menghentikan Instance

Menghentikan instance yang didukung Amazon EBS. Saat Anda menghentikan instance, sistem akan mencoba mematikannya secara paksa setelah penundaan singkat. Butuh beberapa menit sampai instance berhenti. Anda dapat memulai ulang instance kapan saja. Anda tidak dapat menghentikan instance yang didukung penyimpanan instance; Anda harus menghentikannya. Untuk mengetahui informasi selengkapnya tentang instance yang didukung penyimpanan instance, lihat https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Instance String T/A Ya Daftar ID instance yang dipisahkan koma.
Force Bool T/A Tidak Jika dipilih, tindakan ini akan melakukan penonaktifan paksa (hard shutdown), yang langsung menghentikan instance tanpa membiarkannya mengosongkan cache sistem file atau metadata. Proses ini memerlukan prosedur pemeriksaan dan perbaikan sistem file wajib sebelum instance dapat melanjutkan operasi. Tidak direkomendasikan untuk instance Windows.

Tidak diaktifkan secara default.

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Ambil snapshot

Ambil snapshot instance.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID instance String T/A Ya Tentukan ID Instance.
Deskripsi String T/A Tidak Tentukan deskripsi snapshot.

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
  "EC2_Snapshot": [
    {
      "Description": "",
      "Tags": [],
      "Encrypted": false,
      "VolumeId": "vol-ID",
      "State": "pending",
      "VolumeSize": 8,
      "StartTime": "2022-11-13 15:45:44.795000+00:00",
      "Progress": "",
      "OwnerId": "OWNER_ID",
      "SnapshotId": "snap-ID"
    }
  ]
}

Menghentikan Instance

Menghentikan instance.

Instance yang dihentikan tidak dapat dimulai ulang. Hanya instance yang didukung penyimpanan instance yang dapat dihentikan. Untuk mengetahui informasi selengkapnya tentang instance yang didukung penyimpanan instance, lihat Penyimpanan untuk perangkat root.

Jika Anda menghentikan instance lebih dari sekali, setiap panggilan akan berhasil. Jika Anda menentukan beberapa instance dan permintaan gagal (misalnya, karena satu ID instance yang salah), tidak ada instance yang dihentikan.

Instance yang dihentikan tetap terlihat setelah penghentian (selama sekitar satu jam). Secara default, Amazon EC2 menghapus semua volume EBS yang terpasang saat instance diluncurkan. Volume yang dipasang setelah peluncuran instance akan terus berjalan. Untuk mengetahui informasi selengkapnya, lihat panduan pengguna Amazon.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
ID Instance String T/A Ya Satu atau beberapa ID instance. Dipisahkan dengan koma.

Dijalankan Pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama hasil skrip Opsi nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
"StoppingInstances": [
      {
      "CurrentState": "shutting-down",
        "InstanceId": "string",
        "PreviousState":"running"
      }
   ]
Repositori Kasus
Jenis Hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika status saat ini dari semua/beberapa instance berbeda dari: shutting-down, terminated: ( Is_success = false): Cannot terminate the following instances from their current state: <failed_instance ids>
  • Jika status saat ini adalah shutting-down: (is_success=true) → tindakan masih berlangsung: Melanjutkan….instance yang diminta masih dimatikan
  • Jika status saat ini dihentikan:(is_success=true): Instance berikut berhasil dihentikan : <stopped_instance ids>
  • Jika salah satu instance tidak valid (is_success =false): Instance berikut tidak valid: <not valid ids>. Coba lagi.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error executing action "Terminate Instance". Reason: {0}''.format(error.Stacktrace)

 Umum

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