An organization represents a distinct entity; this can be your business, a specific department within your business, or one of your customers. All actions, tasks, Explorers, scans, and other objects managed by runZero are tied to specific organizations and isolated from each other.
Your active organization can be switched by using the dropdown selector at the top right of the runZero Console. If your default role is Viewer or higher, you can select All Organizations from the dropdown to view the data for all of your organizations in the Dashboard and Inventory. The Queries page also supports the All Organizations view. Pages that are not compatible with the All Organizations view will be hidden until a single organization is selected.
runZero Starter Edition is limited to a single organization.
Use cases for organizations
It is common to segment your assets to multiple organizations based on a few common requirements:
- RBAC: users will only be able to see the assets in organizations they’re added to.
- Environments: it is possible you do not want your dev, prod, etc assets in one pool and would prefer them to be segmented.
- Customers: service providers general have one organization per customer.
Organizations can be created, modified, and deactivated by going to the organizations section within the console. Click the Organizations link under Global Settings on the left-hand sidebar.
- Name: name of the organization.
- Parent organization: allows for sub-organizations.
- Description: description of the organization.
- Stale asset expiration: sets the number of days before stale assets are removed from the inventory. This applies to online and offline assets not seen within the configured number of days.
- Offline asset expiration: sets the number of days before offline assets are removed from the inventory. This applies to offline assets not seen within the configured number of days.
- Scan data expiration: sets the number of days before completed scans are removed from the platform. This applies to the scan task metadata as well as the raw data files and change reports.
A project is a special type of organization designed for temporary use. They behave like organizations, and can have sites defined within them. The important difference is that projects automatically become read only after 30 days, and are automatically deleted after 90 days. While organizations allow you to customize expiration times, the expiration times for projects are fixed.
Your runZero license allows you to have five times as many assets in projects as in regular organizations.
If you decide that you want to keep a project indefinitely, it can be converted into an organization.
Note that organizations support custom data retention settings that you can edit to your requirements.