Manage Organization

To ensure everybody at your organization has full access to the Shodan platform we provide a few ways to help you upgrade/ downgrade users. The 2 primary methods described below are the Enterprise website and the Shodan command-line interface. Alternatively, Shodan also provides an API to automate the process as part of your existing workflows. If you have any questions let us know – we’re here to help!

Note

The following guide also applies to Corporate API subscribers. Both Corporate and Enterprise customers can use the website/ API/ CLI to manage upgrades for their users.

Enterprise Portal

The Shodan Enterprise website provides a portal for accessing/ managing your enterprise license. There are 2 main sections to the portal:

• Downloads
• Manage Access

The Downloads section provides an easy way to quickly download the various datasets via the website. It’s ideal for grabbing a few data files for ad-hoc processing/ analysis outside of the standard, automated workflows. In addition to the main Shodan daily data files, the website also contains other datasets such as our DNS DB, CVE DB and InternetDB. Administrators for organizations will see the Manage Access section of the portal which gives a list of all the users that are currently on your enterprise license. And it provides the ability to add/ remove members so you can easily manage who has full access to the Shodan platform. Behind the scenes, the entire website is fully powered by our Bulk Data API and the Organizations API which are documented in our Developer portal.

Caution

Only administrators can see the list of members and add/ remove users from the organization. And administrators can only be added/ removed by Shodan support staff.

Organizations API and Command-Line Interface

Shodan provides an Organizations API to help you manage access to your Shodan license in an automated, programmatic manner. There are 2 components:

1. Developer API: we’ve documented the relevant methods on the developer website and have implemented them in our official Python library. Use this option if you can’t use the command-line interface or want to integrate access to Shodan with your new-hire workflows: https://developer.shodan.io/api
2. Command-line interface: this is the preferred way to currently use the Organizations API. We’ve wrapped the functionality into a few, easy-to-use commands to help upgrade/ downgrade users with access to Shodan.

The following commands are available in the CLI. To see them make sure you’re running the latest version:

sudo pip install --upgrade shodan

Examples

See all available commands

shodan org

Add an account

shodan org add newuser@shodan.org

Remove an account

shodan org remove olduser@shodan.org

List all accounts within the organization

shodan org info

Tip

We recommend using functional accounts (project_a@mycompany.com) that are shared within teams, projects or business units instead of creating separate accounts for each user.