Roles and permissions
What you may do in SECURE Web App follows from your roles: one organization role in each organization you belong to, and a repository role in each repository you were given access to. The tables list what each role allows. ✓ means allowed, – means not allowed.
You can only give, change or take away a role whose rights you have yourself. Organization roles are given in Invite people to the organization, repository roles in Give people access to a repository.
Roles at a glance
The repository roles build on each other: in each table below, every role can do everything the role in the row before it can.
| TARA role | In short |
|---|---|
| TARA Viewer | Opens the TARA read-only and exports it. |
| TARA Contributor | Everything a TARA Viewer can, and edits the TARA. |
| TARA Author | Everything a TARA Contributor can, decides who has access to the TARA, and deletes it. |
| Threat catalog role | In short |
|---|---|
| Catalog Viewer | Opens the catalog, suggests changes and exports its data. |
| Catalog Contributor | Everything a Catalog Viewer can. |
| Catalog Maintainer | Everything a Catalog Contributor can, handles all change requests, decides who has access to the catalog, and deletes it. |
| Organization role | In short |
|---|---|
| Member | Works in the repositories they were given access to. |
| Maintainer | Sees every repository of the organization, opens every TARA read-only, suggests changes in every threat catalog, and manages the organization's members except the Owners. |
| Owner | Can do everything in the organization and in all of its repositories. |
The sections below list the details.
Organization roles
| Owner | Maintainer | Member | |
|---|---|---|---|
| Create repositories (New repository) | ✓ | ✓ | ✓ |
| See every repository of the organization | ✓ | ✓ | – (only repositories they hold a repository role in) |
| Manage the members of any repository of the organization | ✓ | – | – |
| Invite people to the organization, change organization roles, remove members | ✓ | ✓ | – |
| Assign repositories to members | ✓ | – | – |
Owners can also open, export and delete every repository of the organization and edit every TARA in it, without holding a repository role.
Maintainers open every TARA of the organization read-only and can suggest changes in every threat catalog, without holding a repository role. When they invite people or change and remove members, they can only give, change or take away roles whose rights they hold themselves: they cannot make anyone an Owner, and they cannot change or remove an Owner.
When you create a repository, you become its TARA Author, or for a threat catalog its Catalog Maintainer.
The role lists also offer Service; this guide does not cover it.
TARA roles
| TARA Author | TARA Contributor | TARA Viewer | |
|---|---|---|---|
| Open the TARA | ✓ | ✓ | ✓ |
| Edit the TARA | ✓ | ✓ | – |
| Export it, as XSAM or as a template | ✓ | ✓ | ✓ |
| Share it: invite people and change their roles | ✓ | – | – |
| Manage Members and Delete in the repository list | ✓ | – | – |
TARA Contributors and TARA Viewers see who has access to the TARA, but cannot change it. A TARA Viewer opens the TARA read-only, with a notice saying so.
Threat catalog roles
| Catalog Maintainer | Catalog Contributor | |
|---|---|---|
| Open the catalog | ✓ | ✓ |
| Suggest changes (Suggest Changes) | ✓ | ✓ |
| See the list of all change requests (Change requests) | ✓ | – |
| Export the catalog (Export Data) | ✓ | ✓ |
| Manage Members and Delete in the repository list | ✓ | – |
A Catalog Viewer can open the catalog, export its data and suggest changes: every organization role allows suggesting changes, and it adds to the catalog role.