GenGuard portal exception approvals
When GenGuard blocks a transfer, the user can optionally request a portal or email approval. Once or time-window grants return to Agent One or the browser so the user can retry via drag-and-drop.
GenGuard portal exception approvals
From Agent One 4.0.3596 (retry window hardened in 4.0.3600+) and GenGuard extension 3.4.8+, a blocked transfer can offer an optional exception request. The transfer stays blocked until the user chooses Request exception. After admin approval, the station shows approved and the user retries.
Requires:
- Agent One 4.0.3600+ recommended (Session-readable grant delivery + retry window after once-grants)
- GenGuard extension 3.4.8+ for the same opt-in button in the browser (Agent One enrolled for native host)
- GenGuard entitled; Security Policies → GenGuard → Files with Portal exception approval enabled
- Operators with policy write access for the GenGuard Exceptions queue
Desktop scope: drag-and-drop retry
On Agent One (endpoint GenGuard), portal exception approval and local unlock bypass are supported for Explorer drag-and-drop (and file clipboard paste) into covered apps.
Attach / paperclip / Open-file dialogs stay hermetic blocks. After an approval, tell users to drag the same file again from Explorer onto the covered app - do not rely on Attach as the exception retry path.
| Surface | Supported exception / bypass retry |
|---|---|
| Desktop drag-and-drop into covered apps | Yes |
| Desktop file clipboard paste | Yes |
| Desktop Attach / Browse / paperclip dialog | No - hermetic block only |
| Browser extension paste / upload / drop | Yes (with Agent One enrolled) |
Block vs Block with bypass vs portal exception
These are separate controls. Hermetic enforcement (no silent allow while OCR is still running; cancel Enter / double-click on Attach) applies to both Block and Block with bypass. Only Warn leaves the transfer open after a match.
| Files action | Portal exception approval | What the user gets after a block |
|---|---|---|
| Block | Off | Hard stop. No unlock code. No portal request. Fully hermetic. |
| Block with bypass | Off | Same hard stop, plus optional local admin unlock code (drag / clipboard). |
| Block or Block with bypass | On | Top bar: blocked + reported + Request exception. Local unlock code is not shown at the same time (no dual UI). |
Justified blocks do not open an Exceptions row automatically.
What the user sees (Agent One)
- GenGuard blocks a covered drag/clipboard file action and shows the top bar (Request exception / Dismiss). The offer bar closes after about 10 seconds if unused.
- Request exception → bar switches to waiting; a pending row appears under GenGuard → Exceptions.
- Admin Approve → station receives the grant (usually within about one minute). The same bar switches to approved for about 10 seconds.
- User retries with drag-and-drop of the same file within the short retry window (~90 seconds after the grant lands).
- Once grants allow the matching retry, then end. TTL grants allow matching transfers until the window expires.
Configure policy
In Security Policies → GenGuard → Files:
- Set the Files action to Block or Block with bypass.
- Optionally enable Portal exception approval.
- Choose Grant mode:
- Once (N transfers) - after approval, up to N matching retries are allowed.
- Time window - matching transfers are allowed until the TTL (minutes) expires.
- Optionally list Department approvers as
Department|emaillines.
Save the policy and Sync / Pull now on pilot stations. Reload the GenGuard extension after policy sync.
Operate the queue
Open GenGuard → Exceptions (sidebar under GenGuard).
| Action | Effect |
|---|---|
| Approve | Creates a grant, pushes genguard_exception_grant to the station, marks the request approved |
| Deny | Closes the request; the user stays blocked for that fingerprint |
| Sends (or re-sends) the department approver link when an email is on the request |
Audit actions include GENGUARD_EXCEPTION_REQUESTED, APPROVED, DENIED, and DELEGATED.
Validate
- Enable portal exception approval; set mode to Once with
1use. - On Windows Agent One 4.0.3600+, drag a matching file onto a covered app (for example ChatGPT Desktop).
- Confirm the top bar appears without a new Exceptions row until Request exception.
- Confirm a pending row after the request; Approve in the portal.
- Confirm the station bar shows approved, then drag the same file again within ~90 seconds - transfer should succeed.
- Drag again after the window - expect a new block (once grant consumed).
- Optional: confirm Attach/paperclip still blocks hermetically and is not the documented retry path.
