About the connector
MACVendors provides a simple and fast mac address vendor lookup, with a fully featured easy API.
This document provides information about the MACVendors connector, which facilitates automated interactions, with a MACVendors server using FortiSOAR™ playbooks. Add the MACVendors connector as a step in FortiSOAR™ playbooks and perform automated operations, such as retrieving vendor information from MACVendors based on the MAC address you have specified.
Version information
Connector Version: 1.0.0
FortiSOAR™ Version Tested on: 4.12.0-746
Authored By: Fortinet
Certified: Yes
Installing the connector
All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:
yum install cyops-connector-macvendors
For the detailed procedure to install a connector, click here
Prerequisites to configuring the connector
- You must have the Hostname of MACVendors server to which you will connect and perform automated operations.
Configuring the connector
For the procedure to configure a connector, click here
Configuration parameters
In FortiSOAR™, on the Connectors page, click the MACVendors connector row, and in the Configure tab enter the required configuration details.
| Parameter |
Description |
| Hostname |
Hostname of MACVendors server to which you will connect and perform automated operations. |
Actions supported by the connector
The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 and onwards:
| Function |
Description |
Annotation and Category |
| MAC Address Lookup |
Retrieves the vendor name from MACVendors based on the MAC address you have specified. |
mac_lookup
Investigation |
operation: MACVendor Lookup
Input parameters
| Parameter |
Description |
| MAC Address |
MAC address for which you want to retrieve the vendor information from MACVendors. |
Output
The output contains a non-dictionary value.
Included playbooks
The Sample - MACVendors - 1.0.0 playbook collection comes bundled with the MACVendors connector. These playbooks contain steps using which you can perform all supported actions. You can see bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the MACVendors connector.
Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during connector upgrade and delete.
