API overview
API standards and multilingual preset SDKs
The OpenAPI of this product (CsasEdr/2024-11-22) uses the RPC signature style. We have encapsulated SDKs for common programming languages for developers. Developers can download the SDK to directly call this product's OpenAPI without worrying about technical details. If the existing SDK does not meet your needs, you can use the signature mechanism for self-signing integration. Since the details of self-signing are very complex, it may take around 5 business days. Therefore, we recommend joining our DingTalk service group (147535001692) and conducting signature integration under expert guidance.
Before using the API, you need to prepare your identity account and access key (AccessKey) to effectively access the API through client tools (such as SDK and CLI). For details, see Obtain an AccessKey.
Custom signature scenarios
If your business scenario has special requirements and you need to integrate the API through self-signing, we recommend consulting our technical support team first (DingTalk service group: 147535001692) to obtain professional guidance and ensure efficient integration.
Account and security preparation
Alibaba Cloud accounts have full administrative permissions over all resources. Once an AccessKey is compromised, all associated resources will be at risk of unauthorized access. To ensure security, it is recommended to create a RAM user with only API access permissions and configure its AccessKey, while configuring RAM policies based on the principle of least privilege (PoLP). Use the Alibaba Cloud account only in specific scenarios where Alibaba Cloud account permissions are explicitly required.
Security alert
|
API |
Title |
Description |
| UpdateAssetScope | Update endpoint asset scope | Updates the effective scope mode and target list of a specified asset scope record. |
| HandleSimilarSecurityEvents | Process similar security alerts in batches | Performs batch operations on similar security alerts filtered by a query task. |
| HandleSecurityEvents | Handle security alert events | Handles security alert events. |
| DescribeSimilarSecurityEvents | Query identical alerts | Queries aggregated alerts triggered by the same rule or type. |
| DescribeSimilarEventScenarios | Query handling scenarios for similar alerts | Queries the handling scenarios for alerts triggered by the same rule or type. |
| DescribeSecurityEventOperationStatus | Query the processing status of security alerts | Queries the processing status of security alerts based on the task ID or alert event ID. |
| DescribeSecurityEventOperations | View the operation list for alert event handling | Queries the handling operations, operability, and whitelist rule configurations for a specified endpoint alert in its current state. |
| DescribeNsasSuspEventType | Query security alert types | Queries security alert types. |
| DescribeSecurityEventMarkMissList | Query alert whitelist rules | Queries the automatic whitelist rules for alerts. |
| DescribeAssetScope | Query endpoint asset scopes | Queries the effective scope mode, target list, and scope record information based on the asset scope ID. |
| DescribeSuspEvents | Query security alerts | Queries endpoint security alerts and supports filtering by alert, endpoint, and processing status. |