ISA sessions

The ISASessions endpoint is for Information Systems Administrator (ISA) role access.

For more information on Requestor and Requestor/Approver role access, please see the following:

POST ISASessions

Purpose

Creates a new Information Systems Administrator (ISA) release request and returns the requested session.

Similar to POST Requests and POST Sessions in a single call.

Required roles

  • ISA role to managed account referenced by ID.

Request body

Content-Type: application/json

{
    SessionType : string,
    SystemID: int,
    AccountID: int,
    DurationMinutes : int, // can be null
    ApplicationID: int, // can be null
    Reason : string
}

Request body details

  • SessionType: (required) The type of session to create.
  • SystemID: (required) ID of the managed system to request.
  • AccountID: (required) ID of the managed account to request.
  • DurationMinutes: (optional) The request duration (in minutes). If omitted, uses the value ManagedAccount.ISAReleaseDuration.
  • ApplicationID: (required when AccessType = App or AccessType = AppFile) ID of the application to request.
  • Reason: (optional) The reason for the request.

Response body (SSH or sshticket)

Content-Type: application/json

{
    ID : string,
    Ticket : string,
    Host : string,
    Port : string,
    TicketAtHost : string,
    Link : string,
    Command : string
}

Response body (RDP or rdpticket)

Content-Type: application/json

{
    ID : string, 
    Ticket : string, 
    Host : string, 
    Port : string
}

Response body (rdpfile or appfile)

RDP file as an attachment.

Response codes

201- Request successful. Session details or RDP file in the response body.

For more information, please see Common response codes.