Panggil API Security Center dengan Alibaba Cloud CLI - Security Center

Topik ini menjelaskan cara memanggil API Security Center menggunakan Alibaba Cloud CLI. Operasi DescribeCloudCenterInstances digunakan sebagai contoh untuk mengkueri informasi aset.

Latar Belakang

Alibaba Cloud CLI (Alibaba Cloud Command Line Interface) adalah alat baris perintah umum yang dibangun di atas OpenAPI. Anda dapat menggunakan Alibaba Cloud CLI untuk mengotomatiskan pengelolaan dan pemeliharaan Security Center. Untuk informasi selengkapnya, lihat Apa itu Alibaba Cloud CLI.
Alibaba Cloud CLI tidak mendukung pemanggilan Security Center (Threat Analysis) dan Security Center (SOAR). Untuk meminta dukungan ini, kirimkan tiket.

Langkah 1: Instal Alibaba Cloud CLI

Sebelum menggunakan Alibaba Cloud CLI, lakukan instalasi terlebih dahulu. Alibaba Cloud CLI mendukung Windows, Linux, dan macOS. Pilih metode instalasi sesuai sistem operasi Anda.

Windows: Instal Alibaba Cloud CLI di Windows.
Linux: Instal, perbarui, dan uninstal Alibaba Cloud CLI.
macOS: Instal Alibaba Cloud CLI di macOS.

Anda juga dapat melakukan debugging perintah Alibaba Cloud CLI di Cloud Shell. Cloud Shell telah dilengkapi Alibaba Cloud CLI yang pra-instal dan secara berkala memperbarui versi perangkat lunaknya. Untuk informasi selengkapnya, lihat Apa itu Cloud Shell.

Langkah 2: Konfigurasi Alibaba Cloud CLI

Penting

Akun Alibaba Cloud (akun root) memiliki izin akses dan manajemen penuh atas semua operasi OpenAPI, yang menimbulkan risiko keamanan tinggi. Kami menyarankan Anda membuat RAM user, memberikan izin berdasarkan prinsip least privilege, dan menggunakan RAM user tersebut untuk mengakses OpenAPI. Untuk kebijakan izin yang didukung oleh Security Center, lihat Referensi kebijakan akses sistem Security Center dan Kebijakan kustom untuk Security Center.

Sebelum menggunakan Alibaba Cloud CLI, konfigurasikan kredensial identitas dan ID wilayah. Alibaba Cloud CLI mendukung berbagai jenis kredensial identitas. Untuk informasi selengkapnya, lihat Konfigurasi dan kelola kredensial. Anda dapat mengonfigurasi kredensial identitas tipe AK menggunakan AccessKey dari RAM user. Ikuti langkah-langkah berikut:

Buat RAM user dan buat AccessKey untuk mengonfigurasi kredensial identitas. Untuk informasi selengkapnya, lihat Buat RAM user dan Buat AccessKey.
Berikan izin kepada RAM user tersebut. Contoh ini memerlukan izin akses read-only pada Security Center: AliyunYundunSASReadOnlyAccess. Untuk informasi selengkapnya, lihat Kelola izin RAM user.
Dapatkan ID wilayah yang tersedia untuk mengonfigurasi kredensial identitas. Alibaba Cloud CLI menggunakan wilayah yang ditentukan untuk memulai panggilan OpenAPI. Untuk daftar wilayah yang tersedia untuk Security Center, lihat Endpoints.
Catatan
Anda dapat menggunakan opsi --region untuk menentukan wilayah saat menjalankan perintah. Opsi ini menggantikan informasi wilayah dalam kredensial identitas default dan variabel lingkungan. Untuk informasi selengkapnya, lihat Opsi baris perintah.
Konfigurasikan kredensial tipe AK menggunakan AccessKey dari RAM user tersebut. Beri nama file konfigurasi AkProfile. Untuk informasi selengkapnya, lihat Konfigurasi dan kelola kredensial.

Langkah 3: Hasilkan contoh perintah CLI

Di portal OpenAPI, buka halaman debugging DescribeCloudCenterInstances.
Di bagian Parameters, tentukan parameter permintaan. Klik tab CLI Sample untuk melihat contoh CLI yang dihasilkan.
Salin contoh CLI atau jalankan di Cloud Shell:
- Klik Run Command untuk membuka Cloud Shell dan lakukan debugging perintah.
- Klik Copy untuk menyalin contoh CLI ke clipboard. Anda kemudian dapat menempelkannya ke alat shell lokal untuk dijalankan atau membuat skrip baris perintah.
Catatan
Saat menyalin contoh CLI ke alat shell lokal untuk debugging, perhatikan format parameternya. Untuk informasi selengkapnya tentang format parameter perintah CLI, lihat Memahami parameter perintah.
Portal OpenAPI secara default menambahkan opsi --region ke contoh yang dihasilkan. Saat Anda menyalin perintah tersebut untuk dijalankan secara lokal, Alibaba Cloud CLI akan mengabaikan informasi wilayah dalam kredensial identitas default dan variabel lingkungan, serta menggunakan wilayah yang ditentukan dalam opsi tersebut. Anda dapat menghapus atau mempertahankan opsi tersebut sesuai kebutuhan.

Langkah 4: Panggil Security Center OpenAPI

Contoh 1: Daftar operasi Security Center OpenAPI yang didukung oleh Alibaba Cloud CLI

Contoh berikut menunjukkan cara menggunakan opsi --help untuk mendaftar operasi OpenAPI Security Center yang didukung oleh Alibaba Cloud CLI. Untuk informasi selengkapnya, lihat Ikhtisar API.

Jalankan perintah berikut.
```
aliyun sas --help
```

Tanggapan contoh.

Product: Sas (Security Center)
Version: 2018-12-03
Available Api List:
    AddAssetSelectionCriteria          Adds assets to an asset selection operation.
    AddBaselineCheckWhiteRecord
    AddCheckInstanceResultWhiteList    Adds instances to the allowlist for a check item.
    AddCheckResultWhiteList            Adds a check item to the allowlist.
    AddClientUserDefineRule            Creates a user-defined defense rule.
    AddCloudVendorAccountAK
    AddContainerDefenseRule            Creates a non-image program defense rule.
    AddContainerPluginRule             Adds a container escape prevention rule.
    AddIdcProbe
    AddImageEventOperation             Adds an image alert handling rule.
    AddImageVulWhiteList               Adds an image vulnerability to the allowlist.
    AddInstallCode                     Creates an agent installation command.

Contoh 2: Kueri informasi aset

Contoh berikut menunjukkan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi DescribeCloudCenterInstances dari Security Center guna mengkueri informasi aset Elastic Compute Service (ECS) yang memiliki risiko.

Jalankan perintah berikut.

aliyun sas DescribeCloudCenterInstances --Criteria '[{"name":"riskStatus","value":"YES"}]' --MachineTypes ecs

Tanggapan contoh.

{
  "Success": true,
  "PageInfo": {
    "Count": 10,
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 10,
    "NextToken": "B604532DEF982B875E8360A6EFA3B***"
  },
  "RequestId": "7D6FD965-745C-5580-A3E8-83FEC3BE1FE8",
  "Instances": [
    {
      "AlarmStatus": "NO",
      "AssetType": "0",
      "AssetTypeName": "ECS Instance",
      "AuthVersionName": "Basic Edition",
      "Bind": false,
      "ClientStatus": "online",
      "Cores": 4,
      "CpuInfo": "Intel(R) Xeon(R) Platinum 8269CY CPU @ 2.50GHz",
      "ExposedStatus": 0,
      "Flag": 0,
      "FlagName": "ALIYUN",
      "GroupId": 1355****,
      "GroupTrace": "Ungrouped",
      "HcStatus": "YES",
      "HealthCheckCount": 0,
      "Importance": 1,
      "InstanceId": "i-bp1b84nxki0g2cyg****",
      "InstanceName": "example",
      "InternetIp": "",
      "IntranetIp": "172.16.****",
      "Ip": "172.16.****",
      "IpListString": "172.16.****",
      "Kernel": "5.10.134-16.3.al8.x86_64",
      "LastLoginTimestamp": 1729840886000,
      "MacListString": "00:16:3e:**:**:**",
      "Mem": 16384,
      "Os": "linux",
      "OsName": "Alibaba Cloud Linux 3.2104 LTS 64-bit",
      "Region": "cn-hangzhou-dg-a01",
      "RegionId": "cn-hangzhou",
      "RegionName": "China (Hangzhou)",
      "RiskCount": "{\"account\":0,\"agentlessAll\":0,\"agentlessBaseline\":0,\"agentlessMalicious\":0,\"agentlessSensitiveFile\":0,\"agentlessVulCve\":0,\"agentlessVulSca\":0,\"agentlessVulSys\":0,\"appNum\":0,\"asapVulCount\":0,\"baselineHigh\":0,\"baselineLow\":0,\"baselineMedium\":0,\"baselineNum\":1,\"cmsNum\":0,\"containerAsap\":0,\"containerLater\":0,\"containerNntf\":0,\"containerRemind\":0,\"containerSerious\":0,\"containerSuspicious\":0,\"cveNum\":4,\"emgNum\":0,\"health\":0,\"imageBaselineHigh\":0,\"imageBaselineLow\":0,\"imageBaselineMedium\":0,\"imageBaselineNum\":0,\"imageMaliciousFileRemind\":0,\"imageMaliciousFileSerious\":0,\"imageMaliciousFileSuspicious\":0,\"imageVulAsap\":0,\"imageVulLater\":0,\"imageVulNntf\":0,\"laterVulCount\":1,\"newSuspicious\":0,\"nntfVulCount\":3,\"remindNum\":0,\"scaNum\":0,\"seriousNum\":0,\"suspNum\":0,\"suspicious\":0,\"sysNum\":0,\"trojan\":0,\"uuid\":\"11c50347-4745-4a7a-b8dd-405f276201ff\",\"vul\":4,\"weakPWNum\":0}",
      "RiskStatus": "YES",
      "SafeEventCount": 0,
      "Status": "Running",
      "Uuid": "11c50347-4745-4a7a-b8dd-405f****",
      "Vendor": 0,
      "VendorName": "ALIYUN",
      "VpcInstanceId": "vpc-bp132a80775r3d7kz****",
      "VulCount": 4,
      "VulStatus": "YES"
    }
  ]
}

Catatan

Jika pemanggilan OpenAPI Security Center mengembalikan error, periksa parameter permintaan dan nilainya berdasarkan kode kesalahan.

Anda juga dapat mencatat RequestID atau pesan error SDK dari tanggapan dan menggunakan Alibaba Cloud OpenAPI Diagnostics untuk troubleshooting self-service.