Fleet DM Integration

BastionXP integrates with Fleet APIs to download the devices (hosts) present in the Fleet DM's Host inventory.

Before you could register Fleet with BastionXP MDM Connector, you need the base URL of your Fleet instance. If you are using the cloud-hosted version of Fleet, the base URL generally looks like the following:

https://[your-org-name].fleetdm.cloud

You also need to get an API token from Fleet. To get an API token, retrieve it from "My account" > "Get API token" in the Fleet UI.

Connect Fleet DM to BastionXP

Visit the BastionXP UI, click the settings icon in the top right corner. Select Device Management from the dropdown menu.

In the Device Management page, you can add a new MDM connector. Click the + Add MDM Connector button. A dialog window will open up. Select Fleet as the MDM provider. Enter the Fleet instance's base URL and the API token provided by it. Click the Add MDM Connector button in the bottom right corner of the dialog window to add the Fleet MDM connector to the registry.

BastionXP will connect and authenticate with the Fleet instance's API server using the API token, and will start downloading the devices (Hosts) from the Fleet's Host inventory. The device download happens in batches. So, this may take a few minutes to complete.

Go to the BastionXP UI's Devices tab and you'll start seeing devices being synce'd from Fleet.

Webhook URL

In the Device Management page, you'll see the Fleet MDM connector being listed in the table. Click the link in it (or edit the entry using the kebab menu) to view the details. A card will open up and display all the information you just entered. It will also show a webhook URL that needs to be registered with your Fleet instance.

Copy the webhook URL. Go to your Fleet UI. Go to the home page. In the Activities section, click the Manage Automations link. A dialog window will open up. Activate the enable button. Add the webhook URL as the destination URL. Click the save button.

Fleet will use this webhook URL to notify BastionXP when a new device gets added to the Fleet or when a device is deleted from it. BastionXP will use this information to update its device inventory in its database.

After the initial full download is completed, Fleet will notify BastionXP when devices are added or deleted using the webhook URL. BastionXP will not periodically poll the Fleet APIs for new devices.