This section assumes two things:
- You have registered with Mudmap, if not see Register an Account.
- The device you're about to add has been prepared, if not see Preparing your Device
Before you can integrate your firewall into Mudmap it needs to be added to the list of devices and then registered within the application. The next two sections cover this process in detail.
The broad scheme is like so:
- Add a new device to Mudmaps database (this page)
- Register an added device, meaning make the initail connection, install the agent and test connectivity (see Registering Devices for more info)
Adding your device to Mudmap is as simple as providing some information about the firewall and submitting that in a form. What information does Mudmap require?
- A label for the firewall, this is just for convenience
- Host Address, must be a IPv4 or IPv6 address
- SSH Port that is publicly available
- Graphical User Interface port - the port used to access the pfSense user
interface, defaults to 443
why do you need the pfSense user interface port?
This is for the API only - it uses this port to interact with pfSense. This does not need to be internet facing (highly recommend against that practice).
- pfSense version; possible combinations 2.4, 2.5 and 2.6
The Device Registration page has two components; Register Device and Devices. We only care about Register Devices, which should look the same as the image below.
After filling out the required information click the Add button.
If you've already added this device, the step will fail with an alert notification. Otherwise, you should get a success notification and see the newly added device appear in the Devices table to the right.
If you've made it this far, then congratulations, your device is now in Mudmap's database ready to be registered into the system.