Skip to main content
Sudo lets an admin temporarily act as another user. It helps when a teammate reports a bug an admin cannot reproduce, or when Gravity support needs to investigate something specific to your tenant. During a sudo session, every page shows a sudo control naming the user being acted as, and every session is recorded in your tenant’s activity log.

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

  1. Open Admin Settings → Users.
  2. Find the user you want to act as.
  3. Click the Sudo icon on their row.
Orion reloads on the home page, now acting as that user. An orange sudo control in the bottom-right corner shows the target user’s email. Click it to see the session details and the Exit sudo button. Drag it to any corner to move it.
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.
  1. Open Admin Settings → Support Access.
  2. Enter the Gravity engineer’s email address.
  3. Choose how long the grant lasts: 8 hours, 24 hours, 7 days, or 30 days.
  4. Add a short note describing the reason (e.g. a support ticket number). The note is required so the access is traceable.
  5. Click Grant access.
The Gravity engineer can then sign in through Gravity’s dedicated support entry point. Once signed in, they pick a user to sudo as. A red sudo control appears on every page they visit. Clicking it shows the engineer’s email and the user they are acting as.
Granting access lets a Gravity engineer sign in to your tenant and act as one of your users. Only grant access in response to a request you initiated (a support ticket, an incident, or a scheduled investigation) and pick the shortest TTL that covers the work.

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

No notification is sent. Sudo activity is recorded in your tenant’s activity log, which admins can review.
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.
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.
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.