使用API在SMA上的SL/BL中添加发件人

简介

本文档介绍使用API和curl命令在安全管理设备(SMA)的安全列表/阻止列表(SL/BL)中添加发件人的配置。

先决条件

要求

建议掌握下列主题的相关知识：

• 安全管理设备(SMA)
• API知识
• 垃圾邮件隔离区知识
• 安全列表/阻止列表知识

使用的组件

本文档中的信息基于以下软件和硬件版本：

• 安全管理设备，AsyncOS版本12.0或更高版本。
• 客户端或编程库cURL。必须支持JSON才能解释来自API的响应。
• 访问AsyncOS API的授权。
• 集中垃圾邮件隔离区。
• 已启用安全列表和阻止列表。

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

API服务的主要用途是从SMA获取报告和配置信息。

您可以从垃圾邮件隔离区获取安全列表和阻止列表信息，并使用API cURL查询添加新用户。

配置

安全列表GET和POST

GET

此查询从安全列表获取信息，其中 sma1.example.com 是SMA主机名和 admin是用户名。

curl --location --request GET 'https://sma1.example.com/sma/api/v2.0/quarantine/safelist?action=view&quarantineType=spam&viewBy=recipient' -u admin

输入有问题的用户的密码。

作为输出，您将得到：

{"meta": {"totalCount": 2}, "data": [{"senderList": ["example.com"], "recipientAddress": "user2@example.com"}, {"senderList": ["test.com"], "recipientAddress": "user2@test.com"}]}

GUI安全列表如图所示：

GUI安全列表输出

POST

此查询将发件人信息添加到安全列表，其中 sma1.example.com 是SMA主机名和 admin是用户名， user1@example.com是新的接收方，  example.com 是安全列表的发件人。

curl --location --request POST 'https://sma1.example.com/sma/api/v2.0/quarantine/safelist' -u admin --data-raw '{
"action": "add",
"quarantineType": "spam",
"recipientAddresses": ["user1@example.com"],
"senderList": ["example.com"],
"viewBy": "recipient"
}'


运行此命令并输入相关用户的密码。

GUI安全列表如图所示：

GUI安全列表输出

阻止列表GET和POST

GET

此查询从安全列表获取信息，其中 sma1.example.com 是SMA主机名和 admin是用户名

curl --location --request GET 'https://sma1.example.com/sma/api/v2.0/quarantine/blocklist?action=view&quarantineType=spam&viewBy=recipient' -u admin

作为输出，您将得到：

{"meta": {"totalCount": 2}, "data": [{"senderList": ["example1.com"], "recipientAddress": "user2@example.com"}, {"senderList": ["test1.com"], "recipientAddress": "user2@test.com"}]

GUI安全列表如图所示：

GUI阻止列表输出

 

POST

此查询将发件人信息添加到安全列表，其中 sma1.example.com 是SMA主机名和 admin是用户名， user1@example.com是新的接收方，  example1.com 是要阻止列表的发件人。


curl --location --request POST 'https://sma1.example.com/sma/api/v2.0/quarantine/blocklist' -u admin --data-raw '{
"action": "add",
"quarantineType": "spam",
"recipientAddresses": ["user1@example.com"],
"senderList": ["example1.com"],
"viewBy": "recipient"
}'

运行此命令并输入相关用户的密码。

GUI安全列表如图所示：

GUI阻止列表输出

  

相关信息

• 编程指南SMA
• 最终用户指南SMA