Skip to content
Documentation

JIT access: approvals and access windows in Remote Access

This page is for the administrator who decides how people get into a remote host: at any time, or only after someone says yes, for a limited time. What the requester and the approver see is in Access request approval and remote sessions.

Who can do this. A Super admin or an Application admin sets the access policy. Approvers are the people and groups you list; they need no administrator role. Only a Super admin can Revoke approved access from the console.

What is needed first. A saved Remote Access resource assigned to an application, and the people who will use it assigned to that application.

The result. A person sees the resource on My Apps with Request access, asks with a reason and a duration, an approver decides from their approvals page, and the person can open the host only inside the approved window. Everything is recorded.

The examples use the fictional company Acme Corp, the employee Maria Lopez, the approver Pat Chen and the server Acme Build Server (SSH).

Mode What the console says What happens
Standing “Standing: everyone who may open it can, any time” Anyone in the audience opens the resource whenever they like, for up to its maximum session length.
Just in time “Just in time: a person asks, an approver says yes, for a limited time” A person requests access with a reason; one approver approves; the person may open the resource until the window ends.

A new resource has no access policy. The Access tab warns: “Access has not been set up for this resource. It is just-in-time with no approver, so nobody can request or open it until you save a policy here.”

  1. In the Admin Console, choose Secure access > Remote Access and open the resource.
  2. Open the Access tab. The top line shows the saved policy’s “Version N, saved … by …”.
  3. Under How access is granted, choose Just in time: a person asks, an approver says yes, for a limited time.
  4. Under Who may open it, choose Everyone assigned to the application, or Only these groups and people (who are also assigned) and use Add a group and Add a person (and Remove) to build the list.
  5. Under Approval, read the fixed rule: “The requester is never their own approver, whatever is listed. One approval is required in this version, and a reason is always required.” Under Approvers, add at least one group or person with Add a group / Add a person.
  6. Set the time limits:
Field Range Meaning
Longest access window (minutes, 15 to 1440) 15 minutes to 24 hours The most a person may ask for. The requester’s form shows it as “up to”, for example “up to 4 h”.
A request may wait (hours, 1 to 72) 1 to 72 hours How long a request stays Pending before it expires undecided. Approvers see it as “Expires if undecided at …”.
  1. Select Review changes. The panel Who loses access now lists each person affected by the change: “Could open or request access”, “Pending request revoked” or “Approved access revoked, live session ended”, or says “Nobody loses access.”
  2. Select Save access. The page says “Access saved.”

To let a capability (clipboard or file transfer) be granted per request rather than to everyone, turn it on With approval in the Capabilities section of the same tab; see File transfer and clipboard. The requester then ticks it under Also allow, and the approver may grant all, some or none of what was asked.

State How it gets there What the requester sees on My Apps
Pending The person selects Request access, gives a Reason (10 to 500 characters), a Duration in minutes (15 up to the longest window) and a Start (When approved, or At a time within 7 days). One pending request per person per resource. “Waiting for approval · requested 5 minutes ago”, with Cancel request
Approved An approver selects Approve. The window starts at approval (or at the requested start, if later) and lasts the requested duration, capped by the longest access window. “Approved · from 14:00 to 15:00” and “Opens at 14:00”, then “Access until 15:00 (42 min left)” with Open
Denied An approver selects Deny and confirms Deny request. “Denied by Pat Chen · note”, with Request again
Withdrawn The requester selects Cancel request. Request access again
Expired Nobody decided within A request may wait, or the approved window ended. Any live session is ended. “Expired …”, with Request again
Revoked A Super admin selects Revoke in the console, or the policy changed so the person is no longer allowed. Any live session is ended. “Revoked by … · note”, with Request again

A denied, expired or revoked outcome stays on the requester’s card for 24 hours, then the card returns to Request access.

  • Any person listed under Approvers, directly or through a listed group, except the requester: “You cannot decide your own request.”
  • The approver must have completed a second sign-in step within the last 10 minutes, of a kind the resource’s application accepts. Otherwise the approvals page says “Needs a second step from the last 10 minutes, of a kind this resource accepts. Sign in again and return here.”
  • One approval decides the request. There is no second approver and no approval step in the Admin Console: approvals happen on the approver’s own Approvals page on My Apps.
  • When SSOGEN has mail set up, each eligible approver gets one email per request, subject SSOGEN Remote Access approval waiting on followed by the SSOGEN address, with a Review request button. The email says nothing about who asked or why.

Inside an approved window, a session is also bound by the resource’s Maximum session (seconds) and Idle timeout (seconds) (set on the resource’s Overview tab; 300 to 86,400 and 60 to 86,400 seconds). The session page shows the sooner of the window end and the maximum session as “… left”; the console shows the moment a session must end at the latest as its Hard limit. When the window ends the person sees “Your access window ended or the session reached its time limit.”

  1. Choose Secure access > Remote Access and open the Requests tab (every resource) or a resource’s Requests tab.
  2. The table shows Requester, Resource, State, Reason, Asked for, Requested and Decided by. Under the reason: “Also asked for: …” and, once decided, “Approved with: …” or “Approved without extra capabilities”. Filter by State.
  3. To withdraw approved access, open the row menu of an Approved request and choose Revoke. The dialog Revoke Maria Lopez’s access? says: “Maria Lopez’s approved access to Acme Build Server (SSH) is withdrawn, and any session they have open on it is ended.” Select Revoke access.

On the resource’s Timeline and in Monitoring > Audit: Access requested (with “Reason:”, “Access: just in time”, “From:”, “Until:” and “Capabilities:”), Approved or Denied (with the approver, their “Note:” and what was approved), Request withdrawn, Access expired, Access revoked (with who and why), and Access settings changed when the policy is saved. See Remote Access session audit.

  1. As a person in the audience, open My Apps: the resource’s card reads “Requires approval · up to …” with Request access. Send a request.
  2. As an approver, open Access requests waiting for your approval on My Apps: the request is there with the reason. Select Approve.
  3. Back on the requester’s My Apps, the card reads “Access until … (… left)” with Open, and the resource opens.
  4. In the console, the resource’s Requests tab shows the request as Approved with Decided by filled in, and the Timeline shows Access requested followed by Approved.
What you see What it means What to do
“Choose at least one group or person, or allow everyone assigned to the application.” The audience is empty. Add someone, or choose Everyone assigned to the application.
“Choose at least one approver.” / “Just-in-time access needs at least one approver.” Just in time with no approver. Add an approver.
“The longest access window is a whole number of minutes from 15 to 1440 (24 hours).” / “A request may wait a whole number of hours from 1 to 72.” A limit is out of range. Correct it.
“The access policy changed since you opened it. It has been reloaded; make the change again.” Another administrator saved meanwhile. Make the change again.
“The access settings could not be saved.” The save failed. Try again.
A person’s card says “Access has not been set up yet” No policy is saved. Save one on the Access tab.
A person sees “You already have a request waiting for approval.” One pending request per person per resource. Wait for the decision or Cancel request.
A person sees “That duration is outside what this resource allows.” More than the longest access window, or under 15 minutes. Ask for less.
An approver sees “You are not an approver for this request.” They are not in the resource’s current approver list. Add them under Approvers.
An approver sees “The resource’s access settings changed and no longer allow this request. You can deny it.” The policy changed (for example to standing, or the requester left the audience) after the request was made. Deny it; the person requests again if needed.
“Only an approved request can be revoked.” / “That access could not be revoked.” The request is not approved, or the revoke failed. Check the State; try again.
Approvers get no email Mail is not set up, or the approver is the requester. Set up mail, or tell approvers to check Access requests waiting for your approval.
“Only a Super Admin can change this.” on Revoke Your role cannot revoke. Ask a Super admin, or change the policy so the person loses access (the review panel ends their session).

Related: Remote Access to SSH, RDP and VNC hosts, Access request approval and remote sessions.