Usar API para adicionar remetentes em SL/BL no SMA

Introduction

Este documento descreve as configurações para adicionar remetentes na Lista de permissão/bloqueio (SL/BL) para o Secure Management Appliance (SMA) com API e comando curl.

Prerequisites

Requirements

A Cisco recomenda o conhecimento destes tópicos:

• Dispositivo de gerenciamento seguro (SMA)
• Conhecimento de API
• Conhecimento de quarentena de spam
• Conhecimento de Lista de permissão/bloqueio

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Security Management Appliance, AsyncOS versão 12.0 ou mais recente.
• Um cURL de biblioteca de programação ou cliente. Isso deve suportar JSON para interpretar a resposta da API.
• Autorização para acessar a API do AsyncOS.
• Quarentena de spam centralizada.
• Lista de permissão e Lista de bloqueio ativadas.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio

A principal finalidade do serviço de API é obter informações de relatórios e configuração do SMA.

Você pode obter informações de Lista segura e Lista de bloqueio da Quarentena de spam, bem como adicionar novos usuários com consultas API cURL.

Configurar

Lista segura GET e POST

GET

Essa consulta obtém as informações da Lista de permissão, onde sma1.example.com é o nome do host SMA e adminé o nome de usuário.

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

Digite a senha do usuário em questão.

Como saída, você obtém:

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

A Lista de permissão GUI é mostrada na imagem:

Saída da Lista de permissão GUI

POST

Esta consulta adiciona informações do remetente à Lista de permissão, onde sma1.example.com é o nome do host SMA e adminé o nome de usuário, user1@example.comé o novo destinatário e  example.com é o remetente da Lista de permissão.

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"
}'


Execute esse comando e digite a senha do usuário em questão.

A Lista de permissão GUI é mostrada na imagem:

Saída da Lista de permissão GUI

GET e POST na lista de bloqueio

GET

Essa consulta obtém as informações da Lista de permissão, onde sma1.example.com é o nome do host SMA e adminé o nome de usuário

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

Como saída, você obtém:

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

A Lista de permissão GUI é mostrada na imagem:

Saída da lista de bloqueio da GUI

 

POST

Esta consulta adiciona informações do remetente à Lista de permissão, onde sma1.example.com é o nome do host SMA e adminé o nome de usuário, user1@example.comé o novo destinatário e  example1.com é o remetente da lista de bloqueio.


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"
}'

Execute esse comando e digite a senha do usuário em questão.

A Lista de permissão GUI é mostrada na imagem:

Saída da lista de bloqueio da GUI

  

Informações Relacionadas

• Guias de programação SMA
• Guia do usuário final SMA