Two ways to use Sudo
Sudo as a teammate
A tenant admin opens Admin Settings → Users, finds a user in their
tenant, and clicks Sudo. No invitation needed: admins already have full authority
in the tenant.
Grant Gravity support access
A tenant admin invites a Gravity support engineer by email and sets how long
the access lasts. The engineer signs in through a dedicated Gravity-only
entry point and can then sudo as a user in the tenant.
Sudoing as a teammate
- Open Admin Settings → Users.
- Find the user you want to act as.
- Click the Sudo icon on their row.
The Sudo button is only available to tenant admins, and only for active users
in your own tenant.
Granting Gravity support access
If a Gravity support engineer needs to investigate something in your tenant, grant them temporary access from Admin Settings → Support Access.- Open Admin Settings → Support Access.
- Enter the Gravity engineer’s email address.
- Choose how long the grant lasts: 8 hours, 24 hours, 7 days, or 30 days.
- Add a short note describing the reason (e.g. a support ticket number). The note is required so the access is traceable.
- Click Grant access.
Revoking access
A grant can be revoked at any time. From the Support Access section, find the grant and click Revoke. Any sudo session running under that grant ends within 15 minutes. Gravity’s session is rechecked every 10 minutes while the tab is open, and a revoked grant fails the next check. Without a successful recheck, the session token expires after 15 minutes.What changes during a sudo session
- The sudo control is always visible: orange for intra-tenant sudo, red for Gravity support sudo. It shows who the session is acting as, and clicking it reveals an Exit sudo button.
- Your normal session is preserved. Exiting sudo (or letting the session expire) drops you back into your own account, not the login screen.
- A sudo session can do anything the target can do. This is intentional: the point is to reproduce what the target sees, including saving forms, running analyses, and editing settings. Be deliberate about destructive actions.
- Everything is logged. Every action taken during a sudo session is recorded in your tenant’s activity log, along with the identity of the real driver, so “what did Drew do while signed in as Alice” is fully attributable.
FAQ
Will the user I'm sudoing as be notified?
Will the user I'm sudoing as be notified?
No notification is sent. Sudo activity is recorded in your tenant’s activity
log, which admins can review.
How long does a sudo session last?
How long does a sudo session last?
A session lasts 15 minutes and refreshes silently every 10 minutes while
the tab is open, and again when the tab regains focus. Exiting sudo or
closing the tab ends the session immediately. For Gravity-support sudo, the underlying grant also has its own
TTL (8 hours to 30 days), and once that expires, no new sessions can start,
even if the engineer is mid-investigation.
Who can use Sudo?
Who can use Sudo?
Only tenant admins. Analysts and viewers do not see the Sudo button on the
Manage Users page and cannot start a sudo session through the API.
Can I tell which users have used Sudo?
Can I tell which users have used Sudo?
Yes. Sudo events (
session started, session ended, grant created,
grant revoked) flow through the same activity stream as the rest of Orion.
Contact your Gravity account team if you need a custom report.