/sys/config/auditing/request-headers
The /sys/config/auditing
endpoint is used to configure auditing settings.
Read all audited request headers
This endpoint lists the request headers that are configured to be audited.
sudo
required – This endpoint requiressudo
capability in addition to any path-specific capabilities.
Method | Path |
---|---|
GET | /sys/config/auditing/request-headers |
Sample request
Sample response
Read single audit request header
This endpoint lists the information for the given request header.
sudo
required – This endpoint requiressudo
capability in addition to any path-specific capabilities.
Method | Path |
---|---|
GET | /sys/config/auditing/request-headers/:name |
Parameters
name
(string: <required>)
– Specifies the name of the request header to query. This is specified as part of the URL.
Sample request
Sample response
Create/Update audit request header
This endpoint enables auditing of a header.
sudo
required – This endpoint requiressudo
capability in addition to any path-specific capabilities.
Method | Path |
---|---|
POST | /sys/config/auditing/request-headers/:name |
Parameters
hmac
(bool: false)
– Specifies if this header's value should be HMAC'ed in the audit logs.
Sample payload
Sample request
Delete audit request header
This endpoint disables auditing of the given request header.
sudo
required – This endpoint requiressudo
capability in addition to any path-specific capabilities.
Method | Path |
---|---|
DELETE | /sys/config/auditing/request-headers/:name |
Sample request