Organizations
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 Community 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 the organizations or the children of organizations they’re added to.
- Environments: It is possible you do not want your development, production, or other assets in one pool and would prefer them to be segmented.
- Customers: Service providers generally have one organization per customer.
Creating organizations
Organizations can be created, modified, and deactivated by going to the organizations section within the console. Click the Organizations link under Global Settings.
Organization configurations
- Name: Name of the organization.
- Parent organization: Allows for sub-organizations, limited to three levels of nesting. Permissions will be inherited based on most privilege.
- 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.
Projects
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 cannot be parents of organizations or other 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 includes the addition of up to five times as many project assets as the total number of licensed live assets. For example, if your license includes 1,000 live assets, you can have up to 5,000 project assets total. The total number of assets in organizations and projects can be seen on your license information page in the runZero console.
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.
Organization and project details
Click on the name of an organization or project to get to the details page. This page includes basic details about the organization or project, as well as its place in the organization hierarchy.