Contents

Introduction

Prerequisites

Requirements

Componentes Utilizados

Informações de Apoio

Configurar

Lista segura GET e POST

GET

POST

GET e POST na lista de bloqueio

GET

POST

Informações Relacionadas

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