109 lines
1.8 KiB
Markdown
109 lines
1.8 KiB
Markdown
---
|
|
layout: "http"
|
|
page_title: "HTTP API: /sys/audit"
|
|
sidebar_current: "docs-http-audits-audits"
|
|
description: |-
|
|
The `/sys/audit` endpoint is used to enable and disable audit backends.
|
|
---
|
|
|
|
# /sys/audit
|
|
|
|
## GET
|
|
|
|
<dl>
|
|
<dt>Description</dt>
|
|
<dd>
|
|
List the mounted audit backends.
|
|
</dd>
|
|
|
|
<dt>Method</dt>
|
|
<dd>GET</dd>
|
|
|
|
<dt>Parameters</dt>
|
|
<dd>
|
|
None
|
|
</dd>
|
|
|
|
<dt>Returns</dt>
|
|
<dd>
|
|
|
|
```javascript
|
|
{
|
|
"file": {
|
|
"type: "file",
|
|
"description: "Store logs in a file",
|
|
"options": {
|
|
"path": "/var/log/file"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
</dd>
|
|
</dl>
|
|
|
|
## PUT
|
|
|
|
<dl>
|
|
<dt>Description</dt>
|
|
<dd>
|
|
Enable an audit backend.
|
|
</dd>
|
|
|
|
<dt>Method</dt>
|
|
<dd>PUT</dd>
|
|
|
|
<dt>URL</dt>
|
|
<dd>`/sys/audit/<path>`</dd>
|
|
|
|
<dt>Parameters</dt>
|
|
<dd>
|
|
<ul>
|
|
<li>
|
|
<span class="param">type</span>
|
|
<span class="param-flags">required</span>
|
|
The type of the audit backend.
|
|
</li>
|
|
<li>
|
|
<span class="param">description</span>
|
|
<span class="param-flags">optional</span>
|
|
A description of the audit backend for operators.
|
|
</li>
|
|
<li>
|
|
<span class="param">options</span>
|
|
<span class="param-flags">optional</span>
|
|
An object of options to configure the backend. This is
|
|
dependent on the backend type. Please consult the documentation
|
|
for the backend type you intend to use.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
|
|
<dt>Returns</dt>
|
|
<dd>`204` response code.
|
|
</dd>
|
|
</dl>
|
|
|
|
## DELETE
|
|
|
|
<dl>
|
|
<dt>Description</dt>
|
|
<dd>
|
|
Disable the given audit backend.
|
|
</dd>
|
|
|
|
<dt>Method</dt>
|
|
<dd>DELETE</dd>
|
|
|
|
<dt>URL</dt>
|
|
<dd>`/sys/audit/<path>`</dd>
|
|
|
|
<dt>Parameters</dt>
|
|
<dd>None
|
|
</dd>
|
|
|
|
<dt>Returns</dt>
|
|
<dd>`204` response code.
|
|
</dd>
|
|
</dl>
|