Organizations & Teams

Organization (Org) is a way to group your people and your data.Usually you want it to correspond to your company, but sometimes it makes sense to keep it more granular and create separate orgs for different departments, etc.

Create Organization

Any user of the Public Peaksel Hub can create an Org and invite others to the Org.

For on-prem Peaksel installations this is configurable since usually you want only Global Admins to create orgs and assign permissions.In order to change that, set security.permissions.teams_can_create_orgs=Registered in docker-compose.yml.

Invite to Organization

The user must have signed in to Peaksel at least once for you to be able to invite them. Then go to Org Settings → Teams, and add them to the team of choice:

Org Settings button

Remove user from Organization

On the same screen (Org Settings → Users) you can remove users from the org.

Once removed, the user won’t be able to access org resources as before, even if the permissions were granted to them personally. Such user will have as much permissions in your org as any other just-registered user.

When user was part of the org, someone may have granted them permissions personally (as opposed to granting permissions to the Team). Such permission are completely wiped own when user is removed from an org. So if user is re-invited to the same org, their old personally-granted permissions won’t be restored.

Teams

When an Org is created, a set of standard Teams are added each with their own permissions:

  • Admins can manage the whole org, including billing. They can see, modify, delete, share everything.

  • Maintainers can view & change most of the org settings, but they don’t have access to the billing. By default, they have administrative access to the resources (injections & batches), but it’s possible to lower their permissions for each resource.

  • Creators are the typical users who can upload and process the data.

  • Viewers are those who can see all the resources by default but can’t modify anything. Useful to implement integration with other apps or scripts that want to receive the data from Peaksel.

Global Teams (on-prem)

Global Teams aren’t bound to any Org - they are Peaksel-wide teams. These are relevant only to non-cloud Peaksel installations. Global Admins see additional item Settings when clicking on their user icon. Global Teams:

  • Global Admins - can change Global Settings like default colors or max upload size, promote other users to Global Admins, set up automatic import (aka Crawlers) from remote locations like Windows Shared Folders and FTP servers.

  • Registered users - every user is part of this team, it’s used for some advanced Peaksel configuration e.g. to allow non-admin users create Orgs.

  • Public - for anonymous access (makes sense only in Hub mode). It’s possible to share resources with this team, which would allow anyone on the Internet to view that resource. Note, that if anonymous access to Peaksel is turned off completely, then granting access to Public won’t have any real effect.