Organisation

List of organisations showing organisation name, linked organisations, created by, dates, and edit/link actions

Energy SOAR supports multi-tenancy through organisations. A single instance can host multiple organisations, each with its own users, cases, alerts, and analyzers. Data is fully isolated between organisations by default.

Users

A user can belong to multiple organisations and holds a separate profile in each one. This means the same user account can have the analyst profile in one organisation and the read-only profile in another.

Users switch between organisations using the switch button in the header, without logging out. Permissions and data access update automatically for the selected organisation.

Linking organisations

By default, organisations cannot see each other’s data. A user with the manageOrganisation permission can link two organisations. The link is bidirectional: both organisations gain visibility into each other simultaneously.

Only after organisations are linked can cases be shared between them.

Case sharing

When a user creates a case, it belongs to their organisation with the org-admin profile applied to the share — meaning there are no restrictions for the owning organisation.

To share a case with another organisation:

  1. The owning organisation must already be linked to the target organisation.

  2. Open the case and use the Share action.

  3. Select the target organisation and the profile to apply to the share.

The selected profile controls what the receiving organisation can do with the case. For a user to act on a shared case, the permission must be present in both their own profile and the case share profile.

Tasks and observables can be shared individually, but only with organisations the case is already shared with. A case can be shared at most once per organisation.

The admin organisation

Energy SOAR creates a default organisation named admin after installation. This organisation is reserved for platform administrators. It can manage global objects (profiles, tags, custom fields, organisations) but cannot hold cases or alerts.

Custom tags

Custom tags are labels created manually, outside of taxonomy libraries. Managing them requires the manageTag permission.

Tags are available under Organisation > Custom tags. The list shows how many cases, alerts, observables, and case templates use each tag.

To change a tag’s border colour, click the colour swatch in the Colour column. The change applies everywhere the tag appears.

To delete a tag, click the delete button in the Actions column.