mirrors/vault
1
0
Fork 0
mirror of https://github.com/hashicorp/vault.git synced 2025-09-08 23:41:13 +02:00
Code Issues Projects Releases Wiki Activity
vault/website/source/docs/http/sys-config-auditing.html.md
Seth Vargo 50ca10b5c8
Fix http layout
2017-03-06 16:11:05 -05:00

2.0 KiB
Raw Blame History

layout, page_title, sidebar_current, description
layout page_title sidebar_current description
http HTTP API: /sys/config/auditing docs-http-config-auditing The `/sys/config/auditing` endpoint is used to configure auditing settings.

/sys/config/auditing/request-headers

GET

Description
List the request headers that are configured to be audited. _This endpoint requires `sudo` capability._
Method
GET
Parameters
None
Returns
```javascript
{
  "headers": {
    "X-Forwarded-For": {
      "hmac":true
    }
  }
}
```

/sys/config/auditing/request-headers/

GET

Description
List the information for the given request header. _This endpoint requires `sudo` capability._
Method
GET
URL
`/sys/config/auditing/request-headers/`
Parameters
None
Returns
```javascript
{
  "X-Forwarded-For": {
    "hmac":true
  }
}
```

PUT

Description
Enable auditing of a header. _This endpoint requires `sudo` capability._
Method
PUT
URL
`/sys/config/auditing/request-headers/`
Parameters
  • hmac optional Bool, if this header's value should be hmac'ed in the audit logs. Defaults to false.
Returns
`204` response code.

DELETE

Description
Disable auditing of the given request header. _This endpoint requires `sudo` capability._
Method
DELETE
URL
`/sys/config/auditing/request-headers/`
Parameters
None
Returns
`204` response code.