API v4 is here, with more data and more options

ShadowTrackr has been gathering more information on your assets since API v3 was released. There are more indexes, reports and magic queries available too. Not all of those were available in the API yet. Also, version 3 had some inconsistenties that we'd love to get rid of.

Api v4 is now available. The ShadowTrackr python module on github is also updated.

The most significant changes:

The data returned is consistent and proper formatted everywhere

Error messages and result descriptions have improved

API is much better documented, with code examples

Code examples are with cURL, Python and PHP

All endpoints now have the same names in the python module

New endpoints available for suppliers, vulnerabilities and more

If you have specific requests for the API or questions on how to use it, please let us know :-)

Scannernodes upgraded

There has been a big upgrade on all scannernodes. Fresh installs with a new OS, better monitoring, and better security. All scannernodes have encryption enabled now. Besides software improvements, server capacity had been increased too.

Multi-tenant endpoints in API

There have been some hidden API options for multi-tenant users for a while, and since there is a growing number of multi-tenant users it was about time to properly document it.

If you have a multi-tenant subscription, there are groupadmins that can create, view and delete organizations in the GUI. These organizations are isolated and cannot see each others data. The groupadmin does have options to query and report over all organizations in the group.

Some of you want to dynamically manage organizations through the API. For that, there are three endpoints available:

create organization
active_organizations
delete_organization

You can of course also use this functionality in the ShadowTrackr Python API. There is a multi-tenant example included in the code on Github.

The groupcode and group API key needed to use this can be found in the GUI on the group settings page. This page is only accessible to groupadmins.