Organization Management

6min

SOOS Organization Management allows users to link multiple sub-organization accounts and toggle between their respective dashboards, all with a single login. This way you can keep your individual team projects separate from one another and view a "top level" view of security performance across all teams in one place.

Each sub-org can have unique users, permissions, integrations and configurations. Configurations may be defined at the parent organization level and optionally locked so sub-orgs cannot change these settings. See Configuration Inheritance for more details.

Statistical data in sub-orgs will flow up to the parent organization dashboard, allowing for an org-wide view of your scans details as well as org-wide search capabilities.

Requires the Organization Management add on. See Subscribing to SOOS Services to make changes to your plan.

The Organization dashboard includes high level statistics for each sub-org (such as the API Team, Frontend Team, and DevSecOps Team in the screenshot below). Select a sub-org to in the main dashboard list or in the left menu to be be put in the context of that sub-org.

Additionally, global In The News and Search capabilities are included which are rolled up views for each sub-organization that has been configured.

Document image


Enabling Organization Management

When SOOS enables Organization Management on your existing account, a new "Parent" account will be generated, and the existing account will become one of the "child" accounts, or sub-orgs. Note that the name of the new parent account will be identical to the name of the original account. It is the responsibility of the Admin user to update the Company Names appropriately to differentiate the two.

Original to Parent account


Configuring Organization Management

  1. Use the Org Management dropdown to select the Parent Account, then access Organization in the user dropdown in the left nav menu.
  2. Once on the Organization Settings page add each desired sub-organization to the list with a corresponding administrative email. Note - the email used does not create a user under that sub-org.
    • A warning will be provided as a reminder of the contracted number of sub-orgs allowed.
  3. When finished, each sub-organization will be listed in the Organization dropdown in the left nav menu.
Creating and viewing sub-organizations


Adding Users

All users who existed under the original account (which is now Sub Org 1) will remain with that account. The only user on the new Parent account will be the original administrator, this is the individual associated with the email address listed as the Administrative Email under the Organization Settings.

  1. All users invited to the main parent account will have access to each sub-organization using the dropdown, they do not need to be invited to each sub-org. Parent organization users will maintain the same user role across all linked sub-orgs.
  2. To invite users to specific sub-orgs, select the desired sub-org from the dropdown and proceed with Adding Users as usual.
    • Users belonging to sub-orgs will not see the dropdown displaying linked organizations when they log in.
    • Users who require access to multiple sub-orgs, but not to the main Parent account will need to be invited to each individual sub-org using a unique email address each time. We suggest using the "+" syntax.

Moving Users

Administrators can move users from sub-org to parent or from parent to sub-org as needed. Users cannot be moved directly from one sub-org to another, they will need to be moved from one sub-org to the parent, then moved again to the new desired sub-org.

Use the arrow icon in the Users list to initiate a move.

Moving users