open-vault/website/source/docs/http/sys-audit.html.md

1.8 KiB

layout page_title sidebar_current description
http HTTP API: /sys/audit docs-http-audits-audits The `/sys/audit` endpoint is used to enable and disable audit backends.

/sys/audit

GET

Description
Lists all the available policies.
Method
GET
Parameters
None
Returns
```javascript
{
  "file": {
    "type: "file",
    "description: "Store logs in a file",
    "options": {
      "path": "/var/log/file"
    }
  }
}
```

PUT

Description
Enable an audit backend.
Method
PUT
URL
`/sys/audit/`
Parameters
  • type required The type of the audit backend.
  • description optional A description of the audit backend for operators.
  • options optional 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.
Returns
`204` response code.

DELETE

Description
Disable the given audit backend.
Method
DELETE
URL
`/sys/audit/`
Parameters
None
Returns
`204` response code.