Skip to main content

Cyware Orchestrate

MXToolBox

App Vendor: MXToolBox

App Category: Data Enrichment & Threat Intelligence

Connector Version: 1.0.0

API Version: 1.0.0

About App

MxToolbox is the leading provider of free Blacklist, DNS and email tools, and paid email delivery solutions. It provides free, fast, and accurate network diagnostic and lookup tools.

The MXToolBox app is configured with the Orchestrate application to perform the following actions:

Action Name

Description

Network Lookup

This action retrieves the lookup details of a network using the specified hostname, lookup command, and port.

Get Monitor List

This action retrieves a list of details about monitors from the MXToolBox application.

Get Monitor Details by ID

This action retrieves details of the specified monitor from the MXToolBox application.

Configuration Parameters

The following configuration parameters are required for the MXToolBox app to communicate with the MXToolBox enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

API Key

Enter your MXToolBox API key.

Example:

"34dccdd26c5c99ceb3af22f392b708bf"

Text

Required

Action: Network Lookup

This action retrieves the lookup details of a network using the specified hostname, lookup command, and port from the MXToolBox platform.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Hostname

Enter the hostname for which you want to retrieve details.

Example:

"ipv4"

Text

Required

Allowed values:

  • ipv4

  • fqdn

Lookup command

Enter the required lookup command.

Example:

"CNAME"

Text

Required

Allowed values:

  • SMTP

  • TCP

  • HTTP

  • HTTPS

  • PING

  • TRACE

  • SOA

  • ARIN

  • WHOIS

  • CNAME

  • PTR

  • TXT

  • SPF

  • A

  • MX

  • blacklist

Port

Enter the required port.

Example:

8080

Integer

Optional

Example Request

[
  {
    "hostname": "ipv4",
    "command": "CNAME",
    "port": 8080
  }
]
Action: Get Monitor List

This action retrieves a list of details about monitors from the MXToolBox application.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Query Params

Enter the required query as key-value pairs.

Example:

{"command": "blacklist"}

Key Value

Optional

Allowed values:

  • tag: (comma-separated str)

  • name: (str)

  • command: (str) Allowed values:

    • blacklist

    • SMTP

    • TCP

    • HTTP

    • HTTPS

    • PING

    • TRACE

    • SOA

    • ARIN

    • WHOIS

    • CNAME

    • PTR

    • TXT

    • SPF

    • A

    • MX

Example Request

[
  {
    "extra_params": {
      "command": "blacklist"
    }
  }
]
Action: Get Monitor Details by ID

This action retrieves details of the specified monitor from the MXToolBox application.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Monitor UID

Enter the monitor UID for which you want to retrieve details.

Example:

"12345"

Text

Required

Example Request

[
  {
    "monitor_uid": "12345"
  }
]