> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plerion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Access review

> Assign a grantee, record a decision, trust a grant until its review date, and keep a full audit history

With **[resource access grants](https://app.plerion.com/entitlements/access-grants)**, you can audit and review each grant over time: assign a grantee, record what should happen to it, note why it exists, and schedule when to look again. One decision, `Trust until review`, also trusts the grant for a fixed period. Every change is kept in a per-grant audit history.

***

## What reviewing adds

Classifying a grant by scope, origin, and trust tells you what the grant *is*. Reviewing records what your team has *decided* about it and who is accountable, so the set of grants stays understood as it changes.

`Keep`, `Remove`, and `Review later` are records only: they change nothing about a grant's classification or its findings. `Trust until review` is different. It opens a time-boxed [trust window](#trusting-a-grant-until-its-review-date) that makes the grant `Trusted` until the review date you set.

***

## Review fields

Each grant carries four review fields.

| Field | What it records |
| - | - |
| **Grantee** | The team or person accountable for the grant. |
| **Decision** | What should happen to the grant: `Keep`, `Remove`, `Review later`, or `Trust until review`. |
| **Comment** | Why the access exists, or any note worth keeping for the audit trail. |
| **Next review** | The date to look at the grant again. |

All four are optional, and every field can be changed at any time. Each change is recorded in the grant's [review history](#review-history).

Two decisions interact with **Next review**:

* `Review later` fills in a date three months out if you have not set one.
* `Trust until review` requires a date. See [Setting the trust window](#setting-the-trust-window).

***

## Finding the grants that need attention

Three controls narrow the inventory to review work:

* The `Past due` preset above the table shows grants whose next-review date has passed. Grants with no review date set are not included.
* The **Decision** filter selects grants by recorded decision. Grants with no decision are not returned, so it cannot be used to find unreviewed grants.
* The **Next review** filter takes a **From** and a **To** date. Grants with no review date set are not returned.

The **Grantee** filter searches the grantee field, so you can pull up everything one team owns.

<Note>
  There is no filter for the `Needs re-review` state. Those grants are `Untrusted`, so they appear under the `Untrusted external` preset. To list them exactly, export the table and filter the export on the column recording why a trust window lapsed.
</Note>

***

## Reviewing in the table

The grants table has two column layouts, chosen from the view control next to the column options above the table:

* **List** shows the default reference columns (mechanism, scope, origin, and the rest).
* **Access review** replaces some of those columns with the editable **Grantee**, **Decision**, **Comment**, and **Next review** fields.

In the Access review layout you can review grants directly in the table. Each cell saves on its own as soon as you finish editing it, and there is no separate save step. An overdue **Next review** date is shown in red. The chosen layout is kept in the page URL, so you can reload or share a link and stay in it.

<Frame>
  <img src="https://mintcdn.com/pleriondocs/aS40Jmo7-QpGM2iw/images/platform/resource-access-grants/access-review-view.jpg?fit=max&auto=format&n=aS40Jmo7-QpGM2iw&q=85&s=3a1ee3a9916280091daf79e8d81965ce" alt="Grants table in the Access review layout with editable Grantee, Decision, Comment and Next review cells, and overdue dates in red" width="3064" height="1166" data-path="images/platform/resource-access-grants/access-review-view.jpg" />
</Frame>

<Tip>
  Combine the Access review layout with the `Untrusted external` preset and the filter panel to work through the grants most likely to need a decision first.
</Tip>

***

## Reviewing in the grant detail

Select any row to open the grant's slide-over, then open the **Access review** tab. The tab shows the same review fields for that one grant, with **Grantee**, **Decision**, and **Next review** on a single line and **Comment** below.

Unlike the table, the tab does not save as you type. Change what you need, then select `Save review`. The whole edit is recorded as one history entry.

<Frame>
  <img src="https://mintcdn.com/pleriondocs/DbvKq1H34qA96UzT/images/platform/resource-access-grants/access-review-tab.jpg?fit=max&auto=format&n=DbvKq1H34qA96UzT&q=85&s=3785a7f067fb5c94ff550d670756cca5" alt="Access review tab on a grant slide-over showing the Grantee, Decision, Next review and Comment fields, the Save review button, and the review history below" width="2516" height="1246" data-path="images/platform/resource-access-grants/access-review-tab.jpg" />
</Frame>

***

## Trusting a grant until its review date

Select `Trust until review` to accept a single grant for a fixed period. Plerion sets the grant's **Trust** to `Trusted` and shows the end date on the badge, for example `Trusted until 31 Jan 2027`. From the next scan, the grant stops counting toward its asset's [untrusted external access finding](/guides/platform/resource-access-grants/findings). Trust is recalculated on every scan, so a window you open, a review date you edit, and a window that runs out all take effect on the next scan rather than immediately.

Use it when access is expected but you do not want to trust the principal everywhere. Adding a principal to your [trusted principals](/guides/platform/resource-access-grants/trusted-principals) list clears its grants across every resource it touches and does not expire. `Trust until review` covers one grant and ends on a date you choose.

`Trust until review` is available on external grants only. Internal grants raise no findings, so there is nothing to suppress.

<Warning>
  `Trust until review` does not change the access and it does not close the finding. It records that you accepted one grant for a period. An asset's finding stops failing only once every external grant on it is trusted, and on the review date the grant returns to `Untrusted` and the finding fails again unless someone acts.
</Warning>

### Setting the trust window

Select `Trust until review` and the review-date picker opens. It offers `30d`, `90d`, `180d`, and `1y`, or you can pick a date.

<Frame>
  <img src="https://mintcdn.com/pleriondocs/aS40Jmo7-QpGM2iw/images/platform/resource-access-grants/trust-until-review-popover.jpg?fit=max&auto=format&n=aS40Jmo7-QpGM2iw&q=85&s=60d5e3e2c3837313f91a0fbc943d20ec" alt="Trust until review date picker showing the 30d, 90d, 180d, and 1y presets, a review date field, and the Trust button" width="780" height="620" data-path="images/platform/resource-access-grants/trust-until-review-popover.jpg" />
</Frame>

* A review date is required. Without one the trust window would have no end.
* The date must be in the future.
* The window can run at most one year ahead. Re-trusting is always available, so a long-lived grant comes back for a decision each year instead of being suppressed permanently.
* If the grant's permissions changed while it was trusted, moving the review date out is refused. Review the grant as it stands now, then trust it again if it is still expected.

### When trust ends

A trust window closes in three ways, and the **Trust** badge tooltip says which one applied.

| What happened | What Plerion does |
| - | - |
| **`Review date passed`**: the window reached its end date. | The grant returns to `Untrusted` and to the review queue. The decision and date stay in place so you can see what was last decided and when it was due. |
| **`Review date cleared`**: someone removed the next-review date. | The grant returns to `Untrusted`. |
| **`Permissions changed after it was trusted`**: the grant's actions, conditions, or resource scope changed. | Trust ends early, the decision and date are cleared, and the grant shows `Needs re-review`. |

The third case is the one that needs a person. Plerion records the exact permissions you approved, so a policy that is later widened cannot inherit the trust you gave the narrower version. Reordering actions, changing their case, or reordering condition keys does not end trust, because the access is unchanged.

Plerion does not notify you when a window closes. The grant starts failing its asset's finding again on the next scan, and the `Past due` preset lists the grants whose review date has passed.

***

## Review history

The **Access review** tab also shows the grant's review history below the fields, newest first. Each entry records who made the change, when they made it, and what changed. Entries capture only the fields that changed, so the history reads as a running account of the grant's review rather than a repeated snapshot.

Some entries are recorded by Plerion rather than by a person, and show **System** as the author. These are the points where a trust window opened or closed on its own, such as a window reaching its end date.

***

## Related pages

* [Resource access grants overview](/guides/platform/resource-access-grants/overview): The full inventory, presets, and filters.
* [External access](/guides/platform/resource-access-grants/external-access): The grants that reach principals outside your organization.
* [Trusted principals](/guides/platform/resource-access-grants/trusted-principals): Confirm which external principals are expected.
* [Untrusted external access findings](/guides/platform/resource-access-grants/findings): How unconfirmed external grants surface as findings.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.