Starting & Stopping Sessions
Starting a Session
Navigate to Sessions in the sidebar.
- Select a session duration from the dropdown at the top of the page. Available options: 1h, 2h, 4h, 8h, 12h, or 24h (options limited by your subscription tier and role settings).
- Click Start Session.
EntryGuard automatically detects your current IP address and whitelists it on all cloud resources assigned to you. The session appears in your sessions table with a PENDING status, which changes to ACTIVE once all rules are applied (usually within a few seconds).
You don't need to specify which resources to whitelist — EntryGuard automatically applies rules to all resources assigned through your roles.
What You'll See
After starting a session, a new row appears in the sessions table with these columns:
| Column | Description |
|---|---|
| IP Addresses | Your detected IPv4 and/or IPv6 addresses, labeled with v4 and v6 badges |
| Status | Current session status (PENDING, ACTIVE, PARTIAL, etc.) |
| Resources | Number of resources the session applies to |
| Expires | When the session will automatically end |
| Actions | Stop and extend buttons |
Click on a session row to expand it and see per-resource details, including the resource name, IP address, status, and any error messages.
Stopping a Session
To stop an active session before it expires:
- Find the session in your sessions table.
- Click the Stop button (square icon) in the Actions column.
The session transitions to EXPIRING while IP rules are being removed, then to CANCELLED once all rules are revoked. This usually takes a few seconds.
You can only stop sessions that are in ACTIVE, PENDING, or PARTIAL status.
Viewing Session Details
Your sessions table on the Sessions page shows all your sessions, including active and past ones.
Click on any session row to expand it and see the per-resource breakdown:
| Column | Description |
|---|---|
| Resource | The cloud resource name |
| IP | The IP address whitelisted |
| Status | APPLIED, PENDING, FAILED, REMOVING, or REMOVED |
| Error | Error message if the rule failed to apply |
Common Errors
- "Duration exceeds maximum allowed" — Your selected duration exceeds your tier or role limit. Choose a shorter duration.
- "User has no accessible cloud resources" — No resources are assigned to you. Ask your admin to assign you to a role with resources.
API Reference: For programmatic access, see Start Session and Stop Session.