Skip to main content
Oplane uses a layered access model. Permissions are determined by your organisation role and workspace membership, with threat model access inherited from the workspaces they belong to.

Organisation roles

Every user belongs to an organisation with one of these roles:

What each role can do

Workspace access

Workspaces have their own access layer that determines who can view and modify the threat models within them.

Workspace types

If an Oplane organisation claims the repository’s Git namespace (the GitHub organisation or GitLab group), membership of the claiming organisation grants runtime access to it. Oplane doesn’t rely on each user’s personal Git OAuth check in that case. See Namespace claims.

Access types

Shared and repository workspaces have a configurable access type:

Workspace permissions

Within a shared or repository workspace, permissions depend on your relationship to the workspace:

Transferring workspace ownership

The workspace owner or an org admin can transfer ownership of a shared or repository workspace to another member:
  1. Open the workspace’s Access panel.
  2. On the row of the member you want to make owner, open the actions menu (⋮).
  3. Select Make owner and confirm the transfer.
After the transfer:
  • The selected member becomes the workspace owner.
  • The previous owner keeps access as a regular member.
The new owner must be a member of the organisation. Personal workspaces cannot change owner.

Threat model access

Access to threat models is inherited from workspaces. If you can access any workspace that contains a threat model, you can view and update it. Security requirements inherit access from their parent threat model.
A threat model can belong to multiple workspaces. A user only needs access to one of those workspaces to view and edit the threat model.

Invite members

Org admins invite people to the organisation by email. Each invite is tied to one email address and expires after 7 days. Until someone accepts, their invite appears under Pending invites, where you can resend it. You can open the invite dialog from two places:
  • Organisation settings: Open the Members tab and click Invite members.
  • A workspace: In the workspace’s Access panel, type the email address of someone who isn’t in the organisation yet, then select Invite ”…”. The person joins the organisation and the workspace when they accept.

Invite people one at a time

  1. Open the invite dialog.
  2. Enter each person’s email address and, optionally, their name. Pick a role for each person: Org Member or Org Admin. Click Add another to add more rows.
  3. Optionally, add a personal message.
  4. Click Invite team members.
Use this dialog when you want to invite someone directly as Org Admin.

Invite many people at once

Bulk invite lets you invite a whole team from a pasted list, a CSV file, or an Excel (.xlsx) file.
  1. Open the invite dialog and click Paste a list or upload a file. Anything you already typed is carried over.
  2. Paste email addresses into the Email addresses box, or click Upload CSV or Excel and choose a .csv or .xlsx file.
  3. Check the count. Oplane checks the list as you edit it and shows how many people will be invited, and which rows it will skip.
  4. Optionally, add a personal message.
  5. Click Send invites.
In a pasted list, separate entries with new lines, commas, or semicolons. To include a name, write the entry as Name <email>. Quote a name that contains a comma.
In a file, give the email column the header Email. Without that header, Oplane uses the only column that contains an ”@”.

How bulk invites work

  • Everyone you invite in bulk joins as Org Member. To invite someone as Org Admin, invite them one at a time, or change their role after they join.
  • Oplane skips people who are already members of the organisation.
  • Duplicate addresses become one invite.
  • If someone already has a pending invite, Oplane replaces it with a new invite link and sends a new email. This applies even if the pending invite was for Org Admin.
  • Rows that can’t be invited are listed under Skipped addresses with their row number and the reason, such as “Missing “@”” or “Contains a space”. Everyone else is invited when you send. You can fix the skipped rows in the box first, or send without them.
  • If Oplane creates the invites but can’t send every email, the dialog tells you. Use Resend invite under Pending invites to send them again.

Limits

Names and messages can use any script, including non-Latin characters and emoji. An emoji counts as two characters toward the limit.

Files that Oplane refuses

Oplane refuses the whole file, and tells you why, when:
  • More than one column contains an ”@” and no column is headed Email. Head the column to invite Email, or remove the other columns.
  • An Excel file has a hidden sheet, or content in hidden rows or columns. Rows and columns of zero height or width count as hidden. Unhide or delete them, then upload the file again.
  • The email column contains formulas. Copy the column, paste it as values, then upload the file again.
  • The file has more than 100 columns and none of the first 100 is headed Email.

How roles are assigned

  • Organisation role: Set by an existing org admin via the organisation settings. New members join as Org Member by default. Bulk invites always use Org Member. See Invite members.
  • Workspace membership: Added by the workspace owner, an existing workspace member, or an org admin.
  • Workspace ownership: The user who creates the workspace becomes its owner. The current owner or an org admin can transfer ownership. See Transferring workspace ownership.

Workspaces

Learn about creating and configuring workspaces.