Network Lists

Edite no GitHub

Através da API de Network Lists você pode criar, consultar ou atualizar Network Lists utilizadas no Rules Engine do Novo Edge Firewall.

  1. Consultar lista de Network Lists
  2. Consultar dados de uma Network List
  3. Consultar dados da Network List - Origin Shield
  4. Consultar dados da Network List - Tor Exit Nodes
  5. Criar uma nova Network List
  6. Sobrescrever uma Network List existente

  1. Consultar lista de Network Lists

Retorna a lista de Network Lists.

GET /network_lists

Permissão necessária: View Network Lists

Parâmetros obrigatórios

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept (obrigatório) Informações sobre o tipo de retorno e versão header string;
application/json;version=3

Exemplo de Requisição

GET /network_lists 
Accept: application/json; version=3
Authorization: token ec6aabdc0b6bbeed826a36d8731630e36b6e3f22
Content-Type: application/json

Exemplo de Resposta


    {
    "count": 3,
    "total_pages": 1,
    "schema_version": 3,
    "links": {
        "previous": null,
        "next": null
    },
    "results": [
        {
            "id": 9,
            "last_editor": "products@azion.com",
            "last_modified": "2019-12-11T18:15:29.073687Z",
            "list_type": "ip_cidr",
            "name": "Azion IP"
        },
        {
            "id": 17,
            "last_editor": "products@azion.com",
            "last_modified": "2019-12-11T18:15:35.124016Z",
            "list_type": "asn",
            "name": "Azion ASN"
        },
        {
            "id": 20,
            "last_editor": "products@azion.com",
            "last_modified": "2019-12-11T18:14:10.514494Z",
            "list_type": "countries",
            "name": "Azion Country"
        }
    ]
}

2. Consultar dados de uma Network List

Retorna detalhes de uma Network List. As informações que são retornadas nessa chamada se referem às Network Lists que podem estar vinculadas a um ou mais Rule Sets do Novo Edge Firewall.

GET /network_lists/:id

Permissão necessária: View Network Lists

Parâmetros obrigatórios

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept (obrigatório) Informações sobre o tipo de retorno e versão header string;
application/json;version=3
:id (obrigatório) O id da network list que se pretende consultar. path number

Exemplo de Requisição

GET /network_lists/111
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5942

Exemplos de Resposta

Resposta para lista do tipo IP/CIDR:

{
    "results": {
        "last_editor": "products@azion.com",
        "last_modified": "2019-09-12T14:07:26.871995Z",
        "list_type": "ip_cidr",
        "name": "IP Blacklist - Azion Docs",
        "items_values": [
            "10.1.1.10/16",
            "192.168.0.1",
            "192.168.0.2/32"
        ]
    },
    "schema_version": 3
}

Resposta para lista do tipo ASN:

{
    "results": {
        "last_editor": "RTM User Name",
        "last_modified": "2019-09-12T14:07:26.871995Z",
        "list_type": "asn",
        "name": "ASN List",
        "items_values": [
            1234,
            4321
        ]
    },
    "schema_version": 3
}

Resposta para lista do tipo Countries:

{
    "results": {
        "last_editor": "RTM User Name",
        "last_modified": "2019-09-12T14:07:26.871995Z",
        "list_type": "countries",
        "name": "Countries List",
        "items_values": [
            "CN",
            "RU"
        ]
    },
    "schema_version": 3
}

3. Consultar dados da Network List - Origin Shield

Retorna detalhes da Network List de Origin Shield. As informações que são retornadas nessa chamada se referem à Network List de Origin Shield que contém a lista de todos os IP’s do perímetro de segurança para a sua infraestrutura de origem.

GET /network_lists/187

Permissão necessária: View Network Lists

Parâmetros obrigatórios

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept (obrigatório) Informações sobre o tipo de retorno e versão header string;
application/json;version=3
:id (obrigatório) O id da network list referente à Origin Shield. path number

Exemplo de Requisição

GET /network_lists/****
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5942

Exemplo de Resposta

Resposta para lista Origin do tipo IP/CIDR:

{
    "results": {
        "last_editor": "Azion",
        "last_modified": "2019-09-12T14:07:26.871995Z",
        "list_type": "ip_cidr",
        "name": " Azion Origin Shield",
        "items_values": [
            "149.56.116.123/32",
            "149.56.148.202/32",
            "151.80.204.60/30",
            "168.181.22.64/29",
            "169.239.132.192/28",
            "170.0.81.120/29"
        ]
    },
    "schema_version": 3
}

4. Consultar dados da Network List - Tor Exit Nodes

Retorna detalhes da Network List de Tor Exit Nodes. As informações que são retornadas nessa chamada se referem à Network List de Tor Exit Nodes que contém a lista de todos os IP’s que podem ser utilizados no Rules Engine em Edge Firewall, com o objetivo de previnir requisições destes endereços da lista.

GET /network_lists/2

Permissão necessária: View Network Lists

Parâmetros obrigatórios

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept (obrigatório) Informações sobre o tipo de retorno e versão header string;
application/json;version=3
ID = 66 (obrigatório) O id da network list referente à Tor Exit Nodes. path number

Exemplo de Requisição

GET /network_lists/2
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5942

Exemplo de Resposta

Resposta para lista Origin do tipo IP/CIDR:

{
    "results": {
        "last_editor": "Azion",
        "last_modified": "2019-09-12T14:07:26.871995Z",
        "list_type": "ip_cidr",
        "name": " Azion IP Tor Exit Nodes",
        "items_values": [
            "173.249.57.253",
            "176.10.104.240",
            "176.10.107.180",
            "176.10.99.200",
            "176.107.179.147",
            "176.107.187.151"
        ]
    },
    "schema_version": 3
}

4. Criar uma nova Network List

Possibilita a criação de uma nova Network List.

POST /network_lists

Permissão necessária: Edit Network Lists

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept (obrigatório) Informações sobre o tipo de retorno e versão header string;
application/json;version=3
Content-Type (obrigatório) O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string

Exemplo de Requisição

POST /network_lists
Accept: application/json; version=3
Authorization: token cf2078926f91a6e638af3f4a6977b505edfe5941
Content-Type: application/json
{
    "name": "Network List criada pela API",
    "items_values": [
    	   "192.168.0.1",
        "192.168.0.2/32",
        "10.1.1.10/16"
    ],
    "list_type": "ip_cidr"
}

Exemplo de Resposta

{
    "results": {
        "items_values": [
            "10.1.1.10/16",
            "192.168.0.1",
            "192.168.0.2/32"
        ],
        "name": "Network List criada pela API",
        "last_modified": "2019-12-11T18:28:35.349078Z",
        "list_type": "ip_cidr",
        "last_editor": "products@azion.com",
        "id": 85
    },
    "schema_version": 3
}

5. Sobrescrever uma Network List

Sobrescreve todos os campos de uma Network List, preservando o id.

PUT /network_lists/:id

Permissão necessária: Edit Network Lists

Parâmetro Descrição Tipo Tipo de Dado
Authorization (obrigatório) A autenticação por Token previamente criado através do endpoint de Criação de Token header string
Accept (obrigatório) Informações sobre o tipo de retorno e versão header string;
application/json;version=3
Content-Type (obrigatório) O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string
:id (obrigatório) O id da network list a ser sobrescrita. path number

Exemplos de Requisição

PUT /network_lists/85
Accept: application/json; version=3
Authorization: token ec6aabdc0b6bbeed826a36d8731630e36b6e3f22
Content-Type: application/json

Requisição para lista do tipo IP/CIDR:

{
    "name": "Network List Modificada pela API",
    "items_values": [
    	"192.168.0.5",
        "192.168.0.2/32",
        "10.1.1.10/16"
    ],
    "list_type": "ip_cidr"
}

Requisição para lista do tipo ASN:

{
    "items_values": [
    	   "1234",
        "4321"
    ],
    "name": "ASN - Azion Docs - Modificada pela API",
    "list_type": "asn"
}

Requisição para lista do tipo Countries:

{
    "items_values": [
    	"BR",
    	"AG",
    	"US"
 ],
    "name": "Country Modificada pela API",
    "list_type": "countries"
}

Exemplos de Resposta

Resposta para lista do tipo IP/CIDR:

{
    "results": {
        "items_values": [
            "10.1.1.10/16",
            "192.168.0.2/32",
            "192.168.0.5"
        ],
        "name": "Network List Modificada pela API",
        "last_modified": "2019-12-11T18:31:41.780397Z",
        "list_type": "ip_cidr",
        "last_editor": "products@azion.com",
        "id": 85
    },
    "schema_version": 3
}

Resposta para lista do tipo ASN:

{
    "results": {
        "items_values": [
            1234,
            4321
        ],
        "name": "ASN - Azion Docs - Modificada pela API",
        "last_modified": "2019-12-11T18:36:07.282729Z",
        "list_type": "asn",
        "last_editor": "products@azion.com",
        "id": 17
    },
    "schema_version": 3
}

Resposta para lista do tipo Countries:

{
    "results": {
        "items_values": [
            "BR",
            "US",
            "AG"
        ],
        "name": "Country Modificada pela API",
        "last_modified": "2019-12-11T18:33:51.781496Z",
        "list_type": "countries",
        "last_editor": "products@azion.com",
        "id": 20
    },
    "schema_version": 3
}

Não encontrou o que procurava? Abra um ticket.