Call Security Center APIs with Alibaba Cloud CLI - Security Center

Bu konu, Alibaba Cloud CLI kullanarak Security Center API'lerinin nasıl çağrılacağını açıklar. Varlık bilgilerini sorgulamak için örnek olarak DescribeCloudCenterInstances işlemi kullanılır.

Arka plan

Alibaba Cloud CLI (Alibaba Cloud Command Line Interface), OpenAPI üzerine inşa edilmiş genel amaçlı bir komut satırı aracıdır. Alibaba Cloud CLI'yı kullanarak Security Center hizmetinin yönetimini ve bakımını otomatikleştirebilirsiniz. Daha fazla bilgi için bkz. Alibaba Cloud CLI nedir.
Alibaba Cloud CLI, Security Center (Tehdit Analizi) ve Security Center (SOAR) hizmetlerinin API'lerini çağırmayı desteklemez. Bu desteği talep etmek için bir destek talebi oluşturun.

Adım 1: Alibaba Cloud CLI'yi yükleyin

Alibaba Cloud CLI'yı kullanmadan önce yazılımı yüklemeniz gerekir. Alibaba Cloud CLI; Windows, Linux ve macOS işletim sistemlerini destekler. İşletim sisteminize uygun yükleme yöntemini seçin.

Windows: Windows'ta Alibaba Cloud CLI'yi yükleme.
Linux: Alibaba Cloud CLI'yi yükleme, güncelleme ve kaldırma.
macOS: macOS'ta Alibaba Cloud CLI'yi yükleme.

Alternatif olarak, Alibaba Cloud CLI komutlarını Cloud Shell içinde hata ayıklayabilirsiniz. Cloud Shell üzerinde Alibaba Cloud CLI önceden yüklü gelir ve yazılım sürümü düzenli olarak güncellenir. Daha fazla bilgi için bkz. Cloud Shell nedir.

Adım 2: Alibaba Cloud CLI'yı yapılandırın

Önemli

Bir Alibaba Cloud hesabı (kök hesap), tüm OpenAPI işlemleri üzerinde tam yönetim ve erişim iznine sahiptir; bu durum yüksek güvenlik riskleri oluşturur. Bunun yerine bir RAM kullanıcısı oluşturmanızı, en az ayrıcalık ilkesine göre izinler atamanızı ve OpenAPI'ye erişmek için RAM kullanıcısını kullanmanızı öneririz. Security Center tarafından desteklenen izin ilkeleri için bkz. Security Center sistem erişim ilkesi referansı ve Security Center için özel ilkeler.

Alibaba Cloud CLI'yı kullanmadan önce kimlik bilgilerini ve bölge kimliğini yapılandırın. Alibaba Cloud CLI birden çok kimlik bilgisi türünü destekler. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma ve yönetme. Bir RAM kullanıcısının AccessKey bilgilerini kullanarak AK türünde bir kimlik bilgisi yapılandırabilirsiniz. Aşağıdaki adımları uygulayın:

Kimlik bilgilerini yapılandırmak üzere bir RAM kullanıcısı oluşturun ve bu kullanıcı için bir AccessKey oluşturun. Daha fazla bilgi için bkz. RAM kullanıcısı oluşturma ve AccessKey oluşturma.
RAM kullanıcısına izinler atayın. Bu örnekte Security Center hizmeti için salt okunur erişim izni (AliyunYundunSASReadOnlyAccess) gereklidir. Daha fazla bilgi için bkz. RAM kullanıcı izinlerini yönetme.
Kimlik bilgilerini yapılandırmak için kullanılabilir bir bölge kimliği edinin. Alibaba Cloud CLI, OpenAPI çağrılarını başlatmak için belirtilen bölgeyi kullanır. Security Center için kullanılabilir bölgeler hakkında bilgi edinmek için bkz. Uç noktalar.

Not
Bir komutu çalıştırırken --region seçeneğini kullanarak bir bölge belirtebilirsiniz. Bu seçenek, varsayılan kimlik bilgisindeki ve ortam değişkenlerindeki bölge bilgilerinin üzerine yazar. Daha fazla bilgi için bkz. Komut satırı seçenekleri.
RAM kullanıcısının AccessKey bilgilerini kullanarak AK türünde bir kimlik bilgisi yapılandırın. Yapılandırma dosyasına AkProfile adını verin. Daha fazla bilgi için bkz. Kimlik bilgilerini yapılandırma ve yönetme.

Adım 3: CLI komut örnekleri oluşturun

OpenAPI portalında DescribeCloudCenterInstances hata ayıklama sayfasına gidin.
Parameters bölümünde istek parametrelerini belirtin. Oluşturulan CLI örneğini görüntülemek için CLI Sample sekmesini tıklayın.
CLI örneğini kopyalayın veya Cloud Shell içinde çalıştırın:
- Cloud Shell öğesini açıp komutta hata ayıklamak için Run Command düğmesini tıklayın.
- CLI örneğini panoya kopyalamak için Copy düğmesini tıklayın. Ardından örneği yerel bir kabuk aracına yapıştırarak çalıştırabilir veya bir komut dosyası yazabilirsiniz.
Not
CLI örneğini yerel bir kabuk aracına kopyalayıp hata ayıklarken parametre biçimine dikkat edin. CLI komut parametre biçimleri hakkında daha fazla bilgi için bkz. Komut parametrelerini anlama.

OpenAPI portalı, oluşturulan örneklere varsayılan olarak --region seçeneğini ekler. Komutu kopyalayıp yerel olarak çalıştırdığınızda Alibaba Cloud CLI, varsayılan kimlik bilgisindeki ve ortam değişkenlerindeki bölge bilgilerini yok sayar ve bunun yerine belirtilen bölgeyi kullanır. Seçeneği ihtiyacınıza göre silebilir veya koruyabilirsiniz.

Adım 4: Security Center OpenAPI'sini çağırın

Örnek 1: Alibaba Cloud CLI tarafından desteklenen Security Center OpenAPI işlemlerini listeleme

Aşağıdaki örnek, Alibaba Cloud CLI tarafından desteklenen Security Center OpenAPI işlemlerini listelemek için --help seçeneğinin nasıl kullanılacağını gösterir. Daha fazla bilgi için bkz. API'ye genel bakış.

Aşağıdaki komutu çalıştırın.
```
aliyun sas --help
```

Örnek yanıt.

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.

Örnek 2: Varlık bilgilerini sorgulama

Aşağıdaki örnek, risk içeren Elastic Compute Service (ECS) varlık bilgilerini sorgulamak amacıyla Alibaba Cloud CLI ile Security Center hizmetinin DescribeCloudCenterInstances işleminin nasıl çağrılacağını gösterir.

Aşağıdaki komutu çalıştırın.

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

Örnek yanıt.

{
  "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"
    }
  ]
}

Not

Security Center OpenAPI'sini çağırırken bir hata alırsanız hata koduna göre istek parametrelerini ve değerlerini kontrol edin.

Ayrıca yanıttaki RequestID veya SDK hata mesajını kaydedebilir ve kendi kendine sorun giderme amacıyla Alibaba Cloud OpenAPI Tanılama hizmetini kullanabilirsiniz.