Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 47 additions & 5 deletions trustgate/access/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,9 @@ Every person has an **access level**, and it is the first of these that is set:
2. The most permissive level among the groups their login carries.
3. The gateway's **default access**.

On top of that, [Everyone](#everyone-and-bulk-assign) can raise the level of the
people in the groups that receive it. It only ever adds access.

| Level | What it means |
|---|---|
| **All** | Every resource, including ones added later. |
Expand Down Expand Up @@ -69,14 +72,18 @@ to LLM providers:
| **None** | No models. |

Models add up rather than taking the first level set. A person reaches what
their own level, their groups and the default give, together, with three
exceptions:
their own level, their groups and [Everyone](#everyone-and-bulk-assign) give,
together, with three exceptions:

- Their own **None** means no models at all.
- Without a level of their own, a group at **None** wins over their other groups
and the default.
- A provider on their own level replaces that provider from their groups and the
default, so their own selection of it is the one that counts.
and Everyone.
- A provider on their own level replaces that provider from their groups and
Everyone, so their own selection of it is the one that counts.

Everyone's models reach a person only through a group that receives Everyone.
A person in no group, or only in excluded groups, gets nothing from it, and
neither does their personal key with no group.

A level gives a person nothing to configure: their [personal key](/trustgate/mcp/store#personal-key)
reaches what it grants, and the [Employee portal](/trustgate/mcp/store#models)
Expand All @@ -86,6 +93,41 @@ It is enforced by the gateway on every call: a model the person's level does not
reach is refused before any provider is called, whoever else uses that provider.
A change applies to the person's key within seconds.

## Everyone and bulk Assign

**Access › Groups** opens with **Everyone**: the organization-wide permissions,
the models and MCP servers every group receives. Groups inherit them, and their
members get them through their groups.

- **Manage** opens the Everyone panel. Models and MCP each take **Select all**,
which covers every model or MCP server on the gateway, including ones added
later, or a list you build.
- Everyone only adds access. It never lowers a group's level or replaces what
the group has of its own.
- **Group exceptions** are the groups that do not receive Everyone. A group whose
own level is **None** does not receive it either.
- A group's panel lists what it gets from Everyone as locked rows.
- **Remove** stops every group receiving Everyone and clears the exceptions. The
access each group has of its own is kept.

**Assign** changes the access of several groups in one go. Pick the groups, or
**Select all groups**, then set **Models** and **MCP** with the same **All**,
**Selected** and **None** levels:

- **All** and **None** set each group's level. **None** leaves the group without
that access at all, including what it would get from Everyone.
- **Selected** takes the models or MCP servers you pick, and a condition:
- **Add to existing access** adds them to each group's own list.
- **Replace existing access** makes each group's own list exactly these.
Everyone stays.
- A section left empty keeps each group's access as it is.

When a change takes access away, Assign asks for confirmation first. A group
left without models also loses its API keys, immediately.

**Remove** in the same panel takes the selected models and MCP servers off each
group's own list. Levels do not change, and access from Everyone is kept.

## Requests instead of refusals

When someone on **Selected** wants a server outside their grants, or a model
Expand Down
Loading