Skip to content

Commit d1eaa21

Browse files
ai-audit-logs: add siem catalog (#25687)
<!--Delete sections as needed --> ## Description There's a new SIEM catalog in addition to the Custom HTTPS endpoint. - Created dedicated SIEM connector topic with more info - Removed SIEM info from view and export topic - Updated index with new topic Preview: https://deploy-preview-25687--docsdocker.netlify.app/ai/sandboxes/governance/audit/siem/ Added summary bar with min version. Preview: https://deploy-preview-25687--docsdocker.netlify.app/ai/sandboxes/governance/audit/ ## Related issues or tickets ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
1 parent 48600cd commit d1eaa21

6 files changed

Lines changed: 74 additions & 20 deletions

File tree

_vale/config/vocabularies/Docker/accept.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,7 @@ Dockerized
8787
Dockerizing
8888
Dependabot
8989
DuckDuckGo
90+
Dynatrace
9091
Entra
9192
EPERM
9293
ESXi

content/manuals/ai/sandboxes/governance/audit/_index.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ description: Capture, view, export, and collect structured audit records for Doc
66
keywords: docker sandboxes, audit log, audit logging, AI Governance, policy decision, SIEM, compliance, jsonl
77
---
88

9+
{{< summary-bar feature_name="AI Governance Audit Logs" >}}
10+
911
AI Governance Audit Logs record Docker AI Governance activity for your
1012
organization. Each record captures the principal, action, target, decision, and
1113
time for a governance event. Records contain metadata only. They don't contain
@@ -58,6 +60,8 @@ Docker supports two delivery modes for audit records:
5860

5961
Organization owners and users with a [custom role](/manuals/enterprise/security/roles-and-permissions/custom-roles.md) that includes AI Governance audit permissions can configure local disk, Docker Cloud, or both.
6062

63+
The hosted audit log view, CSV export, and SIEM forwarding all require Docker Cloud delivery to be enabled. Local delivery alone does not power these features.
64+
6165
Organizations that used local audit logging before hosted audit logs were
6266
available start with cloud delivery off until an owner opts in from
6367
[audit delivery settings](configure.md).
@@ -75,4 +79,5 @@ Policy](https://www.docker.com/legal/privacy/).
7579
- [Local audit logs](local.md)
7680
- [Configure audit delivery](configure.md)
7781
- [View and export audit events](view-export.md)
82+
- [SIEM forwarding](siem.md)
7883
- [Audit record reference](record-reference.md)
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
title: SIEM forwarding
3+
linkTitle: SIEM forwarding
4+
weight: 35
5+
description: Forward Docker AI Governance audit events to Splunk, Dynatrace, or a custom HTTPS endpoint.
6+
keywords: docker sandboxes, SIEM, audit logs, Splunk, Dynatrace, AI Governance, forwarding, NDJSON
7+
---
8+
9+
Docker can forward audit events to your security information and event
10+
management (SIEM) system, letting you centralize Docker governance data
11+
alongside other security signals. Events are forwarded in NDJSON format.
12+
Docker verifies the endpoint is reachable with the supplied credential before
13+
saving.
14+
15+
## Supported destinations
16+
17+
| Destination | Description |
18+
| -------------------------------- | --------------------------------------------------------------- |
19+
| Splunk Cloud (HEC) | Hosted Splunk using the HTTP Event Collector |
20+
| Splunk Enterprise (self-hosted) | Self-hosted Splunk using the HTTP Event Collector |
21+
| Dynatrace | Dynatrace Log Management using the Log Ingest API |
22+
| Custom HTTPS endpoint (advanced) | Any SIEM that accepts HTTPS with a custom authentication header |
23+
24+
## Before you begin
25+
26+
SIEM forwarding requires Docker Cloud delivery to be enabled for your
27+
organization. If you haven't already, enable it under **AI Platform** >
28+
**Audit logs** > **Audit delivery** before configuring a SIEM destination. See
29+
[Configure audit delivery](configure.md).
30+
31+
Gather credentials from your SIEM before configuring forwarding:
32+
33+
- **Splunk Cloud**: HEC ingest URL and an HEC token. Optionally, a Splunk index
34+
name. See [Splunk documentation](https://docs.splunk.com/).
35+
- **Splunk Enterprise**: HEC endpoint URL (typically port 8088) and an HEC
36+
token. The endpoint must present a publicly-trusted TLS certificate.
37+
Optionally, a Splunk index name. See [Splunk documentation](https://docs.splunk.com/).
38+
- **Dynatrace**: Log Ingest API URL and an API token with the `logs.ingest`
39+
scope. See [Dynatrace documentation](https://docs.dynatrace.com/).
40+
- **Custom HTTPS endpoint**: Your endpoint URL, authentication header name, and
41+
full header value including any scheme (for example, `Bearer <token>`).
42+
43+
## Add a SIEM destination
44+
45+
1. Sign in to [Docker Home](https://app.docker.com/).
46+
1. Open your organization.
47+
1. Go to **AI Platform** > **Audit logs**.
48+
1. Open **Export & Connectors**.
49+
1. Select **Add destination**.
50+
1. Select your destination and complete the form.
51+
1. Select **Save**.
52+
53+
If verification fails, check that the URL and credential are correct and that
54+
the endpoint is accessible from the internet.
55+
56+
## Manage destinations
57+
58+
From the **SIEM forwarding** list, select the menu next to a destination to
59+
edit or delete it. The edit form lets you update credentials and toggle
60+
forwarding on or off for that destination. Deleting a destination permanently
61+
removes the endpoint and its stored credential and cannot be undone.

content/manuals/ai/sandboxes/governance/audit/view-export.md

Lines changed: 3 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
title: View and export audit events
33
linkTitle: View and export
44
weight: 30
5-
description: Search, filter, export, and stream Docker AI Governance audit events from the hosted audit log UI.
6-
keywords: docker sandboxes, audit events, audit logs, AI Governance, CSV export, SIEM, Splunk, NDJSON
5+
description: Search, filter, and export Docker AI Governance audit events from the hosted audit log UI.
6+
keywords: docker sandboxes, audit events, audit logs, AI Governance, CSV export
77
---
88

99
Cloud delivery stores AI Governance audit records in Docker Cloud and makes
1010
them available in the hosted audit log UI. Use the hosted view to investigate
11-
policy decisions, export events to CSV, or stream events to your SIEM.
11+
policy decisions or export events to CSV.
1212

1313
## View audit events
1414

@@ -48,20 +48,3 @@ Use CSV export when you need an offline copy of filtered audit events:
4848
1. Download the generated CSV file from the link Docker provides.
4949

5050
CSV exports include up to 1 000 000 rows. Download links expire after 24 hours.
51-
52-
## SIEM forwarding
53-
54-
Docker can forward audit events to your security information and event
55-
management (SIEM) system, letting you centralize Docker governance data
56-
alongside other security signals in tools such as Datadog or Splunk.
57-
58-
To set up forwarding, you provide an HTTPS endpoint that will receive the audit
59-
events, choose an output format, and supply the credentials Docker will use to
60-
authenticate against your SIEM. Docker verifies the endpoint is reachable before
61-
saving the configuration.
62-
63-
Once configured, forwarding can be enabled or disabled without losing your saved
64-
settings.
65-
66-
To collect host-local files with your own log shipper instead, see
67-
[Local audit logs](local.md).

data/summary.yaml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
AI Governance Audit Logs:
2+
subscription: [AI Governance]
3+
requires: Docker Sandboxes [0.35.0](/manuals/ai/sandboxes/release-notes.md) or later
14
Activity logs:
25
subscription: [Team, Business]
36
for: Administrators

layouts/_shortcodes/summary-bar.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@
1313
"Docker Hardened Images Enterprise" "/icons/dhi.svg"
1414
"Docker Hardened Images Select or Enterprise" "/icons/dhi.svg"
1515
"Docker Offload" "cloud"
16+
"AI Governance" "shield-check"
1617
}}
1718
{{ $availabilityIcons := dict
1819
"Experimental" "beaker"

0 commit comments

Comments
 (0)