# Ignore Lists

# Default Ignore Lists

You can add IP addresses and optional destination ports to this list to ignore traffic that originates from the specified IP. If a ports are specified, we'll only ignore the traffic from the specified IP to the destination port.

# Ignore IP and Port

POST /api/v1/settings/whitelist_ip_port

Ignore Traffic from an IP and (optional) Port.

Required Parameters

auth_token string
A valid auth token
src_ip string
The source IP to ignore

Optional Parameters

dst_port int
The destination port to ignore

Response

A JSON structure with result indicator.

Example

    Response
    {
      "message": "Whitelist added",
      "result": "success"
    }
    
    1
    2
    3
    4

    # Disable Ignore List

    POST /api/v1/settings/whitelisting/disable

    Disable the ignore list.

    Required Parameters

    auth_token string
    A valid auth token

    Response

    A JSON structure with result indicator.

    Example

      Response
      {
        "result": "success"
      }
      
      1
      2
      3

      # Enable Ignore List

      POST /api/v1/settings/whitelisting/enable

      Enable the ignore list.

      Required Parameters

      auth_token string
      A valid auth token

      Response

      A JSON structure with result indicator.

      Example

        Response
        {
          "result": "success"
        }
        
        1
        2
        3

        # Remove an Ignored IP

        POST /api/v1/settings/whitelisting/remove_whitelist_ip

        Remove an ignored IP from the ignore list.

        Required Parameters

        auth_token string
        A valid auth token
        src_ip string
        IP address to remove from the list

        Response

        A JSON structure with result indicator.

        Example

          Response
          {
            "result": "success"
          }
          
          1
          2
          3

          # Set Ignore List

          POST /api/v1/settings/whitelisting/whitelist_ips

          Set a list of IPs to ignore.

          Required Parameters

          auth_token string
          A valid auth token

          Optional Parameters

          whitelist_ips string
          Newline separated list of IP addresses to ignore
          clear boolean
          Clear the ignore list

          TIP

          At least one of the optional parameters is required.

          TIP

          You can add comments to your list of ignored IPs by prefixing a line with '#'

          For example, to set your ignore list to the below:

          # test comment
          1.2.3.4
          10.10.10.10
          
          1
          2
          3

          You would send through:

          -d $'# test comment\n1.2.3.4\n10.10.10.10'

          Response

          A JSON structure with result indicator.

          Example

            Response
            {
              "result": "success"
            }
            
            1
            2
            3

            # Hostname Ignore Lists

            If you want to ignore traffic from a specific, known hostname, you can use these endpoints.

            # Disable Hostname Ignore List

            POST /api/v1/settings/ignore_hostnames/disable

            Disable Ignoring by Hostname.

            Required Parameters

            auth_token string
            A valid auth token

            Response

            JSON structure with result indicator.

            Example

              Response
              {
                "result": "success"
              }
              
              1
              2
              3

              # Enable Hostname Ignore List

              POST /api/v1/settings/ignore_hostnames/enable

              Enable Ignoring by Hostname.

              Required Parameters

              auth_token string
              A valid auth token

              Response

              JSON structure with result indicator.

              Example

                Response
                {
                  "result": "success"
                }
                
                1
                2
                3

                # Set Hostname Ignore List

                POST /api/v1/settings/ignore_hostnames

                Sets the hostname ignore list.

                Required Parameters

                auth_token string
                A valid auth token

                Optional Parameters

                hostnames string
                The list of hostnames separated by a newline character
                clear boolean
                If true, clears the ignore list

                Response

                JSON structure with result indicator.

                Example

                  Response
                  {
                    "result": "success"
                  }
                  
                  1
                  2
                  3

                  # Source Port Ignore Lists

                  If you want to ignore traffic that originates from a known source port, you can use these endpoints.

                  # Disable Source Port Ignore List

                  POST /api/v1/settings/ignorelist_src_port/disable

                  Disable ignoring by source port.

                  Required Parameters

                  auth_token string
                  A valid auth token

                  Response

                  JSON structure with result indicator.

                  # Enable Source Port Ignore List

                  POST /api/v1/settings/ignorelist_src_port/enable

                  Enable ignoring by source port.

                  Required Parameters

                  auth_token string
                  A valid auth token

                  Response

                  JSON structure with result indicator.

                  Example

                    Response
                    {
                      "result": "success"
                    }
                    
                    1
                    2
                    3

                    # Set Source Port Ignore List

                    POST /api/v1/settings/ignorelist_src_port

                    Sets the source port ignore list.

                    Required Parameters

                    auth_token string
                    A valid auth token

                    Optional Parameters

                    ignorelist_src_port_ips string
                    The list of IPs to ignore, separated by a newline character
                    clear boolean
                    If true, clears the ignore list

                    Response

                    JSON structure with result indicator.

                    Example

                      Response
                      {
                        "result": "success"
                      }
                      
                      1
                      2
                      3

                      # Test Ignore Lists

                      Using the below endpoints, you can easily test if given hostnames and IP addresses are already ignored on your Console.

                      # Test if Hostname is Ignored

                      GET /api/v1/settings/is_hostname_whitelisted

                      Test if a given hostname has been ignored.

                      Required Parameters

                      auth_token string
                      A valid auth token
                      hostname string
                      The source hostname to test

                      Optional Parameters

                      dst_port int
                      The destination port to test

                      Response

                      A JSON structure with the test result.

                      Example

                        Response
                        {
                          "is_hostname_whitelisted": true,
                          "is_whitelist_enabled": true
                        }
                        
                        1
                        2
                        3
                        4

                        # Test if IP is Ignored

                        GET /api/v1/settings/is_ip_ignored

                        Test if a given IP address has been ignored.

                        Required Parameters

                        auth_token string
                        A valid auth token
                        src_ip string
                        The source IP to test

                        Optional Parameters

                        dst_port int
                        The destination port to test

                        Response

                        A JSON structure with the test result.

                        Example

                          Response
                          {
                            "is_ip_whitelisted": true,
                            "is_whitelist_enabled": true
                          }
                          
                          1
                          2
                          3
                          4