All pages
Powered by GitBook
1 of 1

Audit Channels

get

List channel templates and their applicable connections

Responses
200Success
application/json
400
The request input was invalid
application/json
401
Authentication error
application/json
402
The purchased Lenses license does not provide access to this feature
application/json
403
Authorisation error
application/json
404
The requested resource cannot be found
application/json
500
An internal server error has occurred
application/json
get
GET /api/v1/environments/{name}/proxy/api/v1/audit/channel-templates HTTP/1.1
Host: 
Accept: */*
[
  {
    "id": 440,
    "name": "Splunk",
    "templateVersion": 1,
    "version": "1",
    "enabled": true,
    "builtIn": true,
    "metadata": {
      "author": "Lenses",
      "description": "Splunk channel template"
    },
    "configuration": [
      {
        "id": 102,
        "key": "source",
        "displayName": "Source",
        "placeholder": "lenses-audits",
        "description": "Source to associate with generated Splunk events",
        "type": {
          "name": "STRING",
          "displayName": "string"
        },
        "required": true,
        "provided": false
      }
    ],
    "suitableConnections": [
      {
        "templateName": "Splunk",
        "name": "splunk-connection"
      }
    ],
    "jsonSchema": {
      "$schema": "http://json-schema.org/draft-04/schema#",
      "type": "object",
      "required": [
        "source",
        "host",
        "useHttps",
        "insecure",
        "token"
      ],
      "title": "Splunk, version: 1 template JSON schema",
      "properties": {
        "source": {
          "type": "string",
          "title": "Source",
          "description": "Source to associate with generated Splunk events"
        },
        "host": {
          "type": "string",
          "title": "Host",
          "description": "The host name for the HTTP Event Collector API of the Splunk instance."
        },
        "useHttps": {
          "type": "boolean",
          "title": "Use HTTPS",
          "description": "Use SSL."
        },
        "port": {
          "type": "number",
          "title": "Port",
          "description": "The port number for the HTTP Event Collector API of the Splunk instance."
        },
        "token": {
          "type": "string",
          "title": "Event collector token",
          "description": "HTTP event collector authorization token"
        },
        "insecure": {
          "type": "boolean",
          "title": "Disable SSL certificate verification",
          "description": "This is *not encouraged* but is required for a Splunk Cloud Trial instance."
        }
      }
    }
  }
]
get

Get the audit channel details

Path parameters
idstring ยท uuidRequired

The channel id

Example: 2c1fc20d-59b4-4f67-8982-6e0377e8fdbd
Responses
200Success
application/json
400
The request input was invalid
application/json
401
Authentication error
application/json
402
The purchased Lenses license does not provide access to this feature
application/json
403
Authorisation error
application/json
404
The requested resource cannot be found
application/json
500
An internal server error has occurred
application/json
get
GET /api/v1/environments/{name}/proxy/api/v1/audit/channels/{id} HTTP/1.1
Host: 
Accept: */*
{
  "id": "2c1fc20d-59b4-4f67-8982-6e0377e8fdbd",
  "name": "splunk-prd",
  "templateName": "Splunk",
  "templateVersion": 1,
  "connectionName": "splunk-connection",
  "properties": [
    {
      "key": "source",
      "value": "splunk_source"
    }
  ],
  "createdAt": "2021-01-01T00:00:00Z",
  "createdBy": "joe.bloggs",
  "updatedAt": "2021-01-01T00:00:00Z",
  "updatedBy": "joe.bloggs",
  "enabled": true
}
delete

Deletes the audit entries up to the timestamp

Query parameters
timestampinteger ยท int64Required
Responses
200Success
400
The request input was invalid
application/json
401
Authentication error
application/json
402
The purchased Lenses license does not provide access to this feature
application/json
403
Authorisation error
application/json
404
The requested resource cannot be found
application/json
500
An internal server error has occurred
application/json
delete
DELETE /api/v1/environments/{name}/proxy/api/audit?timestamp=1 HTTP/1.1
Host: 
Accept: */*

No content

get

Returns a list of audit entries

Query parameters
pageintegerOptional
pageSizeintegerOptional
userstringOptional
actionstring ยท enumOptionalPossible values:
typestring ยท enumOptionalPossible values:
filterstringOptional
Responses
200Success
application/json
400
The request input was invalid
application/json
401
Authentication error
application/json
402
The purchased Lenses license does not provide access to this feature
application/json
403
Authorisation error
application/json
404
The requested resource cannot be found
application/json
500
An internal server error has occurred
application/json
get
GET /api/v1/environments/{name}/proxy/api/audit HTTP/1.1
Host: 
Accept: */*
{
  "values": [
    {
      "type": "TOPIC",
      "action": "ADD",
      "user": "text",
      "timestamp": 1,
      "resourceId": "text",
      "resourceName": "text",
      "content": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "pagesAmount": 1,
  "totalCount": 1
}