openapi: 3.0.0
info:
title: Secret Server Rest Activations SecretSessions API
description: REST API documentation for Secret Server. This document describes how to use the REST API. All requests require an authentication token; please see the authentication document for more information. The Swagger specification for this API is also available.
termsOfService: https://delinea.com/eula
contact:
name: Support
url: https://delinea.com
version: 11.7.2
servers:
- url: /SecretServer/api
security:
- BearerToken: []
tags:
- name: SecretSessions
description: View recorded sessions
paths:
/v1/recorded-sessions/ssh-session:
get:
tags:
- SecretSessions
summary: Get the SSH proxy session data
description: Get the SSH proxy session data
operationId: SecretSessionsService_GetSshProxyData
parameters:
- name: auditSecretId
in: query
description: Either the secret session ID or the secret audit record ID or secret session key must be passed
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: byteLimit
in: query
description: Amout of data in bytes to return
required: false
x-nullable: true
schema:
type: integer
format: int64
- name: filterType
in: query
description: Filter by server, client, or both
required: false
schema:
type: string
- name: searchTerm
in: query
description: Search term to filter
required: false
schema:
type: string
- name: secretSessionId
in: query
description: Either the secret session ID, the secret audit record ID, secret session key, or the session GUID must be passed
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: secretSessionKey
in: query
description: Either the secret session ID, the secret audit record ID, secret session key, or the session GUID must be passed
required: false
schema:
type: string
- name: sessionGuid
in: query
description: This can be the secret session key or the launcher guid Either the secret session ID, the secret audit record ID, secret session key, or the session GUID must be passed
required: false
schema:
type: string
responses:
'200':
description: SSH Proxy Session Data
content:
application/json:
schema:
$ref: '#/components/schemas/SshProxyDataSearchViewModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/ssh-session-file:
get:
tags:
- SecretSessions
summary: Get the SSH proxy session data as an attached file
description: Get the SSH proxy session data as an attached file
operationId: SecretSessionsService_GetSshProxyDataAsFile
parameters:
- name: auditSecretId
in: query
description: Either the secret session ID or the secret audit record ID or secret session key must be passed
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filterType
in: query
description: Filter by server, client, or both
required: false
schema:
type: string
- name: searchTerm
in: query
description: Search term to filter
required: false
schema:
type: string
- name: secretSessionId
in: query
description: Either the secret session ID, the secret audit record ID, secret session key, or the session GUID must be passed
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: secretSessionKey
in: query
description: Either the secret session ID, the secret audit record ID, secret session key, or the session GUID must be passed
required: false
schema:
type: string
- name: sessionGuid
in: query
description: This can be the secret session key or the launcher guid Either the secret session ID, the secret audit record ID, secret session key, or the session GUID must be passed
required: false
schema:
type: string
responses:
'200':
description: SSH Proxy Session Data as an attached file
content:
application/json:
schema:
$ref: '#/components/schemas/StreamContentResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/secret-sessions/{id}/summary:
get:
tags:
- SecretSessions
summary: Get a summary of the secret session data
description: Get a summary of the secret session data
operationId: SecretSessionsService_GetSecretSessionBySecretSessionId
parameters:
- name: id
in: path
description: id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Secret Session Summary
content:
application/json:
schema:
$ref: '#/components/schemas/SecretSessionSummaryModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions:
get:
tags:
- SecretSessions
summary: Search Recorded Sessions
description: Search, filter, sort, and page recorded sessions
operationId: SecretSessionsService_SearchSessions
parameters:
- name: filter.active
in: query
description: Filter by active or inactive status
required: false
x-nullable: true
schema:
type: boolean
- name: filter.dateRange
in: query
description: Return sessions within a certain number of days
required: false
x-nullable: true
schema:
type: string
format: time-span
- name: filter.endDate
in: query
description: EndDate
required: false
x-nullable: true
schema:
type: string
format: date-time
- name: filter.endTime
in: query
description: EndTime
required: false
schema:
type: string
- name: filter.excludedApplications
in: query
description: Exclude particular Applications from search
required: false
explode: true
schema:
type: array
items:
type: string
- name: filter.folderId
in: query
description: Filter by folder
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filter.groupIds
in: query
description: Return sessions for specific groups
required: false
explode: true
schema:
type: array
items:
type: integer
- name: filter.hasError
in: query
description: Filter to only records with errors
required: false
x-nullable: true
schema:
type: boolean
- name: filter.includeNonSecretServerSessions
in: query
description: IncludeNonSecretServerSessions
required: false
x-nullable: true
schema:
type: boolean
- name: filter.includeOnlyLaunchedSuccessfully
in: query
description: Return only sessions that launched successfully
required: false
x-nullable: true
schema:
type: boolean
- name: filter.includeRestricted
in: query
description: Whether to include restricted secret sessions
required: false
schema:
type: boolean
- name: filter.includeSubFolders
in: query
description: Whether to include subfolders in a folder search
required: false
schema:
type: boolean
- name: filter.launcherTypeId
in: query
description: Filter by launcher type
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filter.searchText
in: query
description: Search text
required: false
schema:
type: string
- name: filter.searchTypes
in: query
description: Specifies the sources of information you want to search across, can be many of (SecretItems, Username, Hostname, Domain, RdpKeystroke, RdpApplication, ProxyClient)
required: false
explode: true
schema:
type: array
items:
type: string
- name: filter.secretIds
in: query
description: Return sessions for specific secrets
required: false
explode: true
schema:
type: array
items:
type: integer
- name: filter.siteId
in: query
description: SiteId
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: filter.startDate
in: query
description: StartDate
required: false
x-nullable: true
schema:
type: string
format: date-time
- name: filter.startTime
in: query
description: StartTime
required: false
schema:
type: string
- name: filter.userIds
in: query
description: Return sessions for specific users
required: false
explode: true
schema:
type: array
items:
type: integer
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Recorded session search result object
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfSecretSessionSummary'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/{id}:
get:
tags:
- SecretSessions
summary: Get Recorded Session
description: Get a single recorded session by ID
operationId: SecretSessionsService_Get
parameters:
- name: id
in: path
description: Recorded session ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Recorded session object
content:
application/json:
schema:
$ref: '#/components/schemas/SecretSessionModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/{id}/summary:
get:
tags:
- SecretSessions
summary: Recorded Session Summary
description: Get the summary for a recorded session
operationId: SecretSessionsService_GetSummary
parameters:
- name: id
in: path
description: Recorded session ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Recorded session summary
content:
application/json:
schema:
$ref: '#/components/schemas/SecretSessionSummary'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/{id}/points-of-interest:
get:
tags:
- SecretSessions
summary: Recorded Session Points of Interest
description: Get the points of interest for a recorded session
operationId: SecretSessionsService_SearchPointsOfInterest
parameters:
- name: id
in: path
description: Recorded session ID
required: true
schema:
type: string
format: uuid
- name: filter.searchText
in: query
description: Search text
required: false
schema:
type: string
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Recorded session points of interest
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfSecretSessionPointOfInterestModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/{id}/points-of-interest-summary:
get:
tags:
- SecretSessions
summary: Recorded Session Points of Interest Summary
description: Get the points of interest summary for a recorded session
operationId: SecretSessionsService_SearchPointsOfInterestSummary
parameters:
- name: id
in: path
description: Recorded session ID
required: true
schema:
type: string
format: uuid
- name: filter.searchText
in: query
description: Search text
required: false
schema:
type: string
- name: skip
in: query
description: Number of records to skip before taking results
required: false
schema:
type: integer
format: int32
- name: sortBy[0].direction
in: query
description: Sort direction
required: false
schema:
type: string
- name: sortBy[0].name
in: query
description: Sort field name
required: false
schema:
type: string
- name: sortBy[0].priority
in: query
description: Priority index. Sorts with lower values are executed earlier
required: false
schema:
type: integer
format: int32
- name: take
in: query
description: Maximum number of records to include in results
required: false
schema:
type: integer
format: int32
responses:
'200':
description: Recorded session points of interest summary
content:
application/json:
schema:
$ref: '#/components/schemas/PagingOfISecretSessionPointOfInterestSummaryModel'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/{id}/session-recordings/{fileName}:
get:
tags:
- SecretSessions
summary: Get Recorded Session Video Stream
description: Get the video stream for a recorded session
operationId: SecretSessionsService_GetSessionRecording
parameters:
- name: fileName
in: path
description: fileName
required: true
schema:
type: string
- name: id
in: path
description: Recorded session ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Recorded session video stream
content:
application/json:
schema:
$ref: '#/components/schemas/StreamContentResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/{id}/session-recordings:
get:
tags:
- SecretSessions
summary: Get Recorded Session Video Stream by ID
description: Get the video stream for a recorded session by ID
operationId: SecretSessionsService_GetSessionRecordingById
parameters:
- name: id
in: path
description: Recorded session ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Recorded session video stream
content:
application/json:
schema:
$ref: '#/components/schemas/StreamContentResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/session-image-by-key/{secretSessionKey}/{imageId?}:
get:
tags:
- SecretSessions
summary: Get Session Image By the Session Key
description: Get Session Image By the Session Key
operationId: SecretSessionsService_GetSessionImageByKey
parameters:
- name: imageId
in: query
description: imageId
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: secretSessionKey
in: path
description: secretSessionKey
required: true
schema:
type: string
responses:
'200':
description: Get Session Image By the Session Key
content:
application/json:
schema:
$ref: '#/components/schemas/FileContentResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/session-image-by-launcher-guid/{launcherGuid}/{imageId?}:
get:
tags:
- SecretSessions
summary: Get Session Image By the Launcher Session Guid
description: Get Session Image By the Launcher Session Guid
operationId: SecretSessionsService_GetSessionImageLauncherGuid
parameters:
- name: imageId
in: query
description: imageId
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: launcherGuid
in: path
description: launcherGuid
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Get Session Image By the Launcher Session Guid
content:
application/json:
schema:
$ref: '#/components/schemas/FileContentResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/session-image/{secretSessionId}/{imageId?}:
get:
tags:
- SecretSessions
summary: Get Session Image
description: Get Session Image
operationId: SecretSessionsService_GetSessionImage
parameters:
- name: imageId
in: query
description: imageId
required: false
x-nullable: true
schema:
type: integer
format: int32
- name: secretSessionId
in: path
description: secretSessionId
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Get Session Image
content:
application/json:
schema:
$ref: '#/components/schemas/FileContentResult'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/session-frames/{secretSessionId}/{topImageIdRecovered}:
get:
tags:
- SecretSessions
summary: Get Session Frames
description: Get Session Frames
operationId: SecretSessionsService_GetSessionFrames
parameters:
- name: secretSessionId
in: path
description: secretSessionId
required: true
schema:
type: integer
format: int32
- name: topImageIdRecovered
in: path
description: topImageIdRecovered
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Get Session Frames
content:
application/json:
schema:
description: Get Session Frames
items:
$ref: '#/components/schemas/SessionFrameModel'
type: array
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
/v1/recorded-sessions/{id}/request-processing:
post:
tags:
- SecretSessions
summary: Request Immediate Session Processing
description: Issues a request for the immediate processing of a session video
operationId: SecretSessionsService_ProcessSession
parameters:
- name: id
in: path
description: Recorded session ID
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Unknown or empty response
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestResponse'
'403':
description: Authentication failed
content:
application/json:
schema:
$ref: '#/components/schemas/AuthenticationFailedResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorResponse'
deprecated: false
components:
schemas:
Sort:
description: Sort options. Multiple sort options can be provided in the query string.
required:
- name
- direction
properties:
direction:
$ref: '#/components/schemas/SortDirection'
name:
description: Sort field name
type: string
priority:
description: Priority index. Sorts with lower values are executed earlier
type: integer
format: int32
type: object
SecretSessionActivityType:
description: Logged activity type
properties: {}
type: string
enum:
- SshKeyStroke
- ApplicationStartedOrExisting
- ApplicationEnd
- Keystroke
- Image
- ApplicationMadeActive
SessionFrameModel:
description: SessionFrameModel[]
properties:
captureTime:
description: Capture Time
type: string
format: date-time
description:
description: Description
type: string
imageId:
description: Image Id
type: integer
format: int32
type: object
SortDirection:
description: Sort direction
properties: {}
type: string
enum:
- None
- Asc
- Desc
Severity:
description: Error severity level
properties: {}
type: string
enum:
- None
- Retry
- Warn
- Critical
- Fatal
InternalServerErrorResponse:
description: Response object for internal server errors
required:
- message
- exceptionMessage
- exceptionType
- stackTrace
properties:
message:
description: Error message
type: string
exceptionMessage:
description: Error message from exception
type: string
exceptionType:
description: Exception type
type: string
stackTrace:
description: Exception stack trace
type: string
type: object
PagingOfSecretSessionSummary:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/SecretSessionSummary'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
BadRequestResponse:
description: Response object for invalid requests
required:
- message
properties:
message:
description: Error message
type: string
messageDetail:
description: Error message detail
type: string
errorCode:
description: Error message code
type: string
modelState:
description: An object describing validation errors
type: object
type: object
StreamContentResult:
description: StreamContentResult
properties: {}
type: object
SecretSessionSummary:
description: Recorded session summary
properties:
accessedByName:
description: AccessedByName
type: string
active:
description: Whether the recorded session is active
type: boolean
application:
description: Name of the Application launching the session
type: string
auditSecretId:
description: Associated access audit record
type: integer
format: int32
nullable: true
duration:
description: Duration of recorded session, in seconds
type: integer
format: int32
endDate:
description: Recorded session end time
type: string
format: date-time
nullable: true
endDateDisplay:
description: Recorded session end time (display format)
type: string
errorMessage:
description: Processing error message
type: string
fileExtension:
description: FileExtension
type: string
hasKeyStrokes:
description: Whether the recorded session has logged keystrokes
type: boolean
hasProcesses:
description: Whether the recorded session has info about running processes
type: boolean
hasProcessingError:
description: Whether an error occurred during video processing
type: boolean
isDeleted:
description: Whether the recorded session has been deleted
type: boolean
isLauncher:
description: IsLauncher
type: boolean
launchedSuccessfully:
description: Whether the session reached a state where it was active and not expired and had no other errors
type: boolean
nullable: true
launcherName:
description: Launcher name
type: string
launcherSessionGuid:
description: Launcher session unique identifier
type: string
format: uuid
launcherSessionStatus:
description: LauncherSessionStatus
type: integer
format: int32
launcherTypeId:
description: Launcher type
type: integer
format: int32
nullable: true
machineName:
description: Machine name
type: string
matchingSearchTypes:
description: MatchingSearchTypes
type: string
pbaId:
description: PbaId
type: integer
format: int64
nullable: true
secretId:
description: Secret ID
type: integer
format: int32
nullable: true
secretName:
description: Secret name
type: string
secretSessionId:
description: Recorded session ID
type: integer
format: int32
nullable: true
secretSessionUserName:
description: Recorded session username
type: string
sessionMovieProcessComplete:
description: Whether video processing is complete
type: boolean
startDate:
description: Recorded session start time
type: string
format: date-time
startDateDisplay:
description: Recorded session start time (display format)
type: string
userDomainName:
description: Active Directory domain name
type: string
userId:
description: User ID
type: integer
format: int32
nullable: true
userName:
description: User name
type: string
userNameForDisplay:
description: Recorded session username (display format)
type: string
type: object
SshProxyDataViewModel:
description: The session client and server data
properties:
clientData:
description: The client data recorded during the SSH session
type: string
created:
description: The create date time
type: string
format: date-time
serverData:
description: The server data recorded during the SSH session
type: string
type: object
PagingOfSecretSessionPointOfInterestModel:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/SecretSessionPointOfInterestModel'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
PagingOfISecretSessionPointOfInterestSummaryModel:
description: Specify paging and sorting options for querying records and returning results
properties:
batchCount:
description: Number of result batches available with current query options
type: integer
format: int32
currentPage:
description: Index of current result page
type: integer
format: int32
hasNext:
description: Whether there are any results in additional pages
type: boolean
hasPrev:
description: Whether there are any results in previous pages
type: boolean
nextSkip:
description: Correct value of 'skip' for the next page of results
type: integer
format: int32
pageCount:
description: Number of result pages available with current query options
type: integer
format: int32
prevSkip:
description: Correct value of 'skip' for the previous page of results
type: integer
format: int32
records:
description: Query results
items:
$ref: '#/components/schemas/ISecretSessionPointOfInterestSummaryModel'
type: array
severity:
$ref: '#/components/schemas/Severity'
skip:
description: Number of records to skip before taking results
type: integer
format: int32
sortBy:
description: List of sort properties
items:
$ref: '#/components/schemas/Sort'
type: array
success:
description: Whether the query executed successfully
type: boolean
take:
description: Maximum number of records to include in results
type: integer
format: int32
total:
description: Total number of results available
type: integer
format: int32
type: object
FileContentResult:
description: FileContentResult
properties:
contentType:
description: ContentType
type: string
fileContents:
description: FileContents
type: string
format: binary
fileDownloadName:
description: FileDownloadName
type: string
type: object
ISecretSessionPointOfInterestSummaryModel:
description: Query results
properties:
activityTypeGroup:
description: ActivityTypeGroup
type: string
launcherSessionGuid:
description: LauncherSessionGuid
type: string
format: uuid
score:
description: Score
type: integer
format: int32
secondsFromStart:
description: SecondsFromStart
type: integer
format: int64
timestampOffset:
description: TimestampOffset
type: string
format: time-span
type: object
SshProxyDataSearchViewModel:
description: SshProxyDataSearchViewModel
properties:
data:
description: The session client and server data
items:
$ref: '#/components/schemas/SshProxyDataViewModel'
type: array
secretSessionId:
description: The session ID for the data
type: integer
format: int32
type: object
SecretSessionPointOfInterestModel:
description: Recorded session point of interest
properties:
activityDetails:
description: ActivityDetails
type: string
activityTitle:
description: ActivityTitle
type: string
activityType:
$ref: '#/components/schemas/SecretSessionActivityType'
activityTypeDisplayName:
description: Logged activity type (display format)
type: string
icon:
description: Icon
type: string
launcherSessionGuid:
description: Launcher session unique identifier
type: string
format: uuid
secretId:
description: Secret ID
type: integer
format: int32
nullable: true
secretSessionId:
description: Recorded session ID
type: integer
format: int32
nullable: true
timestamp:
description: Point of interest timestamp
type: string
format: date-time
timestampOffset:
description: Time since session start
type: string
format: time-span
timestampOffsetDisplay:
description: Time since session start (display format)
type: string
type: object
SecretSessionSummaryModel:
description: SecretSessionSummaryModel
properties:
active:
description: Active
type: boolean
endDate:
description: EndDate
type: string
format: date-time
nullable: true
launcherTypeId:
description: LauncherTypeId
type: integer
format: int32
nullable: true
machineName:
description: MachineName
type: string
secretId:
description: SecretId
type: integer
format: int32
secretName:
description: SecretName
type: string
secretSessionId:
description: SecretSessionId
type: integer
format: int32
startDate:
description: StartDate
type: string
format: date-time
userId:
description: UserId
type: integer
format: int32
userName:
description: UserName
type: string
type: object
AuthenticationFailedResponse:
description: Response object for authentication failures
required:
- message
properties:
message:
description: Error message
type: string
type: object
SecretSessionModel:
description: Recorded session
properties:
accessedByName:
description: AccessedByName
type: string
active:
description: Whether the recorded session is active
type: boolean
application:
description: Name of the Application launching the session
type: string
auditSecretId:
description: Associated access audit record
type: integer
format: int32
nullable: true
duration:
description: Duration of recorded session, in seconds
type: integer
format: int32
endDate:
description: Recorded session end time
type: string
format: date-time
nullable: true
endDateDisplay:
description: Recorded session end time (display format)
type: string
errorMessage:
description: Processing error message
type: string
fileExtension:
description: FileExtension
type: string
hasKeyStrokes:
description: Whether the recorded session has logged keystrokes
type: boolean
hasProcesses:
description: Whether the recorded session has info about running processes
type: boolean
hasProcessingError:
description: Whether an error occurred during video processing
type: boolean
isDeleted:
description: Whether the recorded session has been deleted
type: boolean
isLauncher:
description: IsLauncher
type: boolean
launchedSuccessfully:
description: Whether the session reached a state where it was active and not expired and had no other errors
type: boolean
nullable: true
launcherName:
description: LauncherName
type: string
launcherSessionGuid:
description: Launcher session unique identifier
type: string
format: uuid
launcherSessionStatus:
description: LauncherSessionStatus
type: integer
format: int32
launcherTypeId:
description: Launcher type
type: integer
format: int32
nullable: true
machineName:
description: Machine name
type: string
matchingSearchTypes:
description: MatchingSearchTypes
type: string
pbaId:
description: Pba Event Id if session was caused by an access challenge
type: integer
format: int64
nullable: true
secretId:
description: Secret ID
type: integer
format: int32
nullable: true
secretName:
description: Secret name
type: string
secretSessionId:
description: Recorded session ID
type: integer
format: int32
nullable: true
secretSessionUserName:
description: User name from the recorded session
type: string
sessionMovieProcessComplete:
description: Whether video processing is complete
type: boolean
startDate:
description: Recorded session start time
type: string
format: date-time
startDateDisplay:
description: Recorded session start time (display format)
type: string
userDomainName:
description: Active Directory domain name
type: string
userId:
description: User ID
type: integer
format: int32
nullable: true
userName:
description: User name
type: string
userNameForDisplay:
description: Display name for user
type: string
type: object
securitySchemes:
BearerToken:
type: apiKey
description: 'Perform a POST request to `/oauth2/token`. It should include three form data parameters - `username`, `password`, and `grant_type`.The `grant_type` parameter should always have the value `password`.The access token returned should be included in the header of subsequent requests, like ''Authorization: Bearer token''. The token remains valid for a time period returned in the ''expires_in'' property (in seconds). For details, see the token request documentation.'
name: Authorization
in: header