Index

get/trail-index/api/v1/index/{connection_id}/status

Get indexing status of the connection

connection_idstring

required

Format: uuid

Responses

Response examples

Connection successfully found

{
  "connection_id": "string",
  "status": "SCHEDULED"
}

post/trail-index/api/v1/index/status

Gets the statuses of the specified connections

Array of strings

Responses

Request examples

[
  "string"
]

Response examples

Successful request

[
  {
    "connection_id": "string",
    "status": "SCHEDULED"
  }
]

post/trail-index/api/v1/index/start

Starts indexing of the specified connections

Array of strings

Responses

Request examples

[
  "string"
]

Response examples

Successful request

[
  {
    "connection_id": "string",
    "status": "SCHEDULED"
  }
]

post/trail-index/api/v1/index/search

Search for the content based on the search parameters defined

keywordsstring

Comma or space-separated strings to search across all connection attributes. The leading and trailing wildcards for the keywords are implicit.

protocolstring

Enum: SSH
RDP

connection_idstring

defines the connection id to be searched for

channel_idstring

defines the channel id to be searched for

start_timestring

defines the start time for search - abosulte timestamp in the connection

Format: date-time
Example: "2017-01-01T15:05:05Z"

end_timestring

defines the end time for search - absolute timestamp in the connection

Format: date-time
Example: "2017-01-01T15:05:05Z"

start_positionint

specifies the start position to search for in milliseconds - relative to the start of connection

Example: 10

end_positionint

specifies the end position to search for in milliseconds - relative to the start of connection

Example: 100

Responses

Request examples

{
  "keywords": "string",
  "protocol": "SSH",
  "connection_id": "string",
  "channel_id": "string",
  "start_time": "2017-01-01T15:05:05Z",
  "end_time": "2017-01-01T15:05:05Z",
  "start_position": 10,
  "end_position": 100
}

Response examples

Successful request, respond with a list of connections

{
  "count": 123,
  "items": [
    {
      "connnection_id": "string",
      "channel_id": "string",
      "protocol": "SSH",
      "timestamp": "2017-01-01T15:05:05Z",
      "position": 123,
      "content": "ls -ltr"
    }
  ]
}